Emcraft SOM-NRF9151 Firmware, Release 1.1-108

1 1. Purpose
2 2. Hardware Platform
3 3. Software Features
4 4. Use Case Scenarios
5 5. Release Images
6 6. Software Installation
7 7. Software Build
8 8. Application Notes
9 9. Software Manifest
10 10. New Functionality
11 11. Release QA Results
- 11.1 11.1. QA Tests Results
- 11.2 11.2. Memory Footprint Information
12 12. Known Problems and Limitations

1. Purpose

This is the release notes for the Emcraft SOM-NRF9151 Firmware, release 1.1-108.

2. Hardware Platform

This release supports the following hardware platform:

The Emcraft SOM-NRF9151 Rev 1A module plugged into the SOM-NRF9151-BSB Rev 1A carrier board.

Refer to https://voxelbotics.atlassian.net/wiki/x/BIBHKg for more details.

3. Software Features

This release supports the following key software features:

Based on Nordic’s SDK 2.8.0.
Adapted Nordic Asset Tracker v2 application.
Standard Zephyr Shell.
IoT Provisioning, performed on user command from the Zephyr shell.
Run-time connection to the Nordic nRF Cloud, with position tracking via GPS.
Battery charging when connected to USB Type-C. (Note: only basic battery charging is supported, handling of various error and corner cases remains an open development item).
Flash file system (littlefs) enabled on SPI Flash.
PCF85253A RTC support.
LTE modem state exposed by the Asset Tracker to the cloud.
Battery % sensor exposed by the Asset Tracker to the cloud. (Note: Implementation of the battery sensor is based on a function deriving the battery % value from the battery voltage.)
Ambient temp and pressure sensor, as provided by the on-board LPS22HH barometer, exposed by the Asset Tracker to the cloud.
Cloud based logs.
GPI events (User button 1 and 2 press) integrated with the nRF Cloud.
Accelerometer and barometer data integrated with the nRF Cloud.
(NEW) Additional Application Notes added to the web site.
(NEW) Support nRF Cloud FOTA updates for the application firmware, MCUboot bootloader and modem firmware (delta updates only).

4. Use Case Scenarios

Various use-case scenarios available from this software release are illustrated by QA Test Plan.

5. Release Images

The images for this software release can be downloaded from the following location:

Archive with images for the Asset Tracker v2 application on SOM-NRF9151 board:
asset_tracker_v2-on-nrf9151som-v1.1-108-04090319.tar.xz
Archive with images for the Hello MCUboot application on SOM-NRF9151 board:
hello_mcuboot-on-nrf9151som-v1.1-108-04090319.tar.xz
Archive with ECDSA signing key for the MCUboot bootloader:
keys-v1.1-108-04090319.tar.xz

6. Software Installation

The images can be installed onto the hardware platform as described on the https://voxelbotics.atlassian.net/wiki/x/XIA9Kg page.

7. Software Build

The images can be built from the source code as described on the https://voxelbotics.atlassian.net/wiki/x/KgBHKg page.

8. Application Notes

The SOM-NRF9151 application features are described in https://voxelbotics.atlassian.net/wiki/x/oIFAKg.

9. Software Manifest

Repo	Link	Branch	Hash	Tag

Repo	Link	Branch	Hash	Tag
SOM-NRF9151 Application	https://github.com/EmcraftSystems/som-nrf9151-app	`main`	`5e24f1d8`	`tags/1.1-108`
nRF Connect SDK	https://github.com/EmcraftSystems/sdk-nrf	`emcraft-v2.8.0-branch`	`cb9297dd`	`tags/1.1-108-2000`
Zephyr	https://github.com/EmcraftSystems/sdk-zephyr	`emcraft-v3.7.99-ncs1-branch`	`8d5f9d75`	`tags/1.1-108-2000`

10. New Functionality

The following is a summary of the changes in 1.1-108 since the last release 1.0-48:

Issue Key	Summary

