[For builders](https://dotcipher.github.io/hardpoint/format.html) / 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.
