For builders / Terms
Terms for the Web of Things
Every card is also published as a W3C Web of Things Thing Model, so other tools can read the catalog in a standard form. The standard already says whether a value can be changed and whether an action is safe to repeat. These are the terms Hardpoint adds, under the prefix hp, which stands for https://dotcipher.github.io/hardpoint/ns.html#
| Term | Meaning |
|---|---|
| hp:card | The id of the Hardpoint card this model was made from. |
| hp:kind | What kind of device it is. |
| hp:identity | Whether the matching evidence identifies a model, a family, or an integration class. |
| hp:match | How software recognises the device when it is attached. |
| hp:risk | The label on this ability: read, reversible, guarded or gated. |
| hp:floor | The lowest label the shared vocabulary allows this ability to have. |
| hp:harm | What goes wrong if this is done carelessly. |
| hp:privacy | The most that may leave the adapter: open, aggregate or presence. |
| hp:adapter | The code that reaches this ability on the device. |
| hp:checked | How far this claim has been checked: tested, observed, imported or unverified. |
| hp:verification | The records behind that: platform, versions, date and what exactly was checked. |
| hp:firmware | The firmware the device has to be running for this claim to hold. |
Labels
- read
- Nothing changes. The value is only read.
- reversible
- Changes take effect at once, can be undone at once, and cannot stop you using the machine.
- guarded
- Could get in the way of using the machine, so the change is reverted unless you confirm it within a few seconds.
- gated
- Cannot be undone, or needs a physical step. Nothing happens until you approve that exact action, and a step that needs your hands stays yours.
Checked
- tested
- Someone exercised this through the named adapter on that platform.
- observed
- Seen working or present on a real device, but not yet through the adapter.
- imported
- Taken from another project's data. Nobody here has tried it.
- unverified
- Documented somewhere. Nobody here has tried it.
Models
One file per card, at models/<maker>-<model>.tm.jsonld. Each device's page links to its own.