Skip to content

Commit 67c5525

Browse files
committed
docs: improve deployment guide with tabbed OS-specific instructions
- Fix file path consistency: use debug/ instead of build/ for ELF location - Add tabbed instructions for SSH connections (including PuTTY for Windows) - Add OS-specific file transfer commands (scp) - Enhance serial terminal section with minicom alternatives - Improve cross-platform compatibility for all deployment steps - Maintain consistent formatting with previous documents
1 parent c049a85 commit 67c5525

1 file changed

Lines changed: 64 additions & 4 deletions

File tree

content/learning-paths/embedded-and-microcontrollers/observing-ethos-u-on-nxp/10-deploy-test-executorch-runner-on-NXP.md

Lines changed: 64 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -14,19 +14,43 @@ Find your board's IP address using the serial console or check your router's DHC
1414

1515
Connect via SSH:
1616

17+
{{< tabpane code=false >}}
18+
{{< tab header="Windows/Linux" >}}
1719
```bash
1820
ssh root@192.168.1.24
1921
```
2022

23+
Alternative with PuTTY on Windows:
24+
- Host: `192.168.1.24`
25+
- Port: `22`
26+
- Connection type: SSH
27+
- Username: `root`
28+
{{< /tab >}}
29+
{{< tab header="macOS" >}}
30+
```bash
31+
ssh root@192.168.1.24
32+
```
33+
{{< /tab >}}
34+
{{< /tabpane >}}
35+
2136
Replace `192.168.1.24` with your board's IP address.
2237

2338
## Copy the firmware to the board
2439

2540
Copy the built firmware file to the board's firmware directory:
2641

42+
{{< tabpane code=false >}}
43+
{{< tab header="Windows/Linux" >}}
44+
```bash
45+
scp debug/executorch_runner_cm33.elf root@192.168.1.24:/lib/firmware/
46+
```
47+
{{< /tab >}}
48+
{{< tab header="macOS" >}}
2749
```bash
28-
scp build/executorch_runner_cm33.elf root@192.168.1.24:/lib/firmware/
50+
scp debug/executorch_runner_cm33.elf root@192.168.1.24:/lib/firmware/
2951
```
52+
{{< /tab >}}
53+
{{< /tabpane >}}
3054

3155
Verify the file was copied:
3256

@@ -75,9 +99,18 @@ The executor_runner loads `.pte` model files from DDR memory at address 0x801000
7599

76100
Copy your `.pte` model to the board:
77101

102+
{{< tabpane code=false >}}
103+
{{< tab header="Windows/Linux" >}}
78104
```bash
79105
scp model.pte root@192.168.1.24:/tmp/
80106
```
107+
{{< /tab >}}
108+
{{< tab header="macOS" >}}
109+
```bash
110+
scp model.pte root@192.168.1.24:/tmp/
111+
```
112+
{{< /tab >}}
113+
{{< /tabpane >}}
81114

82115
Write the model to DDR memory:
83116

@@ -105,16 +138,29 @@ The executor_runner outputs debug information via UART. Connect a USB-to-serial
105138

106139
Open a serial terminal (115200 baud, 8N1):
107140

141+
{{< tabpane code=false >}}
142+
{{< tab header="Windows/Linux" >}}
108143
```bash
109144
screen /dev/ttyUSB0 115200
110145
```
111146

112-
On macOS:
113-
147+
Alternative with minicom:
148+
```bash
149+
minicom -D /dev/ttyUSB0 -b 115200
150+
```
151+
{{< /tab >}}
152+
{{< tab header="macOS" >}}
114153
```bash
115154
screen /dev/tty.usbserial-* 115200
116155
```
117156

157+
Alternative with minicom:
158+
```bash
159+
minicom -D /dev/tty.usbserial-* -b 115200
160+
```
161+
{{< /tab >}}
162+
{{< /tabpane >}}
163+
118164
You should see output from the ExecuTorch runtime:
119165

120166
```output
@@ -217,7 +263,21 @@ This might indicate memory configuration issues. Reduce the memory pool sizes in
217263
To deploy a new version of the firmware:
218264

219265
1. Build the updated firmware on your development machine
220-
2. Copy to the board: `scp build/executorch_runner_cm33.elf root@<board-ip>:/lib/firmware/`
266+
2. Copy to the board:
267+
268+
{{< tabpane code=false >}}
269+
{{< tab header="Windows/Linux" >}}
270+
```bash
271+
scp debug/executorch_runner_cm33.elf root@<board-ip>:/lib/firmware/
272+
```
273+
{{< /tab >}}
274+
{{< tab header="macOS" >}}
275+
```bash
276+
scp debug/executorch_runner_cm33.elf root@<board-ip>:/lib/firmware/
277+
```
278+
{{< /tab >}}
279+
{{< /tabpane >}}
280+
221281
3. Restart RemoteProc:
222282

223283
```bash { command_line="root@frdm-imx93" }

0 commit comments

Comments
 (0)