Skip to content

Commit b783561

Browse files
committed
Update web-toolkit.md
- Additional use-cases verified - Misc minor updates - Remove _review.md
1 parent a87b4e6 commit b783561

File tree

6 files changed

+51
-98
lines changed

6 files changed

+51
-98
lines changed

content/learning-paths/microcontrollers/yolo-on-himax/_index.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -31,9 +31,9 @@ operatingsystems:
3131
- Linux
3232
- macOS
3333

34-
#draft: true
35-
#cascade:
36-
# draft: true
34+
draft: true
35+
cascade:
36+
draft: true
3737

3838

3939
### FIXED, DO NOT MODIFY

content/learning-paths/microcontrollers/yolo-on-himax/_review.md

Lines changed: 0 additions & 38 deletions
This file was deleted.

content/learning-paths/microcontrollers/yolo-on-himax/build-firmware.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -34,24 +34,24 @@ make
3434

3535
## Generate the firmware image
3636

37-
Copy the `.elf` file to the `input_case1_secboot` directory.
37+
The examples repository contains scripts to generate the image file. Copy the `.elf` file to the `input_case1_secboot` directory.
3838

3939
```bash
4040
cd ../we2_image_gen_local/
4141
cp ../EPII_CM55M_APP_S/obj_epii_evb_icv30_bdv10/gnu_epii_evb_WLCSP65/EPII_CM55M_gnu_epii_evb_WLCSP65_s.elf input_case1_secboot/
4242
```
43-
The examples repository contains scripts to generate the image. Run the script corresponding to the OS of your host machine.
4443

45-
### Linux
44+
Run the script corresponding to the OS of your host machine. This will create a file named `output.img` in the `output_case1_sec_wlcsp` directory.
4645

47-
```bash
48-
./we2_local_image_gen project_case1_blp_wlcsp.json
49-
```
5046

51-
### macOS
52-
```console
47+
{{< tabpane code=true >}}
48+
{{< tab header="Linux" language="shell">}}
49+
./we2_local_image_gen project_case1_blp_wlcsp.json
50+
{{< /tab >}}
51+
{{< tab header="MacOS" language="shell">}}
5352
./we2_local_image_gen_macOS_arm64 project_case1_blp_wlcsp.json
54-
```
53+
{{< /tab >}}
54+
{{< /tabpane >}}
5555

5656
Your terminal output should end with the following.
5757

content/learning-paths/microcontrollers/yolo-on-himax/dev-env.md

Lines changed: 14 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -67,18 +67,15 @@ git version 2.39.3
6767

6868
Install the make build tool, which is used to build the firmware in the next section.
6969

70-
### Linux
71-
72-
```bash
70+
{{< tabpane code=true >}}
71+
{{< tab header="Linux" language="shell">}}
7372
sudo apt update
7473
sudo apt install make -y
75-
```
76-
77-
### macOS
78-
79-
```console
74+
{{< /tab >}}
75+
{{< tab header="MacOS" language="shell">}}
8076
brew install make
81-
```
77+
{{< /tab >}}
78+
{{< /tabpane >}}
8279

8380
Successful installation of make will show the following when the `make --version` command is run.
8481

@@ -96,26 +93,25 @@ To run this learning path on macOS, you need to verify that your installation is
9693
{{% /notice %}}
9794
## Install Arm GNU toolchain
9895

99-
### Linux
100-
101-
The toolchain is used to cross-compile from the host architecture (x86) to the embedded device architecture (AArch64).
96+
The toolchain is used to compile code from the host to the embedded device architecture.
10297

