Navigation

Toolchain installation

CatPilot and C-ATOM projects are maintained under Ubuntu and MacOS, at the same time nothing OS specific in invovled, so you should have no problems for working with codebase.

Toolchain list

  • cmake > 3.15

  • openocd 0.11.0

  • stlink-tools 1.7.0

  • catch2 3.0.1

  • bison 3.8.2

  • flex 2.6.4

  • arm-none-eabi <https://developer.arm.com/downloads/-/gnu-rm> 10.3-2021.10

Ubuntu installation

sudo apt-get update
sudo apt-get install cmake openocd stlink-tools catch2 bison flex

If you plan to use ESWB GUI via PyQt (Quick graphical user interfaces creation) Then also install:

sudo apt-get install python3-pyqt5 pyqt5-dev-tools qttools5-dev-tools

MacOS installation

brew install open-ocd
brew install stlink

If you plan to use ESWB GUI via PyQt (Quick graphical user interfaces creation) Then also install:

python3 -m pip install PyQt5

For M1 environment this variant played out:

brew install pyqt5

Catch2 install tips

Note

You may omit this section if you don’t plan to run tests,

but make sure you don’t build all targets in CMakeLists tree.

git clone https://github.com/catchorg/Catch2.git
cd Catch2
git checkout v3.0.1
cmake -Bbuild -H. -DBUILD_TESTING=OFF
sudo cmake --build build/ --target install

IDE integration

Check JetBrains Clion IDE setup and VS Code IDE setup for IDE integration quick tips.