1 l  \% m7 |% l) b
1 i0 I# i. z) C1 I% s- ?今天来搞一下STM32MP157F-DK2，顺便写一下，我是参考官方的wiki，进行体验使用，并对相关过程做个记录。

先来个全貌展示

6 e; Q  h8 `* e' K基础准备工作
2 @* ?1 T* {7 V1 @5 m0 G系统环境
; ]9 B+ `8 c0 {! u0 K! M- P: v( o下载安装Ubuntu Desktop（这里使用版本为20.04.4）：https://ubuntu.com/download/desktop
# f% D3 ]( D1 z7 }% b) k
& s- T* v: x* k0 l
$ `% l. F8 t: Z安装完成后进行基础环境安装与设置：

1. sudo apt update
   6 F! w9 H: v/ y# L, C8 q
2. sudo apt install -y build-essential

复制代码

以下为应用与内核开发需要的环境安装与设置：

1. sudo apt install -y gawk git-core diffstat texinfo gcc-multilib chrpath socat cpio python3-pip python3-pexpect xz-utils debianutils iputils-ping python3-git python3-jinja2 libegl1-mesa libsdl1.2-dev pylint3 pylint xterm
   
2. sudo apt install -y xsltproc docbook-utils fop dblatex xmlto
   
3. sudo apt install -y libmpc-dev libgmp-dev
   - Y% P# O" a# M; o4 w
4. sudo apt install -y libncurses5 libncurses5-dev libncursesw5-dev libssl-dev linux-headers-generic u-boot-tools device-tree-compiler bison flex libyaml-dev libmpc-dev libgmp-dev
   
5. sudo apt install -y python-is-python3
   ( h0 k6 Y. M  i# L
6. 
   
7. # 设置使MMC支持分为16个分区
   
8. echo 'options mmc_block perdev_minors=16' > /tmp/mmc_block.conf
   " B) t2 Y2 z% ~1 A, m
9. sudo mv /tmp/mmc_block.conf /etc/modprobe.d/mmc_block.conf
   

复制代码

硬件连接
1 q4 e8 e, Z9 U3 P- w硬件连接如下图所示：

* R- i4 e* r0 @7 n) E2 {$ w特别需要注意的是使用的电源（5V3A）、供电的USB线、通讯的USB线品质不能太差，不然可能系统镜像烧录过程中会出错。

0 l; m, }) Y8 u2 c8 _
# s5 M" _9 b, Y- s2 r系统镜像烧录测试
& u' e5 p+ ~/ D) {& M. Y& K: QST官方提供了测试用的系统镜像，使用ST的烧录工具可以烧录镜像到存储器中。烧录工具有Linux、Windows、Mac版本的，选择合适的平台进行即可。


烧录是通过 USB OTG 那个口进行的（DFU模式）。需要注意的是烧录过程中设备会断开重新连接，如果使用虚拟机的话需要把这个USB设备设置为自动转到虚拟机或是在重新连接的过程中手动转到虚拟机。
, u  O2 k- y" W" t

" p' Y3 A9 T" a. @9 n下面是Linux下系统镜像烧录测试过程：
* l7 q4 t/ M" g: I4 b6 D
3 v3 |7 V2 ?3 ^7 G) g+ U& N* F) D
STM32CubeProgrammer安装
- l, }" i( e! Z7 V6 G* k% \  zSTM32CubeProgrammer用来将系统二进制文件烧录到TF卡或eMMC中，可以从下面选择合适的版本下载：
& k' T8 z/ L& R, Zhttps://www.st.com/en/development-tools/stm32cubeprog.html
我这里通过Ubuntu自带的浏览器下载，得到的 en.stm32cubeprg-lin_v2-10-0.zip 文件位于 ~/Downloads/ 目录下。


接下来进行安装：
6 y) h' X3 C+ t) Z6 {/ ]

1. # 建立STM32CubeProgrammer安装目录
   / U3 G0 g& \- `- P% n8 p+ N
2. mkdir -p ~/mp157/tools/prog
   " Q2 h! R1 \* r* f# w
3. 
   
4. # 解压与安装
   4 M# g9 a1 K( N4 ^9 M; |% Z% X. \7 l2 i
5. cd ~/Downloads/
   
6. unzip en.stm32cubeprg-lin_v2-10-0.zip
   ) e+ l4 m) R' I0 j7 Q
