Deploy Tools

This Repo aims to ease compilation and deployment code to STM32 boards. Most of the projects are oriented towards its use in Robomaster Competition.

Prerequisites:

If you would like to use this repo, you'll need:

• Ubuntu host
• Git
• VSCode
• GNU-ARM toolchain (Optional)
• CubeMx (Optional)

Installation steps

1. If you're on Ubuntu, first run the following:

    sudo apt install -y git
   
    git clone https://github.com/RobomasterOwltech/deployTools.git
   
    code deployTools
   

2. When VS prompts if you want to install the recommended extensions, select Install, so your VS Code env is ready to go.

3. Run the first script. Don't forget to make sure it is has executable permissions!

    sudo bash initialSetup/runMeUbuntu.sh
   

4. Then, register the created ssh keys to your Github account.

5. Ctrl+Shift+P -> will open the command palette.

   • From the command palette you can run tasks.
   1. From here select the tasks to build the development container

6. Continue cloning all the repos you need.

(Optional) Replicate the container on your local machine

1. Download the gnu-arm-none-eabi toolchain form Developer Arm GNU Toolchains

2. After that, run

   sudo bash initialSetup/setUpCrossCompiler.sh
   

3. (Optional) Download CubeMx

    sudo bash initialSetup/setUpCubeMx.sh
   

Tools used installed by the repo

• Docker
• Some VS Code extensions
• screen

Contents brief:

TODO:

• Why is this the repo structure
• What each folder does
• How to run a task
• Configure Docker to do the complete installation of the tools

/builderImages

Contains DockerFiles to make containerized development. Tho most tools will be installed locally, the compilation needs to be the same across all team members, so to keep it standarized it must be done through the container.

/initialSetup

Contains a series of bash scripts that aim to facilitate the installation of the tools you'll be using.

/.vscode

Contains configuration files to ease development for your projects. IT achieves so in two ways, tasks, which are a number of small automations. Standard extentions, to make sure evryone has whats required to make clean code on this and other repos easier.

/.vscode

TBDone