...

1. Install docker. For Mac and Windows, you must install docker desktop instead.

2. If using Windows follow two more steps because Docker for Windows runs on WSL (Windows Subsystem for Linux):

   1. Install WSL by running wsl --install

   2. Setup wsl by launching ubuntu from the start menu

3. Setup the formatter:

   1. Open (File-->Preferences-->Settings)

   2. Type clang in the settings search bar

   3. Change C_Cpp: Clang_format_fallback Style to none

   4. Change C_Cpp: Clang_format_style to file:${workspaceRoot}/Drivers/Embedded-Base/clang-format

   5. Now you are ready to format the files using the builtin vscode shortcut (right click in the editor and hit format)

   6. Note: Never format files touched by CubeMX. This includes any files listed as autogenerated, including files you may need to edit like main.c or stm32XXX_it.c!!!

Usage

MacOS

1. Make sure Docker Desktop is started

2. Clone and open a terminal in a embedded project.

3. Pull down the Docker container you are using by running docker compose pull.

4. Start the container by running docker compose run --rm ner-gcc-arm.

   1. Make sure you are running it in the root directory of the project (Ex. Cerberus, Shepherd, Iroh, Proteus, etc.)

...