7. ./SetupSTM32CubeProgrammer-2.10.0.linux
   
8. # 安装时选择上面建立的安装目录，其它默认即可
   

复制代码

允许USB相关功能：
' _7 v, e7 \  D' G  K* ~

1. # sudo apt install libusb-1.0-0
   
2. cd ~/mp157/tools/prog/Drivers/rules/
   
3. sudo cp *.* /etc/udev/rules.d/

复制代码

导出到环境变量方便使用：

1. # 下面方式是临时的，每次打开终端都需要重新设置
   
2. export PATH=$HOME/mp157/tools/prog/bin:$PATH
   ! o9 O4 A8 G& q. k
3. # 设置成功的话使用 STM32_Programmer_CLI --h 可以看到软件信息

复制代码

系统镜像烧录
6 j  S7 m. D  {2 w/ d从下面地址下载ST官方提供的系统镜像：
! S) y: K. H6 S2 whttps://www.st.com/content/st_com/en/products/embedded-software/mcu-mpu-embedded-software/stm32-embedded-software/stm32-mpu-openstlinux-distribution/stm32mp1starter.html
* ?0 L' S# M' I: R, G. B我这里通过Ubuntu自带的浏览器下载，得到的 en.FLASH-stm32mp1-openstlinux-5-10-dunfell-mp1-21-11-17_tar.xz 文件位于 ~/Downloads/ 目录下。

1. mkdir -p ~/mp157/ecosystem/starter
   7 ]2 }1 ~, p$ w/ Z
2. cd ~/mp157/ecosystem/starter
   
3. 
   
4. mv ~/Downloads/en.FLASH-stm32mp1-openstlinux-5-10-dunfell-mp1-21-11-17_tar.xz ./
   4 |5 A0 }4 n7 c# L
5. tar xvf en.FLASH-stm32mp1-openstlinux-5-10-dunfell-mp1-21-11-17_tar.xz
   3 ]- w. [) Q0 J" d# c7 `6 X
6. # 官方的系统固件与烧录配置等都在解压得到的目录中
   

复制代码

烧录前将开发板背面的两个拨码开关都拨到OFF位置，然后按正面的RESET按钮进行复位。接着启动烧录工具：
9 Q* z. w* Z# w# `' D, N

1. STM32CubeProgrammer

复制代码

