You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: variants/STM32MP157_DK/README.md
+33-17
Original file line number
Diff line number
Diff line change
@@ -13,49 +13,65 @@ Because every OS may have different software configurations (especially Device T
13
13
*[STM32 MPU OpenSTLinux Distribution]
14
14
*[Balena OS]
15
15
16
-
Note that the first two OSes should select `stm32mp157c-dk2-m4-examples-sdcard` boot mode (or device tree configuration) on boot time. `stm32mp157c-dk2-sdcard` boot mode is also known to work but it is not guaranteed. See [ST Wiki page on boot mode] for more detail. If you are using it for your own OS, see the [Linux Device Tree considerations](#Linux-Device-Tree-considerations) section.
16
+
#### Note
17
+
* Other distributions not listed here may run Arduino firmware but they are not tested.
18
+
*__The first two OSes should select `stm32mp157c-dk2-m4-examples-sdcard` boot mode (or device tree configuration) on boot time.__
19
+
*`stm32mp157c-dk2-sdcard` boot mode is also known to work but it is not guaranteed. See [ST Wiki page on boot mode] for more detail. If you are using it for your own OS, see the [Linux Device Tree considerations](#Linux-Device-Tree-considerations) section.
17
20
18
21
## How to use
19
22
20
23
After Verify and Upload, you will see a message similar to the following in Arduino IDE:
In this example, the user **must** upload `<Arduino build output path>/run_arduino.sh`file manually. Uploading instruction is described later in the [Uploading](#Uploading) section.
31
+
`<Arduino build output path>/run_arduino_<sketch name>.sh`looks like this for *Blink* example:
29
32
30
-
After uploading the user can use `sh run_arduino.sh start` in the console of host Linux via either SSH or Serial Console, to run the Arduino firmware.
33
+
* Windows:
31
34
32
-
Note: `sh run_arduino.sh start` is a one-shot command: the Arduino firmware only runs for the current boot. If you want to make it run after reboot, you need to use `sh run_arduino.sh install` command.
Usage: sh run_arduino.sh [start|stop|restart|generate|install|uninstall]
39
+
`/tmp/arduino_build_668148/run_arduino_Blink.sh`
37
40
38
-
run_arduino.sh is a helper script that helps managing an Arduino binary
41
+
In this example, the user **must** upload `<Arduino build output path>/run_arduino_<sketch name>.sh` file manually. Uploading instruction is described later in the [Uploading](#Uploading) section.
42
+
43
+
After uploading the user can use `sh run_arduino_<sketch name>.sh start` in the console of host Linux via either SSH or Serial Console, to run the Arduino firmware.
44
+
45
+
#### Note
46
+
*`sh run_arduino_<sketch name>.sh start` is a one-shot command, the Arduino firmware only runs for the current boot. If you want to make it run after reboot, you need to use `sh run_arduino_<sketch name>.sh install` command.
47
+
48
+
`run_arduino_<sketch name>.sh` help page summary:
49
+
50
+
Usage: sh run_arduino_<sketch name>.sh [start|stop|restart|generate|install|uninstall]
51
+
52
+
run_arduino_<sketch name>.sh is a helper script that helps managing an Arduino binary
39
53
file for the coprocessor using remoteproc framework.
40
54
41
-
sh run_arduino.sh start
55
+
sh run_arduino_<sketch name>.sh start
42
56
Upload the binary to the coprocessor then start it.
43
57
This command must be executed while the script contains the binary
44
58
after generate command is run.
45
59
46
-
sh run_arduino.sh install
60
+
sh run_arduino_<sketch name>.sh install
47
61
Run the binary on boot automatically by installing a systemd service.
48
62
49
-
sh run_arduino.sh uninstall
63
+
sh run_arduino_<sketch name>.sh uninstall
50
64
Uninstall the autostart service.
51
65
52
-
sh run_arduino.sh stop
66
+
sh run_arduino_<sketch name>.sh stop
53
67
Stop the coprocessor.
54
68
55
-
sh run_arduino.sh restart
69
+
sh run_arduino_<sketch name>.sh restart
56
70
Restart the coprocessor.
57
71
58
-
See the source code for the full help page and the more details about [run_arduino.sh].
72
+
See the source code [run_arduino_gen.sh] for the full help page and the more details about the `run_arduino_<sketch name>.sh` generated.
73
+
74
+
[run_arduino_gen.sh] is the shell script that produces a copy of the script called `run_arduino_<sketch name>.sh` but with the sketch binary self-contained.
59
75
60
76
## Pin mapping
61
77
@@ -96,7 +112,7 @@ There are additional pins for LEDs and buttons.
96
112
97
113
## Uploading
98
114
99
-
As mentioned above `run_arduino.sh` file should be uploaded manually in order to work. There are many ways to upload the file.
115
+
As mentioned above `run_arduino_<sketch name>.sh` file have to be uploaded manually from the PC to the board's Linux file system in order to be executed on the board directly through the board's Linux console. There are many ways to upload the file.
100
116
101
117
### Over Network
102
118
@@ -152,7 +168,7 @@ And then the Device Tree should enable TIM1 for the coprocessor, although this d
0 commit comments