Zephyr Devicetree

Zephyr Devicetree Skill

Expert guidance on Zephyr's devicetree system for hardware description, driver integration, and build-time code generation.

Table of Contents

1. Core Concepts
2. Common Workflows
3. Hardware Configuration
4. Advanced Topics
5. Troubleshooting

Core Concepts

Understanding Devicetree Structure

Devicetree is a tree of nodes and properties. Zephyr uses bindings to validate nodes and generate C macros.

• Basic syntax, nodes, properties: See syntax.md
• Bindings and compatible matching: See bindings.md
• Address translation (#address-cells, #size-cells, ranges): See address-translation.md

Key Files in a Build

After building, check these for debugging:

• build/zephyr/zephyr.dts — Final merged devicetree
• build/zephyr/include/generated/devicetree_generated.h — Generated macros

Common Workflows

1. Modifying Hardware via Overlays

Overlays customize hardware without modifying base Zephyr files.

• Override properties, add nodes, enable/disable devices: See overlays.md

2. Writing Custom Bindings

Bindings define the schema for devicetree nodes.

• Basic binding structure: See bindings.md
• Advanced features (child-binding, enums, specifier-cells): See advanced-bindings.md

3. Accessing Devicetree from C Code

Zephyr provides compile-time macros to access devicetree data.

• Basic macros (node IDs, properties, registers): See macros.md
• Advanced macros (iteration, strings, bus helpers): See advanced-macros.md

Hardware Configuration

Pin Control (Pinctrl)

Configure pin multiplexing and electrical properties.

• See pinctrl.md

Clocks

Configure clock providers and consumers.

• See clocks.md

Interrupts

Configure interrupt controllers and consumers with multi-level support.

• See interrupts.md

DMA

Configure DMA controllers and channel assignments.

• See dma.md

Advanced Topics

Address Translation

Understanding #address-cells, #size-cells, and ranges for complex SoC hierarchies.

• See address-translation.md

Advanced Binding Features

Child bindings, enums, const, specifier-cells, and binding inheritance.

• See advanced-bindings.md

Advanced C Macros

Iteration macros, string helpers, and bus-specific conveniences.

• See advanced-macros.md

Troubleshooting

For common errors and debugging techniques:

• See debugging.md

Quick Reference

Practical Examples

See examples.md for complete working examples:

• GPIO LED (Blinky)
• I2C Sensor
• SPI Flash with Partitions
• PWM Buzzer
• UART with Pin Control
• ADC Channel Configuration
• CAN Bus Setup
• Timer/Counter Configuration