mirror of
https://github.com/Telecominfraproject/ols-ucentral-schema.git
synced 2025-11-01 18:47:51 +00:00
d2042faf6b
Extend state/unit.yml to report triplet that states which mac
has been learned on which port in which vlan.
Example of "mac-forwarding-table" in json format:
...
"mac-forwarding-table": {
"overflow": false,
"Ethernet0": {
"1": ["90:3c:b3:6a:e3:59"]
},
"Ethernet1": {
"1": ["90:3c:b3:6a:e4:d5"]
},
"Ethernet47": {
"1": ["ac:1f:6b:65:a4:86"]
},
"Ethernet46": {
"1": ["ac:1f:6b:65:a4:89"]
}
},
...
Signed-off-by: Oleksandr Mazur <oleksandr.mazur@plvision.eu>
uCentral Schema
Collection of JSON schemas and ucode template (utpl) files used by uCentral for validating the data model and rendering incoming configuration JSON into UCI batch sequences.
This software is a part of the OpenWiFi AP NOS.
Building
Dependencies
In order to run the test cases you will need the following tools:
- ucode
- ucentral-jsonschema
- jsonlint-php
- pip3 install jsonschema2md
- pip3 install json-schema-for-humans
- pip3 install python-json2yaml
Unit testing
./run_tests.sh
Documentation
JSDoc is used to generate API documentation
with a ucode transpiler (ucode-transpiler.js), configured by jsdoc.conf.json.
Additional JSON schema docs are generated using
json-schema-for-humans via
the script generate.sh.
Developer Notes
Generated documentation
- JSDoc: https://ucentral.io/docs/
schemaobject: http://ucentral.io/docs/ucentral-schema.htmlstateobject: https://ucentral.io/docs/ucentral-state.html
Installed files
The following ucode scripts are installed to the AP:
schemareader.uc- autogenerated schema readerrenderer/*- renderer sources and templatescommand/*- predefined command implementations, e.g. invoked by ucentral-clientsystem/*- scripts to generate system information (e.g. state, telemetry, health, capabilities)