v1.5.3-tracker.1 (Asset Tracker)

Device OS 1.5.3-tracker.1 Release is out for Asset Tracker

released on production servers May 22nd, 2020

1.5.3-tracker.1

FEATURES

• [Gen 3] Add API to read OTP hardware version and model information
• [Asset Tracker] Alternate I2C interface on D8/D9

ENHANCEMENTS

• [Asset Tracker] Improve external RTC accuracy

BUGFIXES

• [Asset Tracker] Hardware flow control should not be disable for revision 0 devices
• [Asset Tracker] Suspend program/erase opertion when QSPI flash init gives timeout error

System Binaries (all devices)

https://github.com/particle-iot/device-os/releases/download/v1.5.3-tracker.1/[email protected]

v1.5.2 (Photon/P1/Electron/Argon/Boron/Xenon/B SoM/B5 SoM)

Device OS 1.5.2 Default Release is out on the Web IDE for (Photon/P1/Electron/Argon/Boron/Xenon/B SoM/B5 SoM)

released on production servers May 20th, 2020

✏️ Please read all notes below

See documentation about Device OS versions, their current state, upgrades and downgrades here.

Note: If you have previously last used one of the prerelease or release versions of 1.5.x on a device, please re-flash it with 1.5.2.

Note: OTA or YModem transfer on Electron (sequence required)

1. First Update to 0.5.5 (if the current version is less than that)
2. Then update to 0.6.4 (if the current version is less than that)
3. Then update to 0.7.0 (if the current version is less than that)
4. Then update to 1.2.1 (if the current version is less than that)
5. Then update to 1.5.2

Note: DFU over USB on Electron/Photon/P1 (sequence not required)

• You may update to 1.5.2 directly first, flash the system firmware (attached above) in order 1,2(,3) to the device using particle flash --usb <system-part.bin>. See the next note about the bootloader if you are offline!

Note: P1/Photon Bootloader
The Cloud will automatically update the bootloader on P1/Photon devices if your device is online. If your device does not connect to the cloud and it is offline, you should flash the bootloader to the device using particle flash --serial <bootloader.bin>. This should be done after upgrading system firmware. The Electron bootloader is applied automatically from it's own system parts.

Note: Argon/Boron/Xenon/Argon-SoM/Boron-SoM/Xenon-SoM Bootloader
If your device is offline, the bootloader must be manually updated using particle flash --serial <bootloader.bin>. This can be done before or after upgrading system firmware.

Note: Argon/Boron/Xenon/Argon-SoM/Boron-SoM/Xenon-SoM SoftDevice
If your device is offline, the SoftDevice must be manually updated using the CLI. See the instructions below.

Note: Downgrading [Electron/Photon/P1] OTA or YModem transfer:
If you need to downgrade, you must downgrade to 1.2.1, then 0.7.0, then 0.6.3(Photon/P1), 0.6.4(Electron) to ensure that the bootloader downgrades automatically. When downgrading to older versions, downgrade to 1.2.1, then 0.7.0 first, then 0.6.3(Photon/P1), 0.6.4(Electron), then to an older version such as 0.5.5.

1.5.2

Note: If your Gen 2 Photon/P1 or Gen 3 device does not have a Cloud connection, it is recommended to update system firmware via CLI with particle update. Electron bootloaders are still contained in system firmware and will update automatically as needed.
Note: If your Gen 3 device does not have a Cloud connection, this release will also require manually updating the SoftDevice via CLI. The instructions are available in the release notes and the SoftDevice binaries are available in the Github release.
This release contains v502 bootloaders.

BUGFIXES

• [Boron / B SoM] LTE-M1 (SARA R4) radio unresponsive when sending certain amount of data within a period of time #2100 #2105
• [B5 SoM] Suspend program/erase opertion when QSPI flash init gives timeout error

ENHANCEMENTS

• [Boron/B SoM] Forward compatibility with 460800 baudrate on SARA R4-based devices to support >= 2.x downgrades #2104
• [Boron/B SoM] Enables hardware flow control on SARA R4-based devices with appropriate modem firmware version #2079 cc7adb7c46ea82383a5f948ea1dc898270a27a3c

System Binaries (all devices)

https://github.com/particle-iot/device-os/releases/download/v1.5.2/[email protected]

SoftDevice update

This Device OS release will automatically update the SoftDevice for devices connected to the cloud.

Prerequisites

particle-cli version 2.6.0.

Upgrading using particle update

1. Put the device into DFU mode
2. Run particle update

DeviceOS, bootloader and SoftDevice should get correctly updated.

Upgrading OTA

1. Upgrade to 1.5.2
2. Manually flash 1.5.2 bootloader: particle flash <deviceId> [email protected]
3. Flash SoftDevice: particle flash <deviceId> [email protected]

Upgrading using YModem

1. Upgrade to 1.5.2
2. Put the device into listening mode (blinking blue) by holding MODE button
3. Manually flash 1.5.2 bootloader: particle flash --serial [email protected]
4. Flash SoftDevice: particle flash --serial [email protected]

Upgrading using DFU (--usb only works for SoftDevice, not bootloader yet)

1. Upgrade Device OS to 1.5.2
2. Update the bootloader to 1.5.2 with the OTA or YModem process above
3. Put the device into DFU mode (blinking yellow)
4. Flash the SoftDevice: particle flash --usb [email protected]

---

Programming and Debugging

You can view specific programming and debugging notes for this version of firmware here.

QA Report Summary for Particle Device OS

You can view results of tests run this release here.

v1.5.1 (Photon/P1/Electron/Argon/Boron/Xenon/B SoM/B5 SoM)

Device OS 1.5.1 Default Release is out on the Web IDE for (Photon/P1/Electron/Argon/Boron/Xenon/B SoM/B5 SoM)

released on production servers May 6th, 2020

✏️ Please read all notes below

See documentation about Device OS versions, their current state, upgrades and downgrades here.

Note: If you have previously last used one of the prerelease or release versions of 1.5.x on a device, please re-flash it with 1.5.1.

Note: OTA or YModem transfer on Electron (sequence required)

1. First Update to 0.5.5 (if the current version is less than that)
2. Then update to 0.6.4 (if the current version is less than that)
3. Then update to 0.7.0 (if the current version is less than that)
4. Then update to 1.2.1 (if the current version is less than that)
5. Then update to 1.5.1

Note: DFU over USB on Electron/Photon/P1 (sequence not required)

• You may update to 1.5.1 directly first, flash the system firmware (attached above) in order 1,2(,3) to the device using particle flash --usb <system-part.bin>. See the next note about the bootloader if you are offline!

