This is the guide you need to have the PLC01A1 module working with stm32mp157* board. The module is this one.

1. Run Linux on the Board
2. Run FORTE on the Board
3. Enable SPI in the board
4. Some good info

Run Linux on the Board

1. Follow the guide here so you have a running linux on your board and get to know the board by accessing it using the serial port first. To connect the NUCLEO PLC01A1 extension board, follow this tutorial. Be careful that the extension board needs 24V which could damage the STM32 board. Read carefully the documentation to know where the 24V is used.

Run FORTE on the Board

1. Follow the instruction here to download the SDK to a Ubuntu machine, and set the cross-compilers as default for the terminal session.
2. Clone the FORTE repository and compile as usual.
3. Change the IP of the board by executing:
   ip addr add XXX.XXX.XXX.XXX/MM dev eth0
   which will set the ip according to what you use in the XXX and the YY, which is a two-digit number representing the mask.
4. Test with a simple application without IOs, and monitor it from the IDE.

Enable SPI in the board

1. Check the file being called when the board boots. For that, connect to it using the USB cable for serial communication to the stm32 board using 115200 for the speed. Establish a connection and reboot the board. You'll see something similar to:
   Found /mmc0_stm32mp157a-dk1_extlinux/extlinux.conf Retrieving file: /mmc0_stm32mp157a-dk1_extlinux/extlinux.conf
   You see in this case that the board is stm32mp157a-dk1 and the configuration file being used is /mmc0_stm32mp157a-dk1_extlinux/extlinux.conf or something similar.
2. Follow the guide here and compile the Linux image. It's a big step.
3. Once you are able to compile it, you need to change some things depending on your board. Go to the folder arch/arm/boot/dts of the linux source code and you will find some files stm32mp157* with a .dts extension. You need to edit the one you saw on your board when booting. (some users complained that the booting file didn't match the actual board they had, so checking at boot time is safer). In the file you'll see some blocks inside curly brackets {}. The first one has a slash / before opening it. After this whole block (it ends with "};") you need to add the following text in a new line:
   &spi4 { pinctrl-names = "default"; pinctrl-0 = <&spi4_pins_a>; status = "okay"; cs-gpios = <&gpioh 6 GPIO_ACTIVE_LOW>, <&gpioe 11 GPIO_ACTIVE_LOW>; /* Usage of CS1 and CS2 */ CLT01-38SQ7@0 { /* INPUTS */ compatible = "spidev"; reg = <0>; /* CS1 */ spi-max-frequency = <6250000>; }; VNI8200XP@1 { /* OUTPUTS */ compatible = "spidev"; reg = <1>; spi-max-frequency = <5000000>; }; };
4. Recompile the Linux Image and you'll get a new .dtb file for your board.
5. Put this file in the board in the folder /boot. You can use a scp client for it. Use a different name so you don't overwrite the original one, just in case.
6. You need then to edit the booting file, which selects the .dtb file to be loaded. So you need to change the file mmc0_stm32mp157a-dk1_extlinux/extlinux.conf or mmc0_stm32mp157c-dk2_extlinux/ extlinux.conf inside the /boot folder depending on what you saw before
7. There, you need to add a new LABEL at the end and its configuration. You can copy from the first one and change it accordingly. You need to change the LABEL to some desired name (for example FORTE_SPI) and the FDT name, which should point to the .dtb file you just copied. It should look something like the following (pay attention to the FDT field which should match the one you are using):
   LABEL FORTE_SPI KERNEL /uImage FDT /stm32mp157a-dk1-SPI4.dtb APPEND root=/dev/mmcblk0p6 rootwait rw console=ttySTM0,115200
   or
   LABEL FORTE_SPI KERNEL /uImage FDT /stm32mp157c-dk2-SPI4.dtb APPEND root=/dev/mmcblk0p6 rootwait rw console=ttySTM0,115200
8. In the same file, there's a line which says DEFAULT followed by some text. If there's none, add it before the first label. Change this text to FORTE_SPI (or whatever name you used in your LABEL). Be careful in leaving no blank space after your text. The line should look something like this:
   DEFAULT FORTE_SPI
9. Reboot the board.
10. You need then to enable the output directly, which should be done everytime the board boots, so you can put the following command in some script (the best idea is to have it in the same script that starts forte at boot)
    gpioset gpiochip4 9=1
    That's it. You can check that you have enabled the spi by doing
    ls -l /sys/class/spidev
    which should show two files.
11. To access the IOs, you need to use the special FB called PLC01A1 in the IDE.

Some good info

• Start forte at boot: Make sure that you can start your forte manually, and then create a script file that executes it and put it in the folder /usr/local/weston-start-at-startup and give this file execution permissions. An example of the script to start forte, assuming the forte file is in /home/root/
  #!/bin/bash FOLDER=/home/root/ sleep 5 # Enable output gpioset gpiochip4 9=1 # Execute forte cd ${FOLDER} if [ -f ./currentLog.txt ]; then mv ./currentLog.txt ./lastLog.txt fi ./forte > ./currentLog.txt 2>&1 &
  which saves the current log and the previous one, in case the board reboots.

Where to go from here?

You can see the supported protocols:

Supported Communication Protocols

You can see the examples:

4diac Examples

If you want to go back to the Where to Start page, we leave you here a fast access

Where to Start

Or Go to top