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: content/hardware/04.pro/carriers/portenta-hat-carrier/tutorials/user-manual/content.md
+21-4Lines changed: 21 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2582,21 +2582,25 @@ The pins used for the JTAG debug port on the Portenta Hat Carrier are the follow
2582
2582
2583
2583
## Understanding Device Tree Blobs (DTB) Overlays
2584
2584
2585
+
### Device Tree Blobs (DTB) And DTB Overlays
2586
+
2585
2587
In the world of embedded systems, _U-boot_ and the _Linux kernel_ use a concept called __Device Tree Blobs (DTB)__ to describe a board's hardware configuration. This approach allows for a unified main source tree to be used across different board configurations, ensuring consistency.
2586
2588
2587
2589
The boards, acting as carriers, allow various peripherals to be connected, such as temperature sensors or accelerometers. These carriers serve as expansion connectors. You might want to connect various peripherals and be able to add or remove them easily.
2588
2590
2589
-
The concept of modularity is applied to the _DTB_, resulting in __DTB overlays__. The hardware configuration is split into multiple small files, each representing a different peripheral or function.
2591
+
The concept of modularity is applied to the _DTB_, resulting in __DTB overlays__. The hardware configuration is split into multiple small files, each representing a different peripheral or function in the form of a DTB overlay.
2590
2592
2591
2593
During the early boot stage, these overlays are merged together into a single DTB and loaded into RAM. This approach enables users to select and change configurations with ease. However, it is important to note that changing the hardware configuration requires a system reboot to maintain system stability.
2592
2594
2595
+
### Handling DTB Overlays
2596
+
2593
2597
You can modify and maintain the Device Tree Blob (DTB) overlays through a couple of methods. In builds that do not prioritize security, you can edit the file located at the following location:
2594
2598
2595
2599
```
2596
2600
/boot/devicetree/overlays.txt
2597
2601
```
2598
2602
2599
-
After making the desired changes, it is necessary to save and reboot the system to apply desired changes.
2603
+
After making the desired changes, it is necessary to save the changes and reboot the system to apply them.
2600
2604
2601
2605
On the other hand, in builds that prioritize security, the *fw_setenv tool* accessible in user space must be used to apply the corresponding changes to the U-boot settings as follows:
Currently, parameters are passed indirectly to the overlays; however, upcoming enhancements to U-boot will introduce direct parameter passing functionality.
2608
2612
2609
-
U-boot can be configured to automatically load specific DTB overlays based on the carrier board it detects, in this case Portenta Hat Carrier, either by probing specific hardware or by reading an identification ID from an EEPROM.
2613
+
### Custom DTB Overlays
2614
+
2615
+
In cases where the required DTB overlay is not readily available and a specific configuration that is not part of the pre-compiled set is needed, it is possible to create customized DTB overlays.
2616
+
2617
+
DTB overlays originate from readable source files known as _DTS files_. Users with the respective experience can modify these DTS files and cross-compile them to create tailored overlays suited to their needs.
2618
+
2619
+
### Automated Load And Carrier Detection
2610
2620
2611
-
The configuration was done by logging into the board and executing commands on the shell. For instance, for a Portenta-X8 placed on a Portenta HAT Carrier, the expected output is as follows:
2621
+
U-boot can be configured to automatically load specific DTB overlays based on the carrier board it detects, in this case the Portenta Hat Carrier, either by probing specific hardware or by reading an identification ID from an EEPROM.
2622
+
2623
+
For instance, for a Portenta-X8 placed on a Portenta HAT Carrier, upon logging into the board and executing subsequent commands on the shell, the expected output is as follows:
The commands above enable functionalities such as a speed-controlled fan connector, an OV5647 based RPi v1.3 camera, and an IQ Audio Codec Zero audio HAT.
2640
2652
2653
+
### Hardware Configuration Layers
2654
+
2641
2655
Hardware configuration is divided into the following layers:
2642
2656
2643
2657
-__Layer 0__: System on Module (SoM), prefixed with `ov_som_`.
@@ -2654,6 +2668,9 @@ Some overlays, such as:
2654
2668
2655
2669
add functionalities like Wi-Fi® and external microcontroller support. If no known carrier is detected, the first two overlays are applied by default if the Portenta X8 is mounted as the main board.
2656
2670
2671
+
#### Distinction Between System And Hardware Configuration
2672
+
<br></br>
2673
+
2657
2674
The distinction between system and hardware configuration is crucial. System configuration includes settings such as user creation and Wi-Fi® passwords, whereas hardware configuration is explicitly defined through the device tree.
2658
2675
2659
2676
In production environments, the addition of custom compiled device tree overlays is restricted to maintain system integrity and security.
0 commit comments