AgentSkillsCN

devicetree

Zephyr RTOS 的 DeviceTree 管理。涵盖语法、绑定、叠加层，以及硬件模型 v2（HWMv2），并深入探讨节点与属性的删除模式。在定义硬件拓扑、创建叠加层，或进行引脚与外设映射时，可触发此流程。

SKILL.md
--- frontmatter
name: devicetree
description: Devicetree management for Zephyr RTOS. Covers syntax, bindings, overlays, Hardware Model v2 (HWMv2), and advanced node/property deletion patterns. Trigger when defining hardware topology, creating overlays, or mapping pins and peripherals.

Zephyr Devicetree

The Devicetree (DT) is the source of truth for your hardware topology in Zephyr.

Core Workflows

1. Understanding Syntax & Nodes

Nodes, properties, and phandles form the hierarchy.

  • •Reference: dt_syntax.md
  • •Key Tools: Labels (&label), Properties (reg, status, compatible).

2. Working with Bindings

Mapping hardware descriptions to driver schemas.

  • •Reference: dt_bindings.md
  • •Key Tools: YAML bindings, compatible strings, pinctrl.

3. Application Overlays & HWMv2

Modifying board behavior for specific application needs.

  • •Reference: dt_overlays.md
  • •Key Tools: .overlay files, zephyr,chosen, variant-specific overlays.

4. Advanced Hardware Modification

Deleting and redefining nodes/properties for product variants.

  • •Reference: dt_overlays.md
  • •Key Tools: /delete-node/, /delete-property/.

Tooling & Validation

  • •west build -t rom_report: See how devicetree definitions impact memory.
  • •build/zephyr/zephyr.dts: Inspect the FINAL resolved devicetree after all overlays are applied.
  • •scripts/devicetree/gen_defines.py: (Internal) The tool that turns DT into C macros.

Resources

  • •References:
    • •dt_syntax.md: Core syntax and properties.
    • •dt_bindings.md: Binding definitions and compatible mapping.
    • •dt_overlays.md: Overlays, HWMv2, and deletion patterns.