1. Overview[edit source]
This stage explains how to connect the Linux terminal of your board to your host computer through the ST-LINK/V2-1.
Then you can see how to execute basic commands with the Linux command line interface in order to be familiarized with the Linux console.
2. The serial terminal[edit source]
The serial terminal allows you to communicate with the board trough an UART serial interface.
- Install minicom
sudo apt-get install minicom
- Get the ttyACM device instance that needs to be used to access the ST-LINK/V2-1
ls /dev/ttyACM* /dev/ttyACM0
- Connect the minicom to the /dev/ttyACM0 device
minicom -D /dev/ttyACM0 Welcome to minicom 2.7 OPTIONS: I18n Compiled on Nov 15 2018, 20:18:47. Port /dev/ttyACM0, 15:56:03 Press CTRL-A Z for help on special keys
- Press the reset button to reset the board. You should see logs displayed in the minicom window
For ecosystem release v2.1.0 
:
NOTICE: CPU: STM32MP157FAA Rev.Z NOTICE: Model: STMicroelectronics STM32MP157F eval daughter on eval mother NOTICE: Board: MB1263 Var4.0 Rev.C-03 INFO: Reset reason (0x14): INFO: Pad Reset from NRST INFO: PMIC version = 0x20 INFO: Using SDMMC INFO: Instance 1 INFO: Boot used partition fsbl1 NOTICE: BL2: v2.2-r2.0(debug):v2.2-dirty NOTICE: BL2: Built : 13:36:23, Oct 22 2019 INFO: Using crypto library 'stm32_crypto_lib' INFO: BL2: Doing platform setup INFO: RAM: DDR3-DDR3L 32bits 533000Khz INFO: Memory size = 0x40000000 (1024 MB) INFO: BL2 runs SP_MIN setup INFO: BL2: Loading image id 4 INFO: Loading image id=4 at address 0x2ffeb000 INFO: Image id=4 loaded: 0x2ffeb000 - 0x2ffff000 INFO: BL2: Loading image id 5 INFO: Loading image id=5 at address 0xc0100000 INFO: STM32 Image size : 909210 INFO: Image id=5 loaded: 0xc0100000 - 0xc01ddf9a WARNING: Skip signature check (header option) NOTICE: ROTPK is not deployed on platform. Skipping ROTPK verification. NOTICE: BL2: Booting BL32 INFO: Entry point address = 0x2ffeb000 INFO: SPSR = 0x1d3 NOTICE: SP_MIN: v2.2-r2.0(debug):v2.2-dirty NOTICE: SP_MIN: Built : 13:36:23, Oct 22 2019 INFO: ARM GICv2 driver initialized INFO: Set calibration timer to 60 sec INFO: stm32mp IWDG1 (12): Secure INFO: SP_MIN: Initializing runtime services INFO: SP_MIN: Preparing exit to normal world U-Boot 2020.01-stm32mp-r2 (Jan 06 2020 - 20:56:31 +0000) CPU: STM32MP157FAA Rev.Z Model: STMicroelectronics STM32MP157F eval daughter on eval mother Board: stm32mp1 in trusted mode (st,stm32mp157f-ev1) Board: MB1263 Var4.0 Rev.C-03 DRAM: 1 GiB Clocks: - MPU : 800 MHz - MCU : 208.878 MHz - AXI : 266.500 MHz - PER : 24 MHz - DDR : 533 MHz WDT: Started with servicing (32s timeout) NAND: 1024 MiB MMC: STM32 SD/MMC: 0, STM32 SD/MMC: 1 Loading Environment from MMC... OK In: serial Out: serial Err: serial Net: eth0: ethernet@5800a000 Hit any key to stop autoboot: 0 Boot over mmc0! switch to partitions #0, OK mmc0 is current device Scanning mmc 0:4... Found /mmc0_extlinux/stm32mp157f-ev1_extlinux.conf Retrieving file: /mmc0_extlinux/stm32mp157f-ev1_extlinux.conf 706 bytes read in 32 ms (21.5 KiB/s) Retrieving file: /splash.bmp 18244 bytes read in 32 ms (556.6 KiB/s) Select the boot mode 1: OpenSTLinux 2: stm32mp157f-ev1-a7-examples 3: stm32mp157f-ev1-m4-examples Enter choice: 1: OpenSTLinux Retrieving file: /uInitrd 3632201 bytes read in 185 ms (18.7 MiB/s) Retrieving file: /uImage 7341840 bytes read in 342 ms (20.5 MiB/s) append: root=PARTUUID=e91c4e10-16e6-4c0e-bd0e-77becf4a3582 rootwait rw console=ttySTM0,115200 Retrieving file: /stm32mp157f-ev1.dtb 111905 bytes read in 36 ms (3 MiB/s) ## Booting kernel from Legacy Image at c2000000 ... Image Name: Linux-5.4.56 Created: 2020-08-05 7:59:52 UTC Image Type: ARM Linux Kernel Image (uncompressed) Data Size: 7341776 Bytes = 7 MiB Load Address: c2000040 Entry Point: c2000040 Verifying Checksum ... OK ## Flattened Device Tree blob at c4000000 Booting using the fdt blob at 0xc4000000 XIP Kernel Image Loading Ramdisk to cfc89000, end cffffc49 ... OK Loading Device Tree to cfc6a000, end cfc88520 ... OK Starting kernel ... [ 0.000000] Booting Linux on physical CPU 0x0 [ 0.000000] Linux version 5.4.56 (oe-user@oe-host) (gcc version 9.3.0 (GCC)) #1 SMP PREEMPT Wed Aug 5 07:59:52 UTC 2020 [ 0.000000] CPU: ARMv7 Processor [410fc075] revision 5 (ARMv7), cr=10c5387d [ 0.000000] CPU: div instructions available: patching division code [ 0.000000] CPU: PIPT / VIPT nonaliasing data cache, VIPT aliasing instruction cache [ 0.000000] OF: fdt: Machine model: STMicroelectronics STM32MP157F eval daughter on eval mother [ 0.000000] Memory policy: Data cache writealloc [ 0.000000] Reserved memory: created DMA memory pool at 0x10000000, size 0 MiB [ 0.000000] OF: reserved mem: initialized node mcuram2@10000000, compatible id shared-dma-pool [ 0.000000] Reserved memory: created DMA memory pool at 0x10040000, size 0 MiB [ 0.000000] OF: reserved mem: initialized node vdev0vring0@10040000, compatible id shared-dma-pool [ 0.000000] Reserved memory: created DMA memory pool at 0x10041000, size 0 MiB [ 0.000000] OF: reserved mem: initialized node vdev0vring1@10041000, compatible id shared-dma-pool [ 0.000000] Reserved memory: created DMA memory pool at 0x10042000, size 0 MiB [ 0.000000] OF: reserved mem: initialized node vdev0buffer@10042000, compatible id shared-dma-pool [ 0.000000] Reserved memory: created DMA memory pool at 0x30000000, size 0 MiB [ 0.000000] OF: reserved mem: initialized node mcuram@30000000, compatible id shared-dma-pool [ 0.000000] Reserved memory: created DMA memory pool at 0x38000000, size 0 MiB [ 0.000000] OF: reserved mem: initialized node retram@38000000, compatible id shared-dma-pool [...] [ 4.051696] asoc-audio-graph-card sound: dir-hifi <-> 4000d000.audio-controller mapping ok [ 4.058764] asoc-audio-graph-card sound: dmic-hifi <-> 4400d000.dfsdm:filter@0:dfsdm-d mapping ok [ 4.067948] asoc-audio-graph-card sound: dmic-hifi <-> 4400d000.dfsdm:filter@1:dfsdm-d mapping ok [ 4.076655] asoc-audio-graph-card sound: dmic-hifi <-> 4400d000.dfsdm:filter@2:dfsdm-d mapping ok [ 4.085961] asoc-audio-graph-card sound: dmic-hifi <-> 4400d000.dfsdm:filter@3:dfsdm-d mapping ok [ 4.094887] hub 2-1:1.0: USB hub found [ 4.097958] hub 2-1:1.0: 4 ports detected [ 4.133136] input: joystick as /devices/platform/joystick/input/input2 [ 4.139783] stm32_rtc 5c004000.rtc: setting system clock to 2000-01-01T00:05:13 UTC (946685113) [ 4.149753] ALSA device list: [ 4.151270] #0: STM32MP1-EV [ 4.159175] Freeing unused kernel memory: 1024K [ 4.163367] Run /init as init process Starting version 244.3+ [ 5.858706] EXT4-fs (mmcblk0p6): recovery complete [ 5.864217] EXT4-fs (mmcblk0p6): mounted filesystem with ordered data mode. Opts: (null) [ 6.284242] systemd[1]: System time before build time, advancing clock. [ 6.415692] NET: Registered protocol family 10 [ 6.447816] Segment Routing with IPv6 [ 6.482791] systemd[1]: systemd 244.3+ running in system mode. (+PAM -AUDIT -SELINUX +IMA -APPARMOR -SMACK +SYSVINIT +UTMP -LIBCRYPTSETUP -GCRYPT -GNUTLS -) [ 6.503966] systemd[1]: Detected architecture arm. Welcome to ST OpenSTLinux - Weston - (A Yocto Project Based Distro) 3.1-openstlinux-5-4-dunfell-mp1-20-11-12 (dunfell)! [ 6.632901] systemd[1]: Set hostname to <stm32mp1>. [ 6.645159] systemd[1]: Hardware watchdog 'STM32 Independent Watchdog', version 0 [ 6.652457] systemd[1]: Set hardware watchdog to 32s. [ 7.380195] systemd[1]: Unnecessary job for /dev/ttySTM0 was removed. [ 7.392493] systemd[1]: Created slice system-getty.slice. [ OK ] Created slice system-getty.slice. [...] [ OK ] Started Serial Getty on ttySTM0. [ OK ] Reached target Login Prompts. Starting Weston Wayland Compositor (on tty7)... [ OK ] Started Weston Wayland Compositor (on tty7). [ OK ] Created slice User Slice of UID 0. Starting User Runtime Directory /run/user/0... [ OK ] Started User Runtime Directory /run/user/0. Starting User Manager for UID 0... [ OK ] Started Sound Service. [ OK ] Reached target Multi-User System. Starting Update UTMP about System Runlevel Changes... [ OK ] Started Update UTMP about System Runlevel Changes. [ OK ] Started User Manager for UID 0. [ OK ] Started Session c1 of user root. ST OpenSTLinux - Weston - (A Yocto Project Based Distro) 3.1-openstlinux-5-4-dunfell-mp1-20-11-12 stm32mp1 ttySTM0 stm32mp1 login: root (automatic login) root@stm32mp1:~#
For ecosystem release v2.0.0 :
NOTICE: Model: STMicroelectronics STM32MP157F eval daughter on eval mother NOTICE: Board: MB1263 Var4.0 Rev.C-03 INFO: Reset reason (0x14): INFO: Pad Reset from NRST INFO: PMIC version = 0x20 INFO: Using SDMMC INFO: Instance 1 INFO: Boot used partition fsbl1 NOTICE: BL2: v2.2-r1.0(debug):v2.2-dirty NOTICE: BL2: Built : 13:36:23, Oct 22 2019 INFO: Using crypto library 'stm32_crypto_lib' INFO: BL2: Doing platform setup INFO: RAM: DDR3-DDR3L 32bits 533000Khz INFO: Memory size = 0x40000000 (1024 MB) INFO: BL2 runs SP_MIN setup INFO: BL2: Loading image id 4 INFO: Loading image id=4 at address 0x2ffed000 INFO: Image id=4 loaded: 0x2ffed000 - 0x2ffff000 INFO: BL2: Loading image id 5 INFO: Loading image id=5 at address 0xc0100000 INFO: STM32 Image size : 875033 INFO: Image id=5 loaded: 0xc0100000 - 0xc01d5a19 WARNING: Skip signature check (header option) NOTICE: ROTPK is not deployed on platform. Skipping ROTPK verification. NOTICE: BL2: Booting BL32 INFO: Entry point address = 0x2ffed000 INFO: SPSR = 0x1d3 NOTICE: SP_MIN: v2.2-r1.0(debug):v2.2-dirty NOTICE: SP_MIN: Built : 13:36:23, Oct 22 2019 INFO: ARM GICv2 driver initialized INFO: stm32mp IWDG1 (12): Secure INFO: SP_MIN: Initializing runtime services INFO: SP_MIN: Preparing exit to normal world U-Boot 2020.01-stm32mp-r1 (Jan 06 2020 - 20:56:31 +0000) CPU: STM32MP157FAA Rev.Z Model: STMicroelectronics STM32MP157F eval daughter on eval mother Board: stm32mp1 in trusted mode (st,stm32mp157f-ev1) Board: MB1263 Var4.0 Rev.C-03 DRAM: 1 GiB Clocks: - MPU : 800 MHz - MCU : 208.878 MHz - AXI : 266.500 MHz - PER : 24 MHz - DDR : 533 MHz WDT: Started with servicing (32s timeout) NAND: 1024 MiB MMC: STM32 SD/MMC: 0, STM32 SD/MMC: 1 Loading Environment from MMC... OK In: serial Out: serial Err: serial Net: eth0: ethernet@5800a000 Hit any key to stop autoboot: 0 Boot over mmc0! switch to partitions #0, OK mmc0 is current device Scanning mmc 0:4... Found /mmc0_extlinux/stm32mp157f-ev1_extlinux.conf Retrieving file: /mmc0_extlinux/stm32mp157f-ev1_extlinux.conf 706 bytes read in 38 ms (17.6 KiB/s) Retrieving file: /splash.bmp 18244 bytes read in 36 ms (494.1 KiB/s) Select the boot mode 1: OpenSTLinux 2: stm32mp157f-ev1-a7-examples 3: stm32mp157f-ev1-m4-examples Enter choice: 1: OpenSTLinux Retrieving file: /uInitrd 3632439 bytes read in 265 ms (13.1 MiB/s) Retrieving file: /uImage 7309840 bytes read in 506 ms (13.8 MiB/s) append: root=PARTUUID=e91c4e10-16e6-4c0e-bd0e-77becf4a3582 rootwait rw console=ttySTM0,115200 Retrieving file: /stm32mp157f-ev1.dtb 77087 bytes read in 42 ms (1.7 MiB/s) ## Booting kernel from Legacy Image at c2000000 ... Image Name: Linux-5.4.31 Created: 2020-04-08 7:08:47 UTC Image Type: ARM Linux Kernel Image (uncompressed) Data Size: 7309776 Bytes = 7 MiB Load Address: c2000040 Entry Point: c2000040 Verifying Checksum ... OK ## Flattened Device Tree blob at c4000000 Booting using the fdt blob at 0xc4000000 XIP Kernel Image Loading Ramdisk to cfc89000, end cffffd37 ... OK Loading Device Tree to cfc73000, end cfc88d1e ... OK Starting kernel ... [ 0.000000] Booting Linux on physical CPU 0x0 [ 0.000000] Linux version 5.4.31 (oe-user@oe-host) (gcc version 9.3.0 (GCC)) #1 SMP PREEMPT Wed Apr 8 07:08:47 UTC 2020 [ 0.000000] CPU: ARMv7 Processor [410fc075] revision 5 (ARMv7), cr=10c5387d [ 0.000000] CPU: div instructions available: patching division code [ 0.000000] CPU: PIPT / VIPT nonaliasing data cache, VIPT aliasing instruction cache [ 0.000000] OF: fdt: Machine model: STMicroelectronics STM32MP157F eval daughter on eval mother [ 0.000000] Memory policy: Data cache writealloc [ 0.000000] Reserved memory: created DMA memory pool at 0x10000000, size 0 MiB [ 0.000000] OF: reserved mem: initialized node mcuram2@10000000, compatible id shared-dma-pool [ 0.000000] Reserved memory: created DMA memory pool at 0x10040000, size 0 MiB [ 0.000000] OF: reserved mem: initialized node vdev0vring0@10040000, compatible id shared-dma-pool [.....] [ 8.286198] Segment Routing with IPv6 [ 8.371136] systemd[1]: systemd 244.3+ running in system mode. (+PAM -AUDIT -SELINUX +IMA -APPARMOR -SMACK +SYSVINIT +UTMP -LIBCRYPTSETUP -GCRYPT -GNUTLS -ACL +XZ -LZ4 -SECCOMP +BLKID -ELFUTILS +KMOD -IDN2 -IDN -PCRE2 default-hierarchy=hybrid) [ 8.392256] systemd[1]: Detected architecture arm. Welcome to ST OpenSTLinux - Weston - (A Yocto Project Based Distro) 3.1-openstlinux-5.4-dunfell-mp1-20-06-24 (dunfell)! [ 8.518589] systemd[1]: Set hostname to <stm32mp1>. [ 8.539305] systemd[1]: Hardware watchdog 'STM32 Independent Watchdog', version 0 [ 8.546605] systemd[1]: Set hardware watchdog to 32s. [ 9.715426] systemd[1]: Unnecessary job for /dev/ttySTM0 was removed. [.....] [ OK ] Started Session c1 of user root. ST OpenSTLinux - Weston - (A Yocto Project Based Distro) 3.1-openstlinux-5.4-dunfell-mp1-20-06-24 stm32mp1 ttySTM0 stm32mp1 login: root (automatic login) Last login: Fri Feb 7 15:51:05 UTC 2020 on tty7 root@stm32mp1:~#
3. Basic commands[edit source]
3.1. Printing distribution specific information[edit source]
For ecosystem release v2.1.0 :
cat /etc/build
-----------------------
Build Configuration: |
-----------------------
BB_VERSION = 1.46.0
BUILD_SYS = x86_64-linux
NATIVELSBSTRING = universal
TARGET_SYS = arm-ostl-linux-gnueabi
MACHINE = stm32mp1
DISTRO = openstlinux-weston
DISTRO_VERSION = 3.1-openstlinux-5-4-dunfell-mp1-20-11-12
TUNE_FEATURES = arm vfp cortexa7 neon vfpv4 thumb callconvention-hard
TARGET_FPU = hard
MANIFESTVERSION = ostl-20-11-12-rc10
DISTRO_CODENAME = dunfell
ACCEPT_EULA_stm32mp1 = 1
GCCVERSION = 9.%
PREFERRED_PROVIDER_virtual/kernel = linux-stm32mp
PREFERRED_VERSION_linux-stm32mp =
-----------------------
Layer Revisions: |
-----------------------
meta-python = default.xml:144077083457ccb75700777d5e6b1da9aaff01aa
meta-oe = default.xml:144077083457ccb75700777d5e6b1da9aaff01aa
meta-gnome = default.xml:144077083457ccb75700777d5e6b1da9aaff01aa
meta-xfce = default.xml:144077083457ccb75700777d5e6b1da9aaff01aa
meta-initramfs = default.xml:144077083457ccb75700777d5e6b1da9aaff01aa
meta-multimedia = default.xml:144077083457ccb75700777d5e6b1da9aaff01aa
meta-networking = default.xml:144077083457ccb75700777d5e6b1da9aaff01aa
meta-webserver = default.xml:144077083457ccb75700777d5e6b1da9aaff01aa
meta-filesystems = default.xml:144077083457ccb75700777d5e6b1da9aaff01aa
meta-perl = default.xml:144077083457ccb75700777d5e6b1da9aaff01aa
meta-st-stm32mp = default.xml:e0168b92a0c00b1f6dff2411b8e2d5d0d406a05e
meta-qt5 = default.xml:fdd19517e17240b0b61765bd02fc483a1bde986f
meta-st-openstlinux = default.xml:aecec7a497fa7fc1abf05a8c376dd7e962da827c
meta = default.xml:b39bda4cc62db12c0edfbe489d5a7f5988ede6a9 -- modified
For ecosystem release v2.0.0 :
cat /etc/build
-----------------------
Build Configuration: |
-----------------------
BB_VERSION = 1.46.0
BUILD_SYS = x86_64-linux
NATIVELSBSTRING = universal
TARGET_SYS = arm-ostl-linux-gnueabi
MACHINE = stm32mp1
DISTRO = openstlinux-weston
DISTRO_VERSION = 3.1-openstlinux-5.4-dunfell-mp1-20-06-24
TUNE_FEATURES = arm vfp cortexa7 neon vfpv4 thumb callconvention-hard
TARGET_FPU = hard
MANIFESTVERSION = ostl-20-06-24-rc7-1-gcb1de90
DISTRO_CODENAME = dunfell
ACCEPT_EULA_stm32mp1 = 1
GCCVERSION = 9.%
PREFERRED_PROVIDER_virtual/kernel = linux-stm32mp
PREFERRED_VERSION_linux-stm32mp =
-----------------------
Layer Revisions: |
-----------------------
meta-python = HEAD:b5f510e48080b6dc710ff4800feb90ef679c5456
meta-oe = HEAD:b5f510e48080b6dc710ff4800feb90ef679c5456
meta-gnome = HEAD:b5f510e48080b6dc710ff4800feb90ef679c5456
meta-xfce = HEAD:b5f510e48080b6dc710ff4800feb90ef679c5456
meta-initramfs = HEAD:b5f510e48080b6dc710ff4800feb90ef679c5456
meta-multimedia = HEAD:b5f510e48080b6dc710ff4800feb90ef679c5456
meta-networking = HEAD:b5f510e48080b6dc710ff4800feb90ef679c5456
meta-webserver = HEAD:b5f510e48080b6dc710ff4800feb90ef679c5456
meta-filesystems = HEAD:b5f510e48080b6dc710ff4800feb90ef679c5456
meta-perl = HEAD:b5f510e48080b6dc710ff4800feb90ef679c5456
meta-st-stm32mp = HEAD:b86c2f2e092830f011a813d7f2c8fb076b2cbe66
meta-qt5 = HEAD:ac7514e2bc295c97faa86d24e8823829257adbb8
meta-st-openstlinux = HEAD:0124236609b3c1c56df265d7986919df4deb1814
meta = HEAD:1795f30d8ab73d35710ca99064c51190dc84853e
3.2. Printing system information[edit source]
For ecosystem release v2.1.0 :
uname -a Linux stm32mp1 5.4.56 #1 SMP PREEMPT Wed Aug 5 07:59:52 UTC 2020 armv7l armv7l armv7l GNU/Linux
For ecosystem release v2.0.0 :
uname -a Linux stm32mp1 5.4.31 #1 SMP PREEMPT Wed Apr 8 07:08:47 UTC 2020 armv7l armv7l armv7l GNU/Linux
3.3. Printing Linux kernel and GCC versions[edit source]
For ecosystem release v2.1.0 :
cat /proc/version Linux version 5.4.56 (oe-user@oe-host) (gcc version 9.3.0 (GCC)) #1 SMP PREEMPT Wed Aug 5 07:59:52 UTC 2020
For ecosystem release v2.0.0 :
cat /proc/version Linux version 5.4.31 (oe-user@oe-host) (gcc version 9.3.0 (GCC)) #1 SMP PREEMPT Wed Apr 8 07:08:47 UTC 2020
3.4. Printing the amount of disk space available on all mounted file systems[edit source]
df -h Filesystem Size Used Avail Use% Mounted on devtmpfs 370M 0 370M 0% /dev /dev/mmcblk0p6 690M 416M 229M 65% / tmpfs 436M 64K 436M 1% /dev/shm tmpfs 436M 8.9M 427M 3% /run tmpfs 436M 0 436M 0% /sys/fs/cgroup tmpfs 436M 4.0K 436M 1% /tmp /dev/mmcblk0p4 58M 14M 41M 25% /boot /dev/mmcblk0p5 15M 6.7M 6.8M 50% /vendor tmpfs 436M 144K 436M 1% /var/volatile /dev/mmcblk0p7 1.1G 40M 956M 4% /usr/local tmpfs 88M 0 88M 0% /run/user/0
3.5. ssh connection (only if Ethernet cable is connected)[edit source]
- Get the IP address of your board
ip addr show eth0 3: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> 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/64 scope link valid_lft forever preferred_lft forever
- On the host computer connect the terminal to the board using ssh
ssh root@xx.xx.xx.xx
root@stm32mp1:~#