103-
```bash
98+
{{< tabpane code=true >}}
99+
{{< tab header="Linux" language="shell">}}
104100
cd $HOME
105101
wget https://developer.arm.com/-/media/Files/downloads/gnu/13.2.rel1/binrel/arm-gnu-toolchain-13.2.rel1-x86_64-arm-none-eabi.tar.xz
106102
tar -xvf arm-gnu-toolchain-13.2.rel1-x86_64-arm-none-eabi.tar.xz
107103
export PATH="$HOME/arm-gnu-toolchain-13.2.Rel1-x86_64-arm-none-eabi/bin/:$PATH"
108-
```
109-
### macOS
110-
```console
104+
{{< /tab >}}
105+
{{< tab header="MacOS" language="shell">}}
111106
cd $HOME
112107
wget https://developer.arm.com/-/media/Files/downloads/gnu/13.3.rel1/binrel/arm-gnu-toolchain-13.3.rel1-darwin-arm64-arm-none-eabi.tar.xz
113108
tar -xvf arm-gnu-toolchain-13.3.rel1-darwin-arm64-arm-none-eabi.tar.xz
114109
export PATH="$HOME/arm-gnu-toolchain-13.3.rel1-darwin-arm64-arm-none-eabi/bin/:$PATH"
115-
```
110+
{{< /tab >}}
111+
{{< /tabpane >}}
116112

117113
{{% notice %}}
118-
You can add the above command to the `.bashrc` file. This was, the Arm GNU toolchain is configured from new terminal sessions as well.
114+
You can add the `export` command to the `.bashrc` file. This was, the Arm GNU toolchain is configured from new terminal sessions as well.
119115
{{% /notice %}}
120116

121117

content/learning-paths/microcontrollers/yolo-on-himax/flash-and-run.md

Lines changed: 13 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -19,15 +19,15 @@ pip install -r xmodem/requirements.txt
1919

2020
## Connect the module
2121

22-
Insert the Flexible printed circuit (FPC) into the Grove Vision AI V2 module. Lift the dark grey latch on the connector as per the image below.
22+
To prepare for the next steps, it's time to get the board set up. Insert the Flexible printed circuit (FPC) into the Grove Vision AI V2 module. Lift the dark grey latch on the connector as per the image below.
2323

2424
![unlatched](./unlatched.jpg)
2525

2626
Then, slide the FPC connector in with the metal pins facing down and close the dark grey latch to fasten the connector.
2727

2828
![latched](./latched.jpg)
2929

30-
Then connect the Groove Vision AI V2 Module to your computer via the USB-C cable.
30+
Now you can connect the Groove Vision AI V2 Module to your computer via the USB-C cable.
3131

3232
{{% notice Note %}}
3333
The development board may have two USB-C connectors. If you are running into issues connecting the board in the next step, make sure you are using the right one.
@@ -37,17 +37,16 @@ The development board may have two USB-C connectors. If you are running into iss
3737

3838
You'll need to provide the communication port (COM) which the board is connected to in order to flash the image. There are commands to list all COMs available on your machine. Once your board is connected through USB, it'll show up in this list. The COM identifier will start with **tty**, which may help you determine which one it is. You can run the command before and after plugging in the board if you are unsure.
3939

40-
### Linux
4140

42-
```bash
41+
{{< tabpane code=true >}}
42+
{{< tab header="Linux" language="shell">}}
4343
sudo grep -i 'tty' /var/log/dmesg
44-
```
45-
46-
### MacOS
47-
48-
```console
44+
{{< /tab >}}
45+
{{< tab header="MacOS" language="shell">}}
4946
ls /dev/tty.*
50-
```
47+
{{< /tab >}}
48+
{{< /tabpane >}}
49+
5150

5251
{{% notice Note %}}
5352
If the port seems unavailable, try changing the permissions temporarily using the `chmod` command. Be sure to reset them afterwards, as this may pose a computer security vulnerability.
@@ -64,11 +63,13 @@ The full path to the port is needed in the next step, so be sure to note it down
6463
Run the python script below to flash the firmware.
6564

6665
```bash
67-
python xmodem\xmodem_send.py --port=<COM port> --baudrate=921600 --protocol=xmodem --file=we2_image_gen_local\output_case1_sec_wlcsp\output.img
66+
python xmodem\xmodem_send.py --port=<COM port> \
67+
--baudrate=921600 --protocol=xmodem \
68+
--file=we2_image_gen_local\output_case1_sec_wlcsp\output.img
6869
```
6970