连接设备，打开下面目录中对应的烧录配置文件（.tsv）:
~/mp157/ecosystem/starter/stm32mp1-openstlinux-5.10-dunfell-mp1-21-11-17/images/stm32mp1/flashlayout_st-image-weston/
' @# T0 \0 W3 X4 e' `- b1 }0 G0 q然后二进制文件路径选择下面这个：
: n1 x8 l, L7 G6 B5 i7 K, K~/mp157/ecosystem/starter/stm32mp1-openstlinux-5.10-dunfell-mp1-21-11-17/images/stm32mp1/
: k; }% ~2 z! _9 k# S+ a2 c& R最后点击 Download 进行烧录即可：
* x7 a8 [6 Y+ n0 z/ p
烧录过程比较漫长，请耐心等待。
& c% D" {$ p) }$ I/ k

  T' N* G# [* K( C1 ]  ~" ]* i烧录完成后将开发板背面的两个拨码开关都拨回ON位置，然后按正面的RESET按钮进行复位。
: J& T$ b- R; \  ?7 J" N0 m% g3 a系统将正常启动显示开机画面，初次启动时接着将黑屏几分钟进行初始化，完成后会在屏幕上显示文章开头图片中画面。
0 ]$ j/ G7 m: @+ W' C  G

如果STLink那个USB口使用数据线连接到电脑的话会在电脑上有一个串口，使用终端工具进行连接的话会在这里打印出启动日志。也可以通过这里与系统进行交互：
* L1 ?# n' T- S8 z& s* ?9 b
+ t$ W  n% V' B9 _' \# C

应用与内核开发
SDK安装
0 _; t1 @' [8 P, @从下面地址下载ST官方提供的SDK（SDK中包含编译工具链和库文件）：
0 K1 F$ p, a/ w9 Rhttps://www.st.com/content/st_com/en/products/embedded-software/mcu-mpu-embedded-software/stm32-embedded-software/stm32-mpu-openstlinux-distribution/stm32mp1dev.html
! v8 H2 [4 a+ V) L我这里通过Ubuntu自带的浏览器下载，得到的 en.SDK-x86_64-stm32mp1-openstlinux-5.10-dunfell-mp1-21-11-17.tar.xz 文件位于 ~/Downloads/ 目录下。
/ F( c# ^1 t4 A7 ~; U, i

1. cd ~/Downloads/
   
2. tar xvf en.SDK-x86_64-stm32mp1-openstlinux-5.10-dunfell-mp1-21-11-17.tar.xz
   
3. 
   
4. # 建立SDK安装目录
   4 p7 D& L/ X5 ~
5. mkdir -p ~/mp157/ecosystem/developer/SDK
   9 c6 \8 F; Z9 o( O
6. # 执行脚本安装SDK
   
7. chmod +x stm32mp1-openstlinux-5.10-dunfell-mp1-21-11-17/sdk/st-image-weston-openstlinux-weston-stm32mp1-x86_64-toolchain-3.1.11-openstlinux-5.10-dunfell-mp1-21-11-17.sh
   
8. ./stm32mp1-openstlinux-5.10-dunfell-mp1-21-11-17/sdk/st-image-weston-openstlinux-weston-stm32mp1-x86_64-toolchain-3.1.11-openstlinux-5.10-dunfell-mp1-21-11-17.sh -d $HOME/mp157/ecosystem/developer/SDK
   
9. 
   
10. # 设置SDK
    
11. # 下面方式是临时的，每次打开终端都需要重新设置
    7 |* Q' e9 e7 P# n5 r
12. cd ~/mp157/ecosystem/developer/
    
13. source SDK/environment-setup-cortexa7t2hf-neon-vfpv4-ostl-linux-gnueabi
    
14. # echo $ARCH
    6 A$ H, k% F7 [' L
15. # echo $CROSS_COMPILE
    $ k9 f  s3 c3 T4 ?- _
16. # $CC --version
    
17. # echo $OECORE_SDK_VERSION
    7 `3 A% i4 h. J7 s; C: K* v

复制代码

应用开发
3 H$ U( X5 i# N

1. # 建立并进入工程目录
   
2. mkdir -p ~/mp157/ecosystem/developer/application/gtk_hello_world_example
   ) Q3 x) c3 N, L7 s; k2 j2 C0 r
3. cd ~/mp157/ecosystem/developer/application/gtk_hello_world_example/
   4 \& p5 D3 _$ v- ?: N7 R0 K# L

复制代码

建立 gtk_hello_world.c 文件（gedit gtk_hello_world.c），内容如下：

1. #include <gtk/gtk.h>
   : x3 B  l" l+ ^0 Y
