Skip to content

Commit c7704ca

Browse files
committed
fixed more atym speak, added first board to board support, and a few other minor changes
1 parent 253abd8 commit c7704ca

17 files changed

Lines changed: 92 additions & 44 deletions

File tree

docs/architecture/containers/index.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,8 @@ parent: Architecture
66
nav_order: 1
77
---
88

9-
Ocre containers are lightweight, portable environments that allow software to run consistently across different platforms. In the embedded world, Ocre/Ocre containers bring the benefits of containerization to resource-constrained devices, revolutionizing embedded development. Ocre containers (which are identical to [Ocre](https://lfedge.org/projects/ocre/) containers in function) enable developers to write applications in any language that can compile to WebAssembly, including C, C++, Rust, and more. This flexibility allows organizations to easily repackage existing C code into containerized apps, significantly simplifying management compared to monolithic firmware.
9+
Ocre containers are lightweight, portable environments that allow software to run consistently across different platforms. In the embedded world, Ocre containers bring the benefits of containerization to resource-constrained devices, revolutionizing embedded development. Ocre containers enable developers to write applications in any language that can compile to WebAssembly, including C, C++, Rust, and more. This flexibility allows organizations to easily repackage existing C code into containerized apps, significantly simplifying management compared to monolithic firmware.
1010

11-
12-
![](containers.png)
11+
![](ocre_containers.webp)
1312

1413
The containerized approach facilitates easier collaboration in embedded projects, allowing vendors to contribute modules without deep integration challenges. Moreover, containers provide enhanced security through virtualization, which is particularly crucial for tiny devices lacking hardware memory management units. Importantly, Ocre containers offer these benefits while maintaining near-native performance, making them suitable for a wide range of embedded applications.
63 KB
Loading

docs/architecture/index.md

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

88
# Architecture
99

10-
![](ocre_solution.png)
1110
Ocre's core architecture consists of two **primary** components.
1211

1312
- **[Ocre Runtime:](../architecture/runtime/)** Installed on embedded devices, it serves as a stable base for container deployments. This commercially-supported version of the open-source [Ocre](https://lfedge.org/projects/ocre/) runtime provides a hardware abstraction layer and container runtime, working seamlessly with the Ocre Hub. It allows developers to focus on building solutions rather than dealing with low-level device details.

docs/architecture/runtime/index.md

Lines changed: 8 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -4,28 +4,20 @@ title: Ocre Runtime
44
parent: Architecture
55
nav_order: 0
66
---
7-
87
# Ocre Runtime
98

9+
The Ocre Runtime enables containerization on resource-constrained devices through a combination of proven open-source technologies:
1010

11-
The Ocre Runtime is built upon the foundation of the [Ocre Runtime](https://lfedge.org/projects/ocre/), an entirely open-source initiative that provides the core functionality for running containerized applications on embedded devices.
11+
![](ocre_runtime.webp)
1212

13-
---
13+
## Components
1414

15-
![](ocre_runtime_detailed.png)
15+
- **[Zephyr](https://zephyrproject.org)**: A mature RTOS providing comprehensive library support, modularity, and support for hundreds of platforms out-of-the-box with easy adaptation to new hardware.
1616

17-
## Components
17+
- **[WebAssembly Micro Runtime](https://github.com/bytecodealliance/wasm-micro-runtime)**: Provides lightweight, sandboxed execution of containers through efficient virtualization.
1818

19-
As illustrated in the diagram above, the runtime is composed of two main layers: the open-source Ocre components (in orange) and Ocre's proprietary additions (in green).
19+
- **[WASI Components](https://component-model.bytecodealliance.org/introduction.html)**: Implements the WebAssembly System Interface for embedded systems, enabling standardized system access.
2020

21-
### Ocre Components (Open-source)
22-
- **[Zephyr](https://zephyrproject.org)**: Ocre is built on the Zephyr RTOS for its comprehensive library support, modularity, and active developer community. This choice enables support for hundreds of platforms out-of-the-box and easy adaptation to new or custom hardware.
23-
- **[WebAssembly Micro Runtime](https://github.com/bytecodealliance/wasm-micro-runtime)**: Used as the virtualization layer, it allows for lightweight, sandboxed execution of containers on resource-constrained devices.
24-
- **Runtime Manager**: Oversees the execution of WebAssembly containers on target devices.
25-
- **Application Framework**: Supports multi-container embedded applications.
26-
- **[WASI Components](https://component-model.bytecodealliance.org/introduction.html)**: Tailored implementations of the WebAssembly System Interface for embedded systems.
27-
- **Hardware Abstraction Layer (HAL)**: Facilitates the "develop once, deploy anywhere" approach.
21+
- **Application Framework**: Manages container lifecycle, resource allocation, and inter-container communication for multi-container applications.
2822

29-
### Ocre Components (Proprietary)
30-
- **Device Manager**: Manages the secure boot process, establishes connection with the Ocre Hub, handles configuration updates, and maintains runtime integrity according to the manifest file.
31-
- **Container Supervisor**: Manages container lifecycles using a state machine approach. It oversees container creation, execution, and termination, interfacing with the Ocre container runtime.
23+
- **Runtime Manager**: Controls container deployment, updates, and monitoring across target devices.
61 KB
Loading
-221 KB
Binary file not shown.
2.2 MB
Loading
Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
---
2+
title: "B-U585I-IOT02A"
3+
layout: default
4+
parent: ST
5+
grandparent: Board Support
6+
---
7+
8+
# B-U585I-IOT02A Discovery Board Overview
9+
10+
---
11+
12+
## Overview
13+
14+
The **STM32 B-U585I-IOT02A Discovery Board** is a versatile IoT development platform built around ST Micro's STM32U585AI microcontroller. This board combines ultra-low-power operation with advanced security features, making it ideal for developing IoT, wearable, and sensor applications.
15+
16+
Key features include:
17+
* Arm® Cortex®-M33 processor with TrustZone® security
18+
* 2 MB Flash memory and 786 KB SRAM
19+
* Wi-Fi® (802.11 b/g/n) and Bluetooth® Low Energy connectivity
20+
* Rich sensor array:
21+
* 3D accelerometer and gyroscope
22+
* Temperature and humidity sensor
23+
* Digital barometer
24+
* Time-of-flight and gesture detection
25+
* Multiple expansion options via ARDUINO® Uno V3, STMod+, and Pmod™ connectors
26+
* Integrated STLINK-V3E debugger with USB connectivity
27+
28+
In the diagram below, you can see many of the board's physical components:
29+
30+
![Board Layout](B-U585I-IOT02A.png)
31+
32+
---
33+
34+
## Powering the Device
35+
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.
37+
38+
---
39+
40+
## Connecting to the Device
41+
42+
---
43+
44+
## Rebooting the Device
45+
46+
You may reboot the device by pressing the black button once.
47+
48+
---
49+
50+
## Resetting the Device to Factory Defaults
51+
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 from the Atym hub. 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.
53+
54+
---
55+
56+
## Important Links
57+
58+
For additional details about the board and development tools, please refer to the following resources:
59+
60+
* **Product Page**: [https://www.st.com/en/evaluation-tools/b-u585i-iot02a.html](https://www.st.com/en/evaluation-tools/b-u585i-iot02a.html)
61+
* **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)
62+
* **STM32CubeIDE**: [https://www.st.com/content/st_com/en/stm32cubeide.html](https://www.st.com/content/st_com/en/stm32cubeide.html)
Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
---
2-
title: Placeholder
2+
title: ST
33
layout: default
44
parent: Board Support
5-
nav_order: 0
5+
has_children: true
66
---
77

8-
# Placeholder
8+
# ST Boards
Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
---
22
title: Board Support
33
layout: default
4-
parent: Reference
5-
has_children: true
4+
has_children: true
5+
nav_order: 6
66
---
77

88
# Board Support

0 commit comments

Comments
 (0)