Note: P1/Photon Bootloader
The Cloud will automatically update the bootloader on P1/Photon devices if your device is online. If your device does not connect to the cloud and it is offline, you should flash the bootloader to the device using particle flash --serial <bootloader.bin>. This should be done after upgrading system firmware. The Electron bootloader is applied automatically from it's own system parts.

Note: Argon/Boron/Xenon/Argon-SoM/Boron-SoM/Xenon-SoM Bootloader
If your device is offline, the bootloader must be manually updated using particle flash --serial <bootloader.bin>. This can be done before or after upgrading system firmware.

Note: Argon/Boron/Xenon/Argon-SoM/Boron-SoM/Xenon-SoM SoftDevice
If your device is offline, the SoftDevice must be manually updated using the CLI. See the instructions below.

Note: Downgrading [Electron/Photon/P1] OTA or YModem transfer:
If you need to downgrade, you must downgrade to 1.2.1, then 0.7.0, then 0.6.3(Photon/P1), 0.6.4(Electron) to ensure that the bootloader downgrades automatically. When downgrading to older versions, downgrade to 1.2.1, then 0.7.0 first, then 0.6.3(Photon/P1), 0.6.4(Electron), then to an older version such as 0.5.5.

1.5.1

Note: If your Gen 2 Photon/P1 or Gen 3 device does not have a Cloud connection, it is recommended to update system firmware via CLI with particle update. Electron bootloaders are still contained in system firmware and will update automatically as needed.
Note: If your Gen 3 device does not have a Cloud connection, this release will also require manually updating the SoftDevice via CLI. The instructions are available in the release notes and the SoftDevice binaries are available in the Github release.
This release contains v501 bootloaders.

ENHANCEMENTS

• [Argon] Increase the size of the ARP queue #2075
• [Cellular] Increase registration timeout to 10 minutes #2072
• [Electron / Boron] Make sure that SARA R4-based LTE devices report LTE Cat M1 access technology #2083
• [B5 SoM] Enable hardware flow control on Quectel modems earlier in the initialization process #2069 #2071
• [Vitals] Add CoAP transmitted, retransmitted counter diagnostics #2043
• [Vitals] Add CoAP latency diagnostic #2050
• [Cellular] Increase registration timeout to 10 minutes #2072
• Remove locking in some of the SPI and I2C APIs. SPI perofrmance tests #2088
• Particle.process() no-op when called from custom threads #2085
• [Electron] Minor log message changes when the modem is not responsive #2087

BUGFIXES

• [wiring] Resolves an incompatibility around usage of SPIClass #2095
• [Cellular] Fixes an issue with CGI (Cellular Global Identity) not available on some devices #2067
• [Electron] Compatibility CellularSignal rssi and qual values generation for LTE devices using AT+UCGED #2070
• [B5 SoM / Asset Tracker] Zero RSRP/RSRQ values from AT+QCSQ treated as errors #2078
• [wiring] BLE: use delete for objects allocated with new #2081
• [Gen 3] I2C HAL recovers the I2C bus on transmission errors #2084
• [Gen 3] Devices should be able to enter STANDBY / Hibernate sleep mode without specifying any wake-up sources #2086
• [Gen 3] Fix an issue with platform_user_ram.ld generation when the application path contains 'data' #2090
• [wiring] Fix SPI macros polluting global namespace #2089
• [system] firmware_update_failed and firmware_update_complete are mixed up 71a8eb56f8d34efbda46f5d547c92e32a42a2148
• [system] Do not propagate non-critical network errors to communication layer ba6c9d863ed79cd036848329c3b89b3c0e84dbd0
• [Gen 3] Fix a crash in netif_ext_callback_handler() when parsing unset event fields dd01b12ea6166b6b175c46348a2b4c180d779ead

System Binaries (all devices)

https://github.com/particle-iot/device-os/releases/download/v1.5.1/[email protected]

SoftDevice update

This Device OS release will automatically update the SoftDevice for devices connected to the cloud.

Prerequisites

particle-cli version 2.5.0.

Upgrading using particle update

1. Put the device into DFU mode
2. Run particle update

DeviceOS, bootloader and SoftDevice should get correctly updated.

Upgrading OTA

1. Upgrade to 1.5.1
2. Manually flash 1.5.1 bootloader: particle flash <deviceId> [email protected]
3. Flash SoftDevice: particle flash <deviceId> [email protected]

Upgrading using YModem

1. Upgrade to 1.5.1
2. Put the device into listening mode (blinking blue) by holding MODE button
3. Manually flash 1.5.1 bootloader: particle flash --serial [email protected]
4. Flash SoftDevice: particle flash --serial [email protected]

Upgrading using DFU (--usb only works for SoftDevice, not bootloader yet)

1. Upgrade Device OS to 1.5.1
2. Update the bootloader to 1.5.1 with the OTA or YModem process above
3. Put the device into DFU mode (blinking yellow)
4. Flash the SoftDevice: particle flash --usb [email protected]

---

Programming and Debugging

You can view specific programming and debugging notes for this version of firmware here.

QA Report Summary for Particle Device OS

You can view results of tests run this release here.

v1.5.1-rc.1 (Photon/P1/Electron/Argon/Boron/Xenon/B SoM/B5 SoM)

Device OS 1.5.1-rc.1 Release Candidate is out on the Web IDE for (Photon/P1/Electron/Argon/Boron/Xenon/B SoM/B5 SoM)

released on April 29th, 2020

---

✅ This 1.5.1-rc.1 Release Candidate will be defaulted to 1.5.1 on May 6th, 2020 unless there are regressions found that require further patches. ✏️ Testing on your applications is encouraged and appreciated, thank you! 🙇

---

Note: This is a Release Candidate (RC) and is not intended for production yet. We've tested this RC to the best of our ability and we want to know what you think now! Please understand that some care and attention is necessary when testing this RC, and be sure to upgrade to the final release when it's available. This RC will not be available by default. To use you must select the version dropdown from the devices drawer. Downgrading back to the current release info is at the bottom of this post.

Note: OTA or YModem transfer on Electron (sequence required)

1. First Update to 0.5.5 (if the current version is less than that)
2. Then update to 0.6.4 (if the current version is less than that)
3. Then update to 0.7.0 (if the current version is less than that)
4. Then update to 1.2.1 (if the current version is less than that)
5. Then update to 1.5.1-rc.1

Note: DFU over USB on Electron/Photon/P1 (sequence not required)

• You may update to 1.5.1-rc.1 directly first, flash the system firmware (attached above) in order 1,2(,3) to the device using particle flash --usb <system-part.bin>. See the next note about the bootloader if you are offline!

