Requirements

Bridle supports Linux for development and in theory macOS and Windows, but these have not been tested yet.

Supported operating systems

The following table shows the operating system versions that support the Bridle development environment:

LinuxmacOSWindows

Operating System	x86	x64	ARM64
Ubuntu 22.04 LTS	Not applicable	Tier 2	Tier 3
Ubuntu 20.04 LTS	Not applicable	Tier 1	Tier 2

The table uses the following Tier # definitions to categorize the level of operating system support:

Tier 1

The Bridle development environment will always work. The automated build and automated testing ensure that the Bridle development environment build and successfully complete tests after each change.

Tier 2

The Bridle development environment will always build. The automated build ensures that the Bridle development environment build successfully after each change. There is no guarantee that a build will work because the automation tests do not always run.

Tier 3

The Bridle development environment are supported by design but not built or tested after each change. Therefore, the application may or may not work.

Not supported

The Bridle development environment do not work, but it may be supported in the future.

Not applicable

The specified architecture is not supported for the respective operating system.

Note

The Bridle development environment are not supported by the older versions of the operating system.

Required tools

The following table shows the tools that are required for working with Bridle vv3.6.99. It lists the minimum version that is required and the version that is installed when using the System Install Manager as described in Installing Bridle through … t.b.d. (TBD) Desktop Installer.

LinuxmacOSWindows

Tool	Minimum version	Tested version
Ccache		3.7.7-1
CMake	3.20	3.27.7-0kitware1ubuntu20.04.1
DFU Utilities		0.9-1
Device tree compiler (Snap Craft)	1.4.6	1.5.1-1
OpenOCD	0.11	0.11.0-5 (xPack OpenOCD from GitHub)
Git		1:2.25.1-1ubuntu3.5
GNU gperf	3.1	3.1-1build1
Ninja	1.8.2	1.10.0-1build1
Python	3.8	3.8.2-0ubuntu2
west	0.12	0.14.0
Zephyr SDK	0.16.4	0.16.5
Arm GNU Toolchain	11.2-2022.02	13.2.rel1
GNU Arm Embedded Toolchain	10-2020-q4-major	10.3-2021.10
STM32CubeCLT (GNU tools for STM32)	1.11.1 (10.3.rel1)	1.14.0 (11.3.rel1)
MCUXpresso IDE (Arm GNU Toolchain)	11.9.0 (12.3.rel1)	11.9.0 (12.3.rel1)
Doxygen	1.9.2	1.9.8-1+ppa~tsn1~focal
Graphviz (dot)	2.42	2.42.2-3build2
MscGen	0.20	0.20-12

Required Python dependencies

The following table shows the Python packages that are required for working with Bridle vv3.6.99. If no version is specified, the default version provided with pip is recommended. If a version is specified, it is important that the installed version matches the required version. See Installing additional Python dependencies for instructions on how to install the Python dependencies.

Building and running applications, samples, and tests

Package	Version
ecdsa	>=0.18.0
imagesize	>=1.4
intelhex	>=2.3
pyelftools	>=0.30
pymcuprog	>=3.16
pyserial	>=3.5
pyocd	>=0.36
pylint	>=3.1
PyYAML	>=6.0
west	>=0.14.0,<1.3.0
windows-curses (only Windows)

Building documentation

Package	Version
breathe	>=4.35
docutils	>=0.18
doxmlparser	~=1.10
Pygments	~=2.18
Sphinx	~=7.1
sphinx-tsn-theme	~=2024.1
sphinxcontrib-mscgen	~=0.6
sphinxcontrib-svg2pdfconverter	~=1.2
sphinx-copybutton	~=0.5
sphinx-csv-filter	~=0.4
sphinx-notfound-page	~=1.0
sphinx-sitemap	~=2.6
sphinx-tabs	~=3.4
sphinx-togglebutton	~=0.3