Metadata

Type: object

Metadata is a description about the device: a specification about how the device should be configured and expectations about what the device should be doing. Defined by metadata.json

No Additional Properties

Type: string

RFC 3339 timestamp UTC the data was generated


Example:

"2019-01-17T14:02:29.364Z"

Type: string

Version of the UDMI schema for this file

Type: string

Original version of the UDMI schema for this file

Type: string

Generic human-readable text describing the device

Type: string

Automatically generated field that contains the hash of file contents.

Must match regular expression: ^[0-9a-z]{8}$

Type: string

Version of schema supported by the device

Type: object

Information specific to how the device communicates with the cloud.

No Additional Properties

Type: string

Not published by devices which publish , appended to message subblocks within cloud pipeline. RFC 3339 Timestamp the payload was generated


Example:

"2019-01-17T14:02:29.364Z"

Type: string

Version of the UDMI schema

Type: enum (of string)

The key type used for cloud communication.

Must be one of:

  • "ES256"
  • "ES256_X509"
  • "RS256"
  • "RS256_X509"

Type: boolean

Indicates if the device private key is provided in the site model.

Type: enum (of string)

The resource type of this model

Must be one of:

  • "DEVICE"
  • "GATEWAY"
  • "REGISTRY"

Type: boolean

Type: array

Each item of this array must be:

Type: object

Type: enum (of string)

The key type used for cloud communication.

Must be one of:

  • "ES256"
  • "ES256_X509"
  • "RS256"
  • "RS256_X509"

Type: string

Type: string

Type: string

Type: enum (of string)

Must be one of:

  • "FETCH"
  • "CREATE"
  • "UPDATE"
  • "DELETE"
  • "BIND"
  • "BLOCK"

Type: object

All property whose name matches the following regular expression must respect the following conditions

Property name regular expression: ^[-_a-zA-Z0-9]+$
Type: string

Type: object

If operating on the entire registry, then this manifests as a map of devices not just one device.

All property whose name matches the following regular expression must respect the following conditions

Property name regular expression: ^[-_a-zA-Z0-9]+$
Type: object

Type: object

High-level system information about the device. System Model Documentation

No Additional Properties

Type: object

Properties the expected physical location of the device.

No Additional Properties

Type: string

The site name according to the site model in which a device is installed in

Must match regular expression: ^[A-Z]{2}-[A-Z]{3}-[A-Z0-9]{2,9}$
Example:

"US-SFO-XYY"

Type: string
Must match regular expression: ^[A-Z0-9-]+$

Type: object
No Additional Properties

Type: number

The x coordinate of the device location in a project specific coordinate system

Type: number

The y coordinate of the device location in a project specific coordinate system

Type: number

The z (height) coordinate of the device location in a project specific coordinate system

Type: object

A collection of fields which describe the physical hardware of the device.

No Additional Properties

Type: string

The manufacturer of the device


Example:

"Google"

Type: string

The model of the device


Examples:

"Pixel 5"
"Pixel 6"
"Pixel 6 Pro"

Type: string

A stock keeping unit which identifies the unique composition of a device, for example those with different hardware configurations


Examples:

"GF5KQ"
"4215612"

Type: string

Hardware revision of the device


Examples:

"A"
"B"
"1"

Type: object

A collection of items which can be used to describe version of software running on a device

No Additional Properties
Examples:

"firmware"
"os"
"driver"

All property whose name matches the following regular expression must respect the following conditions

Property name regular expression: ^[a-z_]+$
Type: string

Type: object

Information used to print a physical QR code label.

No Additional Properties

Type: object
No Additional Properties

Type: string
Must match regular expression: ^[a-z]+://[-0-9a-zA-Z_$]+$

Type: string
Must match regular expression: ^[A-Z]{2}-[A-Z]{3}-[A-Z0-9]{2,9}$

Type: string
Must match regular expression: ^[A-Z]{2,6}-[0-9]{1,6}$

Type: object
No Additional Properties

Type: string
Must match regular expression: ^[a-zA-Z0-9-]+$

Type: integer Default: 300

The minimum loglevel for reporting log messages below which log entries should not be sent. Default to 300.

Value must be greater or equal to 100 and lesser or equal to 800

Type: object

Gateway Documentation

No Additional Properties

Type: object

The following properties are required:

  • gateway_id
Type: object

The following properties are required:

  • proxy_ids

Type: string

The device ID of the gateway the device is bound to

Must match regular expression: ^[A-Z]{2,6}-[0-9]{1,6}$
Example:

"GAT-100"

Type: string

Protocol family used for connecting to the proxy device

Type: array of string

An array of all the device IDs which are bound to the device

Each item of this array must be:

Type: string
Must match regular expression: ^[A-Z]{2,6}-[0-9]{1,6}$

Example:

[
    "AHU-22"
]

Type: object

Discovery target parameters

No Additional Properties

Type: object

All property whose name matches the following regular expression must respect the following conditions

Property name regular expression: ^[a-z][a-z0-9]*(_[a-z0-9]+)*$
Type: object

Type: object

Used to describe device local network parameters

No Additional Properties

Type: object
No Additional Properties

All property whose name matches the following regular expression must respect the following conditions

Property name regular expression: ^[a-z0-9-]+$
Type: object

The type of network

No Additional Properties
Examples:

"bacnet"
"modbus"

Type: string

The address of a device on the local network


Example:

"0x414889"

Type: object

Testing target parameters

No Additional Properties

Type: boolean

Type: object
No Additional Properties

All property whose name matches the following regular expression must respect the following conditions

Property name regular expression: ^[a-z][a-z0-9]*(_[a-z0-9]+)*$
Type: object
No Additional Properties

Type: string

Point name used for testing

Type: object

Value used for testing

Type: object

Model of supported features

No Additional Properties

All property whose name matches the following regular expression must respect the following conditions

Property name regular expression: ^[._a-zA-Z]+$
Type: object

Object representation for for a single feature enumeration

No Additional Properties

Type: enum (of string)

Stage of a feature implemenation

Must be one of:

  • "disabled"
  • "alpha"
  • "preview"
  • "beta"
  • "stable"

Type: object

Pointset representing the abstract system expectation for what the device should be doing, and how it should be configured and operated. This block specifies the expected points that a device holds

No Additional Properties

Type: object

Information about a specific point name of the device.

No Additional Properties

All property whose name matches the following regular expression must respect the following conditions

Property name regular expression: ^[a-z][a-z0-9]*(_[a-z0-9]+)*$
Type: object

Information about a specific point name of the device.

No Additional Properties

Type: string

Expected unit configuration for the point

Type: boolean

Indicates if this point is writable (else read-only)

Type: object

Represents the expected baseline value of the point


Example:

22

Type: number

Maximum deviation from baseline_value


Example:

2

Type: enum (of string)

Expected state when baseline_value is set as the set_value for this point the config message

Must be one of:

  • "applied"
  • "updating"
  • "overridden"
  • "invalid"
  • "failure"

Type: number

Triggering threshold for partial cov update publishing


Example:

1

Type: string

Mapping for the point to an internal resource (e.g. BACnet object reference)


Examples:

"AI3"
"400070"

Type: integer

Minimum time between sample updates for the device (including complete and COV updates). Updates more frequent than this should be coalesced into one update.

Value must be greater or equal to 0 and lesser or equal to 86400

Type: integer

Maximum time between samples for the device to send out a complete update. It can send out updates more frequently than this. Default to 600.

Value must be greater or equal to 1 and lesser or equal to 86400