Vibeleaderboard
Index / tool
Visit github.com
Category
Developer Tools
Rank
No. 1705Tools index
Pricing
Open Source
Type
TOOL
Use case
Software Testing & Quality
Interfaces
Web
GitHub
12 stars
Latest release
v0.5.0
Date

About

Cooja-NG is a deterministic network simulator that runs unmodified Contiki-NG firmware, with experimental support for Zephyr, RIOT and OpenThread, on emulated MSP430 and Cortex-M boards. Nodes running different operating systems share one simulated IEEE 802.15.4 radio network, and the same seed reproduces a run exactly. It runs headless in CI, on a laptop, or in the browser through WebAssembly.

At a glance

Cooja-NG is a C network simulator for IEEE 802.15.4 networks that runs unmodified firmware images on emulated MSP430 and Cortex-M boards, down to the radio chip. Contiki-NG is the validated target; Zephyr, RIOT and OpenThread are experimental on specific boards. A seed gives a byte-identical run, so the cngsim command works headless in CI, in a web UI, or compiled to WebAssembly in a browser tab.

Good fit

Embedded and IoT developers testing low-power mesh firmware (RPL, TSCH, Thread) without a rack of boards, especially Contiki-NG teams who already use Cooja. It runs Contiki-NG's Cooja test suite headless, converts .csc files with cngsim convert, and lets nodes running different operating systems share one simulated network.

Consider something else when

Your product uses Bluetooth LE, LoRa, Wi-Fi or Wi-SUN, or you need realistic propagation: the medium is a unit-disk model with no path loss, fading or SINR. Skip it too above 128 nodes, or if you rely on Cooja's desktop GUI, Java plugins or its DGRM and MRM radio media, which are not implemented.

Start here

Try the browser demo first, which needs no install. Locally, download a release or run make && make install PREFIX=~/.local, then cngsim run rpl-udp-sky --ui to watch a bundled Contiki-NG network in the browser. Each run exits 0 when its checks pass and 1 when one fails, which is what a CI step needs. Zephyr users can run cngsim run build/zephyr/zephyr.elf.

Cost and requirements

Free under the 3-clause BSD licence. Release binaries cover Linux x86-64 and macOS on arm64 and x86-64; FreeBSD builds from source with gmake. Building needs only a C compiler, with GNU Lightning optional for the JITs. cngsim convert and the Cooja suite need python3, and the 8 TUN/border-router tests need root, iproute2 and tunslip6.

Limits to know

Version 0.5.0. Non-Contiki stacks have gaps: on several boards Zephyr or RIOT only boots or is untested, and OpenThread's RCP, POSIX and border-router builds are out of scope. Flash erases and writes complete instantly, the nRF52840's CryptoCell is not modelled, and native Cooja motes do not build on FreeBSD. The serial socket deliberately delays bytes from mote to host by 40 ms.

Still unclear

  • Windows support is not addressed: release binaries are listed only for Linux and macOS.

Sources checked 2026-11-17. Source-based assessment.

Tags

simulatoriotcontiki-ngzephyr802.15.4webassembly

Comments (0)

No comments yet

Editorially curated, with community endorsements as a secondary signal. Corrections welcome.