Categories
IoT Zephyr

Zephyr Weekly Update – LLEXT extension development made easier

A very cool addition this week makes the lives of LLEXT extension developers easier, and makes me think I should already start working on some nice demos for when it will be time to announce Zephyr 3.7 (which is not until late July, though!). Check this out, alongside other cool news, in this new weekly update 🙂

Extension developer kit for LLEXT

Introduced with the latest Zephyr 3.6 release, the LLEXT (Linkable Loadable Extension) subsystem has been gaining a lot of traction lately.

In many cases, people developing the “core” of a Zephyr application designed to be extensible (e.g. a smart home gateway with a fancy display allowing for news “apps” to be added) are not the same people that will be developing the extensions (e.g. an energy monitoring or a weather forecast application, to take the previous example). LLEXT extensions as usually meant as lightweight “plugins” that use a well-controlled and limited set of APIs ; therefore, asking developers to setup a full-blown Zephyr development environment is overkill and error-prone.

This is where the new LLEXT Extension Developer Kit (EDK) comes in: it simplifies the development of extensions outside of the Zephyr tree, by allowing to generate an “SDK” (using west build -t llext-edk target) that packages all the necessary headers and compile flags relevant in the context of a given Zephyr app, effectively providing extension developers with all they need to start hacking away!

Try out the new EDK code sample and see PR #69831 for more details.

Sysbuild multi-target sample

As a way to make it easier to grasp the concepts behind sysbuild, and how it can be used to build multiple facets of your application at once (ex. the actual Zephyr application alongside an MCUboot bootloader), a new “multitarget Hello World” code sample has been introduced.

