Skip to content

Commit 782a2d5

Browse files
gonzolivelygonzolively
committed
revised board support and board pages
1 parent 650de32 commit 782a2d5

4 files changed

Lines changed: 102 additions & 23 deletions

File tree

‎docs/board-support/ST/B-U585I-IOT02A/index.md‎

Lines changed: 33 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ parent: STMicroelectronics
55
grandparent: Board Support
66
---
77

8-
# B-U585I-IOT02A Discovery Board Overview
8+
# B-U585I-IOT02A Discovery Board
99

1010
---
1111

@@ -31,13 +31,33 @@ In the diagram below, you can see many of the board's physical components:
3131

3232
---
3333

34-
## Powering the Device
34+
## Connecting to the Device
35+
36+
### Physical Connection
37+
The board has two micro-USB ports. Connect a micro-USB cable to the port labeled **STLINK-V3E USB port (CN8)** in the top right corner of the board. Once connected, power and debug LEDs should illuminate, indicating the board is ready for use.
3538

36-
There are two micro-USB ports on the board. The *top right* usb port labeled **USB STLINK** is the usb port we'll be using in this guide. Plug in the device and you should see some LEDs light up.
39+
### Serial Connection
40+
To monitor your device's output:
41+
1. Open your preferred serial terminal application
42+
2. Configure the following settings:
43+
* **Port**: Select the port where your device is connected
44+
* **Baud Rate**: 115200
45+
* **Data Bits**: 8
46+
* **Parity**: None
47+
* **Flow Control**: None
48+
* **Line Endings**: None
49+
50+
{: .note}
51+
The device will appear as a USB serial port when properly connected. On Linux/macOS it will typically be `/dev/ttyACM0` or similar, on Windows it will be a COM port.
3752

3853
---
3954

40-
## Connecting to the Device
55+
## Flashing the Firmware
56+
57+
To flash the Ocre runtime, please follow the steps in the [Using a Physical Device](../../../quickstart/firmware/hardware) section found in the [Building and Flashing the Ocre Runtime](../../../quickstart/firmware/index) guide.
58+
59+
{: .note}
60+
Be sure to use `b_u585i_iot02a` as your board name.
4161

4262
---
4363

@@ -48,8 +68,16 @@ You may reboot the device by pressing the black button once.
4868
---
4969

5070
## Resetting the Device to Factory Defaults
71+
To erase all stored data and reset the board to its factory default state:
72+
73+
1. Open STM32CubeProgrammer
74+
2. In the port dropdown menu, select "ST-LINK". Click the refresh icon next to "Serial Number", select your device, and click the green "Connect" button
75+
3. Select "Full chip erase" from the left sidebar (eraser icon)
76+
4. Click "OK" to confirm
77+
5. A dialog box will confirm successful flash memory erasure
78+
6. Click the green "Disconnect" button to free up the port for future flashing and debugging
5179

52-
Some information may be stored to flash memory and persist across reboots, such as any WiFi credentials you may have entered or applications that have been installed. You can erase the flash memory to reset the board to a "Factory Default" state by pressing and holding the blue button for five seconds.
80+
**Note**: This will erase all stored data including WiFi credentials and installed applications.
5381

5482
---
5583

‎docs/board-support/ST/NUCLEO-H723ZG/index.md‎

Lines changed: 56 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,12 @@ parent: STMicroelectronics
55
grandparent: Board Support
66
---
77

8-
# NUCLEO-H723ZG Development Board Overview
8+
# NUCLEO-H723ZG Development Board
9+
10+
---
911

1012
## Overview
13+
1114
The **STM32 NUCLEO-H723ZG Development Board** is a high-performance platform built around ST Micro's STM32H723 microcontroller. This board features the powerful Arm® Cortex®-M7 core making it ideal for computationally intensive applications requiring real-time processing.
1215

1316
Key features include:
@@ -24,23 +27,65 @@ Key features include:
2427
* USB power supply
2528
* External sources
2629

30+
In the diagram below, you can see many of the board’s physical components:
31+
2732
![Board Layout](NUCLEO-H723ZG.png)
2833