7071
{{% notice Note %}}
71-
When you run other example models demonstrated in the later section [Object detection and additional models](/learning-paths/microcontrollers/yolo-on-himax/how-to-5/), you need to adapt this command with the right image file.
72+
When you run other example models demonstrated in the later section [Run additional models in the web toolkit](/learning-paths/microcontrollers/yolo-on-himax/web-toolkit/), you need to adapt this command with `--model` argument.
7273
{{% /notice %}}
7374

7475
After the firmware image burning is completed, the message `Do you want to end file transmission and reboot system? (y)` is displayed. Press the reset button indicated in the image below.

content/learning-paths/microcontrollers/yolo-on-himax/web-toolkit.md

Lines changed: 12 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,12 @@
11
---
2-
title: (optional) Run additional models in the web toolkit
2+
title: Run additional models in the web toolkit
33
weight: 6
44

5-
#draft: true
6-
75
### FIXED, DO NOT MODIFY
86
layout: learningpathall
97
---
108

11-
In this section, you will view a live camera feed with the ML application running.
9+
In this section, you will view a live camera feed with a computer vision application running.
1210

1311
## Modify the Makefile
1412

@@ -18,12 +16,11 @@ Change the directory to the where the Makefile is located. If you cloned the rep
1816
cd $HOME/Seeed_Grove_Vision_AI_Module_V2/EPII_CM55M_APP_S/
1917
```
2018

21-
The table shows the different options available to use with the web toolkit. Modify the `APP_TYPE` field in the `makefile` to one of the values in the table. Then, to the xmodem argument, pass the `--model` argument.
19+
The table shows the different options available to use with the web toolkit. Modify the `APP_TYPE` field in the `makefile` to one of the values in the table. Then pass the `--model` argument to the python `xmodem` command.
2220

23-
|APP_TYPE |Description | --model argument |
21+
|APP_TYPE |Description | Model argument |
2422
|--- |--- |---
2523
|tflm_yolov8_od |Object detection | model_zoo\tflm_yolov8_od\yolov8n_od_192_delete_transpose_0xB7B000.tflite 0xB7B000 0x00000 |
26-
|tflm_yolov8_pose |Pose detection | model_zoo\tflm_yolov8_pose\yolov8n_pose_256_vela_3_9_0x3BB000.tflite 0x3BB000 0x00000 |
2724
|tflm_fd_fm |Face detection | model_zoo\tflm_fd_fm\0_fd_0x200000.tflite 0x200000 0x00000 model_zoo\tflm_fd_fm\1_fm_0x280000.tflite 0x280000 0x00000 model_zoo\tflm_fd_fm\2_il_0x32A000.tflite 0x32A000 0x00000 |
2825

2926
{{% notice Note %}}
@@ -47,17 +44,17 @@ Use the commands from [Flash firmware onto the microcontroller](/learning-paths/
4744
cd ../we2_image_gen_local/
4845
cp ../EPII_CM55M_APP_S/obj_epii_evb_icv30_bdv10/gnu_epii_evb_WLCSP65/EPII_CM55M_gnu_epii_evb_WLCSP65_s.elf input_case1_secboot/
4946
```
47+
Run the script corresponding to the OS of your host machine.
5048

51-
### Linux
52-
53-
```bash
49+
{{< tabpane code=true >}}
50+
{{< tab header="Linux" language="shell">}}
5451
./we2_local_image_gen project_case1_blp_wlcsp.json
55-
```
56-
57-
### macOS
58-
```console
52+
{{< /tab >}}
53+
{{< tab header="MacOS" language="shell">}}
5954
./we2_local_image_gen_macOS_arm64 project_case1_blp_wlcsp.json
60-
```
55+
{{< /tab >}}
56+
{{< /tabpane >}}
57+
6158

6259
Finally, use `xmodem` to flash the image.
6360

@@ -92,9 +89,6 @@ The images below are captured images from the models run in the toolkit.
9289
### Objection detection
9390
![object_detection](./object_detection.jpg)
9491

95-
### Pose estimation
96-
![Pose estimation](./pose_estimation.jpg)
97-
9892
### Face detection
9993
![object_detection](./face_detection.jpg)
10094

0 commit comments

Comments
 (0)