Note: P1/Photon Bootloader
The Cloud will automatically update the bootloader on P1/Photon devices if your device is online. If your device does not connect to the cloud and it is offline, you should flash the bootloader to the device using particle flash --serial <bootloader.bin>. This should be done after upgrading system firmware. The Electron bootloader is applied automatically from it's own system parts.

Note: Argon/Boron/Xenon/B SoM/B5 SoM
If your device is offline, the bootloader must be manually updated using particle flash --serial <bootloader.bin>. This can be done before or after upgrading system firmware.

Note: Argon/Boron/Xenon/B SoM/B5 SoM SoftDevice
If your device is offline, the SoftDevice must be manually updated using the CLI. See the instructions below.

Note: Downgrading [Electron/Photon/P1] OTA or YModem transfer:
If you need to downgrade, you must downgrade to 1.2.1, then 0.7.0, then 0.6.3(Photon/P1), 0.6.4(Electron) to ensure that the bootloader downgrades automatically. When downgrading to older versions, downgrade to 1.2.1, then 0.7.0 first, then 0.6.3(Photon/P1), 0.6.4(Electron), then to an older version such as 0.5.5.

1.5.1-rc.1

Note: If your Gen 2 Photon/P1 or Gen 3 device does not have a Cloud connection, it is recommended to update system firmware, and then the bootloader via CLI with particle flash --serial bootloader.bin (bootloaders found in Github release). Electron bootloaders are still contained in system firmware and will update automatically as needed.
Note: If your Gen 3 device does not have a Cloud connection, this release will also require manually updating the SoftDevice via CLI. The instructions are available in the release notes and the SoftDevice binaries are available in the Github release.
This release contains v501 bootloaders.

SoftDevice update

This Device OS release will automatically update the SoftDevice for devices connected to the cloud.

Prerequisites

particle-cli version 2.0.1.

Upgrading OTA

1. Upgrade to 1.5.1-rc.1
2. Manually flash 1.5.1-rc.1 bootloader: particle flash <deviceId> [email protected]
3. Flash SoftDevice: particle flash <deviceId> [email protected]

Upgrading using YModem

1. Upgrade to 1.5.1-rc.1
2. Put the device into listening mode (blinking blue) by holding MODE button
3. Manually flash 1.5.1-rc.1 bootloader: particle flash --serial [email protected]
4. Flash SoftDevice: particle flash --serial [email protected]

Upgrading using DFU (--usb only works for SoftDevice, not bootloader yet)

1. Upgrade Device OS to 1.5.1-rc.1
2. Update the bootloader to 1.5.1-rc.1 with the OTA or YModem process above
3. Put the device into DFU mode (blinking yellow)
4. Flash the SoftDevice: particle flash --usb [email protected]

ENHANCEMENTS

• [Argon] Increase the size of the ARP queue #2075
• [Cellular] Increase registration timeout to 10 minutes #2072
• [Electron / Boron] Make sure that SARA R4-based LTE devices report LTE Cat M1 access technology #2083
• [B5 SoM] Enable hardware flow control on Quectel modems earlier in the initialization process #2069 #2071
• [Vitals] Add CoAP transmitted, retransmitted counter diagnostics #2043
• [Vitals] Add CoAP latency diagnostic #2050
• [Cellular] Increase registration timeout to 10 minutes #2072
• Remove locking in some of the SPI and I2C APIs. SPI perofrmance tests #2088
• Particle.process() no-op when called from custom threads #2085
• [Electron] Minor log message changes when the modem is not responsive #2087

BUGFIXES

• [Cellular] Fixes an issue with CGI (Cellular Global Identity) not available on some devices #2067
• [Electron] Compatibility CellularSignal rssi and qual values generation for LTE devices using AT+UCGED #2070
• [B5 SoM / Asset Tracker] Zero RSRP/RSRQ values from AT+QCSQ treated as errors #2078
• [wiring] BLE: use delete for objects allocated with new #2081
• [Gen 3] I2C HAL recovers the I2C bus on transmission errors #2084
• [Gen 3] Devices should be able to enter STANDBY / Hibernate sleep mode without specifying any wake-up sources #2086
• [Gen 3] Fix an issue with platform_user_ram.ld generation when the application path contains 'data' #2090
• [wiring] Fix SPI macros polluting global namespace #2089
• [system] firmware_update_failed and firmware_update_complete are mixed up 71a8eb56f8d34efbda46f5d547c92e32a42a2148
• [system] Do not propagate non-critical network errors to communication layer ba6c9d863ed79cd036848329c3b89b3c0e84dbd0
• [Gen 3] Fix a crash in netif_ext_callback_handler() when parsing unset event fields dd01b12ea6166b6b175c46348a2b4c180d779ead

System Binaries (all devices)

https://github.com/particle-iot/device-os/releases/download/v1.5.1-rc.1/[email protected]

---

Programming and Debugging

You can view specific programming and debugging notes for this version of firmware here.

QA Report Summary for Particle Device OS

You can view results of tests run this release here.

v1.5.0 (Photon/P1/Electron/Argon/Boron/Xenon/B SoM/B5 SoM)

Device OS 1.5.0 Default Release is out on the Web IDE for (Photon/P1/Electron/Argon/Boron/Xenon/B SoM/B5 SoM)

released on production servers March 30th, 2020

✏️ Please read all notes below

Note: This is a Release and may be used for production. Any known issues are likely slated for a future version, (check Github issues). It is available by default for all devices. To use, select the 1.5.0 version dropdown from the devices drawer.
Downgrading back to a previous release info is at the bottom of this post.

Note: If you have previously last used one of the prerelease or release versions of 1.5.x on a device, please re-flash it with 1.5.0.

Note: OTA or YModem transfer on Electron (sequence required)

1. First Update to 0.5.5 (if the current version is less than that)
2. Then update to 0.6.4 (if the current version is less than that)
3. Then update to 0.7.0 (if the current version is less than that)
4. Then update to 1.2.1 (if the current version is less than that)
5. Then update to 1.5.0

Note: DFU over USB on Electron/Photon/P1 (sequence not required)

• You may update to 1.5.0 directly first, flash the system firmware (attached above) in order 1,2(,3) to the device using particle flash --usb <system-part.bin>. See the next note about the bootloader if you are offline!

Note: P1/Photon Bootloader
The Cloud will automatically update the bootloader on P1/Photon devices if your device is online. If your device does not connect to the cloud and it is offline, you should flash the bootloader to the device using particle flash --serial <bootloader.bin>. This should be done after upgrading system firmware. The Electron bootloader is applied automatically from it's own system parts.

