validate-sbmd

Stars7

Forks6

UpdatedJuly 10, 2026 at 15:02

Validate SBMD (Spec-Based Matter Driver) v4 specification files. Use when the user has edited .sbmd.js files, wants to check schema conformance, or verify driver structure. Covers the validation script, JSON schema, spec file locations, and automatic build-time validation.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

rdkcentral

rdkcentral/BartonCore

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

SKILL.md

readonly

name	validate-sbmd
description	Validate SBMD (Spec-Based Matter Driver) v4 specification files. Use when the user has edited .sbmd.js files, wants to check schema conformance, or verify driver structure. Covers the validation script, JSON schema, spec file locations, and automatic build-time validation.
license	Apache-2.0
compatibility	Requires the BartonCore Docker development container with Python 3, Node.js, and the jsonschema Python package.
metadata	{"author":"rdkcentral","version":"2.0"}

Validate SBMD Specs

SBMD v4 drivers are .sbmd.js JavaScript files that register a driver via SbmdDriver({...}). Validation ensures the registration object conforms to the JSON schema.

Automatic Validation (During Build)

When BCORE_MATTER_VALIDATE_SCHEMAS=ON (the default), SBMD validation runs automatically as part of the build:

cmake --build build

The validate_sbmd_specs target uses Node.js to extract each driver's registration object and validates it against the JSON schema. This is the easiest way to validate.

Manual Validation

Validate SBMD Spec Files

python3 scripts/ci/validate_sbmd_v4_specs.py \
    core/deviceDrivers/matter/sbmd/schema \
    core/deviceDrivers/matter/sbmd/specs/*.sbmd.js

This:

Uses Node.js to evaluate each .sbmd.js file in a sandbox
Extracts the SbmdDriver() registration object as JSON (functions → true)
Validates the JSON against sbmd-spec-schema-v4.0.json

The validator evaluates each .sbmd.js file, extracts the SbmdDriver() registration object, and validates it against the JSON schema.

File Locations

Item	Location
SBMD spec files	`core/deviceDrivers/matter/sbmd/specs/*.sbmd.js`
JSON schema	`core/deviceDrivers/matter/sbmd/schema/sbmd-spec-schema-v4.0.json`
TypeScript definitions (editor tooling only — not used by the validator)	`core/deviceDrivers/matter/sbmd/scriptCommon/sbmd-script.d.ts`
Validation script	`scripts/ci/validate_sbmd_v4_specs.py`
Extraction harness	`scripts/ci/sbmd_extract_registration.js`

Discovering Available SBMD Specs

To see the current set of specs in the repository, list the directory contents:

ls core/deviceDrivers/matter/sbmd/specs/

Error Recovery

If python3 or validation dependencies are not found:

Check if /.dockerenv exists
If it does NOT exist, stop and tell the user: "Validation tools are not available. Please run inside the BartonCore development container."
If it does exist, ensure the validator's dependencies are installed: Node.js (used to extract the SbmdDriver() registration object) and the jsonschema Python package (used to validate it against the schema)

More from this repository

same repository

reference-app

rdkcentral/BartonCore

Run and interact with the BartonCore reference application. Use when the user wants to start the reference app, commission devices, execute/read/write resources, or troubleshoot runtime issues. Covers CLI flags, interactive commands, isolated session management, and known pitfalls.

2026-07-107

format-code

rdkcentral/BartonCore

Format C/C++ code in BartonCore. Use when the user wants to format source files, understand formatting conventions, or fix formatting issues. Covers clang-format usage, the diff-only rule, manual blank-line conventions that clang-format cannot enforce, and the pre-commit hook.

2026-07-107

build

rdkcentral/BartonCore

Build BartonCore from source. Use when the user wants to compile the project, rebuild after code changes, reconfigure CMake options, or understand the build system. Covers the build.sh convenience script, incremental cmake builds, CMake configuration flags, and the development build profile.

2026-05-267

debug

rdkcentral/BartonCore

Debug BartonCore applications and tests. Use when the user needs to set breakpoints, step through code, inspect state, or diagnose crashes. Covers three workflows — gdb for the C/C++ reference app and unit tests, pdb/debugpy for Python integration tests, and gdb-with-Python for debugging C code called from Python tests.

2026-05-267

matter-virtual-devices

rdkcentral/BartonCore

Work with Matter test devices in BartonCore. Use when the user wants to start Matter sample apps, use chip-tool to commission or control devices, work with matter.js virtual devices for integration testing, or create new custom virtual device types. Covers pre-built sample apps, chip-tool commands, and the matter.js sideband API.

2026-05-267

run-integration-tests

rdkcentral/BartonCore

Run BartonCore Python integration tests. Use when the user wants to run integration tests, verify end-to-end behavior, run specific test files, or filter tests by keyword or marker. Covers pytest via the py_test.sh wrapper, ASAN preloading, test filtering, prerequisites, and the CI all-in-one script.

2026-05-267

name	validate-sbmd
description	Validate SBMD (Spec-Based Matter Driver) v4 specification files. Use when the user has edited .sbmd.js files, wants to check schema conformance, or verify driver structure. Covers the validation script, JSON schema, spec file locations, and automatic build-time validation.
license	Apache-2.0
compatibility	Requires the BartonCore Docker development container with Python 3, Node.js, and the jsonschema Python package.
metadata	{"author":"rdkcentral","version":"2.0"}

Validate SBMD Specs

SBMD v4 drivers are .sbmd.js JavaScript files that register a driver via SbmdDriver({...}). Validation ensures the registration object conforms to the JSON schema.

Automatic Validation (During Build)

When BCORE_MATTER_VALIDATE_SCHEMAS=ON (the default), SBMD validation runs automatically as part of the build:

cmake --build build

The validate_sbmd_specs target uses Node.js to extract each driver's registration object and validates it against the JSON schema. This is the easiest way to validate.

Manual Validation

Validate SBMD Spec Files

python3 scripts/ci/validate_sbmd_v4_specs.py \
    core/deviceDrivers/matter/sbmd/schema \
    core/deviceDrivers/matter/sbmd/specs/*.sbmd.js

This:

Uses Node.js to evaluate each .sbmd.js file in a sandbox
Extracts the SbmdDriver() registration object as JSON (functions → true)
Validates the JSON against sbmd-spec-schema-v4.0.json

The validator evaluates each .sbmd.js file, extracts the SbmdDriver() registration object, and validates it against the JSON schema.

File Locations

Item	Location
SBMD spec files	`core/deviceDrivers/matter/sbmd/specs/*.sbmd.js`
JSON schema	`core/deviceDrivers/matter/sbmd/schema/sbmd-spec-schema-v4.0.json`
TypeScript definitions (editor tooling only — not used by the validator)	`core/deviceDrivers/matter/sbmd/scriptCommon/sbmd-script.d.ts`
Validation script	`scripts/ci/validate_sbmd_v4_specs.py`
Extraction harness	`scripts/ci/sbmd_extract_registration.js`

Discovering Available SBMD Specs

To see the current set of specs in the repository, list the directory contents:

ls core/deviceDrivers/matter/sbmd/specs/

Error Recovery

If python3 or validation dependencies are not found:

Check if /.dockerenv exists
If it does NOT exist, stop and tell the user: "Validation tools are not available. Please run inside the BartonCore development container."
If it does exist, ensure the validator's dependencies are installed: Node.js (used to extract the SbmdDriver() registration object) and the jsonschema Python package (used to validate it against the schema)