Integration Manual

NINA-B4 series - System integration manual
UBX-19052230 - R09 u-connectXpress software Page 43 of 60
C1-Public
Prerequisites
As a prerequisite to updating software using AT commands, you must open the JSON file included in
the download container and make note of the defined values to be parsed with the update command.
You also need to copy the signatures given in the related txt files, as shown in Figure 18. This
information is needed during the install. The defined values to include in the command, together with
the signature file (NINA-B41X-SI-x.x.x-xxx.txt), are shown in Table 19.
Figure 17: Defined values for ConnectivitySoftware and SoftDevice as shown in the JSON file
Figure 18: Typical ConnectivitySoftware and SoftDevice signature file
Command syntax
You use the software update command AT+UFWUPD with following syntax to update both the
u-connectXpress and SoftDevice software.
AT+UFWUPD=<mode>,<baud_rate>[,<id>,<size>,<signature>,<name>,<flags>]
The defined values for each parameter are shown in Table 19.
Parameter
Type
Description
<mode>
Enumerator
Download mode:
0: Update mode for the ConnectivitySoftware through the serial port
1: Bootloader mode for update of the SoftDevice through the serial port.
<baud rate>
Enumerator
Baud rate in bits per second: 115200 (default), 230400, 460800, or 921600
<id>
Integer
ID number of the software image.
<size>
Integer
Size of the firmware image. Enter the size integer for the respective software as
defined in the NINA-B41X-SI-x.x.x-xxx.txt file. Shown in hex format in the JSON
file but must entered as bytes in decimal notation in the command.
<signature>
String
RSA signature of the firmware image as base64-encoded string.
Enter the 344-character text string defined in the NINA-B41X-SI-x.x.x-xxx.txt file.
<name>
String
The name of the firmware. Maximum string length is 22.
[
{
"Label": "ConnectivitySoftware",
"Description": "NINA-B41X u-blox connectivity software",
"File": "NINA-B41X-SW-1.0.0-001.bin",
"Version": "NINA-B41X-SW-1.0.0-001",
"Address": "0x26000",
"Size": "0x4C95C",
"Id": "0x0",
"Permissions": "rwx",
"SignatureFile": "NINA-B41X-SI-1.0.0-001.txt"
},
{
"Label": "SoftDevice",
"Description": "S140 softdevice from Nordic for NINA-NRF",
"File": "NINA-S140-SD-6.1.1.bin",
"Version": "NINA-S140-SD-6.1.1",
"Address": "0x0",
"Size": "0x25DE8",
"Id": "0x1",
"Permissions": "rw",
"SignatureFile": "NINA-S140-SI-6.1.1.txt"
}
]
N04lae2U7ztBojLvyBmHJKvuQmyioscrE3kdQviDcqSwST59Dg8WZbcN5C6xwZtA3vE/A0M2h3JulhVv49UIIjzhTZwY
LLrnWGNWgu4cAPkmMHkZa5MZl/QSb/GeT8naXe7oVTS2S2NzXX83N+ovmTVBMpkfQiEoNJw5u5+agXq3J4kz9g1LylUN
tHbucAJR5cs1hsrOC+UZSULY2+4jNqxdN3m6BlvQyycxJCJ2J49cnB85RdY4bfJlPGTwcqtGp2Z014Y/Z7PjeNOMoTFU
KZDWN6e+U8a8e6pULCBLqBH5gC/UU/aSLJLsLL64VEKt2NJB5lZ2fqgzZr82Dqmrpw==