Agenda
- Install an OS on a coupler
- Test connection between a Coupler and a MOD-IO device
Requirements
- a host laptop machine for flashing image to SD card
- a coupler and attached to it a MOD-IO device
- a Micro-SD card with minimal capacity of 16Gb
- an USB OTG cable for serial connection to coupler
Goal
At end of this how to you will have a coupler device with an operating system (OS) which you can use in your automation project. This OS will contain the bare minimum of tools needed.
Install an OS on a coupler
Please follow this procedure on you laptop machine in order to flash image to SD card. First we need to download the Debian 11 which is the currently supported image from the coupler board producer.
Step 1: Download Debian Bullseye base Olimex image repository
ivan@t470:~$ wget
http://images.olimex.com/release/stm32-lime/STM32MP1-OLinuXino-LIME-bullseye-base-20240312-135508.img.7z
Step 2: Extract archive
ivan@t470:~$ 7z e
STM32MP1-OLinuXino-LIME-bullseye-base-20240312-135508.img.7z
Step 3: Flash image to your micro SD card
Using balenaEtcher (or any other tool) flash extracted .img file to your SD card Put the SD card into Lime2 board and NOT into STMP15X-SHIELD! Power up Lime2 wait till you see a green light at the board (maybe you do not see green light at all). Connect to serial connection over USB OTG cable from your laptop
(if you use dd to flash an image to sd card)
root # dd if=STM32MP1-OLinuXino-LIME-bullseye-base-20240312-135508.img of=/dev/YOUR_DEVICE bs=64k oflag=dsync status=progress
root@t470:~$ minicom -D /dev/ttyACM0 # username and password are olimex / olimex by default
(if you use screen)
$ screen /dev/ttyACM0 115200
Note: the initial first boot of your board might take 2-3 minutes. This happens only once!
Make sure that coupler is properly connected to your local LAN (either over RJ45 cable or Wifi). Take a note of assigned IPv4 address of the coupler as you will later connect over ssh to it You are done. Host machine should no longer be needed.
Default coupler configuration
Please follow this procedure
Step 4: Login into coupler and update base software
ssh olimex@<ipv4_address>
(password: is olimex. Please immediately change default username and password)
Update software of coupler
olimex@stm32mp1-olinuxino:~# sudo bash
root@stm32mp1-olinuxino:~# apt update
root@stm32mp1-olinuxino:~# apt upgrade
Step 5: Add Olimex's staging repository
Edit /etc/apt/sources.list.d/olimex.list and add following line
deb http://staging.olimex.com/staging bullseye main
Do distribution upgrade.
root@stm32mp1-olinuxino:~# apt update
root@stm32mp1-olinuxino:~# apt dist-upgrade
Step 6: Enable overlays and restart
Select following overlays: lcd-stm32mp1-10cts.dtbo, lcd-stm32mp1-5.dtbo, lcd-stm32mp1-7cts.dtbo, stm32mp1-hdmi.dtbo, stm32mp1-shield.dtbo, stm32mp1-spi2.dtbo, stm32mp1-spi4.dtbo, stm32mp1-usart1.dtbo, stm32mp1-usart3.dtbo from command below
root@stm32mp1-olinuxino:~# olinuxino-overlay
root@stm32mp1-olinuxino:~# reboot now
Test connection between a Coupler and a MOD-IO device
These steps assure that the coupler can switch on / off relays of attached MOD-IO. Please follow the following steps:
# switch ON all relays, you should hear a ticking noise and relays led should change color to GREEN
root@stm32mp1-olinuxino:~# i2cset -y -f 1 0x58 0x10 0x0F
# switch OFF all relays, you should hear a ticking noise and relays led should become OFF
root@stm32mp1-olinuxino:~# i2cset -y -f 1 0x58 0x10 0x00
Success
With this the minimal coupler OS configuration is over.