| 1 Definition | 2 Functional Requirements | 3 Syntax | 4 Semantics |
1 Definition
Item Property (MMM-IPR) is the Data Type that gives Properties of an Item of an M-Instance: each Property has a Name from the MPAI vocabulary of Table 2 and a Value of the type and among the values that the vocabulary gives the Name. A Process sets Properties of an Item with Property Change (RQ12, With Properties), for instance to open or lock a Door or to switch on a Lamp. The vocabulary takes its names and values, where they exist, from the W3C Web of Things Thing Description, from the Matter device types and clusters and from the IFC property sets of building elements; it can grow without changing Property Change.
2 Functional Requirements
- The Data shall have Header “MMM-IPR-V3.0”.
- The Data shall identify the Item whose Properties it gives and may identify the M-Instance and give a time.
- The Data shall include at least one Property. The Name of each Property shall be one of Table 2, and its Value shall be of the type and among the values that Table 2 gives that Name.
- The Data may include DataXMData and descriptive metadata.
3 Syntax
https://schemas.mpai.community/MMM4/V3.0/data/ItemProperty.json
4 Semantics
Table 1 gives the semantics of the properties of Item Property and Table 2 the vocabulary of Properties.
Table 1 – Properties of Item Property
| Label | Description |
| Header | Header of the Data Type, with the version: “MMM-IPR-V3.0”. (required) |
| MInstanceID | Identifier of the M-Instance. |
| ItemID | Identifier of the Item whose Properties are given. (required) |
| ItemPropertyTime | Time at which the Properties are given. |
| Properties | The Properties, at least one. (required) |
| – Name | The Name of the Property, one of Table 2. (required) |
| – Value | The Value of the Property, of the type and among the values that Table 2 gives the Name. (required) |
| DataXMData | Data Exchange Metadata of MPAI-PTF. |
| DescrMetadata | Descriptive metadata (plain text, at most 2048 characters). |
Table 2 – The vocabulary of Properties
| Name | Meaning | Values | Comparable in |
| OpenState | whether a Door, Window, Gate, Drawer or Container is open. | Open, Closed | Matter Window Covering; IFC door operation |
| LockState | whether a Door, Gate or Container is locked. | Locked, Unlocked | Matter Door Lock |
| PowerState | whether a Lamp, Screen or Device is on. | On, Off | Matter On/Off |
| Level | the level of a Lamp (brightness), of a Speaker (volume) or of a Blind (position), from 0 to 1. | a number from 0 to 1 | Matter Level Control |
| Colour | the colour of a Lamp or of a surface, as sRGB. | sRGB, as #RRGGBB | Matter Color Control |
| Temperature | the temperature of a Room or the set point of a Thermostat, in degrees Celsius. | a number, degrees Celsius | Matter Thermostat |
| Occupancy | whether a Seat or a Room is occupied. | Free, Occupied | Matter Occupancy Sensing |
| Playback | the state of a Screen, a Speaker or an Audio or Visual Object that plays. | Playing, Paused, Stopped | Matter Media Playback |