2. 
   ( F  L( |* `, }* D
3. static void
   
4. print_hello (GtkWidget *widget,
   
5.              gpointer   data)
   
6. {
   
7.   g_print ("Hello World\n");
   4 I1 W) t$ B' ~# @, j( A9 |; Q9 w' W
8. }
   " i" ~/ d+ _: Z9 k$ C/ |" s# S
9. 
   
10. static void
    5 h+ ^; p; h; R* w: p9 t7 R7 D+ P0 b
11. activate (GtkApplication *app,
    
12.           gpointer        user_data)
    
13. {
    ( N7 M! `: y: L& _  F" }
14.   GtkWidget *window;
    
15.   GtkWidget *button;
    + Z' y& }. S. h% v, e
16.   GtkWidget *button_box;
    8 v" E) N2 Q% Q/ j9 J% @2 O
17. 
    
18.   window = gtk_application_window_new (app);
    
19.   gtk_window_set_title (GTK_WINDOW (window), "Window");
    4 ?7 P8 ?% N- d
20.   gtk_window_set_default_size (GTK_WINDOW (window), 200, 200);
    
21. 
    
22.   button_box = gtk_button_box_new (GTK_ORIENTATION_HORIZONTAL);
    
23.   gtk_container_add (GTK_CONTAINER (window), button_box);
    ' M) d( ?% A. @6 d
24. 
    
25.   button = gtk_button_new_with_label ("Hello World");
    
26.   g_signal_connect (button, "clicked", G_CALLBACK (print_hello), NULL);
    
27.   g_signal_connect_swapped (button, "clicked", G_CALLBACK (gtk_widget_destroy), window);
    2 v  c- s& S7 y: @$ W4 P0 p
28.   gtk_container_add (GTK_CONTAINER (button_box), button);
    
29. 
    
30.   gtk_widget_show_all (window);
    9 v9 y0 H" ~( ^0 s4 C+ y
31. }
    
32. 
    
33. int
    - {+ |# C' X; }' Q6 y
34. main (int    argc,
    8 f+ x% W: K- \( h/ y, n5 @' ]
35.       char **argv)
    
36. {
    
37.   GtkApplication *app;
    3 E' w8 G3 Q* G0 m
38.   int status;
    
39. 
    
40.   app = gtk_application_new ("org.gtk.example", G_APPLICATION_FLAGS_NONE);
    7 E& i1 ^1 M- v8 r
41.   g_signal_connect (app, "activate", G_CALLBACK (activate), NULL);
    " Y: _+ W9 N' c) V6 c9 F, S% _5 P
42.   status = g_application_run (G_APPLICATION (app), argc, argv);
    
43.   g_object_unref (app);
    
44. 
    6 w' C3 w6 X9 l! @
45.   return status;
    2 h% W- Y% G! |  ~- s* K3 ]! E/ A
46. }
    / S! B3 g' P  |6 l0 Y& Y% k

复制代码

建立 Makefile 文件（gedit Makefile），内容如下：

1. PROG = gtk_hello_world
   
2. SRCS = gtk_hello_world.c
   
3. 
   
4. CLEANFILES = $(PROG)
   
5. 
   
6. # Add / change option in CFLAGS and LDFLAGS
   $ T8 i0 W. O! N  r9 O0 y. Q2 d
7. CFLAGS += -Wall $(shell pkg-config --cflags gtk+-3.0)
   9 s! r' X3 d! V; |& W
8. LDFLAGS += $(shell pkg-config --libs gtk+-3.0)
   ( V$ Z9 i) Y% p6 f9 x9 c) i2 `
9. 
   / z$ m/ h# ]% t- w5 |- \! d
10. all: $(PROG)
    
11. 
    
12. $(PROG): $(SRCS)
    : N2 }: w2 M. `3 @3 |% F
13.         $(CC) -o $@ $^ $(CFLAGS) $(LDFLAGS)
    $ O$ I3 V5 f; b+ X& k3 @8 F' h
14. 
    
15. clean:
    ; x# u& i' m' T6 b# C2 K. H5 g
16.         rm -f $(CLEANFILES) $(patsubst %.c,%.o, $(SRCS))
    / S. H, ]+ }* E* r; p9 p

复制代码

使用 make 进行编译。编译得到的二进制文件可以通过网络传输到开发板中（比如使用 scp gtk_hello_world root@<board ip address>:/usr/local 方式），然后在开发板中运行（比如通过串口终端来运行）。运行运行上面程序会在开发板的屏幕上出现一个带有按钮的窗体：
  I- g, i3 _! D  d* ?
内核编译
从下面地址下载ST官方提供的Linux内核源码开发包：开发包

