Quickstart Guide - MeCO-AUV/MeCO-Documentation GitHub Wiki

Home | Hardware Specifications | Software Packages | Api-DOCS

Getting Started with Software

Once you have the hardware set up and running, you can use the following process to begin writing code (on your machine) for MeCO. The MeCO project is spread across multiple GitHub repositories that all belong to the meco-auv GitHub organization. Certain repositories are meant to be deployed to certain computers for robot operation. The Dev machine is any x86 computer used for code development, Jetson is the Jetson Orin NX onboard MeCO, Control Teensy is the Teensy 4.1 onboard MeCO, and OCU is the operational control unit, which is the laptop used to connect to MeCO via a tether. To begin use the meco-setup repository to install the necessary dependencies to write and upload microROS code to the Teensy 4.1.

meco-setup

Meta repository containing scripts and resources to setup the software stack for the MeCO AUV and computers to develop code for the Teensy 4.1 and Jetson Orin NX on MeCO.

MeCO AUV project documentation can be found at the meco-auv/meco-docs GitHub repository.

Development or Robot Machine Setup

Clone this repository to the folder $HOME/ros2_ws_meco

mkdir -p $HOME/ros2_ws_meco/extras
cd $HOME/ros2_ws_meco/extras
git clone [email protected]:meco-auv/meco-setup.git

Make sure you have SSH keys setup with github.umn.edu.

Run the setup.sh script to download packages, dependencies, and clone meco-auv repositories. Select Development computer or MeCO Jetson Orin in the menu to initialize default selections in the following menu screens.

cd meco-setup
./setup.sh

TODO more documentation about the development cycle w/build.sh and docker-compose

Executable Script Usage:

setup.sh [OPTION]
  -d     use default values and run without GUI
  
build.sh [OPTIONAL: path/to/ros2_ws]

Teensy Code Development

Once installed, follow directions in the teensy-meta repository to launch the Arduino IDE. You can then navigate to Software Packages, wherein yu can find all of the software repositories currently running on MeCO. Teensy.