SGPIOM JSON Tooling

This directory contains AST10x0 SGPIOM configuration tooling that replaces DTS-style wiring with a declarative JSON pipeline.

What This Builds

The tool consumes board manifests and produces deterministic build artifacts:

• sgpiom_merged.json: canonical merged manifest
• sgpiom_config_generated.rs: generated Rust config module
• sgpiom_report.txt: summary report (optional)
• check/validate stamp outputs for CI gates

Generated Rust symbols include:

• SGPIOM_CONTROLLER
• SGPIOM_BANKS
• SGPIOM_SIGNALS
• SGPIOM_MANIFEST_HASH

CLI

Tool entrypoint:

• tools/sgpiom/sgpio_json_tool.py

Subcommands:

• validate: schema and semantic checks
• merge: deterministic merge of input manifests
• generate: emit Rust static config module
• check: verify generated output is up to date
• report: print human-readable usage summary

Example Inputs

• tools/sgpiom/examples/common.json
• tools/sgpiom/examples/ast1060_dcscm.json
• tools/sgpiom/examples/ast1060_prot_dice.json

Local Usage

Validate:

python3 tools/sgpiom/sgpio_json_tool.py validate \
  --input tools/sgpiom/examples/common.json \
  --input tools/sgpiom/examples/ast1060_dcscm.json

Merge:

python3 tools/sgpiom/sgpio_json_tool.py merge \
  --input tools/sgpiom/examples/common.json \
  --input tools/sgpiom/examples/ast1060_dcscm.json \
  --output /tmp/sgpiom_merged.json

Generate:

python3 tools/sgpiom/sgpio_json_tool.py generate \
  --input tools/sgpiom/examples/common.json \
  --input tools/sgpiom/examples/ast1060_dcscm.json \
  --output /tmp/sgpiom_config_generated.rs

Check:

python3 tools/sgpiom/sgpio_json_tool.py check \
  --input tools/sgpiom/examples/common.json \
  --input tools/sgpiom/examples/ast1060_dcscm.json \
  --output /tmp/sgpiom_config_generated.rs

Report:

python3 tools/sgpiom/sgpio_json_tool.py report \
  --input tools/sgpiom/examples/common.json \
  --input tools/sgpiom/examples/ast1060_dcscm.json

Bazel Integration

Bazel tool package:

• //tools/sgpiom

Board-level SGPIOM pipeline targets:

• //target/ast10x0/board:sgpiom_validate
• //target/ast10x0/board:sgpiom_merged
• //target/ast10x0/board:sgpiom_generate
• //target/ast10x0/board:sgpiom_check
• //target/ast10x0/board:sgpiom_report

Board crate consumption target:

• //target/ast10x0/board:ast10x0_board

Build all SGPIOM pipeline targets:

bazelisk build --config=k_ast1060_evb \
  //target/ast10x0/board:ast10x0_board \
  //target/ast10x0/board:sgpiom_validate \
  //target/ast10x0/board:sgpiom_merged \
  //target/ast10x0/board:sgpiom_generate \
  //target/ast10x0/board:sgpiom_check \
  //target/ast10x0/board:sgpiom_report

Notes

• Board crate selects configuration; peripherals crate consumes typed config.
• Keep manifests declarative and deterministic to avoid runtime parser complexity.