Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/stm32-hotspot/stm32mp1-otbr-posix

Linux package for Openthread Border Router (OTBR) working with a Radio Co-Processor (RCP) STM32WB55 through a serial connection (FTDI) between STM32MPU and STM32WB. This meta-layer provides all recipes needed to compile "ot-br-posix".
https://github.com/stm32-hotspot/stm32mp1-otbr-posix

ftdi matter openthread openthread-border-router otbr posix stm32 stm32mp1 yocto

Last synced: about 2 months ago
JSON representation

Linux package for Openthread Border Router (OTBR) working with a Radio Co-Processor (RCP) STM32WB55 through a serial connection (FTDI) between STM32MPU and STM32WB. This meta-layer provides all recipes needed to compile "ot-br-posix".

Awesome Lists containing this project

README 

        
# X-LINUX_OTBR_POSIX Linux Package



![latest tag](https://img.shields.io/github/v/tag/stm32-hotspot/stm32mp1-otbr-posix.svg?color=brightgreen)



The X-LINUX_OTBR_POSIX is a linux Package running on STM32MPU and tested on STM32MP157F-DK2. Openthread Border Router(OTBR) work with Radio Co Processor(RCP) STM32WB55 through a serial connection (FTDI) between STM32MPU and STM32WB. This meta-layer provide all recipes needed to compile ot-br-posix "https://github.com/openthread/ot-br-posix" on stm32mpu. 



Two cases for RCP  are available  :



  Matter/Openthread : Follow this github       [RCP-MATTER](https://github.com/stm32-hotspot/stm32wb-matter-device-over-thread/tree/main/Projects/P-NUCLEO-WB55.Nucleo/Binary_Thread_RCP)



  Openthread standalone : Follow this github   [RCP-OPENTHREAD](https://github.com/STMicroelectronics/STM32CubeWB/tree/v1.16.0/Projects/P-NUCLEO-WB55.Nucleo/Applications/Thread/Thread_RCP)



## Keywords 

OpenThread, OTBR, WI-FI, Internet of Things, Network, Connectivity, commissioning, CSA, Connectivity Standard Alliance, STM32MP1, P-NUCLEO-WB55 ,MATTER, CHIP, IoT.



## Release note

Details about the content of this release are available in the release note [here](https://htmlpreview.github.io/?https://github.com/stm32-hotspot/stm32mp1-otbr-posix/blob/main/Release_Notes.html).



## Boards Needed

 * Openthread Boarder Router 

    * [STM32MP157F-DK2](https://www.st.com/en/evaluation-tools/stm32mp157f-dk2.html)



  * as Thread RCP firmware P-NUCLEO-WB55  ST Radio Co-Processor (RCP) if used

    * [NUCLEO-WB55RG](https://www.st.com/en/evaluation-tools/nucleo-wb55rg.html) 

	

## System Requirements 

A Linux® PC running under Ubuntu® 18.04 or 20.04 is to be used. The developer can follow the below link. https://wiki.st.com/stm32mpu/wiki/PC_prerequisites



## BUILD: 



This is required to build the recipes and create STM32MP1 images (see https://wiki.st.com/stm32mpu/wiki/STM32MP1_Distribution_Package). 



Create source folder



```

PC $> mkdir ~/stm32mp1_openthread 

```

```

PC $> cd stm32mp1_openthread

``` 



Initialize repo in the current directory



```

PC $> repo init -u https://github.com/STMicroelectronics/oe-manifest.git -b refs/tags/openstlinux-5.15-yocto-kirkstone-mp1-v22.11.23

```



Synchronize the local project directories with the remote repositories specified in the manifest (more details on 'repo sync' here)



```

PC $> repo sync

```



Get the STM32MP1 OTBR repository



```

PC$> git clone "https://github.com/stm32-hotspot/stm32mp1-otbr-posix.git"

```



Initializing the OpenEmbedded build environment



:computer: For MP15, the line below :computer:

```

PC $> DISTRO=openstlinux-weston MACHINE=stm32mp1 source layers/meta-st/scripts/envsetup.sh

```



:computer: For MP13, the line below :computer:



```

PC $> DISTRO=openstlinux-weston MACHINE=stm32mp13-disco source layers/meta-st/scripts/envsetup.sh

```



Prepare the Yocto layer related to OBTR



```

PC$> cp -R ../stm32mp1-otbr-posix/meta-otbr ../layers/meta-st/

```



```

PC$> bitbake-layers add-layer ../layers/meta-st/meta-otbr

```



Build the ST32MP1 image (this might take several hours to complete depending on your network connection and your PC performance)



```

PC$> bitbake st-image-otbr

```



## Flashing the built image (STM32MP157F-DK2)



The *build--/tmp-glibc/deploy/images/stm32mp1* directory receives complete file system images.



Note that the build of the Distribution Package generates the images and the Flash layout files 



https://wiki.stmicroelectronics.cn/stm32mpu/wiki/STM32MP157x-DKx_-_hardware_description#Boot_related_switches



1. MB1272 motherboard: STM32MP157x 12x12, PMIC, DDR3

2. MicroSD card slot

3. 2 x USB Type-A (host) → mouse, keyboard or USB driver

4. 2 x USB Type-A (host) → mouse, Keyboard or USB driverUSB

5. micro-B (ST-LINK/V2-1) → PC virtual COM port and debug

6. Reset button

7. Ethernet → Network

8. USB Type-C (power 5V-3A)



![UG_IMAGE_1](Image/STM32MP157x-DKx_connections.png) 



Let's flash the downloaded image on the microSD card:

* Set the boot switches (1) to the off position

* Connect the USB Type-C™ (OTG) port (2) to the host PC that contains the downloaded image

* Insert the delivered microSD card into the dedicated slot (3)

* Connect the delivered power supply to the USB Type-C™ port (4)

* Press the reset button (5) to reset the board



![UG_IMAGE_2](Image/STM32MP157x-DKx_flashing_configuration.png) 



1. Launch STM32CubeProgrammer to get the GUI

2. On the top right of the window, select USB (instead of STLINK, set by default) in the connection picklist and click the "Refresh" button. The serial number is displayed if the USB is detected. Then click "Connect".



![UG_IMAGE_3](Image/STM32CubePro_GUI_210-IMAGE1.png)



3. Refresh and press to Connect 



![UG_IMAGE_4](Image/STM32CubePro_GUI_210_IMAGE2.png)



4. Select the "Open File" tab and choose the "FlashLayout_sdcard_stm32mp157f-dk2-optee.tsv"  through this path  **build--/tmp-glibc/deploy/images/stm32mp1/flashlayout_st-image-otbr/extensible**



5. Fill the "Binaries Path" by browsing to the **build--tmp-glibc/deploy/images/stm32mp1/**



![UG_IMAGE_5](Image/STM32CubePro_GUI_210_FileSelectedOptee_IMAGE3.png)



command lines can be run from Terminal through USB with st-link 



Note: in this article, any command executed on the board (through the remote Terminal or the Wayland Terminal) starts with BOARD$> , while any command executed on the host PC starts with PC$> 



## Flashing the built image(STM32MP135F-DK)



The *build-openstlinux-weston-stm32mp13-diso/tmp-glibc/deploy/images/stm32mp13-disco* directory receives complete file system images.



Note that the build of the Distribution Package generates the images and the Flash layout files 



[https://wiki.stmicroelectronics.cn/stm32mpu/wiki/STM32MP157x-DKx_-_hardware_description#Boot_related_switches](https://wiki.stmicroelectronics.cn/stm32mpu/wiki/STM32MP135x-DK_-_hardware_description#Boot_related_switches)



* MB1635 motherboard: STM32MP135F 11x11, PMIC, DDR3 (1)

* USB micro-B (ST-LINK/V2-1) → PC virtual COM port and debug (11)

* Reset button (17)



![UG_IMAGE_1](Image/STM32MP13F-DK-IMAGE1.png)



* MicroSD card slot (31)

* 4x USB Type-A (host) → mouse, keyboard or USB driver (35)

* Ethernet → Network (30, 32)

* USB Type-C Programming port (33)

* USB Type-C Power (5V-3A) (34)



![UG_IMAGE_2](Image/STM32MP13F-DK-IMAGE2.png)



Let's flash the downloaded image on the microSD card 

* Set the boot switches to the OPEN position as in the picture below



![UG_IMAGE_3](Image/STM32MP135x-DK_boot_switches_flash.png)



* Connect the USB Type-C™ (OTG) port (33) to the host PC that contains the downloaded image

* Insert the delivered microSD card into the dedicated slot (31)

* Connect the power supply to the USB Type-C™ port (34)

* Press the reset button (17) to reset the board

* Launch STM32CubeProgrammer to get the GUI

* On the top right of the window, select USB (instead of STLINK, set by default) in the connection picklist and click the "Refresh" button. The serial number is displayed if the USB is detected



![UG_IMAGE_3](Image/STM32CubePro_GUI_210-IMAGE1.png)



* Then click “Connect”



![UG_IMAGE_4](Image/STM32CubePro_GUI_210_IMAGE2.png)



* Select the "Open File" tab and choose the "FlashLayout_sdcard_stm32mp135f-dk-extensible.tsv" through this path **"build-openstlinux-weston-stm32mp13-

diso/tmp-glibc/deploy/images/stm32mp13-disco/flashlayout_st-image-otbr/extensible"**

* Fill the Binaries Path" by browsing to the **"build-openstlinux-weston-stm32mp13-diso/tmp-glibc/deploy/images/stm32mp13-disco”**



![UG_IMAGE_5](Image/STM32CubePro_GUI_210_FileSelectedOptee_IMAGE3.png)



 

Note: in this article, any command executed on the board (through the remote Terminal or the Wayland Terminal) starts with BOARD$> , while any command executed on the host PC starts with PC$> 



## Power up the board



Set the boot switches in SD Card boot mode as in the picture below



:computer: STM32MP157F-DK2



![UG_IMAGE_6](Image/STM32MP157x-DKx_boot_switches_microSD_card.png)



:computer: STM32MP135F-DK



![UG_IMAGE_7](Image/STM32MP135x-DK_boot_switches_boot.png)



* Press the reset button (STM32MP157F-DK2 (6) and STM32MP135F-DK (17))

* The following command lines can be run from a Terminal through USB with ST-LINK (STM32MP157F-DK2 port (5) and STM32MP135F-DK port (11))

  

## Getting board IP address with Ethernet 



 plug in ethernet cable (7)



```

 BOARD$> ip addr show eth0

 eth0:  mtu 1500 qdisc mq state UP group default qlen 1000

    link/ether xx:xx:xx:xx:xx:xx brd ff:ff:ff:ff:ff:ff

    inet xx.xx.xx.xx/xx brd xx.xx.xx.xx scope global dynamic eth0

       valid_lft 159045sec preferred_lft 159045sec

    inet6 xxxx::xx:xx:xx:xx/xx scope link 

       valid_lft forever preferred_lft forever

```



## Wlan Network attachment



```

BOARD$>  ifconfig wlan0 up

```



```

BOARD$>  ifconfig wlan0 

         wlan0     Link encap:Ethernet  HWaddr 60:F1:89:3F:F6:0E  

            inet addr:192.168.43.135  Bcast:192.168.43.255  Mask:255.255.255.0

            UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1                   /* UP indicate that your interface is UP */

            RX packets:19 errors:0 dropped:0 overruns:0 frame:0

            TX packets:19 errors:0 dropped:0 overruns:0 carrier:0

            collisions:0 txqueuelen:1000 

            RX bytes:1774 (1.7 KiB)  TX bytes:2326 (2.2 KiB)

```



Scan available SSID (Access Point):



```

BOARD$> iw dev wlan0 scan | grep SSID

        SSID: NETWORK1

        SSID: NETWORK2

```



Set the Wi-Fi network name and password:



```

BOARD$> wpa_passphrase   >> /etc/wpa_supplicant.conf

```



Check new configuration:



```

BOARD$> cat /etc/wpa_supplicant.conf

        ctrl_interface=/var/run/wpa_supplicant

        ctrl_interface_group=0

        update_config=1

        network={

         ssid="your_ssid_name"

         psk="your_ssid_key"

      }

```



Connect to SSID:



```

BOARD$> wpa_supplicant -B -iwlan0 -c /etc/wpa_supplicant.conf

```



link to SSID:



```

BOARD$> iw wlan0 link

        SSID: NETWORK1

        freq: 2462

        RX: 501 bytes (3 packets)

        TX: 4056 bytes (22 packets)

        signal: -75 dBm

        tx bitrate: 12.0 MBit/s

        bss flags:      short-preamble short-slot-time

        dtim period:    1

        beacon int:     100

```



For more information : https://wiki.st.com/stm32mpu/wiki/How_to_setup_a_WLAN_connection



## Configuration otbr-posix on STM32MP1



At first boot you must modify the /usr/bin/otbr_setup.sh as described below (remove the bold line)



mydir=/usr/libexec/otbr-install/



**. "${mydir}"/_initrc** <= This need to be removed



. "${mydir}"/_border_routing



. "${mydir}"/_otbr



. "${mydir}"/_ipforward



. "${mydir}"/_nat64



. "${mydir}"/_dns64






For first boot you must config otbr-agent  with this command 



```

BOARD$>  bash /usr/bin/otbr_setup.sh 

```

```

BOARD$>  reboot

```

## Example to setup Border Router 



```

BOARD$>  ot-ctl thread stop 

```



```

BOARD$>  ot-ctl ifconfig down 

```



```

BOARD$>  ot-ctl networkkey 00112233445566778899aabbccddeeff

```



```

BOARD$>  ot-ctl extpanid 1111111122222222

```



```

BOARD$>  ot-ctl panid 1234

```



```

BOARD$>  ot-ctl channel 15 

```



```

BOARD$>  ot-ctl ifconfig up 

```



```

BOARD$>  ot-ctl thread start 

```



Following this link for more information https://openthread.io/guides/