Note: Argon/Boron/Xenon/Argon-SoM/Boron-SoM/Xenon-SoM Bootloader
If your device is offline, the bootloader must be manually updated using particle flash --serial <bootloader.bin>. This can be done before or after upgrading system firmware.

Note: Argon/Boron/Xenon/Argon-SoM/Boron-SoM/Xenon-SoM SoftDevice
If your device is offline, the SoftDevice must be manually updated using the CLI. See the instructions below.

Note: Downgrading [Electron/Photon/P1] OTA or YModem transfer:
If you need to downgrade, you must downgrade to 1.2.1, then 0.7.0, then 0.6.3(Photon/P1), 0.6.4(Electron) to ensure that the bootloader downgrades automatically. When downgrading to older versions, downgrade to 1.2.1, then 0.7.0 first, then 0.6.3(Photon/P1), 0.6.4(Electron), then to an older version such as 0.5.5.

1.5.0

Note: If your Gen 2 Photon/P1 or Gen 3 device does not have a Cloud connection, it is recommended to update system firmware via CLI with particle update. Electron bootloaders are still contained in system firmware and will update automatically as needed.
Note: If your Gen 3 device does not have a Cloud connection, this release will also require manually updating the SoftDevice via CLI. The instructions are available in the release notes and the SoftDevice binaries are available in the Github release.
This release contains v501 bootloaders.

DEPRECATION

• Spark Core End-Of-Life. 1.5.x+ releases no longer support Spark Core #2003

FEATURES

• Introduce configurable I2C buffer #2022
• Support for > 255 I2C buffers and transfers, configurable timeouts #2035
• Thread-safe cloud variables #1998
• Sleep 2.0 #1986
• Enables C++14 chrono string literals for wiring APIs #1709
• [Gen 3] Implements persistent antenna selection (Mesh.selectAntenna()) #1933
• GCC 8 support #1971
• [B5 SoM] B5 SoM platform support
• [Boron/Electron/B5 SoM] Reverts default PMIC settings changes, adds higher level power configuration API #1992

ENHANCEMENTS

• Replace AT+CSQ usage on Quectel-based devices with AT+QCSQ 147f654
• Replace AT+CSQ/CESQ usage on ublox-based LTE devices with AT+UCGED #2033 #2038
• [wiring] Specify floating precision in JSON library #2054
• Expose full concurrent HAL APIs to the application #2052
• Close cloud socket on communication errors on all platforms except for Electron #2056
• [B5 SoM] Enable hardware flow control for Quectel modem during runtime and add support for EG91-EX #2042
• Enables Workbench DeviceOS local development (deviceOS@source) #1957
• [Gen 3/Cellular] Enables logging of modem AT commands and data transmissions by default in modular builds #1994
• [Gen 2] Removes write protection enforcement of system firmware on boot #2009
• [Cellular] Adds SystemPowerFeature::DISABLE to disable system power management #2015

BUGFIXES

