This project does NOT follow semantic versioning. The version increases as follows:
- Major version updates are breaking updates to the build infrastructure. These should be very rare.
- Minor version updates are made for every major Buildroot release. This may also include Erlang/OTP and Linux kernel updates. These are made four times a year shortly after the Buildroot releases.
- Patch version updates are made for Buildroot minor releases, Erlang/OTP releases, and Linux kernel updates. They're also made to fix bugs and add features to the build infrastructure.
This is a major Erlang and Buildroot update.
Please see the nerves_system_br v1.29.0 release notes for upgrade instructions if you've forked this system.
-
Changes
- Applied and enabled the Real-Time Linux patch set, PREEMPT_RT. Please see write-ups on the web for benefits and how to use. The impact of this patch shouldn't be noticeable to most Nerves users.
- Switch CPU frequency governor from conservative to the more modern schedutil. See LWN article for details.
- Fix missing option for out-of-the-box QMI (cellular modem) support
-
Updated dependencies
- nerves_system_br v1.29.1
- Buildroot 2024.08.2
- Linux 6.6.51 (Raspberry Pi stable_20241008 release)
This is a security/bug fix update.
-
Changes
- Enable QMI kernel modules to support many cellular modems without a Nerves system update
- Reduce copy/pasted definitions in the
fwup.conf
by extracting them tofwup_include/fwup-common.conf
. (No functional changes)
-
Updated dependencies
This is a major Erlang and Buildroot update.
Please see the nerves_system_br v1.28.0 release notes for upgrade instructions if you've forked this system.
-
Changes
- Elixir 1.17 and Erlang/OTP 27 support
-
Fixes
- The serial numbers returned by
Nerves.Runtime.serial_number/0
now contain the whole serial number. If you forked this system, check theboardid.config
anderlinit.config
for the changes and to keep the hostname the same.
- The serial numbers returned by
-
Updated dependencies
- Linux 6.6.31 (Raspberry Pi stable_20240529 release)
- nerves_system_br v1.28.1
- Buildroot 2024.05
- Erlang/OTP 27.0
This is a security/bug fix update.
-
Changes
- Enable the
wpa_supplicant
option for allow wired 802.1x authentication
- Enable the
-
Package updates
This is a major Buildroot update.
Please see the nerves_system_br v1.27.0 release notes for upgrade instructions if you've forked this system.
-
Changes
- The
libcamera
andrpicam_apps
packages have been replaced with the Raspberry Pi-forked versions for better compatibility. Please seenerves_system_br
release notes. - Add back
CONFIG_RASPBERRYPI_GPIOMEM
to support thedht
library.
- The
-
Updated dependencies
This is a major Buildroot update.
Please see the nerves_system_br v1.26.0 release notes for upgrade instructions if you've forked this system.
-
New features
- Add the imx296 overlays for the Raspberry Pi Global Shutter Camera
-
Updated dependencies
This is a security/bug fix update.
Package updates
This is a major Buildroot and toolchain update that also adds support for using Scenic without customizing the system.
Please see nerves_system_br v1.25.0 release notes for upgrade instructions if you've forked this system.
-
New features
- Add libcairo for Scenic support
-
Updated dependencies
This is a security/bug fix update.
- Package updates
This is a Buildroot version update that appears to mostly contain bug and security fixes. It should be a low risk upgrade from v1.23.2.
-
New features
- Support factory reset, preventing firmware reverts. See Nerves.Runtime.FwupOps
-
Updated dependencies
-
Fixes
- This fixes a rare aarch64 Erlang JIT bug that affects NervesKey users. See
nerves_system_br
notes.
- This fixes a rare aarch64 Erlang JIT bug that affects NervesKey users. See
-
Updated dependencies
This is a bug and security fix update. It should be a low risk upgrade.
-
Fixes
- Fix CTRL+R over ssh
-
Updated dependencies
This is a major update that brings in Erlang/OTP 26, Buildroot 2023.02.2, Linux 6.1, and Raspberry Pi firmware updates.
-
New features
- The Raspberry Pi cameras now work with libcamera. The libcamera apps are included. See the Raspberry Pi Camera docs.
- CA certificates are included for OTP 26.
-
Changes
- The
start.elf
andfixup.dat
files were renamed tostart4.elf
andfixup4.dat
to be more consistent with the RaspberryPi OS naming.
- The
-
Updated dependencies
- nerves_system_br v1.23.1
- Buildroot 2023.02.2
- Erlang/OTP 26.0.2
- Linux 6.1.21 (Raspberry Pi Linux tag 1.20230405)
This is a bug and security fix update. It should be a low risk upgrade from v1.22.1.
- Updated dependencies
This is a bug fix and Erlang version bump from 25.2 to 25.2.3. It should be a low risk upgrade from v1.22.0.
-
Fixes
- Set Erlang crash dump timer to 5 seconds, so if an Erlang crash dump does happen, it will run for at most 5 seconds. See erlinit.conf.
-
Updated dependencies
This is a Buildroot version update that appears to mostly contain bug and security fixes. It should be a low risk upgrade from v1.21.2.
- Updated dependencies
-
Changes
- Two Buildroot patch updates and an Erlang minor version update
- Nerves Heart v2.0 is now included. Nerves Heart connects the Erlang runtime to a hardware watchdog. v2.0 has numerous updates to improve information that you can get and also has more safeguards to avoid conditions that could cause a device to hang forever.
-
Updated dependencies
- linux 5.15.78 (RPi 1.20221104)
- nerves_system_br v1.21.6
- Erlang/OTP 25.2
- Buildroot 2022.08.3
- nerves_heart v2.0.2
-
Changes
- Fix regression when building on x86_64 Linux where wrong toolchain was used.
- Reduce first-time Linux kernel download by using tarball source
-
Updated dependencies
This release includes a major change to the display drivers by switching to the full KMS drivers. Raspberry Pi OS has been using these and they appear to be a big improvement over the fake KMS ones. This might cause some application changes or updates if you're using the display.
-
Changes
- Switch from using the fake KMS to full KMS device drivers for using the display. See PR #155.
- Support aarch64 Linux builds
- Add libdtc to support runtime loading of device tree overlays
-
Updated dependencies
- Updated dependencies
- Updated dependencies
This release updates to Buildroot 2022.05, Linux 5.15.32 (from Linux 5.10) and uses GCC 11.3 (from GCC 10.3). The Linux kernel upgrade could introduce a regression, so please verify hardware-specific functionality in your firmware.
If you have cloned this repository for a custom system, please make sure that
you have CONFIG_NOP_USB_XCEIV=y
in your Linux kernel configuration.
- Updated dependencies
This release updates to Buildroot 2022.02.1 and OTP 25.0. While this should be an easy update for most projects, many programs have been updated. Please review the changes in the updated dependencies for details.
The OTP 25 JIT starts by default with this release.
- Updated dependencies
This release bumps Erlang to 24.3.2 and should be a low risk upgrade from the previous release.
-
Changes
- Pull in upstream Linux SquashFS patch to improve file system performance
-
Updated dependencies
This is a Buildroot and Erlang bug and security fix release. It should be a low risk upgrade from the previous release.
-
Updated dependencies
-
Changes
- Enable Prolific PL2303 USB->Serial driver
This is a Buildroot and Erlang bug fix release. It should be a low risk upgrade from the previous release.
-
Updated dependencies
-
Changes
- Specify CPU-specific flags when compiling NIFs and ports. This fixes an issue where some optimizations could not be enabled in NIFs even though it should be possible to have them. E.g., ARM NEON support for CPUs that have it.
- Build the Wireguard kernel driver. This is a small device driver that enables a number of VPN-based use cases.
-
Updated dependencies
-
Changes
- Programs that use OpenMP will run now. The OpenMP shared library
(
libgomp.so
) was supplied by the toolchain, but not copied.
- Programs that use OpenMP will run now. The OpenMP shared library
(
This release updates to Buildroot 2021.11 and OTP 24.2. If you have made a
custom system, please review the nerves_system_br
release
notes
since Buildroot 2021.11 changed some Raspberry Pi firmware options.
-
Updated dependencies
- nerves_system_br v1.18.2
- Buildroot 2021.11
- Erlang/OTP 24.2
- Raspberry Pi WiFi firmware
- Linux 5.10.88 with Raspberry Pi patches
- GCC 10.3
-
Improvements
- Support for the
dl.nerves-project.org
backup site. Due to a GitHub outage in November, there was a 2 day period of failing builds since some packages could not be downloaded. We implemented the backup site to prevent this in the future. This update is in thenerves_defconfig
. - Use new build ORB on CircleCI. This ORB will shorten build times to fit in CircleCI's new free tier limits. Please update if building your own systems.
- Support for the
- Updated dependencies
This release updates the Linux kernel from 5.4 to 5.10 to follow the Raspberry Pi OS.
-
Fixes
- Shrink down the artifact size by reducing duplication in DRI libraries. This has no runtime change.
-
Updated dependencies
- nerves_system_br v1.17.3
- Erlang/OTP 24.1.4.
- Linux 5.10.63 with Raspberry Pi patches
This is a security/bug fix patch release. It should be safe to update for everyone.
-
Updated dependencies
-
Fixes
- Fix the sysfs thermal interface driver. It was incorrectly unselected in the Linux kernel options previously.
-
Improvements
- Include software versioning and licensing info (see legal-info directory in artifact)
This release updates to Buildroot 2021.08 and OTP 24.1. If you have made a
custom system off this one, please review the nerves_system_br v1.17.0
release
notes.
- Updated dependencies
- Improvements
- Enable USB gadget interface on boot so that the USB-C cable can provide power and networking like the RPi Zero and RPi 3A.
This release updates Erlang/OTP from 24.0.3 to 24.0.5 and Buildroot from 2021.05 to 2021.05.1. Both of these are security/bug fix updates. This is expected to be a safe upgrade from v1.16.1 for all users.
-
Updated dependencies
-
Improvements
- Beta support for using a
runtime.exs
script for runtime configuration. - Added a
provision
task to thefwup.config
to enable re-provisioning a MicroSD card without changing its contents. - Adds a default
/etc/sysctl.conf
that enables use of ICMP in Erlang. This requiresnerves_runtime v0.11.5
or later to automatically load the sysctl variables. With it using:gen_udp
to send/receive ICMP will "just work". It also makes it easier to add other sysctl variables if needed.
- Beta support for using a
This release updates Nerves Toolchains to v1.4.3 and OTP 24.0.3. It should be safe for everyone to apply.
- Updated dependencies
This release updates to Buildroot 2021.05 and OTP 24.0.2. If you have made a
custom system off this one, please review the nerves_system_br v1.16.0
release
notes.
-
Updated dependencies
-
Improvements
- This release now contains debug symbols and includes the Build-ID in the ELF headers. This makes it easier to get stack traces from C programs. As before, the Nerves tooling strips all symbols from firmware images, so this won't make programs bigger.
- Enable compile-time
wpa_supplicant
options to support WPA3, mesh networking, WPS and autoscan.
This is a security/bug fix release that updates to Buildroot 2021.02.1 and OTP 23.3.1. It should be safe for everyone to apply.
-
Improvements
- Raspberry Pi CM4 support
- espeak has been removed from the default install to trim 13 MB off the root filesystem
-
Updated dependencies
- Linux 5.4.83 - required for CM4 device tree updates
- nerves_system_br v1.15.1
- Buildroot 2021.02
- Erlang/OTP 23.3.1
This release updates to Buildroot 2021.02 and OTP 23.2.7. If you have made a
custom system off this one, please review the nerves_system_br v1.15.0
release
notes.
The Nerves toolchain has also been updated to v1.4.2. This brings in Linux 4.14 headers to enable use of cdev and eBPF. This won't affect most users.
- Updated dependencies
This release updates to Buildroot 2020.11.2, GCC 10.2 and OTP 23.2.4.
When migrating custom systems based, please be aware of the following important changes:
-
There's a new
getrandom
syscall that is made early in BEAM startup. This has the potential to block the BEAM before Nerves can startrngd
to provide entropy. We have not seen this issue here, but have updatederlinit.config
for the time being as a precaution. -
The GCC 10.2.0 toolchain has a different name that calls out "nerves" as the vendor and the naming is now more consistent with other toolchain providers.
-
Experimental support for tooling that requires more information about the target has been added. The initial support focuses on zigler.
-
Updated dependencies
This release adds missing V3D/VC4 drivers and enables the vc4-fkms-v3d
device
tree overlay. This fixes issues found when trying out OpenGLES w/ DRM.
This releases enables the OpenGL ES drivers so that it's possible to run UI libraries without a custom system. Note that the RPi4 uses the Linux DRM interface rather than MMAL and so it is not compatible with Elixir UI libraries that work on other Raspberry Pis.
- Updated dependencies
This release fixes the following issues found with the switch to 64-bit ARM:
- Circuits.GPIO can't set pullups
- 5 GHz WiFi is either flaky or doesn't work
- No GPU drivers
A huge thanks for people in the Nerves community that identified these issues and helped verify the fixes.
This release also includes a patch release update to Buildroot 2020.08.2.
- Updated dependencies
IMPORTANT: This release runs the RPi4 in 64-bit ARM mode. This change was made for many reasons. See #65 for details. While this is a big change, it is likely that it will not affect your programs at all.
The second change in this release is to bump the Linux kernel to 5.4. This follows the kernel update in the Raspberry Pi OS.
If you have based a custom system off of this one, please inspect all
configuration files for changes. In particular, WiFi firmware location has
changed since the rpi-wifi-firmware
package went out of date. Git commit
messages on the nerves_system_rpi4
repository may also be helpful.
-
Updated dependencies
-
Improvements
- Enabled reproducible builds in Buildroot to remove some timestamp and build path differences in firmware images. This helps delta firmware updates.
- The memory cgroup controller is no longer enabled by default. This was an upstream change. As a result, the memory cgroup directory is no longer mounted.
This release updates to Buildroot 2020.08 and OTP 23.1.1.
-
Updated dependencies
-
New features
- Added support for updating the root filesystem using firmware patches. See the firmware patch docs for more information.
This release updates to Buildroot 2020.05.1 and OTP 23.0.3 which are both bug fix releases.
IMPORTANT: If you have made a custom fwup.conf
file, then you'll need to
replace references to start4.elf
with start.elf
and references to
fixup4.dat
with fixup.dat
. See commit
e21ad76
for how this change was made here.
-
Updated dependencies
-
New features
- The
/data
directory now exists for storing application-specific data. It is currently a symlink to/root
. Using/data
will eventually be encouraged over/root
even though currently there is no advantage. This change makes it possible to start migrating paths in applications and libraries.
- The
-
Fixes
- Fixed old references to the
-Os
compiler flag. All C/C++ code will default to using-O2
now.
- Fixed old references to the
- Fixes
- Remove
nerves_system_linter
from hex package. This fixes mix dependency errors in projects that reference systems with differentnerves_system_linter
dependency specs.
- Remove
This release updates the system to use Buildroot 2020.05 and Erlang/OTP 23. Please see the respective release notes for updates and deprecations in both projects for changes that may affect your application.
-
New features
- Support the Raspberry Pi Sense HAT's joystick
- Enable WiFi mesh support in the 802.11 stack
-
Updated dependencies
- Updated dependencies
- nerves_system_br v1.11.4
- Erlang 22.3.4.1
- fwup 1.7.0
- Updated dependencies
- nerves_system_br v1.11.2
- Erlang 22.3.1
- erlinit 1.7.0 - tty initialization support
- fwup 1.6.0 - xdelta3/VCDIFF patch support
- Enable unixodbc so that Erlang's odbc application can be used in projects
This release updates the Linux configuration to match changes in the latest Raspberry Pi kernel configuration for the Raspberry Pi 4. If you have made a custom system, the following kernel configuration changes may affect you:
+CONFIG_CPUFREQ_DT=y
+CONFIG_ARM_RASPBERRYPI_CPUFREQ=y
+# CONFIG_ARM_BCM2835_CPUFREQ is not set
+CONFIG_RPIVID_MEM=m
+CONFIG_REGULATOR_FIXED_VOLTAGE=y
+CONFIG_DRM_V3D=m
+CONFIG_CLK_RASPBERRYPI=y
- Bug fixes
- Fixed regulator kernel configuration setting that prevented booting sometimes (this was a "not sure how this ever worked" kind of bug)
This release updates Buildroot to 2020.02 and upgrades gcc from 8.3 to 9.2. While this is a minor version bump due to the Buildroot release update, barring advanced usage of Nerves, this is a straightforward update from v1.10.2.
- Updated dependencies
- nerves_system_br v1.11.0
- linux 4.19.97 (raspberrypi-kernel_1.20200212-1 tag)
- Erlang 22.2.8
- Updated dependencies
- nerves_system_br v1.10.2
- Erlang 22.2.4
-
Enhancements
- Set
expand=true
on the application data partition. This will only take effect for users running the complete task, fwup will not expand application data partitions that exist during upgrade tasks.
- Set
-
Updated dependencies
- nerves_system_br v1.10.1
- Erlang 22.2.3
This release updates Buildroot to 2019.11 with security and bug fix updates
across Linux packages. Enables dnsd, udhcpd and ifconfig in the default
Busybox configuration to support vintage_net
and vintage_net_wizard
.
See the nerves_system_br
notes for details.
- Updated dependencies
- nerves_system_br v1.10.0
- Erlang 22.1.8
This release updates Buildroot to 2019.08.2 with security and bug fix updates
across Linux packages. See the nerves_system_br
notes for details.
Erlang/OTP is now at 22.1.7.
- Updated dependencies
This release pulls in security and bug fix updates from nerves_system_br
.
Erlang/OTP is now at 22.1.1.
IMPORTANT: The IEx prompt was being output on the UART. This was inconsistent
with other Nerves/Raspberry Pi systems and has been fixed. If you want to
use the UART, you'll need to override the erlinit.config
file.
-
Bug fixes
- Default to displaying the iex prompt on the HDMI port like the other Raspberry Pi systems
- Compile in the I2C drivers so they're available early on for NervesKey and other use at initialization
-
Updated dependencies
- nerves_system_br v1.9.4
- linux - update to the raspberrypi-kernel_1.20190925-1 tag
NOTE: bootcode.bin is not used by the RPi 4 and is no longer built. If updating a fork of this project, be sure to remove references to it from your fwup.conf. See https://www.raspberrypi.org/documentation/hardware/raspberrypi/booteeprom.md
This release updates Buildroot to 2019.08 with security and bug fix updates
across Linux packages. See the nerves_system_br
notes for details.
-
Updated dependencies
-
Enhancements
- Support a variety of USB->UART adapters so more devices work out-of-the-box
This release fixes an issue that broke display output on small LCD screens. Updating the Raspberry Pi firmware to the latest from the Raspberry Pi Foundation fixed the issue. See pappersverk/rpi_fb_capture#2 for details.
- Updated dependencies
This is the initial Nerves System release for the Raspberry Pi 4. It's version corresponds to other Nerves System releases for Raspberry Pi's for ease of referring to version numbers.
While similar looking, the Raspberry Pi 4 has some significant differences with other Raspberry Pis. The following functionality appears to work so far:
- Support for up to 4 GB of DRAM (1 GB and 2 GB versions supported too)
- I2C, SPI, and GPIO - The RPi 4 has additional pin mux options. They have not been tested.
- The primary UART has not been redirected away from the Bluetooth module. This is useful for using BLE with the Harald library, but is different from the other RPi defaults
- The Pi Camera and Raspberry Pi Foundation 7" Touchscreen both work
- Gigabit Ethernet works
- WiFi appears to work
- USB 3 devices
The following major features have not been tested:
- OpenGL support and HDMI output
- USB Gadget mode via the USB C connector (the gadget drivers are currently enabled, though)
Additionally, the Raspberry Pi 4 port uses 32-bit mode on the ARM even though the processor supports 64-bit usage. 64-bit usage didn't build when tried and the Raspberry Pi Foundation promotes 32-bit usage so that's what's used here.
- Primary constituent project versions