Issue Key	Summary
SOM-NRF9151 Application	https://github.com/EmcraftSystems/som-nrf9151-app
NRF-289	Add configuration parameters to disable sensors, fix typos
NRF-292	Adjust settings for npm1300 battery charger
NRF-267	Modify build script to include dfu images
NRF-267	Generate keys for secure boot
NRF-267	Modify version string to include dfu option
NRF-267	Enable zephyr and at shell in hello_world and hello_mcuboot samples
nRF Connect SDK	https://github.com/EmcraftSystems/sdk-nrf
	Net: lib: nrf_cloud: adjust smp fota validation and status report sequence rt-1000-396: before reboot, do not validate the new image after reboot, report validation passed actual validation is still tbd signed-off-by: alexander dyachenko <sasha_d@emcraft.com>
	Subsys: net: lib: nrf_cloud: add support for smp udp transport rt-1000-404: - allow using smp udp transport for dfu targets signed-off-by: alexander yurtsev <alex@emcraft.com>
	Subsys: net: lib: add download client wrapper api rt-1000-458: - implement download client wrapper api that allows to use a single thread for downloading files by multiple clients. signed-off-by: alexander yurtsev <alex@emcraft.com>
	Subsys: net: lib: fota: add support for download client wrapper api rt-1000-458: - add possibility to use download client wrapper api for fota downloads signed-off-by: alexander yurtsev <alex@emcraft.com>
	Lib: modem_key_mgmt: use malloc for scratch buffer allocation rt-1000-456: - implement option for dynamic allocation of the scratch buffer signed-off-by: alexander yurtsev <alex@emcraft.com>
	Net: lib: nrf_provisioning: allow to configure amount of cbor properties rt-1000-457: - allow to define the amount of configuration properties that can be received via provisioning commands. lower values result in less ram consumption. signed-off-by: alexander yurtsev <alex@emcraft.com>
	Net: lib: nrf_provisioning: add support for dynamic buffer allocation rt-1000-457: - allow to use dynamic memory allocation for some structures in the nrf_provisioning module. signed-off-by: alexander yurtsev <alex@emcraft.com>
Zephyr	https://github.com/EmcraftSystems/sdk-zephyr
	Drivers: sensors: lps22hh: fix interrupts from the barometerrt-1000-400: fix interrupts from the barometersigned-off-by: dmitry alexeyev <dmitry.alexeev@emcraft.com>
	Driver: sensors: set thread names for lis2dw12 and lps22hh sensor threadsrt-1000-458: - set thread names for lis2dw12 and lps22hh sensor threads. this allows to distinguish the threads in the output of the "kernel thread list" shell command.signed-off-by: alexander yurtsev <alex@emcraft.com>
	drivers: charger: bq25895 Add driver
	drivers: flash: spi_nor: add configurable delay before initialization rt-1000-443: add configurable delay before spi nor flash initialization signed-off-by: alexander dyachenko <sasha_d@emcraft.com>
	drivers: flash: spi_nor: revert "add configurable delay before initialization" rt-1000-469: this reverts commit d7bf659eebbcfc8415f0a99597172c39524b6c26. signed-off-by: alexander dyachenko <sasha_d@emcraft.com>
	drivers: charger: bq25895 Fix mistype in property name
	drivers: charger: bq25895 Use microvolts/micoamps for standadrd parameters

11. Release QA Results

The following tests have been executed for this release: QA Test Plan.

11.1. QA Tests Results

The results of the QA testing:

Test	Result	Comments

Test	Result	Comments
Serial Console Test	PASSED
Version Test	PASSED
Memory Footprint Test	PASSED
Thread Stack Utilization	PASSED
Battery Charging Test	PASSED
SPI Flash Test	PASSED
RTC Test	PASSED
User LEDs and Buttons Test	PASSED
IoT Provisioning Test	PASSED
GPS Sensor Test	PASSED
LTE Modem Data Test	PASSED
Battery Sensor Test	PASSED
Ambient Sensor Temp Test	PASSED
Air Pressure Sensor Test	PARTIALLY PASSED	NRF-283
Accelerometer Sensor Test	PASSED
GPI Events Test	PASSED
Cloud Log Backend Test	PASSED
FOTA Update Test	PASSED

11.2. Memory Footprint Information

The below table summarizes memory footprint for nRF9151 MCU in this release:

MCU	Memory Region	Used Size	Region Size	%age Used

MCU	Memory Region	Used Size	Region Size	%age Used
nRF9151	Flash	422.1 KB	736 KB	57.35%
nRF9151	RAM	177.7 KB	206.6 KB	86.00%

12. Known Problems and Limitations

The following are known problems and limitations of this software release:

NRF-283: Barometer interrupts are not working.
NRF-282: New revision on PM1300 no longer supports EVENTBATDETECTED or EVENTBATLOST events, battery detection is supported using alternative means.

1.1-108