Requirements

Bridle supports Linux for development and in theory Windows and macOS, but these have not been tested yet. However, there are some Zephyr features that are currently only available on Linux, including:

• Test Runner (Twister)

• Native POSIX execution (native_posix)

• Networking with native_posix board and Networking with QEMU (net-tools)

• BlueZ integration

• BabbleSim

Note

Before you start setting up the toolchain, install available updates for your operating system.

Supported operating systems

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

WindowsLinuxmacOS

Operating System	x86	x64	ARM64
Windows 11	Tier 3	Tier 3	Not supported
Windows 10	Tier 3	Tier 3	Not supported

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 v3.1.0. 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.

WindowsLinuxmacOS

Tool	Minimum version	Tested version
CMake	3.20	3.20.5
Device tree compiler (MSYS2 Chocolatey)	1.4.6	1.4.7-1
OpenOCD	0.11	0.11.0-5 (xPack OpenOCD from GitHub)
Git		2.26.2.windows.1
GNU gperf	3.1	3.1
Ninja	1.8.2	1.9.0
Python	3.8	3.8.2
west	0.12	0.14.0
Zephyr SDK	0.14.1	0.14.2
GNU Arm Embedded Toolchain	10-2020-q4-major
Doxygen	1.9.1
Graphviz (dot)	2.42
MscGen	0.20

Required Python dependencies

The following table shows the Python packages that are required for working with Bridle v3.1.0. 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.17.0
imagesize	>=1.3
intelhex	>=2.3
pyelftools	>=0.26
pylint	>=2.12
PyYAML	>=5.1
west	>=0.12.0,<0.15.0
windows-curses (only Windows)

Building documentation

Package	Version
docutils	>=0.16,<0.18
breathe	>=4.30,<4.33 # 4.33: disabled due to #803 and #805 issues
Pygments	~=2.13
CommonMark	~=0.9
recommonmark	~=0.7
Sphinx	~=4.0
sphinx-tsn-theme	~=2022.10
sphinxcontrib-svg2pdfconverter	~=1.2
sphinxcontrib-mscgen	~=0.6
sphinx-tabs	~=3.4
sphinx-csv-filter	~=0.3