validate-sbmd

Étoiles7

Forks6

Mis à jour10 juillet 2026 à 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

Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.

Source

rdkcentral

rdkcentral/BartonCore

Ouvrir le dépôt GitHub Voir les dépôts du créateur

Téléchargement

Métiers associésSOC

Basé sur la classification professionnelle SOC

Développeurs de logicielsProfessions informatiques et mathématiques·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)

Plus depuis ce dépôt

même dépôt

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)