It showcases a classical Hello World application, except that it also includes the configuration files and explanation on how to build it and flash it for multiple targets (ex. different SoC cores), also leveraging the new hardware model and board target terminology in the process. (PR #69652)

Boards & SoCs

  • New ARM architecture Kconfig options CONFIG_ROMSTART_REGION_ADDRESS and CONFIG_ROMSTART_REGION_SIZE allow to relocate the rom_start region (that typically contains the boot-vector data and irq vectors) to a custom region. (PR #71684)
  • Removed limitation to 4 CPUs for SMP on x86, and also updated Zephyr kernel limitation to 32 CPUs (instead of 8) in the meantime! (PR #60230)
  • Power management support added to Renesas SmartBond UART. (PR #62190)
  • Power management support added to NXP RW61 SoC series. (PR #72758)
  • Added USB support for NXP MCX N947. (PR #72386)
  • Added RTC alarm support for all STM32 MCU series. (PR #71957)

New boards and shields:

STWIN.box
STWIN.box from STMicroelectronics
  • The STWIN.box (a.k.a. STEVAL-STWINBX1) from STMicroelectronics packs an impressive amount of sensors (accelerometer, magnetometers, MEMS microphones, …) and has Wi-Fi, Bluetooth, and NFC connectivity as well. It is now supported in Zephyr 🙂 (PR #72723)
  • STM32H745I Discovery kit is a complete demonstration and development platform for STMicroelectronics Cortex-M4 and M7 based STM32H745XI MCU. (PR #72510)

Networking

  • There is now a really great documentation page for the new HTTP server. It compliments the existing code sample quite well and really gives you all you need to know how to declare static resources, expose WebSocket endpoints, etc.
  • A new net http shell command gives you the ability to get a quick snapshot of the HTTP resources currently available. (PR #72578)
Host:Port       Concurrent/Backlog        Resource type   Methods         Endpoint

192.0.2.1:80    1/10                      dynamic         GET,POST        /dynamic
                                          static          GET             /
                                          websocket       GET             /

1 service and 3 resources found.
  • TLS sockets have been available and use in Zephyr for quite a while, so it was long time due that they’re no longer marked as “experimental)”. (PR #72482)

Drivers

  • There were several improvements made to the LED strip driver class this week, including new API function to get the length of an LED strip at runtime, which is now also a mandatory binding property alongside color-ordering. (PR #71630)
  • I2C driver for ESP32 now allows for clock speed to be configured at runtime. (PR #72380)
  • Added support for GPIO for Apollo3 SoCs. (PR #72438)
  • Added the ability to read the advanced capabilities (GETCAPS) of an I3C target. (PR #71792)
  • Added DAC and ADC drivers for the General Analog Unit (GAU) peripheral as found on NXP RW SoCs. (PR #70506)
  • New driver for Innovative Sensor Technology TSic xx6 temperature sensors. These are low-power, calibrated sensors with accuracy as high as ±0.07 °C at +20 °C. (PR#70432)
  • Added support for DS18S20 High-Precision 1-Wire Digital Thermometer (maxim,ds18s20) to the existing DS18B20 driver. (PR #71286)

Bluetooth

  • Bluetooth BAP (Basic Audio Profile) shell now supports receiving audio data from e.g. a PC over USB, and encoding it using LC3 before sending it. to BAP audio streams. (PR#71084)
  • Added support for Hands-free Audio Gateway (AG), which can be enabled using CONFIG_BT_HFP_AG). The audio gateway profile allows the microphone/speakers of a Bluetooth device (ex. a computer) to be used as an audio input/output device for another Bluetooth device, such as a mobile phone. (PR #70532)
  • Simplified Kconfig options and interface between the host and controller. (PR #72580)

Miscellaneous

  • I think a lot of people don’t necessarily know it, but Zephyr has a complete State Machine Framework (SMF) that can greatly simplify the implementation of protocol stacks, graphical user interfaces, etc. There are a few places in Zephyr where SMF is being used, but until this week there was no dedicated sample showcasing SMF “on its own”. Thanks to an awesome contribution from Glenn Andrews, it’s not the case anymore, and I highly encourage you to check out this new sample! (PR #70921)
  • A new build option, enabled via CONFIG_BUILD_OUTPUT_COMPRESS_DEBUG_SECTIONS, allows to compress debug sections and therefore reduce size of ELF files substantially. (PR #72436)
  • As part of ongoing work to move away from TinyCrypt and towards PSA (#43712), MCUmgr switched to PSA for its crypto operations (ex. checksum and hash functions). (PR #71947)
  • Added initial HID device support to the USB “next” stack. (PR #65801)
  • Several welcome fixes and improvements were made to the scripts/footprint/size_report script. (PR #72316)
  • When using deferred logging, new log_thread_trigger() API allows to essentially flush the log buffer by forcing the log thread to process any pending messages immediately. (PR #71530)
  • nRF Services library is now available for the Nordic HAL. (PR #70245)

A big thank you to the 7 individuals who had their first pull request accepted this week, 💙 🙌: @trunghieulenxp, @jlh-makeen, @darkmoon32, @AyushKot96, @mstumpf585, @dapperlo, and @Rafal-Nordic.

As always, I very much welcome your thoughts and feedback in the comments below!

If you enjoyed this article, don’t forget to subscribe to this blog to be notified of upcoming publications! And of course, you can also always find me on Twitter and Mastodon.

Catch up on all previous issues of the Zephyr Weekly Update:

Categories
IoT Zephyr

Zephyr Weekly Update – Always a Zephyr meetup near you!

Happy Friday! Before diving into this week’s news, I wanted to remind you about the now almost weekly Zephyr meetups happening all around the world.

It is really great to see the community coming together to share their experiences, and I highly encourage you to check out if there’s a meetup happening near you. If not, you may actually be interested in starting one yourself!

Next up is Cologne, where a second Zephyr meetup is already held after a very successful first edition a few months back!

Update to Python 3.10 as min version

A small but noteworthy change: ahead of the upcoming Long-Term Support version of Zephyr, and in order to make sure we support a minimum version of Python that’s consistent with their own LTS cycles, Zephyr now requires Python 3.10 as the minimum version. PR #72142

SoC-wide overlays

Historically, Devicetree/Kconfig overlays have always been board specific. With the introduction of the new hardware model, it is now possible to define overlays that apply to an entire SoC series, which can be really convenient, as illustrated with this recent update to the Wi-Fi code sample, which now doesn’t require zillions of repetitive overlays for all the different ESP-32 boards supported in-tree, but instead just a few only based on the actual SoCs.

Bash completion for Twister commands

I am frankly always struggling to know how to run Twister test suites from the command line, and I spend a ridiculous amount of time either going through my shell history or recent CI jobs to find the options I need. Therefore, I am really happy to see that there is now bash completion for Twister! (PR #72167)

Boards & SoCs

  • Support has been added for Ambiq Apollo3 Blue and Apollo3 Blue Plus SoCs, alongside associated evaluation boards. Apollo3 Blue series are ultra-low power Cortex-M4F MCUs with an integrated Bluetooth 5 controller. (PR #67815)
  • New MDIO driver (Management Data Input/Output) for STM32. (PR #71012)
  • New video driver for STM32 Digital Camera Memory Interface (DCMI). (PR #71462)
  • GCC toolchain configuration updated to support Arm Cortex-R82. (PR #72279)

New boards and shields:

  • Added support for Croxel CX1825 Bluetooth prototyping board. (PR #71901)
  • New shield defintion for Seeed Studio Round Display for Xiao. (PR #71239)
  • A small yet noteworthy change to the STM32C0116-DK board definition added last week. This board features a 5‑way joystick hooked up to a single ADC input pin using a resistor ladder. The adc-keys driver allows to quickly define which voltage range corresponds to each key combination, making it straightforward to expose all the relevant key codes to the input subsystem. (PR #72315)
adc-keys {
	compatible = "adc-keys";
	io-channels = <&adc1 8>;
	keyup-threshold-mv = <3300>;

	select_key {
		press-thresholds-mv = <0>;
		zephyr,code = <INPUT_KEY_SELECT>;
	};

	left_key {
		press-thresholds-mv = <670>;
		zephyr,code = <INPUT_KEY_LEFT>;
	};

	// ...
};

Networking

  • I mentioned it was coming last week… turns out it’s already there: the new HTTP server now supports WebSocket! (PR #72241)
  • Added support for gratuitous ARP transmission. A device may send such a packet on a local network to announce or update its own IP-to-MAC address mapping. It’s particularly useful for ensuring that devices that frequently enter deep sleep mode are immediately recognized by their peers upon reconnection. (PR #71873)
  • Added support for IPv6 Privacy Extension (RFC 8981). (PR #71996)
  • Updated hostap module. (PR #71805)

Drivers

  • New driver for Sequans GM02S cellular modem. (PR #72217)
  • New driver for LuatOS Air530z GNSS receiver. (PR #72053)
  • New driver for Texas Instruments INA226 bi-directional current/power monitor, which can be used to sense current/voltage on buses up to 36V. (PR #68368)
  • New multi-function device driver for Analog Devices ADP5585 keypad decoder, I/O expander, and PWM generator. (PR #69330)
  • New driver for IS66WVQ8M4 PSRAM. (PR #70620)
  • Several cool improvements to GROW_R502A fingerprint sensor (why yes, Zephyr has support for fingerprint sensors, in case you didn’t know!). (PR #59654)

Miscellaneous

  • Various Twister optimizations and speedups, which according to the author should speed up execution times by 5-7%. (PR #71694)
  • Added support for Bluetooth Common Audio Profile Commander Reception start procedure. (PR #69593)
  • A couple new useful shell commands:
    • The GPIO shell module now features a toggle command to… toggle a GPIO :). (PR #72362)
    • The I2C shell module now has a direct_read command, which reads directly from the I2C device without first writing a register address. (PR #71928)

A big thank you to the 11 individuals who had their first pull request accepted this week, 💙 🙌: @bogdanovs, @smaerup, @debbiemartinarm, @vThibo, @louis-feller, @RafaelLaya, @russkel, @davidschneider-cpi, @markaj-nordic, @schumphi, and @AlessandroLuo.

As always, I very much welcome your thoughts and feedback in the comments below!

If you enjoyed this article, don’t forget to subscribe to this blog to be notified of upcoming publications! And of course, you can also always find me on Twitter and Mastodon.

Catch up on all previous issues of the Zephyr Weekly Update:

Categories
IoT Zephyr

Zephyr Weekly Update – HTTP Server FTW! 🥳

Happy Friday, and welcome back for a new Zephyr Weekly Update! Before diving into some of the additions and notable updates from this week, I wanted to mention that the recordings of all the presentations from the Zephyr Developer Summit 2024 are now available on the YouTube channel of the Zephyr Project.

There were some truly great sessions (and speakers!) and there is a very good chance that you will want to catch up and watch all of them if you didn’t have a chance to attend in person! 😀

HTTP Server

This week’s big update is the addition of a long awaited HTTP server library. It supports HTTP/1.1 as well as HTTP/2, with or without TLS, and WebSocket support should be coming shortly! This has been a multi-month effort that started last year as a Google Summer of Code project from Emna Rekik.

Similar to the socket and CoAP services, adding new HTTP resources can easily be done, with very little overhead, not so differently from how you would do it in a higher-level language like Python or JavaScript!

struct http_resource_detail_static index_html_gz_resource_detail = {
	.common = {
			.type = HTTP_RESOURCE_TYPE_STATIC,
			.bitmask_of_supported_http_methods = BIT(HTTP_GET),
			.content_encoding = "gzip",
		},
	.static_data = index_html_gz,
	.static_data_len = sizeof(index_html_gz),
};

HTTP_RESOURCE_DEFINE(index_html_gz_resource, test_http_service, "/",
		     &index_html_gz_resource_detail);

I highly recommend you dive into the new code sample that will tell you a lot more about the various capabilities of this new service, including how to configure it, or even to profile it.

Power Management for dummies using the Zephyr shell

You’ve heard me praise the Zephyr shell many times before. It is an awesome resource to quickly troubleshoot your system and interact with all your peripherals and subsystems without having to write any code.

A new pm shell module has been introduced to let you interact with the power management subsystem using simple commands. Assuming that power management is indeed enabled in your Zephyr application, you can now do things like pm suspend mydevice to quickly suspend a device.

What’s more, device list, which might be one of the most useful commands in the Zephyr now also gives you feedback regarding the actual PM mode of all the devices in your system:

uart:~$ device list
devices:
- i2c@40003000 (active)
- buttons (active, usage=1)
- leds (READY)

In this example, leds is a device that does not support PM, i2c supports PM with manual suspend and resume actions and is currently active, and buttons supports runtime PM, is currently active and “used” by one user.

As part of introducing all these great commands, Fabio has also added a new callback that a shell module might implement to make tab-completion for device names smarter. In the context of the new pm shell command mentioned before, it means that only devices that do support power management will be suggested when you hit TAB!

Please check out PR #72037 and update your shell modules accordingly 🙂

Boards & SoCs

  • Added MMC driver for RCAR. (PR #60285)
  • Added TPM counter support on i.MX93 Cortex-A Core. (PR #70714)
  • Added RTC driver for Nuvoton Numaker m46x. (PR #71929)
  • Added ADC driver for Nuvoton numaker m2l31x. (PR#71267)
  • Added SDHC driver for ESP32. (PR #71165)

New boards:

  • MikroElektronika Weather Click shield, which features Bosch BME280 sensor (humidity, pressure, temperature). (PR #71076)
  • STM32C0116 DK, a development board for the STM32C0 series of MCUs — Cortex-M0+ with 32K of Flash, 6K of RAM, a Grove connector, a 5-way joystick, … (PR #71722)

Drivers

  • Texas Instruments TMP114 is an ultra-thin, high accuracy, I2C temperature sensor with a 16-bit ADC and an accuracy of ±0.2°C. (PR #71964)

Miscellaneous

  • Added support for LoRaWAN Fragmented Data Block Transport Service. Being able to transmit fragmented blocks of data over an otherwise very constrained network in terms of MTU means essentially unlocking the ability to perform firmware upgrades over-the-air. (PR #68570)
  • New ability for west to run some commands (e.g. erase, recover) only once, either at the beginning or at the end of the programming of a board when using sysbuild. This allows to e.g. only erase the flash once when targeting a multi-core SoC. More documentation available here. (PR #69748)
  • Added support for EUI64 device identifiers in hwinfo. (PR#72057)
  • New code samples for the I2C Target API. (PR #72103)
  • New settings_save_subtree() API allows to only save items from a settings subtree that are different from their persisted value. (PR #72113)

A big thank you to the 9 individuals who had their first pull request accepted this week, 💙 🙌: @swift-tk, @DeHess, @dalprahcd, @0x6e, @fgihl, @bogdanm, @tychofrei02, @JefersonFernando, and @kail.

As always, I very much welcome your thoughts and feedback in the comments below!

If you enjoyed this article, don’t forget to subscribe to this blog to be notified of upcoming publications! And of course, you can also always find me on Twitter and Mastodon.

Catch up on all previous issues of the Zephyr Weekly Update: