Hardpoint

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#

TermMeaning
hp:cardThe id of the Hardpoint card this model was made from.
hp:kindWhat kind of device it is.
hp:identityWhether the matching evidence identifies a model, a family, or an integration class.
hp:matchHow software recognises the device when it is attached.
hp:riskThe label on this ability: read, reversible, guarded or gated.
hp:floorThe lowest label the shared vocabulary allows this ability to have.
hp:harmWhat goes wrong if this is done carelessly.
hp:privacyThe most that may leave the adapter: open, aggregate or presence.
hp:adapterThe code that reaches this ability on the device.
hp:checkedHow far this claim has been checked: tested, observed, imported or unverified.
hp:verificationThe records behind that: platform, versions, date and what exactly was checked.
hp:firmwareThe 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.