29-
## Powering the Device
30-
Connect the board using the USB connector (CN1) labeled **USB PWR/ST-LINK**. The PWR LED (LD3) should illuminate, indicating the board is powered.
34+
---
35+
36+
## Connecting to the Device
37+
38+
### Physical Connection
39+
The board has two micro-USB ports. Connect a micro-USB cable to the port labeled **ST-Link micro USB Connector (CN1)** in the top right corner of the board. Once connected, power and debug LEDs should illuminate, indicating the board is ready for use.
40+
41+
### Serial Connection
42+
To monitor your device's output:
43+
1. Open your preferred serial terminal application
44+
2. Configure the following settings:
45+
* **Port**: Select the port where your device is connected
46+
* **Baud Rate**: 115200
47+
* **Data Bits**: 8
48+
* **Parity**: None
49+
* **Flow Control**: None
50+
* **Line Endings**: None
51+
52+
{: .note}
53+
The device will appear as a USB serial port when properly connected. On Linux/macOS it will typically be `/dev/ttyACM0` or similar, on Windows it will be a COM port.
54+
55+
---
56+
57+
## Flashing the Firmware
58+
59+
To flash the Ocre runtime, please follow the steps in the [Using a Physical Device](../../../quickstart/firmware/hardware) section found in the [Building and Flashing the Ocre Runtime](../../../quickstart/firmware/index) guide.
60+
61+
{: .note}
62+
Be sure to use `nucleo_h723zg` as your board name.
63+
64+
---
3165

3266
## Rebooting the Device
33-
Press the black NRST button to reboot the device.
67+
68+
You may reboot the device by pressing the black button once.
69+
70+
---
3471

3572
## Resetting the Device to Factory Defaults
36-
To reset the board to its factory state and clear any stored applications:
37-
1. Hold the blue USER button (B1)
38-
2. Press and release the black NRST button
39-
3. Keep holding the blue button until the LED blinks
40-
4. Release the blue button
73+
To erase all stored data and reset the board to its factory default state:
74+
75+
1. Open STM32CubeProgrammer
76+
2. In the port dropdown menu, select "ST-LINK". Click the refresh icon next to "Serial Number", select your device, and click the green "Connect" button
77+
3. Select "Full chip erase" from the left sidebar (eraser icon)
78+
4. Click "OK" to confirm
79+
5. A dialog box will confirm successful flash memory erasure
80+
6. Click the green "Disconnect" button to free up the port for future flashing and debugging
81+
82+
**Note**: This will erase all stored data including WiFi credentials and installed applications.
83+
84+
---
4185

4286
## Important Links
87+
4388
For additional details about the board and development tools, please refer to the following resources:
4489

45-
* **[Product Page](https://www.st.com/en/evaluation-tools/nucleo-h723zg.html)**: Official product information and resources
46-
* **[User Manual](https://www.st.com/resource/en/user_manual/um2407-stm32h7-nucleo144-boards-mb1364-stmicroelectronics.pdf)**: Board documentation and technical specifications
90+
* **Product Page**: [https://www.st.com/en/evaluation-tools/b-u585i-iot02a.html](https://www.st.com/en/evaluation-tools/b-u585i-iot02a.html)
91+
* **User Manual**: [https://www.st.com/resource/en/user_manual/um2839-discovery-kit-for-iot-node-with-stm32u5-series-stmicroelectronics.pdf](https://www.st.com/resource/en/user_manual/um2839-discovery-kit-for-iot-node-with-stm32u5-series-stmicroelectronics.pdf)

‎docs/board-support/index.md‎

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,5 +6,15 @@ nav_order: 6
66
---
77

88
# Board Support
9+
The Ocre runtime supports various development boards, each offering different features and capabilities. Each board's documentation provides:
10+
- Hardware specifications and features
11+
- Connection and setup instructions
12+
- Flashing procedures
13+
- Reset and recovery steps
14+
- Relevant board documentation links
915

10-
This is the list of currently supported boards by the Ocre platform. Click on the manufacturer below:
16+
Select your boards manufacturer in the **sidebar** to the left, and subsequently your specific board for detailed setup and usage instructions for your board.
17+
18+
## Adding Board Support
19+
If your board isn't listed in our supported devices, check out the [Adding Board Support](../board-support/adding-support/index) guide in the sidebar. This guide walks you through the process of adding support for new development boards to the Ocre runtime.
20+
I've:

‎docs/quickstart/prerequisites/serial-console/index.md‎

Lines changed: 2 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -7,10 +7,6 @@ nav_order: 0
77

88
# Serial console
99

10-
A serial console program enables you to access the serial port on your board. This will allow you to interact with the device and see useful information reported by the device. If you are familiar with serial consoles, you may opt to use your favorite program with the following configuration:
10+
A serial console program enables you to access the serial port on your board. This will allow you to interact with the device and see useful information reported by the device.
1111

12-
* 115200 baud rate
13-
* 8-bit data
14-
* No parity
15-
* 1 stop bit
16-
* No flow control
12+
See the [Board Support](../../../board-support/index) section for more details on how to connect to your specific board.

0 commit comments

Comments
 (0)