Changelog¶
This page collects recent changes to the nRF Cloud APIs, portal, and documentation.
If a category is not included in a given changelog, there are no changes within that category since the previous deployment date.
Archived changelogs by year¶
- 2022 archive
September 7, 2023¶
This section lists changes deployed on September 7, 2023.
Documentation¶
- Updated Location Services features overview with a Wi-Fi location diagram.
- Updated Wi-Fi location guide to support the nRF7002 EK with nRF Cloud Multi-service sample.
August 30, 2023¶
This section lists changes deployed on August 30, 2023.
New features¶
-
CoAP device connectivity to nRF Cloud, including CID support.
- See also the nRF Cloud CoAP library documentation.
-
Secure device provisioning through CoAP.
Documentation¶
- Updated existing pages and diagrams to include CoAP.
-
Added new documentation related to CoAP:
- CoAP overview.
- Comparison of MQTT and CoAP protocols.
- Guide to using CoAP with the nRF Cloud multi-service sample.
August 17, 2023¶
This section lists changes deployed on August 17, 2023.
New features¶
In the nRF Cloud portal:
- You can now select devices on the Devices page to create a FOTA job.
- A banner appears if the user loses their connection to the nRF Cloud portal.
- Single-item dropdowns have been replaced with icons.
- The Devices page now displays devices in a table, along with filters according to headings.
Enhancements¶
- FOTA jobs can now be canceled regardless of the job execution status of included devices. Previously, in-progress jobs could not be canceled.
In the nRF Cloud portal:
- Update bundles now appear as a table.
- Changed Description to Type when sorting alerts by type.
- When viewing a firmware update job page, you can now scroll to load the next 100 job executions.
- The FOTA job view is now based on job executions instead of devices in a group. The Devices card is now Job Executions. This card is empty until you deploy the update, after which the card displays the devices included in the job.
- UX improvements to handling device groups.
In the nRF Cloud APIs:
- Enhanced accuracy of results for Location Services requests.
- Wi-Fi access points with locally administered and reserved MAC addresses are invalid for location use, and are therefore ignored.
- Wi-Fi requests with fewer than two valid access points are rejected.
- You can now request a window of up to 72 hours of binary logs in a
FetchBinaryLogsUrl
REST API request. The previous limit was 24 hours. - Users with a Developer plan can now allocate IMEIs.
Bug fixes¶
In the nRF Cloud portal:
- Fixed issue with delete button and filter dropdown for FOTA jobs.
- Fixed issue where all options were selected if a user tried to filter, then select.
- Fixed page crash when modem firmware was set to an array.
- Fixed issue with date-time picker for downloading device data, where page crashed upon opening download data.
- Fixed issue where graphs would sometimes go past the width of the card or not fill the available space.
- Fixed issue with sending wrong input values while claiming devices, and added stop action.
- Improved error catching when user is in too many teams.
In the nRF Cloud APIs:
- Removed excessive recursive looping during some cases of FOTA job execution creations.
- Fixed issue where some devices could not be deleted using the
DeleteDevice
endpoint. - Fixed issue where some devices without assigned groups were not visible to Viewer users.
Documentation¶
- Added note that Provisioning Service is in beta.
- Improvements and new diagrams in Identity Service overview, Verifying device authenticity, and Provisioning Service overview.
- Updated FOTA overview and FOTA job life cycle diagram to indicate that in-progress jobs can be canceled.
July 17, 2023¶
This section lists changes deployed on July 17, 2023.
New features¶
-
nRF Cloud Security Services:
- Added Provisioning Service in the nRF Cloud portal and APIs.
- Added Identity Service in the nRF Cloud portal and APIs.
In the APIs:
- Account devices can now subscribe to any team topic, which is a topic prefixed with
/[stage]/[tenantId]/
.
Enhancements¶
In the nRF Cloud portal:
- You can now send messages to all three topics
c2a
(communication from the nRF Cloud server to the portal),d2c
(communication from the device to nRF Cloud), andc2d
(communication from nRF Cloud to the device) through the Terminal card on a device's page.
In the nRF Cloud APIs:
- Improved internal caching logic for Wi-Fi-based queries to release stale data.
- GPS changed in API documentation to the more general GNSS. REST API endpoints with
gps
naming have been deprecated in favor ofgnss
names. Existing GPS endpoints will remain functional. ListMessages
API start and end date parameters are now based on message received timestamp rather than the message’s device-recorded timestamp.
Bug fixes¶
In the nRF Cloud portal:
- Fixed issue with IMEI allocation where the portal would show an “Error Allocating: Undefined” message, but would still allocate the IMEIs.
- Removed Delete account button that occasionally appeared when deleting a team.
- Fixed issue where creating a new team did not switch the user to that team.
In the nRF Cloud APIs:
- Owners and admins are no longer restricted from deleting devices.
ListMessages
REST endpoint now returns400
status (bad request) instead of500
(server error) if the start timestamp parameter is later then the end timestamp.- Location Services
fulfilledWith
response parameter now correctly showsSCELL
orMCELL
instead ofWIFI
in situations where it was erroneously claimingWIFI
when using cell data. - The zip file provided for download with a request to
FetchBinaryLogsUrl
can now include multiple log files.
Documentation¶
- New look and feel for documentation.
New pages:
- Top-level section and overview of nRF Cloud Security Services.
- Overview of the Provisioning Service.
- Guides to claiming devices using the nRF Cloud portal and APIs.
- Guides to provisioning configuration using the nRF Cloud portal and APIs.
- Overview of the Identity Service.
- Guide to using the Identity Service to verify attestation tokens.
June 29, 2023¶
This section lists changes deployed on June 29, 2023.
New features¶
In the nRF Cloud portal:
- Users on a Developer plan now see a banner notification when their plan reaches its service limits.
Enhancements¶
In the nRF Cloud portal:
- Column widths are now based on screen size.
- IMEI allocation and report entries now use infinite loading.
Bug fixes¶
In the nRF Cloud portal:
- Fixed issue where the interface did not update after a user upgraded or downgraded their plan.
- Fixed flashing, unclickable Cancel button on the FOTA update page.
June 22, 2023¶
This section lists changes deployed on June 22, 2023.
New features¶
The following features are now available through both the nRF Cloud portal and APIs:
- IMEI allocation, which is available to Pro and Enterprise customers.
- Binary logs, which can be downloaded through the REST API or the Device page in the nRF Cloud portal.
For more information, see the Documentation section of this month's changelog.
Other changes in the nRF Cloud portal:
- New tables allow sorting with columns.
- Pending invites now show on login. If the user has an invite when they log in, they will see the invite on login and no longer have to check their email for an invitation link.
- Moved the SIM help button and made it more visible.
- When a user is last to leave a team, they are now prompted to confirm that they know it will delete the team.
- Moved Add to Group and Delete Devices actions out of the drop-down menu.
- Added tooltips on limits (100 at a time for adding to a group, and 20 for deleting devices).
In the APIs:
- MQTT support for binary logs.
Enhancements¶
In the nRF Cloud portal:
- Added a tooltip describing what the live data button does.
In the APIs:
- Expanded Location Services coverage.
- Improvements and corrections throughout API references.
Bug fixes¶
In the nRF Cloud portal:
- Fixed issue where "Error loading custom cards" message appeared for a Bluetooth device, even when there were no custom cards to load.
- Fixed issue where FOTA jobs pulled in all devices for the job, causing it to infinitely load.
In the APIs:
- Device messages sent to
d2c/bulk
are now processed in order as much as possible. MQTT does not guarantee message ordering. - Teams, devices, certificates, and keys are now deleted properly.
- Fixed issue with missing alerts and alert timestamps.
Documentation¶
- New content on IMEI allocation.
- Cell location documentation now refers to cells, instead of cell towers, to match common terminology.
- Updated images in Location Services overview.
- Updated documentation on logs to include binary logs.
May 11, 2023¶
This section lists changes deployed on May 11, 2023.
New features¶
New device alerts and logs feature in both the nRF Cloud portal and APIs.
In the nRF Cloud portal:
- Added the Logs card to device pages. Log messages from supported device firmware are visible from this card.
- Added the Alerts page to show all active and archived alerts associated with a team's devices.
- The Devices page shows which devices have active alerts.
In the nRF Cloud APIs:
- Alert and log messages sent through MQTT or over the
SendDeviceMessage
endpoint show in the Alerts and Logs cards on a device's page in the portal. - Added
ListDeviceAlerts
,ArchiveDeviceAlert
, andRestoreDeviceAlert
endpoints to the REST API.
Enhancements¶
In the nRF Cloud portal:
- The Terminal card on device pages now shows raw messages and metadata.
In the nRF Cloud APIs:
- The
FetchDevice
endpoint supports both an API key or JWT for authentication.
Bug fixes¶
In the nRF Cloud portal:
- Fixed an issue where the terminal card historical data download did not show any data.
- Improved error message when cancelling an already-accepted invite.
- Fixed metadata from location requests when downloading data to a CSV file.
- The user's current team is retained when logging back in after logging out.
In the nRF Cloud APIs:
- Messages returned in the
ListMessages
response are exactly as the device sent them. Previously, some numeric fields were erroneously converted.
Documentation¶
- Improved device groups overview and added new guides for working with groups through the portal and APIs.
- Added documentation for device alerts and logs.
- Clarified documentation of service tokens, including terminology.
- Added caution about personal and business account types.
April 18, 2023¶
This section lists changes deployed on April 18, 2023.
New features¶
In the nRF Cloud portal:
- New interface to generate a service key and token for cloud-to-cloud operations.
In the APIs:
- New REST endpoint
ListDeviceTags
that provides a list of device groups the user can access. This endpoint is not restricted by user role. - New REST endpoints to generate a service key and token for cloud-to-cloud operations.
Enhancements¶
In the nRF Cloud portal:
- Improved filtering drop-down.
- A team owner changing a plan from Pro to Enterprise can provide additional information before upgrading.
In the APIs:
- Added filter for location uncertainty values over 10 km. Other location service vendors will be used in those cases, to provide more accurate results.
- Added option to silence Location Services REST API responses by adding the
doReply
flag to Wi-Fi, ground fix, and cellular endpoints. IfdoReply
is set, the server responds with status code200
and an empty message body. - Deprecated
customTypes
parameter for theGetAssistanceData
endpoint. Use thetypes
parameter instead. - Deprecated
requestType
parameter. The service infers the request type from the request data. - The device shadow now includes a
control
section as part of the trimmed shadow republished to{deviceId}/shadow/get/accepted
.
Bug fixes¶
In the nRF Cloud portal:
- Fixed issue that caused invoices to default to paid status.
- Fixed issue that hid Wi-Fi from monthly charges.
- Fixed issue with scrolling to load devices.
- IMEI: Device model names are now trimmed on creation, so trailing white space characters are removed. Reporting an invalid IMEI reel code now returns
N/A
instead ofView IMEIs
. - IMEI: Fixed error when entering a model name consisting of a white space character.
- Fixed issue where attempting a full modem FOTA operation displayed the incorrect number of eligible devices. Added full modem to the options for FOTA, which now displays the correct number of eligible devices.
- Fixed issue where closing the Create pop-up for Teams would not allow it to open again.
- Fixed issue when viewing a gateway's device page, where all Bluetooth® devices displayed as connected to the gateway. Now, only devices connected to that specific gateway are displayed on the gateway's page.
- Removed unsupported beacon device type from the Dashboard.
- Fixed page crash when clearing date picker.
- Fixed ID error when choosing some country names in account information.
- Device location map now refers to GNSS instead of GPS.
In the APIs:
- Fixed
422
failure when sending messages with theSendDeviceMessage
REST endpoint to thed2c/bulk
topic. ListFirmware
now lists allfilenames
in a bundle. Paginated responses are now correctly based on the number of bundles to return, not the number of files.
Documentation¶
- Updated documentation on service key and token generation.
March 16, 2023¶
This section lists changes deployed on March 16, 2023.
New features¶
In the nRF Cloud portal:
- Split charges for MCELL and Wi-Fi.
- New form for submitting Enterprise plan upgrade inquiries from the portal.
- New Invoices card on the Manage Plan page for Pro and Enterprise accounts.
- Locations in Location Services responses through REST now also appear in the live Location map on the device's page.
In the nRF Cloud APIs:
- Any
deviceInfo
,networkInfo
, andserviceInfo
data from MQTTDEVICE
messages are now written to the device shadow. - New
RecordGnssCoordinates
endpoint to report the device's GNSS coordinates to nRF Cloud.
Enhancements¶
In the nRF Cloud portal:
- Removed reminder that the service evaluation token has moved from the Team page.
- Removed reminder that JITP generation has moved from the User Account page.
- Re-enabled device search.
- Removed tour.
- New billing contact field in the plan upgrade form.
In the nRF Cloud APIs:
- Expanded Location Services coverage.
- Updated examples for Location Services endpoints.
Bug fixes¶
In the nRF Cloud portal:
- Fixed GNSS speed units.
- Fixed issue where device groups did not load.
- Removed beacons from the Add Device menu on mobile.
- Removed duplicate
https
in the company URL field of the Pro plan upgrade form. - Removed delete button for full modem updates.
- Fixed white space issue when fetching IMEIs by reel code.
In the nRF Cloud APIs:
- Shadow delta is properly returned in the response to a
FetchDevice
request. - Accurately set expiration date and time for service evaluation tokens.
Documentation¶
- Updated links to the nRF Connect SDK documentation.
- Added links to the IMEI API references.
- Added Invoices to plan documentation.
- Removed references to unsupported beacons.
- Added note about browser compatibility to Getting started page.
- Added D2C MQTT topics.
January 2023¶
This section lists changes deployed in January 2023.
New features¶
In the nRF Cloud portal¶
- Added interface for IMEI Reporting.
- Added overages card to dashboard for relevant Enterprise plans.
- Added current monthly charges and plan summary cards to the Plan Management page for Pro and Enterprise plans.
In the nRF Cloud APIs¶
- New IMEI Reporting APIs.
- Fuzzy matching of device names is now supported with the
deviceNameFuzzy
query parameter to theListDevices
REST API endpoint. - Team owners can retrieve all billing invoices using the
ListInvoices
REST API endpoint.
Enhancements¶
- Completed FOTA jobs are no longer deleted from the history. Previously, they were deleted after 30 days.
In the nRF Cloud APIs¶
- Enabled filtering by
deviceId
when passinglatest
to theGetLocationHistory
REST API endpoint. - Team owners and admins can filter devices by groups (tags) when calling the
GetLocationHistory
endpoint.
In the nRF Cloud portal¶
- Clarified language in service evaluation token card.
Bug fixes¶
In the nRF Cloud portal¶
- Fixed issue where dashboard metric tooltips displayed before the account loaded.
- Fixed crash when editing a user profile for the first time.
- Fixed issue that caused an error during new user creation.
- Fixed issues with logging in to the nRF Cloud portal on mobile devices.
- Fixed low-contrast button colors.
- Fixed an error in fetching SIMs by ID.
- Fixed issue with refreshing a device page that marked the device as invalid.
- Device states now refresh when refreshing the firmware update page.
- Sort by drop-down now displays properly for device groups.
In the nRF Cloud APIs¶
- Fixed bug with leap seconds in GPS time.
- The proper
meta
field is included in response to calling theGetLocationHistory
REST API endpoint, for GNSS location in PVT format.
Documentation¶
- Added IMEI reporting documentation.
- Added a Last updated footer.
- Throughout the documentation, you can click to expand collapsible sections of text. This reduces the amount of scrolling you must do to find relevant information, and presents equivalent options for operations.
- Archived the 2022 changelog.