STM32WB : update Readme

Author: jeromecoutant

targets/TARGET_STM/README.md

@@ -74,7 +74,7 @@ This table summarizes the STM32Cube versions currently used in Mbed OS master br
 | L1          |    1.10.2    | https://github.com/STMicroelectronics/STM32CubeL1 |
 | L4          |    1.16.0    | https://github.com/STMicroelectronics/STM32CubeL4 |
 | L5          |    1.3.0     | https://github.com/STMicroelectronics/STM32CubeL5 |
-| WB          |    1.8.0     | https://github.com/STMicroelectronics/STM32CubeWB |
+| WB          |    1.11.1    | https://github.com/STMicroelectronics/STM32CubeWB |
 | WL          |    1.0.0     | https://github.com/STMicroelectronics/STM32CubeWL |
 
 In Mbed OS repository, we try to minimize the difference between "official" and copied files.

targets/TARGET_STM/TARGET_STM32WB/README.md

@@ -1,3 +1,14 @@
+* [STM32WB family](#stm32wb-family)
+* [Supported boards](#supported-boards)
+   * [NUCLEO_WB55RG](#nucleo_wb55rg)
+   * [DISCO_WB5MMG (STM32WB5MM-DK)](#disco_wb5mmg-stm32wb5mm-dk)
+* [BLE](#ble)
+   * [MBED-OS support](#mbed-os-support)
+   * [mbed-trace support](#mbed-trace-support)
+   * [BLE FW update](#ble-fw-update)
+   * [BLE FW flashing procedure](#ble-fw-flashing-procedure)
+
+
 # STM32WB family
 
 [st.com STM32WB family page](https://www.st.com/en/microcontrollers-microprocessors/stm32wb-series.html)
@@ -9,13 +20,15 @@ This ST MCU family is dual-core : based on an Arm Cortex-M4 core and an Arm Cort
 
 # Supported boards
 
-## NUCLEO_WB55RG
+## NUCLEO_WB55RG (NUCLEO-WB55RG)
 
 [st.com STM32WB55RG MCU page](https://www.st.com/en/microcontrollers-microprocessors/stm32wb55rg.html)
 
-[st.com NUCLEO page](https://www.st.com/en/evaluation-tools/p-nucleo-wb55.html)
+[st.com NUCLEO board page](https://www.st.com/en/evaluation-tools/nucleo-wb55rg.html)
 
-[mbed.com NUCLEO page](https://os.mbed.com/platforms/ST-Nucleo-WB55RG/)
+[st.com Pack board page](https://www.st.com/en/evaluation-tools/p-nucleo-wb55.html)
+
+[mbed.com platform page](https://os.mbed.com/platforms/ST-Nucleo-WB55RG/)
 
 - Total FLASH is 1MB, but note that it is shared by M4 and M0 cores.
     - mbed-os application size is then limited to 768 KB
@@ -30,6 +43,32 @@ SRAM1 is dedicated for M4 core, and then for mbed-os applications.
 SRAM2 is dedicated for M0 core and inter CPU communication, and then can not be addressed.
 
 
+## DISCO_WB5MMG (STM32WB5MM-DK)
+
+[st.com STM32WB5MMG module page](https://www.st.com/en/microcontrollers-microprocessors/stm32wb5mmg.html)
+
+[st.com DISCO board page](https://www.st.com/en/evaluation-tools/stm32wb5mm-dk.html)
+
+[mbed.com platform page](https://os.mbed.com/platforms/DISCO-WB5MMG/)
+
+- Total FLASH is 1MB, but note that it is shared by M4 and M0 cores.
+    - mbed-os application size is then limited to 768 KB
+
+- RAM: 256 KB
+    - SRAM1: 192 KB
+    - SRAM2a: 32 KB
+    - SRAM2b: 32 KB
+
+SRAM1 is dedicated for M4 core, and then for mbed-os applications.
+
+SRAM2 is dedicated for M0 core and inter CPU communication, and then can not be addressed.
+
+NB: MBED CLI1 tool can be used thanks to this command:
+```
+mbedls -m 0884:DISCO_WB5MMG
+```
+
+
 # BLE
 
 ## MBED-OS support
@@ -41,8 +80,8 @@ Note that the BLE controller firmware running on the cortex-M0 is the same as in
 - within mbed, the controller will run only the below-HCI part
 - within STcubeFW (and STM32WPAN middleware), it can run also up to GATT / GAP layers ...
 
-Official ST Application Note AN5289: Building wireless applications with STM32WB Series microcontrollers :
-https://www.st.com/resource/en/application_note/dm00598033-building-wireless-applications-with-stm32wb-series-microcontrollers-stmicroelectronics.pdf
+Official ST Application Note : 
+[AN5289: Building wireless applications with STM32WB Series microcontrollers](https://www.st.com/resource/en/application_note/dm00598033-building-wireless-applications-with-stm32wb-series-microcontrollers-stmicroelectronics.pdf)
 
 
 
@@ -52,19 +91,19 @@ trace group: BLE_WB
 
 example:
 ````
-[INFO][BLE_WB]: WIRELESS COPROCESSOR FW VERSION ID = 1.8.0
-[INFO][BLE_WB]: WIRELESS COPROCESSOR FW STACK TYPE = 1
-[DBG ][BLE_WB]: mbox_write type:1, len:3
-[INFO][BLE_WB]: TX>> BLE CMD
-[DBG ][BLE_WB]:   Type 0x1
-[DBG ][BLE_WB]:    Cmd 0xc03
-[DBG ][BLE_WB]:    Len 0D]
+[INFO][BLWB]: WIRELESS COPROCESSOR FW VERSION ID = 1.11.1
+[INFO][BLWB]: WIRELESS COPROCESSOR FW STACK TYPE = 1
+[DBG ][BLWB]: mbox_write type:1, len:3
+[INFO][BLWB]: TX>> BLE CMD
+[DBG ][BLWB]:   Type 0x1
+[DBG ][BLWB]:    Cmd 0xc03
+[DBG ][BLWB]:    Len 0D]
 ````
 
 ## BLE FW update
 
-Official ST Application Note AN5185: ST firmware upgrade services for STM32WB Series :
-http://www.st.com/st-web-ui/static/active/en/resource/technical/document/application_note/DM00513965.pdf
+Official ST Application Note : 
+[AN5185: ST firmware upgrade services for STM32WB Series](http://www.st.com/st-web-ui/static/active/en/resource/technical/document/application_note/DM00513965.pdf)
 
 Latest BLE FW :
 https://github.com/STMicroelectronics/STM32CubeWB/blob/master/Projects/STM32WB_Copro_Wireless_Binaries/STM32WB5x/stm32wb5x_BLE_Stack_full_fw.bin
@@ -105,7 +144,7 @@ Firmware delete finished
 fwdelete command execution finished
 ```
 
-- STEP 4 : Read and upgrade FUS Version
+- STEP 4 : Read FUS Version
 
 ```
 $ STM32_Programmer_CLI.exe -c port=usb1 -r32 0x20030030 1
@@ -121,17 +160,19 @@ Reading 32-bit memory content
 - STEP 5A if last result is 00050300 : Download new FUS :
 
 ```
-$ ./STM32_Programmer_CLI.exe -c port=usb1 -fwupgrade stm32wb5x_FUS_fw_1_0_2.bin 0x080EC000 firstinstall=0
+$ ./STM32_Programmer_CLI.exe -c port=usb1 -fwupgrade stm32wb5x_FUS_fw_for_fus_0_5_3.bin 0x080EC000 firstinstall=0
 ```
 
 - STEP 5B if last result is 01000100 or 01000200 : Download new FUS :
 
 ```
 $ STM32_Programmer_CLI.exe -c port=usb1 -fwupgrade stm32wb5x_FUS_fw.bin 0x080EC000 firstinstall=0
+...
+Firmware Upgrade Success
 ```
 
 
-- STEP 4 (to check) : Read and upgrade FUS Version
+- STEP 4 (to check) : Read FUS Version
 
 ```
 $ STM32_Programmer_CLI.exe -c port=usb1 -r32 0x20030030 1
@@ -140,14 +181,14 @@ Reading 32-bit memory content
   Size          : 4 Bytes
   Address:      : 0x20030030
 
-0x20030030 : 01010000
+0x20030030 : 01020000
 ```
 
 - STEP 6 : Download new wireless stack :
 
 
 ```
-$ STM32_Programmer_CLI.exe -c port=usb1 -fwupgrade stm32wb5x_BLE_Stack_full_fw.bin 0x080CB000 firstinstall=1
+$ STM32_Programmer_CLI.exe -c port=usb1 -fwupgrade stm32wb5x_BLE_Stack_full_fw.bin 0x080CA000 firstinstall=1
 
 ...
 Download firmware image at address 0x80cb000 ...