Rate this page Â
- ★★
- ★★
- ★★
- ★★
- ★★
Can we improve this page? Send us feedbackRate this page
- ★★
- ★★
- ★★
- ★★
- ★★
Blues Wireless regularly provides updated firmware releases for the Notecard that include feature additions and other improvements.
Make sure you read and understand the Blues Firmware Release Policies and Procedures before updating Notecard firmware.
Firmware: notecard-3.5.2.15620$20221031190539.bin and checksums
hub.set
continuous
mode data usage from ~4KB/hour to ~2.5KB/hour for apps
requesting immediate inbound Notefile sync by specifying sync:true
.Firmware: notecard-3.5.1.15545$20221118160948.bin and checksums
card.motion.sync
request now
allows you to sync on orientation changes (instead of motion changes) by passing a
threshold
of 0
. With this mode enabled, motion events now include a tilt
field to
show the number of orientation changes since the previous event.card.voltage
request.{wifi-unavailable}
error when making a card.wifi
request on cellular Notecards.no-sat
tracking notes could inadvertently appear when using
external GPS.cmd
requests if sent in rapid succession.Firmware: notecard-3.4.1.15128$20220811230306.bin and checksums
card.aux.serial
to expose various capabilities over the Notecard AUX
pins.env.get
and env.set
to fetch a group of variables,
and query variables by modified time.env
mode to card.attn
to monitor environment variable changes.auxgpio
mode to card.attn
to monitor AUX GPIO changes.time
field to env.modified
to query
for environment variable changes since a known epoch time.threshold
to card.location.mode
response when not 0.limit
to card.aux
to disable concurrent modem use when using an external GPS receiver.on
, seconds
, and off
to hub.set
to enable temporary
continuous mode when performing web transactions.hdop
to float.hub.sync.status
returns extended service failure errors in response.Firmware: notecard-3.3.1.14612$20220518212851.bin and checksums
usb
, gps
, wifi
, and cell
to the response object of
card.status which
indicates the associated component is powered on.uint8
, uint16
, uint24
, and uint32
, to
Note templates.card.motion.mode
API's sensitivity
settings have been updated to use
25Hz sampling, providing improved performance._track.qo
Note template.card.wireless
API is now supported on Wi-Fi Notecard._restart_no_activity_hours
reserved environment variable.Firmware: notecard-3.2.1.13982$20220821154627.bin and checksums
note.template
payloads and strings can now be variable-length.verify:true
to note.template
to return the current template on a Notefile.web.post
now supports payload fragmentation and reassembly at Notehub.card.attn
adds verify:true
to show the current attention mode
configuration.card.attn
adds mode: disarm,-all
to clear all monitored conditions.card.aux
request.card.location
response in status
and threshold
fields.seconds
as an optional parameter on all
web requests as an override to the standard 90 second timeout.verify:true
parameter to immediately save the Notefile change to flash.err
string property. If used along with "stop":true
, this sets the host DFU to an
error state with the specified string._track.qo
notes,
and adding the HDOP to the _track.qo body.sync:true
is specified in card.location.track, an immediate sync occurs every time a track note is added.major-version
that defines, for compatibility
purposes, the major version number of the notecard firmware that the host was
developed to use. In the response, the api returns the current firmware’s version
number._tri_gps_failure
environment variable as a triangulation configuration
option for Notecard to first try GPS, then fallback to using cellular
triangulation if it is unable to make a GPS fix.card.voltage
readings.card.location.track
._health.qo
if battery voltage is low or dead, at most once per day.866098e724c5aef221d19fdf0356f538 notecard-3.2.1.13982$20220821154627.bin e4a30632d42784c347f09aaf3825737d notecard-3.3.1.14612$20220518212851.bin fd7318030d4fef21b6e6c4b088ed16ca notecard-3.4.1.15128$20220811230306.bin 97bc2aeb17dd6c573b47f58335f092cd notecard-3.5.1.15545$20221118160948.bin 8cf964de13a2d2bbbbb96fb4146f1e24 notecard-3.5.2.15620$20221031190539.bin
3a1ef9c6ebe45501ca26b425569ed469cc2636807ef1a39c780f3657e803cdf1 notecard-3.2.1.13982$20220821154627.bin 8a58324e4d2a4b04b69a60fe101687f51354e6dcc1037fda33e15abb8a21129c notecard-3.3.1.14612$20220518212851.bin 2e9043883e2f57265a18f74e79ad448b8a3d8e4567983011480d06c0a4cbf46f notecard-3.4.1.15128$20220811230306.bin 6744e0c3f31849944151d08364fb02b2d27187897f0932d6c07cf1c4e1051e5d notecard-3.5.1.15545$20221118160948.bin ffbf202264ba7d2b7aa28167cc0722df90fbbed5e3064b0440273729fe13b9a9 notecard-3.5.2.15620$20221031190539.bin
Firmware: notecard-4.2.1.4015688$20230227005219.bin and checksums
hub.set
mode
changed to "off" while the modem is powering up, modem will quickly and gracefully shut down.hub.set
mode:"dfu"
idempotent.mode:"off"
.Firmware: notecard-2.4.1.2014024$20230127210448.bin and checksums
card.attn
to add -all
option and improve watchdog timing.hyb.sync.status
requests.card.location.track
heartbeat events, and prevent spurious heartbeat events if motion has occurred.card.wireless
requests and in _session.qo
Notefiles.Firmware: notecard-4.1.1.4015681$20221206134917.bin and checksums
files
on card.attn
when mode
is disarm
.card.aux.serial
request.Firmware: notecard-2.3.1.2014013$20220613194620.bin and checksums
card.motion.mode
sensitivity
settings, GPS location updates._restart_no_activity_hours
reserved environment variable.Firmware: notecard-2.2.1.2013856$20220219214539.bin and checksums
card.version
.Firmware: notecard-2.1.1.2013839$20211117220152.bin and checksums
.dbx
extension. These Notefiles reside on the Notecard and do
not sync to Notehub.io.653d3045e3ab369a4641132c71bf9cef notecard-2.1.1.2013839$20211117220152.bin f1c207f897ac1a44a6f1f784c7353863 notecard-2.2.1.2013856$20220219214539.bin b1bebc3c08001bce9f99a02a7b992ba5 notecard-2.3.1.2014013$20220613194620.bin 105c8a30865e5313ce527190286c8de8 notecard-4.1.1.4015681$20221206134917.bin a7746b162b4a355229b5a651f58974b0 notecard-2.4.1.2014024$20230127210448.bin f4c8ee422540de40edd51da7c4b72497 notecard-4.2.1.4015688$20230227005219.bin
bea9ad4e9e47fdc4114c5f20f55e06dbbe20520f69eb0b6b6a71566e2c9fbfc4 notecard-2.1.1.2013839$20211117220152.bin 1bc71770ac49d61d42ec80f9fc41928e81a7aa40083dcb34c3cd62f99b25641b notecard-2.2.1.2013856$20220219214539.bin 3d65ac74b8c30cb18d661339356042d1108ace2b177b532ee02114729dfa8456 notecard-2.3.1.2014013$20220613194620.bin 64d60511365351f711d6e7ad5cece4cb04029e634b1d1e29080cf93becff3d3b notecard-4.1.1.4015681$20221206134917.bin 31c6e561695d07f3d72f4b1fa1a0e3d3e850d2e469d01f1c45ce908e97d78c70 notecard-2.4.1.2014024$20230127210448.bin f4205d3c6f6b1b2117d53ee374b968b170f414ef29b7c60bb93484dac6b367f2 notecard-4.2.1.4015688$20230227005219.bin
The Notecard firmware is managed on two parallel product lifecycles:
This section summarizes how these releases are versioned, as well as our policies around customer deployments and support timelines.
Developer Firmware Releases are meant for testing new Notecard features and functionality during the early prototype and pilot phases of a project. It's not uncommon for these releases to expand the feature-set of the Notecard based on feedback and requests from customers building real applications.
These releases happen, on average, once a quarter and are supported by Blues for 90 days from the date of release, or the date of the following developer firmware release whichever is soonest. Once that 90-day period elapses, customers will be required to upgrade to a newer version in order to receive support.
Long-term Support, or LTS, releases are meant for scaling customers deploying an application to production. These applications are often feature complete and ready for the field, and do not need new features, or the risk associated with incorporating updated firmware into an existing application. LTS releases address this problem by supplying stable and consistent behavior that customers can bet on for field deployments.
LTS releases happen at least once per year, with occasional bug-fixes back-ported into the current major LTS line each quarter, if needed. LTS releases are feature-frozen, meaning that they do not generally receive new features, API changes, or any functionality that modifies the documented behavior of the device. They do, however, benefit from an extended support window in which Blues will address critical OTA vulnerabilities for a period of 10 years from the date of initial release. Customers deploying an application to the field must select an LTS version in order to receive support.
We've chosen to adopt a firmware version numbering scheme inspired by the LTS practices employed for NodeJS. Namely, we're adopting an even and odd major version numbering scheme to delineate between our LTS and Developer releases.
LTS releases will always start with an even number, and we will increase the minor or patch version numbers in the event fixes from a newer release need to be back-ported to an earlier LTS. For example, 2.1.1 was our first LTS version. If, in the support period, we identify a need to back-port a critical vulnerability, we would release a new LTS version on this line with a new minor or patch number, for example 2.2.1.
Likewise, Developer releases will always start with an odd number, and we will increase the minor or patch version numbers as we cut updated Developer firmware releases throughout the year. For example, the next developer firmware release, which is planned for January of 2023, will be version 5.1.1.
To put these version numbers and what they mean into more context, here's the current plan for releases scheduled in 2023:
While we recommend the use of Notehub.io to update device firmware, you can manually update by directly connecting to a Notecard over USB.
Serial terminal emulator software (e.g. our In-Browser Terminal, CoolTerm, or TinyTerm).
A fresh Notecard binary file (download from the Firmware Releases list above).
STM32CubeProgrammer (download the latest version for your OS).
The minimum version of STM32CubeProgrammer we support is 2.11.0.
Installing STM32CubeProgrammer requires OS-specific instructions.
If you're on a version of Windows older than Windows 10, you'll first need to install the STM32 Virtual COM Port Driver.
Download and extract the zip package and run the installer (ignoring the security issues from Windows).
Download and extract the zip package (noting that the version number of 2.11.0 used in these instructions will likely change in the future).
Using your terminal app of choice, navigate to the extracted directory and launch the installer in CLI mode. For example:
./SetupSTM32CubeProgrammer-2.11.0.app/Contents/MacOs/SetupSTM32CubeProgrammer-2_11_0_macos
You will likely be prompted with a security error from macOS, noting that the installer cannot be opened because the developer cannot be verified.
Click "Cancel", open "System Preferences", navigate to the "General" tab, and click "Open Anyway".
Finally, back in your terminal, launch the installer in CLI mode again, using the same command used previously.
Prior to installation, make sure you have the following packages installed:
If you are using a USB port to connect to the STM32 device, install the
libusb1.0
package by typing the following command:
sudo apt-get install libusb-1.0.0-dev
Please note libusb1.0.12 version or higher is required to run STM32CubeProgrammer.
Extract the zip package downloaded earlier from ST, and execute it. Note the version number may change.
$unzip en.stm32cubeprg-lin_v2-11-0_v2.11.0 && cd en.stm32cubeprg-lin_v2-11-0_v2.11.0 && ./SetupSTM32CubeProgrammer-2.11.0.linux
Copy the rules files into /etc/udev/rules.d/
. This is needed use ST-LINK probe
or USB DFU.
$sudo cp ~/STMicroelectronics/STM32Cube/STM32CubeProgrammer/Drivers/rules/* /etc/udev/rules.d
Connect your Notecard device to your computer via USB. Verify that your terminal
emulator (e.g. dev.blues.io, CoolTerm, or TinyTerm) is able to connect to the
device by sending the card.version
request:
{"req": "card.version"}
The response should look similar to this:
{
"version": "notecard-3.5.1.15545",
"device": "dev:000000000000000",
"name": "Blues Wireless Notecard",
"sku": "NOTE-NBGL-500",
"board": "1.11",
"api": 3,
"body": {
"org": "Blues Wireless",
"product": "Notecard",
"version": "notecard-3.5.1",
"ver_major": 3,
"ver_minor": 5,
"ver_patch": 1,
"ver_build": 15545,
"built": "Oct 10 2022 12:37:13"
}
}
Important: Next, launch the built-in bootloader firmware by sending the
bootloader
command via your terminal emulator:
>bootloader
In Windows Device Manager, this causes Notecard to disappear as a "Ports (COM LPT)/USB Serial Device (VID 0x30A4, PID 0x0001)" and to reappear as a "Universal Serial Bus devices/STM32 BOOTLOADER (VID 0x0438, PID 0xDF11)".
Open the STM32CubeProgrammer application.
Select "USB" from the dropdown menu provided in the upper-right corner:
Select the port corresponding to your Notecard in the "Port" dropdown menu (likely "USB1"). You may need to click the button next to the port dropdown to refresh the list.
Click the "Connect" button and the log should update and display
Data read successfully
.
Next, access the "Erasing & Programming" screen by clicking the menu button with the arrow pointing down:
Follow the other configuration options in the image above:
.bin
file.Never enable the "Full chip erase" option as you will wipe the Notecard in a way that renders it permanently unusable.
After a few seconds of commands displayed in the log, you should see multiple dialog warnings/notifications to click through and confirm.
Once the update process is complete, your Notecard will reset and reconnect. You
can verify the firmware process was successful by executing another
card.version
request and inspecting the version
parameter.
{"req": "card.version"}
The simplest way to update the firmware on your Notecard device is to perform an over-the-air DFU with Notehub.io. For instructions on how to update your Notecard firmware with Notehub.io, please visit the Manage Notecard Firmware guide.
Please be aware that OTA DFU updates use data in your data plan.