• [Boron/B SoM/B5 SoM] Fix Cellular Global Identity generation #2062
• [B5 SoM] Strip padding F from ICCID 4aa1746
• Fix 3G signal strength calculation on ublox-based cellular devices 553af7b
• Only increment unacknowledged counter for requests, not acknowledgements #2046
• Fix YModem transfer regression introduced in 1.5.0-rc.2 #2051
• [wiring] Fixes a memory leakage in Mutex and RecursiveMutex classes #2053
• [B5 SoM] Fixes a hardfault when Ethernet is enabled #2057
• [P1] Enable power save clock (32KHz) only if not disabled by feature flag #2058
• [wiring] Fixes multiple conflicting candidates when calling Wire.requestFrom() #2059
• [Gen 2] Fix SPI.beginTransaction() deadlocking #2060
• [Gen 3] Fix a race condition in NCP client when the GSM0710 muxer connection to the NCP is abruptly broken #2049
• [Workbench] Workaround for failing Device OS builds on Windows #2037
• [Gen 2] platform: fix FLASH_Update() for unaligned writes #2036
• Fixes the issue with SPI default SS pin being not configured #2039
• [gcc] fixes builds on osx and enables usage of the latest gcc versions #2041
• [Gen 3] Fixes renegotiation of options and adds IPCP packet parsing #2029
• [Gen 3] Fix parsing of large AT command responses #2017
• String::substring() unnecessarily modifies the source buffer #2026
• [B5 SoM] Fix CGI for Quectel modems #2019
• [Gen 2] Fixes socket leak in UDP.begin() #2031
• [Gen 3] Fixes Serial.read() returning -1 instead of 0 when there's no data to read #2034
• [Gen 3] Fixes BLE UUID conversion issue #1997
• [wiring] Fixes a regression in SPI due to thread-safety additions from #1879 #2023
• [Boron/BSoM] Enables advance SETUP/MODE button features (single click - RSSI, double click - soft poweroff) #1918
• Fixes a call to objdump when the compiler is not in PATH #1961
• [gcc] Ensure GPIO pinmap is initialized on first use #1963
• [Gen 3] Fixes too many connection attempts with deactivated SIM #1969
• [Gen 3] Fixes NCP issue with devices stuck in a seemingly connected state #1980
• [Photon/P1] Fixes a hardfault when calling certain WiFI class methods with WICED networking stack uninitialized #1949
• [Gen 3] Fixes .particle/toolchains/gcc-arm/5.3.1/bin/objdump: not found issues in Workbench [#1996](https://github.com/particle-iot/device-os/pull/199...

v1.5.0-rc.2 (Photon/P1/Electron/Argon/Boron/Xenon/B SoM/B5 SoM)

Device OS 1.5.0-rc.2 Release Candidate is out on the Web IDE for (Photon/P1/Electron/Argon/Boron/Xenon/B SoM/B5 SoM)

released on March 6th, 2020

---

✅ This 1.5.0-rc.2 Release Candidate will be defaulted to 1.5.0 on March 20th, 2020 unless there are regressions found that require further patches. ✏️ Testing on your applications is encouraged and appreciated, thank you! 🙇

---

Note: This is a Release Candidate (RC) and is not intended for production yet. We've tested this RC to the best of our ability and we want to know what you think now! Please understand that some care and attention is necessary when testing this RC, and be sure to upgrade to the final release when it's available. This RC will not be available by default. To use you must select the version dropdown from the devices drawer. Downgrading back to the current release info is at the bottom of this post.

Note: OTA or YModem transfer on Electron (sequence required)

1. First Update to 0.5.5 (if the current version is less than that)
2. Then update to 0.6.4 (if the current version is less than that)
3. Then update to 0.7.0 (if the current version is less than that)
4. Then update to 1.2.1 (if the current version is less than that)
5. Then update to 1.5.0-rc.2

Note: DFU over USB on Electron/Photon/P1 (sequence not required)

• You may update to 1.5.0-rc.2 directly first, flash the system firmware (attached above) in order 1,2(,3) to the device using particle flash --usb <system-part.bin>. See the next note about the bootloader if you are offline!

Note: P1/Photon Bootloader
The Cloud will automatically update the bootloader on P1/Photon devices if your device is online. If your device does not connect to the cloud and it is offline, you should flash the bootloader to the device using particle flash --serial <bootloader.bin>. This should be done after upgrading system firmware. The Electron bootloader is applied automatically from it's own system parts.

Note: Argon/Boron/Xenon/B SoM/B5 SoM
If your device is offline, the bootloader must be manually updated using particle flash --serial <bootloader.bin>. This can be done before or after upgrading system firmware.

Note: Argon/Boron/Xenon/B SoM/B5 SoM SoftDevice
If your device is offline, the SoftDevice must be manually updated using the CLI. See the instructions below.

Note: Downgrading [Electron/Photon/P1] OTA or YModem transfer:
If you need to downgrade, you must downgrade to 1.2.1, then 0.7.0, then 0.6.3(Photon/P1), 0.6.4(Electron) to ensure that the bootloader downgrades automatically. When downgrading to older versions, downgrade to 1.2.1, then 0.7.0 first, then 0.6.3(Photon/P1), 0.6.4(Electron), then to an older version such as 0.5.5.

1.5.0-rc.2

Note: If your Gen 2 Photon/P1 or Gen 3 device does not have a Cloud connection, it is recommended to update system firmware, and then the bootloader via CLI with particle flash --serial bootloader.bin (bootloaders found in Github release). Electron bootloaders are still contained in system firmware and will update automatically as needed.
Note: If your Gen 3 device does not have a Cloud connection, this release will also require manually updating the SoftDevice via CLI. The instructions are available in the release notes and the SoftDevice binaries are available in the Github release.
This release contains v501 bootloaders.

SoftDevice update

This Device OS release will automatically update the SoftDevice for devices connected to the cloud.

Prerequisites

particle-cli version 2.0.1.

Upgrading OTA

1. Upgrade to 1.5.0-rc.2
2. Manually flash 1.5.0-rc.2 bootloader: particle flash <deviceId> [email protected]
3. Flash SoftDevice: particle flash <deviceId> [email protected]

Upgrading using YModem

1. Upgrade to 1.5.0-rc.2
2. Put the device into listening mode (blinking blue) by holding MODE button
3. Manually flash 1.5.0-rc.2 bootloader: particle flash --serial [email protected]
4. Flash SoftDevice: particle flash --serial [email protected]

Upgrading using DFU (--usb only works for SoftDevice, not bootloader yet)

1. Upgrade Device OS to 1.5.0-rc.2
2. Update the bootloader to 1.5.0-rc.2 with the OTA or YModem process above
3. Put the device into DFU mode (blinking yellow)
4. Flash the SoftDevice: particle flash --usb [email protected]

FEATURES

• Introduce configurable I2C buffer #2022
• Support for > 255 I2C buffers and transfers, configurable timeouts #2035
• Thread-safe cloud variables #1998

ENHANCEMENTS

• [B5 SoM] Enable hardware flow control for Quectel modem during runtime and add support for EG91-EX #2042

BUGFIXES

• [Workbench] Workaround for failing Device OS builds on Windows #2037
• [Gen 2] platform: fix FLASH_Update() for unaligned writes #2036
• Fixes the issue with SPI default SS pin being not configured #2039
• [gcc] fixes builds on osx and enables usage of the latest gcc versions #2041
• [Gen 3] Fixes renegotiation of options and adds IPCP packet parsing #2029
• [Gen 3] Fix parsing of large AT command responses #2017
• String::substring() unnecessarily modifies the source buffer #2026
• [B5 SoM] Fix CGI for Quectel modems #2019
• [Gen 2] Fixes socket leak in UDP.begin() #2031
• [Gen 3] Fixes Serial.read() returning -1 instead of 0 when there's no data to read #2034
• [Gen 3] Fixes BLE UUID conversion issue #1997
• [wiring] Fixes a regression in SPI due to thread-safety additions from #1879 #2023

INTERNAL

• [test] unit: fixes Print tests failing #2027
• [B5 SoM] Change the prefix of BLE broadcasting name for B5SoM #2030
• update workbench manifest with latest buildscripts dependency #2020

System Binaries (all devices)

https://github.com/particle-iot/device-os/releases/download/v1.5.0-rc.2/[email protected]

---

Programming and Debugging

You can view specific programming and debugging notes for this version of firmware here.

QA Report Summary for Particle Device OS

You can view results of tests run this release here.

v1.5.0-rc.1 (Photon/P1/Electron/Argon/Boron/Xenon/B SoM/B5 SoM)

Device OS 1.5.0-rc.1 Release Candidate is out on the Web IDE for (Photon/P1/Electron/Argon/Boron/Xenon/B SoM/B5 SoM)

released on February 6th, 2020

---

✅ This 1.5.0-rc.1 Release Candidate will be defaulted to 1.5.0 on February 21st, 2020 unless there are regressions found that require further patches. ✏️ Testing on your applications is encouraged and appreciated, thank you! 🙇

---

Note: This is a Release Candidate (RC) and is not intended for production yet. We've tested this RC to the best of our ability and we want to know what you think now! Please understand that some care and attention is necessary when testing this RC, and be sure to upgrade to the final release when it's available. This RC will not be available by default. To use you must select the version dropdown from the devices drawer. Downgrading back to the current release info is at the bottom of this post.

Note: OTA or YModem transfer on Electron (sequence required)

1. First Update to 0.5.5 (if the current version is less than that)
2. Then update to 0.6.4 (if the current version is less than that)
3. Then update to 0.7.0 (if the current version is less than that)
4. Then update to 1.2.1 (if the current version is less than that)
5. Then update to 1.5.0-rc.1

Note: DFU over USB on Electron/Photon/P1 (sequence not required)

• You may update to 1.5.0-rc.1 directly first, flash the system firmware (attached above) in order 1,2(,3) to the device using particle flash --usb <system-part.bin>. See the next note about the bootloader if you are offline!

Note: P1/Photon Bootloader
The Cloud will automatically update the bootloader on P1/Photon devices if your device is online. If your device does not connect to the cloud and it is offline, you should flash the bootloader to the device using particle flash --serial <bootloader.bin>. This should be done after upgrading system firmware. The Electron bootloader is applied automatically from it's own system parts.

Note: Argon/Boron/Xenon/B SoM/B5 SoM
If your device is offline, the bootloader must be manually updated using particle flash --serial <bootloader.bin>. This can be done before or after upgrading system firmware.

Note: Argon/Boron/Xenon/B SoM/B5 SoM SoftDevice
If your device is offline, the SoftDevice must be manually updated using the CLI. See the instructions below.

Note: Downgrading [Electron/Photon/P1] OTA or YModem transfer:
If you need to downgrade, you must downgrade to 1.2.1, then 0.7.0, then 0.6.3(Photon/P1), 0.6.4(Electron) to ensure that the bootloader downgrades automatically. When downgrading to older versions, downgrade to 1.2.1, then 0.7.0 first, then 0.6.3(Photon/P1), 0.6.4(Electron), then to an older version such as 0.5.5.

1.5.0-rc.1

Note: If your Gen 2 Photon/P1 or Gen 3 device does not have a Cloud connection, it is recommended to update system firmware, and then the bootloader via CLI with particle flash --serial bootloader.bin (bootloaders found in Github release). Electron bootloaders are still contained in system firmware and will update automatically as needed.
Note: If your Gen 3 device does not have a Cloud connection, this release will also require manually updating the SoftDevice via CLI. The instructions are available in the release notes and the SoftDevice binaries are available in the Github release.
This release contains v501 bootloaders.

SoftDevice update

This Device OS release will automatically update the SoftDevice for devices connected to the cloud.

Prerequisites

particle-cli version 2.0.1.

Upgrading OTA

1. Upgrade to 1.5.0-rc.1
2. Manually flash 1.5.0-rc.1 bootloader: particle flash <deviceId> [email protected]
3. Flash SoftDevice: particle flash <deviceId> [email protected]

Upgrading using YModem

1. Upgrade to 1.5.0-rc.1
2. Put the device into listening mode (blinking blue) by holding MODE button
3. Manually flash 1.5.0-rc.1 bootloader: particle flash --serial [email protected]
4. Flash SoftDevice: particle flash --serial [email protected]

Upgrading using DFU (--usb only works for SoftDevice, not bootloader yet)

1. Upgrade Device OS to 1.5.0-rc.1
2. Update the bootloader to 1.5.0-rc.1 with the OTA or YModem process above
3. Put the device into DFU mode (blinking yellow)
4. Flash the SoftDevice: particle flash --usb [email protected]

1.5.0-rc.1

DEPRECATION

• Spark Core End-Of-Life. 1.5.x+ releases no longer support Spark Core #2003

FEATURES

• Sleep 2.0 #1986
• Enables C++14 chrono string literals for wiring APIs #1709
• [Gen 3] Implements persistent antenna selection (Mesh.selectAntenna()) #1933
• GCC 8 support #1971
• [B5 SoM] B5 SoM platform support
• [Boron/Electron/B5 SoM] Reverts default PMIC settings changes, adds higher level power configuration API #1992

ENHANCEMENTS

• Enables Workbench DeviceOS local development (deviceOS@source) #1957
• [Gen 3/Cellular] Enables logging of modem AT commands and data transmissions by default in modular builds #1994
• [Gen 2] Removes write protection enforcement of system firmware on boot #2009
• [Cellular] Adds SystemPowerFeature::DISABLE to disable system power management #2015

BUGFIXES

• [Boron/BSoM] Enables advance SETUP/MODE button features (single click - RSSI, double click - soft poweroff) #1918
• Fixes a call to objdump when the compiler is not in PATH #1961
• [gcc] Ensure GPIO pinmap is initialized on first use #1963
• [Gen 3] Fixes too many connection attempts with deactivated SIM #1969
• [Gen 3] Fixes NCP issue with devices stuck in a seemingly connected state #1980
• [Photon/P1] Fixes a hardfault when calling certain WiFI class methods with WICED networking stack uninitialized #1949
• [Gen 3] Fixes .particle/toolchains/gcc-arm/5.3.1/bin/objdump: not found issues in Workbench #1996
• [B5 SoM] Temporarily disables hardware flow control #1999
• [Gen 3] Fixes retained variables first-time initialization #2001
• [B5 SoM] Removes unsupported AT+CGDCONT call with CHAP:<APN> #2006
• [Boron] Increases AT+COPS=0 timeout, lowers baudrate to 115200 #2008
• Prevents expansion of EXTRA_CFLAGS variable #2012
• [Gen 3] Workaround for QSPI/XIP nRF52840 hardware anomaly 215 #2010
• Fixes a potential buffer overflow in Time.format() #1973
• [Gen 2] Clear WLAN_WD when disconnect() is called #2016
• [Gen 3] Fixes concurrency/thread-safety SPI issues with Ethernet Featherwing #1879

INTERNAL

• Increase VitalsPublisher test coverage #1920
• Adds missing platforms to manifest.json #1959
• Add support for control requests sent by the test runner #1987
• Add support for chunked transfer of USB request/reply data #1991
• Implements EnumFlags class for bitwise operations on C++ enum classes #1978
• Improves cellular test coverage #1930
• [Gen 3] Frees up some flash space in system-part1 #2000
• [Cellular] Internal function to modify cellular registration timeout #2007 #2014
• Removes xsom and asom platforms #2011

DOCUMENTATION

• Documents adding custom CFLAGS during DeviceOS application build #2004

System Binaries (all devices)

https://github.com/particle-iot/device-os/releases/download/v1.5.0-rc.1/[email protected]

---

Programming and Debugging

You can view specific programming and debugging notes for this version of firmware here.

QA Report Summary for Particle Device OS

You can view [results of tests run thi...

v1.4.4 (Core/Photon/P1/Electron/Argon/Boron/Xenon/A SoM/B SoM/X SoM)

Device OS 1.4.4 Default Release is out on the Web IDE for (Core/Photon/P1/Electron/Argon/Boron/Xenon/A SoM/B SoM/X SoM)

released on production servers December 4th, 2019

✏️ Please read all notes below

Note: This is a Release and may be used for production. Any known issues are likely slated for a future version, (check Github issues). It is available by default for all devices. To use, select the 1.4.4 version dropdown from the devices drawer.
Downgrading back to a previous release info is at the bottom of this post.

Note: If you have previously last used one of the prerelease or release versions of 1.4.x on a device, please re-flash it with 1.4.4.

Note: OTA or YModem transfer on Electron (sequence required)

1. First Update to 0.5.5 (if the current version is less than that)
2. Then update to 0.6.4 (if the current version is less than that)
3. Then update to 0.7.0 (if the current version is less than that)
4. Then update to 1.2.1 (if the current version is less than that)
5. Then update to 1.4.4

Note: DFU over USB on Electron/Photon/P1 (sequence not required)

• You may update to 1.4.4 directly first, flash the system firmware (attached above) in order 1,2(,3) to the device using particle flash --usb <system-part.bin>. See the next note about the bootloader if you are offline!

Note: P1/Photon Bootloader
The Cloud will automatically update the bootloader on P1/Photon devices if your device is online. If your device does not connect to the cloud and it is offline, you should flash the bootloader to the device using particle flash --serial <bootloader.bin>. This should be done after upgrading system firmware. The Electron bootloader is applied automatically from it's own system parts.

Note: Argon/Boron/Xenon/Argon-SoM/Boron-SoM/Xenon-SoM Bootloader
If your device is offline, the bootloader must be manually updated using particle flash --serial <bootloader.bin>. This can be done before or after upgrading system firmware.

Note: Argon/Boron/Xenon/Argon-SoM/Boron-SoM/Xenon-SoM SoftDevice
If your device is offline, the SoftDevice must be manually updated using the CLI. See the instructions below.

Note: Downgrading [Electron/Photon/P1] OTA or YModem transfer:
If you need to downgrade, you must downgrade to 1.2.1, then 0.7.0, then 0.6.3(Photon/P1), 0.6.4(Electron) to ensure that the bootloader downgrades automatically. When downgrading to older versions, downgrade to 1.2.1, then 0.7.0 first, then 0.6.3(Photon/P1), 0.6.4(Electron), then to an older version such as 0.5.5.

1.4.4

This release resolves a bug in handling of incorrectly initialized WiFi credentials list, resulting in crashes on a number of Photons and P1s manufactured with DeviceOS 1.2.1 - 1.4.2. It is recommended to update Photons and P1s with factory 1.2.1 - 1.4.2 DeviceOS to this release.

Note: If your Gen 2 Photon/P1 or Gen 3 device does not have a Cloud connection, it is recommended to update system firmware via CLI with particle update. Electron bootloaders are still contained in system firmware and will update automatically as needed.
Note: If your Gen 3 device does not have a Cloud connection, this release will also require manually updating the SoftDevice via CLI. The instructions are available in the release notes and the SoftDevice binaries are available in the Github release.
This release contains v501 bootloaders.

SoftDevice update

This Device OS release will automatically update the SoftDevice for devices connected to the cloud.

Prerequisites

particle-cli version 1.53.0.

Upgrading using particle update

1. Put the device into DFU mode
2. Run particle update

DeviceOS, bootloader and SoftDevice should get correctly updated.

Upgrading OTA

1. Upgrade to 1.4.4
2. Manually flash 1.4.4 bootloader: particle flash <deviceId> [email protected]
3. Flash SoftDevice: particle flash <deviceId> [email protected]

Upgrading using YModem

1. Upgrade to 1.4.4
2. Put the device into listening mode (blinking blue) by holding MODE button
3. Manually flash 1.4.4 bootloader: particle flash --serial [email protected]
4. Flash SoftDevice: particle flash --serial [email protected]

Upgrading using DFU (--usb only works for SoftDevice, not bootloader yet)

1. Upgrade Device OS to 1.4.4
2. Update the bootloader to 1.4.4 with the OTA or YModem process above
3. Put the device into DFU mode (blinking yellow)
4. Flash the SoftDevice: particle flash --usb [email protected]

BUGFIXES

• [Photon/P1] Fixes handling of invalid WiFi access point config entries in DCT #1976

System Binaries (all devices)

https://github.com/particle-iot/device-os/releases/download/v1.4.4/[email protected]

---

Programming and Debugging

You can view specific programming and debugging notes for this version of firmware here.

QA Report Summary for Particle Device OS

You can view results of tests run this release here.

v1.4.3 (Core/Photon/P1/Electron/Argon/Boron/Xenon/A SoM/B SoM/X SoM)

Device OS 1.4.3 Default Release is out on the Web IDE for (Core/Photon/P1/Electron/Argon/Boron/Xenon/A SoM/B SoM/X SoM)

released on production servers November 25th, 2019

✏️ Please read all notes below

Note: This is a Release and may be used for production. Any known issues are likely slated for a future version, (check Github issues). It is available by default for all devices. To use, select the 1.4.3 version dropdown from the devices drawer.
Downgrading back to a previous release info is at the bottom of this post.

Note: If you have previously last used one of the prerelease or release versions of 1.4.x on a device, please re-flash it with 1.4.3.

Note: OTA or YModem transfer on Electron (sequence required)

1. First Update to 0.5.5 (if the current version is less than that)
2. Then update to 0.6.4 (if the current version is less than that)
3. Then update to 0.7.0 (if the current version is less than that)
4. Then update to 1.2.1 (if the current version is less than that)
5. Then update to 1.4.3

Note: DFU over USB on Electron/Photon/P1 (sequence not required)

• You may update to 1.4.3 directly first, flash the system firmware (attached above) in order 1,2(,3) to the device using particle flash --usb <system-part.bin>. See the next note about the bootloader if you are offline!

Note: P1/Photon Bootloader
The Cloud will automatically update the bootloader on P1/Photon devices if your device is online. If your device does not connect to the cloud and it is offline, you should flash the bootloader to the device using particle flash --serial <bootloader.bin>. This should be done after upgrading system firmware. The Electron bootloader is applied automatically from it's own system parts.

Note: Argon/Boron/Xenon/Argon-SoM/Boron-SoM/Xenon-SoM Bootloader
If your device is offline, the bootloader must be manually updated using particle flash --serial <bootloader.bin>. This can be done before or after upgrading system firmware.

Note: Argon/Boron/Xenon/Argon-SoM/Boron-SoM/Xenon-SoM SoftDevice
If your device is offline, the SoftDevice must be manually updated using the CLI. See the instructions below.

Note: Downgrading [Electron/Photon/P1] OTA or YModem transfer:
If you need to downgrade, you must downgrade to 1.2.1, then 0.7.0, then 0.6.3(Photon/P1), 0.6.4(Electron) to ensure that the bootloader downgrades automatically. When downgrading to older versions, downgrade to 1.2.1, then 0.7.0 first, then 0.6.3(Photon/P1), 0.6.4(Electron), then to an older version such as 0.5.5.

1.4.3

This release resolves a thread-safety issue on Gen 2 devices (Photon, P1, Electron), affecting non-reentrant C standard library functions requiring temporary non-stack storage. It is recommended to update any Gen 2 devices to this release.

Note: If your Gen 2 Photon/P1 or Gen 3 device does not have a Cloud connection, it is recommended to update system firmware via CLI with particle update. Electron bootloaders are still contained in system firmware and will update automatically as needed.
Note: If your Gen 3 device does not have a Cloud connection, this release will also require manually updating the SoftDevice via CLI. The instructions are available in the release notes and the SoftDevice binaries are available in the Github release.
This release contains v501 bootloaders.

SoftDevice update

This Device OS release will automatically update the SoftDevice for devices connected to the cloud.

Prerequisites

particle-cli version 1.52.0.

Upgrading using particle update

1. Put the device into DFU mode
2. Run particle update

DeviceOS, bootloader and SoftDevice should get correctly updated.

Upgrading OTA

1. Upgrade to 1.4.3
2. Manually flash 1.4.3 bootloader: particle flash <deviceId> [email protected]
3. Flash SoftDevice: particle flash <deviceId> [email protected]

Upgrading using YModem

1. Upgrade to 1.4.3
2. Put the device into listening mode (blinking blue) by holding MODE button
3. Manually flash 1.4.3 bootloader: particle flash --serial [email protected]
4. Flash SoftDevice: particle flash --serial [email protected]

Upgrading using DFU (--usb only works for SoftDevice, not bootloader yet)

1. Upgrade Device OS to 1.4.3
2. Update the bootloader to 1.4.3 with the OTA or YModem process above
3. Put the device into DFU mode (blinking yellow)
4. Flash the SoftDevice: particle flash --usb [email protected]

BUGFIXES

• [Photon/P1/Electron] Fixes thread-safety issues with non-reentrant C standard library functions requiring temporary thread-local storage #1970

System Binaries (all devices)

https://github.com/particle-iot/device-os/releases/download/v1.4.3/[email protected]

---

Programming and Debugging

You can view specific programming and debugging notes for this version of firmware here.

QA Report Summary for Particle Device OS

You can view results of tests run this release here.

v1.4.2 (Core/Photon/P1/Electron/Argon/Boron/Xenon/A SoM/B SoM/X SoM)

Device OS 1.4.2 Default Release is out on the Web IDE for (Core/Photon/P1/Electron/Argon/Boron/Xenon/A SoM/B SoM/X SoM)

released on production servers October 18th, 2019

✏️ Please read all notes below

Note: This is a Release and may be used for production. Any known issues are likely slated for a future version, (check Github issues). It is available by default for all devices. To use, select the 1.4.2 version dropdown from the devices drawer.
Downgrading back to a previous release info is at the bottom of this post.

Note: If you have previously last used one of the prerelease or release versions of 1.4.x on a device, please re-flash it with 1.4.2.

Note: OTA or YModem transfer on Electron (sequence required)

1. First Update to 0.5.5 (if the current version is less than that)
2. Then update to 0.6.4 (if the current version is less than that)
3. Then update to 0.7.0 (if the current version is less than that)
4. Then update to 1.2.1 (if the current version is less than that)
5. Then update to 1.4.2

Note: DFU over USB on Electron/Photon/P1 (sequence not required)

• You may update to 1.4.2 directly first, flash the system firmware (attached above) in order 1,2(,3) to the device using particle flash --usb <system-part.bin>. See the next note about the bootloader if you are offline!

Note: P1/Photon Bootloader
The Cloud will automatically update the bootloader on P1/Photon devices if your device is online. If your device does not connect to the cloud and it is offline, you should flash the bootloader to the device using particle flash --serial <bootloader.bin>. This should be done after upgrading system firmware. The Electron bootloader is applied automatically from it's own system parts.

Note: Argon/Boron/Xenon/Argon-SoM/Boron-SoM/Xenon-SoM Bootloader
If your device is offline, the bootloader must be manually updated using particle flash --serial <bootloader.bin>. This can be done before or after upgrading system firmware.

Note: Argon/Boron/Xenon/Argon-SoM/Boron-SoM/Xenon-SoM SoftDevice
If your device is offline, the SoftDevice must be manually updated using the CLI. See the instructions below.

Note: Downgrading [Electron/Photon/P1] OTA or YModem transfer:
If you need to downgrade, you must downgrade to 1.2.1, then 0.7.0, then 0.6.3(Photon/P1), 0.6.4(Electron) to ensure that the bootloader downgrades automatically. When downgrading to older versions, downgrade to 1.2.1, then 0.7.0 first, then 0.6.3(Photon/P1), 0.6.4(Electron), then to an older version such as 0.5.5.

1.4.2

Note: If your Gen 2 Photon/P1 or Gen 3 device does not have a Cloud connection, it is recommended to update system firmware via CLI with particle update. Electron bootloaders are still contained in system firmware and will update automatically as needed.
Note: If your Gen 3 device does not have a Cloud connection, this release will also require manually updating the SoftDevice via CLI. The instructions are available in the release notes and the SoftDevice binaries are available in the Github release.
This release contains v501 bootloaders.

SoftDevice update

This Device OS release will automatically update the SoftDevice for devices connected to the cloud.

Prerequisites

particle-cli version 1.49.0.

Upgrading using particle update

1. Put the device into DFU mode
2. Run particle update

DeviceOS, bootloader and SoftDevice should get correctly updated.

Upgrading OTA

1. Upgrade to 1.4.2
2. Manually flash 1.4.2 bootloader: particle flash <deviceId> [email protected]
3. Flash SoftDevice: particle flash <deviceId> [email protected]

Upgrading using YModem

1. Upgrade to 1.4.2
2. Put the device into listening mode (blinking blue) by holding MODE button
3. Manually flash 1.4.2 bootloader: particle flash --serial [email protected]
4. Flash SoftDevice: particle flash --serial [email protected]

Upgrading using DFU (--usb only works for SoftDevice, not bootloader yet)

1. Upgrade Device OS to 1.4.2
2. Update the bootloader to 1.4.2 with the OTA or YModem process above
3. Put the device into DFU mode (blinking yellow)
4. Flash the SoftDevice: particle flash --usb [email protected]

BUGFIXES

• [Gen 3] Fixes a boot/crash-loop due to a POWER_CLOCK_IRQn firing in between the jump into the system firmware from the bootloader #1948

System Binaries (all devices)

https://github.com/particle-iot/device-os/releases/download/v1.4.2/[email protected]

---

Programming and Debugging

You can view specific programming and debugging notes for this version of firmware here.

QA Report Summary for Particle Device OS

You can view results of tests run this release here.