4 g( {, ?9 g! j* |( d; ?" b我这里通过Ubuntu自带的浏览器下载，得到的 en.SOURCES-kernel-stm32mp1-openstlinux-5.10-dunfell-mp1-21-11-17.tar.xz 文件位于 ~/Downloads/ 目录下。
' P6 _' e9 z, ?! Q% N8 f& T" F6 b

1. # 解压开发包内容
   
2. cd ~/mp157/ecosystem/developer/
   , ~$ p# {& W) `( T: Y, O2 u, K3 u
3. cp ~/Downloads/en.SOURCES-kernel-stm32mp1-openstlinux-5.10-dunfell-mp1-21-11-17.tar.xz ./
   
4. tar xvf en.SOURCES-kernel-stm32mp1-openstlinux-5.10-dunfell-mp1-21-11-17.tar.xz
   
5. 
   
6. # 解压内核，打上MP157补丁
   , d6 Q% l! Y- R$ _" M* e
7. cd stm32mp1-openstlinux-5.10-dunfell-mp1-21-11-17/sources/arm-ostl-linux-gnueabi/linux-stm32mp-5.10.61-stm32mp-r2-r0/
   
8. tar xvf linux-5.10.61.tar.xz
   " ~  Z& G. @% v0 H( @; P6 Z
9. cd linux-5.10.61
   
10. for p in `ls -1 ../*.patch`; do patch -p1 < $p; done
    

复制代码

1. # source $HOME/mp157/ecosystem/developer/SDK/environment-setup-cortexa7t2hf-neon-vfpv4-ostl-linux-gnueabi
   
2. # 进行相关设置
   7 N' p0 W4 O( b9 L; t% @' V+ Z! T5 N
3. make ARCH=arm multi_v7_defconfig "fragment*.config"
   6 i( R! |5 b( j" E2 ^
4. for f in `ls -1 ../fragment*.config`; do scripts/kconfig/merge_config.sh -m -r .config $f; done
   
5. yes '' | make ARCH=arm oldconfig
   # f; @+ u# s: C1 B3 e9 X5 U
6. 
   # u( v3 Y! R$ J
7. # 编译内核和设备树
   5 t$ N8 R; C  ~3 h; W% S
8. make ARCH=arm uImage vmlinux dtbs LOADADDR=0xC2000040
   
9. 
   
10. # 编译内核模块
    * I6 C7 z. L0 c+ ~
11. make ARCH=arm modules
      s! R) Y4 O, A
12. 
    
13. mkdir -p $PWD/install_artifact/
    8 s' \1 f# t0 T7 L
14. make ARCH=arm INSTALL_MOD_PATH="$PWD/install_artifact" modules_install
    

复制代码

编译完成后后可以使用网络将生成的内容更新到开发板上：
% \0 g3 q$ }4 y& w: H# q

1. # 更新内核
   
2. # scp arch/arm/boot/uImage root@<board ip address>:/boot
   
3. 
   ! p8 T5 p( t7 o# }8 I' f
4. # 更新设备树
   2 Z: j8 m5 I: e3 b
5. # scp arch/arm/boot/dts/stm32mp157*.dtb root@<board ip address>:/boot
   
6. 
   
7. # 更新内核模块
   1 ]. M9 S5 }- M. u
8. # rm install_artifact/lib/modules/5.10.61/build install_artifact/lib/modules/5.10.61/source
   0 `6 H/ ?! X8 ^1 r( N' y3 k
9. # find install_artifact/ -name "*.ko" | xargs $STRIP --strip-debug --remove-section=.comment --remove-section=.note --preserve-dates
   : F6 _; D! d8 P" g( q" b
10. # scp -r install_artifact/lib/modules/* root@<ip of board>:/lib/modules
    . f4 b0 B( d) B2 ^9 Q

复制代码

以下操作在开发板终端中进行：

1. # /sbin/depmod -a
   
2. # sync
   
3. 
   
4. # 重启使所有更改生效
   
5. # reboot

复制代码

内核修改测试
. z7 {8 ^  M6 X5 n

1. # cd $HOME/mp157/ecosystem/developer/stm32mp1-openstlinux-5.10-dunfell-mp1-21-11-17/sources/arm-ostl-linux-gnueabi/linux-stm32mp-5.10.61-stm32mp-r2-r0/linux-5.10.61/
   
2. 
   
3. # 打开内核一个源码进行修改
   ' m6 L6 K; B# r* x0 F% s$ f3 c
4. gedit ./drivers/gpu/drm/stm/drv.c
   

复制代码

在打开的文件中添加红框中一条语句：
/ T: W' ?4 q$ @; R% |0 N
修改完成后保存推出，然后重新编译内核：

1. make uImage LOADADDR=0xC2000040
   
2. 
   
3. # 编译完成后重新传输内核到开发板
   * G8 D  l: E6 \- C) d
4. scp arch/arm/boot/uImage root@<board ip address>:/boot

复制代码

以下操作在开发板终端中进行：
  b9 ?/ P, r7 \+ A5 r

1. reboot
   
2. # 等待重启完成查看刚才修改的打印信息
   5 `' t+ K. D9 y1 ^5 a
3. dmesg | grep -i stm_drm_platform_probe

复制代码

+ z  b& w' l2 D3 x- v7 z
8 U9 M7 |! I3 b6 X1 w0 ]7 L

谢谢分享
/ J3 A4 q) S, L