We are pleased to announce the Mbed OS 6.12.0 release is now available.
Summary
The main changes in this release are further enhancements to connectivity with changes to socket APIs and to the Mesh support for Wi-SUN.
Support for one new target is added too:
- Nuvoton M2354 - https://os.mbed.com/platforms/NUMAKER-M2354/
Migration Guide
This section lists specific changes which are part of this release and may
need special attention.
LWIP Broadcast socket option added
Summary of changes
This PR adds Broadcast socket option
Impact of changes
No impact
Migration actions required
Not needed
Fix 'netsocket: several dynamic allocation results not checked' (#14210)
Summary of changes
This changes adds std::nowthrow
and the checks for allocation failure to all places in the netsocket
portion that lacked it. This change addresses #14210.
Impact of changes
add_event_listener
in NetworkInterface
now returns an error if the method fails. Previous attempts to add the event listener would attempt to use an unchecked standard dynamically allocated ns_list_*
item.
In other cases, the dynamically allocated items will now be checked, and if unsuccessful, will return after cleaning up any outstanding issues.
TCPSocket::accept
will now check that its own internally allocated new TCPSocket
call will succeed, and if not, will clean up the stack resources. This should help when memory is low but an incoming connection requests a connection when the TCPSocket
is listening.
Migration actions required
As new
calls are now handled, code that did not check against this failure may now check for failure and handle it at the application layer.
add_event_listener
now returns nsapi_error_t
instead of void
. The two return values possible are NSAPI_ERROR_OK
and NSAPI_ERROR_NO_MEMORY
in the case of memory allocation failure.
Mesh api: Added PHY mode, channel plan IDs and configuration functions
Summary of changes
Support for Wi-SUN FAN v1.1 PHY mode ID and channel plan ID in Mesh API.
- Enables using OFDM modulation with Wi-SUN stack.
- This change is copied from PR: #14161
Implemented domain configuration functions in mesh API: - Functions will set, get and validate the parameters using corresponding Nanostack API.
- This change is copied from PR: #14251
Enable the RWW function of Macronix Flash MX25LW51245G in OSPI block device driver
Summary of changes
Update PR #12644.
Add source code about RWW(read while write) in OSPI block device driver for using the RWW function Macronix octaflash MX25LW51245G to improve performance.
Impact of changes
Enable the RWW function of MX25LW51245G.
Known Issues
We publish Mbed OS as a collection of modules on GitHub. Issues are raised in the specific repositories and then tracked internally. The purpose of this section is to provide a single view of the outstanding key issues that have not been addressed for this release. As such, it is a filtered and reviewed list based on priority and potential effect. Each item summarizes the problem and includes any known workarounds, along with a link to the GitHub issue (if applicable). We welcome any comments or proposed solutions.
For more information about an issue, contact us on the forum.
TLS: IP addresses in the X.509 certificate subjectAltNames
- Description: Parsing IP addresses in the X.509 certificate subjectAltNames is not supported yet. In certificate chains relying on IP addresses in subjectAltNames a
BADCERT_CN_MISMATCH
error is returned. - Workaround: merge branch https://github.com/ARMmbed/mbedtls/tree/iotssl-602-san-ip into your copy of Mbed TLS before building the application. It is still in EXPERIMENTAL stage, use it on your own responsibility!
- Reported Issue: Issue reported by a customer in email.
- Priority: MAJOR
TLS: Mismatch of root CA and issuer of CRL not caught
- Description: The
x509_crt_verifycrl()
function ignores the CRL, when the CRL has an issuer different from the subject of root CA certificate. - Workaround: Make sure that the issuer of the CRL and the root CA certificate's subject are the same before passing them to
x509_crt_verifycrl()
. - Reported Issue: Reported by a partner.
- Priority: MAJOR
TLS: Self Test Failure with Some Hardware Accelerators
- Description: Most HW acceleration engines (if not all) require the parameters to be from contiguous memory.
All the self tests use test vectors that are defined in the .bss section, which means these are not contiguous. This causes the self test to possibly fail, when implementing HW accelerated engines. - Workaround: There are no known workarounds.
- Reported Issue: Reported by the development team.
- Priority: MAJOR
TLS: Hardware-accelerated hash creates CBC padding oracle in TLS
- Description: The current countermeasures against CBC padding oracle attacks in Mbed TLS call a low level internal API. The implementation of this API might not be possible with the hardware accelerator API and even if it is, the timing might still have detectable differences. The lower level API is called out of sequence and accelerators that are not aware of this might crash.
- Workaround: Keep
MBEDTLS_SSL_ENCRYPT_THEN_MAC
enabled inmbedtls/config.h
and enable the Encrypt-then-MAC extension (RFC7366) on the peers side. - Reported Issue: Reported by the development team.
- Priority: MAJOR
Crypto: Mbed OS ATECC608A example fails to build with IAR
- Description: The current ATECC608A secure element example fails to build with the IAR toolchain. The Microchip-provided cryptoauthlib library does not build with IAR.
- Workaround: Use a different toolchain, like GCC_ARM.
- Reported Issue: MicrochipTech/cryptoauthlib#116
- Priority: Minor
Wi-SUN Hardfaults with IAR compiled image with Mbed OS 5.15.0
- Description: Mesh Wi-SUN FAN may HardFault in rare occasions with IAR8 compiled binaries during initial network connection.
- Workaround: The workaround is to use other compilers.
- Reported Issue: IOTTHD-3898
- Priority: Major
Contents
Ports for Upcoming Targets
14746
STM32WB: introduce STM32WB15CC NUCLEO
14441
M2354: Support Nuvoton's new target
Fixes and Changes
14801
BKE: fix statements outside correct feature guard blocks
14797
run example-tls on faster K64F board (than K66F)
14772
Improve implementation of Mbed TLS timing
14768
Update mbed-coap to version v5.1.11
14767
connectivity tests: early skip fix
14765
Fix unittest check
14760
mbedtls: Rename Mbed timing implementation
14756
mbedtls: Add an alt implementation of timing
14753
Add mbed prefix into atomic
14752
LWIP Broadcast socket option added
14750
Increase SPI stack size to 2048 for BlueNrg driver
14749
Fcntl setting improvement,
14748
Correct ufsi timing calculation
14747
BLE: fix advertising set termination event
14746
STM32WB: introduce STM32WB15CC NUCLEO
14743
Nuvoton: Support watchdog on M251/M261 series
14741
MbedTLS: Add definition checks for TRNG
14740
Fix 'netsocket: several dynamic allocation results not checked' (#14210)
14739
M2354: Substitute HIRC for HXT to clock PLL
14738
Gate ticker (timer0) clock on deepsleep for MAX32620FTHR
14737
BLE: Add cmake unittest fakes for BLE and events
14736
STM32 USB: update init
14734
STM32WL LORA: HW specific out of STM32WL_LoRaRadio class
14733
STM32H7 ADC : dual pad feature update
14729
tools/STM32 Modified Python script generates Peripheral Pins
14724
STM32G0: correct voltage scaling control
14722
STM32 TRNG: update init to match all configs
14721
Nuvoton: Enable no HXT/LXT configurability
14720
STM32L5: corrected voltage scaling when using MSI
14713
lgtm: Add initial LGTM configuration file
14710
BLE: support non-low power devices
14709
CMake: Remove forgotten debug message
14708
test: Fix function does not return a value warnings
14705
Fix frozen tools check never failing
14704
Pin name tests update
14702
Silence expansion-to-defined for nrfx
14701
Add Travis test to make sure text files are UTF-8 encoded
14699
STM32 astyle format
14698
STM32: Fixed I2C Bug
14697
TESTS: rename variable interface to fix broken tests
14693
Fix compilation errors with kvstore - TDB_INTERNAL option to store BLE bonding info
14692
STM32WB: improve FLASH size
14691
Add GitHub action for issue triaging script
14689
Information on Asynchronous SPI limitation on High Speeds
14687
STM32L5 update drivers version to CUBE V1.4.0
14686
STM32: correct __cplusplus brackets
14684
Fix missing as_entry
method in KVStoreSecurityDb
14683
Baremetal tests: enable BLE tests with NUCLEO_WB55RG
14678
Serial: remove shadowing member variables
14675
i2c: start()
should aquire the bus
14674
Update mbed-coap to version v5.1.10
14672
BLE: Fix advertising start and stop
14671
enable aws example test in CI
14670
STM32: add information in README for SLEEP feature
14669
STM32L152: Added ADC Bank_B functionality
14668
Driver: I2C: STM32F2/STM32F4/STM32L1: Fix alternate i2c read.
14667
Update GCC except.S to support ARMC6 and use GCC assembly with ARM toolchain in CMake
14665
Travis: Move frozen tools check to the end
14664
Enable FlashIAP for MCU_NRF52832
14662
Add CANMessage deep comparison operators
14659
STM32: make i2c_salve_read return the number of bytes read
14652
tls: Upgrade to Mbed TLS v2.25.0
14629
Mesh api: Added PHY mode, channel plan IDs and configuration functions
14617
Add legacy I2C/SPI pin aliases
14608
STM32H7 update drivers version to CUBE V1.9.0
14593
STM32F7 update drivers version to CUBE V1.16.1
14592
STM32G4 update drivers version to CUBE V1.4.0
14574
Fix string buffer length in UUID trace helper
14547
CMake: Remove all unittest.cmake script from test suite
14536
STM32: Add LP_TICKER and US_TICKER optimisation macro
14471
COMPONENT_WHD: make reusable code available for other targets
14441
M2354: Support Nuvoton's new target
14221
Enable the RWW function of Macronix Flash MX25LW51245G in OSPI block device driver
Test Report
Release automated CI test
In addition to regular Pull Request tests and Nightly test, we also ran a nightly release test on mbed-os 6.12.0-RC1
Results for the tests we run in CI on mbed-os 6.12.0-RC1 (nightly):
- Build Greentea ARMC6 - SOME FAILS (Issue: MBEDOSTEST-1163 - ARMC6 Failed to build mbed OS with LTO options)
- Build Greentea GCC_ARM - ALL PASSED
- Build Examples ARMC6 - ALL PASSED
- Build Examples GCC_ARM - ALL PASSED
- Build Cloud Examples ARMC6 - ALL PASSED
- Build Cloud Examples GCC_ARM - ALL PASSED
- Build CMAKE Examples ARMC6 - ALL PASSED
- Build CMAKE Examples GCC_ARM - ALL PASSED
- Build CMAKE Cloud Examples ARMC6 - ALL PASSED
- Build CMAKE Cloud Examples GCC_ARM - ALL PASSED
- Unittest Test matrix - ALL PASSED
- GreenTea test matrix - ALL PASSED
- Examples test matrix - ALL PASSED
- CMAKE Examples test matrix - ALL PASSED
- Exporter Test - SOME FAILS (Issue: IOTCORE-1663 - Nightly: Export uvision failing with missing context fault handler)
- Cloud Client integration Test - ALL PASSED
- Memory Usage Test - ALL PASSED
Toolchain Coverage
In the mbed OS 6.12.0 release. we are testing the following toolchains:
- ARM compiler 6.15.0
- GCC_ARM 9-2019-q4-major
Targets Coverage
In mbed-os 6.12.0, the compilation test targets scope has not changed and remains all mbed OS enabled targets.
At the time of the mbed-os 6.12.0 release, we run the greentea tests on the following targets:
- ARM_MUSCA_S1
- DISCO_L457VG_IOT01A
- K64F
- K66F
- NRF52840_DK
- NUCLEO_F429ZI
- NUCLEO_F767ZI
- NUCLEO_WB55RG
- FPGAs on K64F, NRF52840_DK, NUCLEO_F429ZI, NUCLEO_F767ZI, NUCLEO_WB55RG, and DISCO_L457VG_IOT01A
We have the following issues on the test jobs:
- MBEDOSTEST-1163 - ARMC6 Failed to build mbed OS with LTO options
- IOTCORE-1663 - Nightly: Export uvision failing with missing context fault handler
Test Numbers
Greentea test number 1723 (+2)
Unittest number 741 (-1)
Code Coverage
Test Code Coverage been tracked and information is published on COVERALLS
Memory Monitoring
Observed no significant changes from mbed-os-6.11.0
Using this release
You can fetch this release from the mbed-os GitHub repository, using the tag "mbed-os-6.12.0".
If you need any help with this release please visit our support page, which provides reference links and details of our support channels.