Service currently supports the following devices and its traits
Switch
Switch, a basic device in Smart Home, has binary modes on/off only.
Input message
msg.payload =
TRUE / FALSE
Required state of the switch
Output message
msg.payload =
TRUE / FALSE
Represents the state of the switch
Message Payloads
Payload type
Payload value and type for On/Off value are customizable [string / number / boolean / JSON / buffer]
Optional
Two-factor authentication
Two-factor authentication (2FA) lets you add second-factor security to voice commands. The Google Assistant can issue two types of challenges - explicit acknowledgement or personal identification number (PIN).
Init state
Initial value after Node-RED restart (until the connected equipment sends another value).
Light
Light, a basic device in Smart Home, has binary modes on/off, brightness and color settings modes.
Input message
Without brightness control
msg.payload =
TRUE / FALSE
Required state of the light
With brightness control
msg.payload =
0..100
Required brightness of the light
With color control or with "complete state as payload"
msg.payload = {
on
TRUE / FALSE
Required state of the light
brightness
0..100
Required brightness of the light
color : {
spectrumHsv : {
Required color of the light in the HSV format
hue
0..360
Hue
saturation
0..1
Saturation
value
0..1
Lightness
}
}
}
Output message
Without brightness control
msg.payload =
TRUE / FALSE
Represents the state of the light
With brightness control
msg.payload =
0..100
Represents the brightness of the light
With color control or with "complete state as payload"
msg.payload = {
on
TRUE / FALSE
Represents the state of the light
brightness
0..100
Represents the brightness of the light
color : {
spectrumHsv : {
Represents the color of the light in the HSV format
hue
0..360
Hue
saturation
0..1
Saturation
value
0..1
Lightness
}
}
}
Message Payloads
Payload type
Payload value and type for On/Off value are customizable [string / number / boolean / JSON / buffer]
Optional
Two-factor authentication
Two-factor authentication (2FA) lets you add second-factor security to voice commands. The Google Assistant can issue two types of challenges - explicit acknowledgement or personal identification number (PIN).
Outlet
Outlet, a basic device in Smart Home, has binary modes on/off only.
Input message
msg.payload =
TRUE / FALSE
Required state of the outlet
Output message
msg.payload =
TRUE / FALSE
Represents the state of the outlet
Message Payloads
Payload type
Payload value and type for On/Off value are customizable [string / number / boolean / JSON / buffer]
Optional
Two-factor authentication
Two-factor authentication (2FA) lets you add second-factor security to voice commands. The Google Assistant can issue two types of challenges - explicit acknowledgement or personal identification number (PIN).
Init state
Initial value after Node-RED restart (until the connected equipment sends another value).
Blinds
Blinds can be opened and closed, and various types of blinds are supported such as venetian (opens in one direction), panel or vertical (may open either left or right), and top-down bottom-up (may open either up or down).
Input message
msg.payload =
0..100
Required how they are open
Output message
msg.payload =
0..100
Represents how they are open
Optional
Two-factor authentication
Two-factor authentication (2FA) lets you add second-factor security to voice commands. The Google Assistant can issue two types of challenges - explicit acknowledgement or personal identification number (PIN).
Init state
Initial value after Node-RED restart (until the connected equipment sends another value).
Invert value
Invert value for open / close state
Lock
Locks can be locked, unlocked, and report a locked state. Locking and Unlocking is a security sensitive action which can require two-factor authentication.
Input message
msg.payload =
TRUE / FALSE
Required state of the lock
Output message
msg.payload =
TRUE / FALSE
Represents the state of the lock
Jamming
msg.topic =
"jammed" / ""
Information aboud jammed or not jammed state of the lock. It's also required TRUE / FALSE state of payload.
Optional
Payload type
Payload value and type for On/Off value are customizable [string / number / boolean / JSON / buffer]
Two-factor authentication
Two-factor authentication (2FA) lets you add second-factor security to voice commands. The Google Assistant can issue two types of challenges - explicit acknowledgement or personal identification number (PIN).
Init state
Initial value after Node-RED restart (until the connected equipment sends another value).
Garage
Garage doors can be opened and closed, and detect an open state. Opening and Closing is a security sensitive action which can require two-factor authentication.
Input message
msg.payload =
0..100
Required how they are open
Output message
msg.payload =
0..100
Represents how they are open
Message Payloads
Payload type
Payload value and type for On/Off value are customizable [string / number / boolean / JSON / buffer]
Optional
Discrete function
When set to true, this indicates that the device must either be fully open or fully closed (that means it does not support values between 0% and 100%).
Two-factor authentication
Two-factor authentication (2FA) lets you add second-factor security to voice commands. The Google Assistant can issue two types of challenges - explicit acknowledgement or personal identification number (PIN).
Init state
Initial value after Node-RED restart (until the connected equipment sends another value).
Gate
Gate can be opened and closed, and detect an open state. Opening and Closing is a security sensitive action which can require two-factor authentication.
Input message
msg.payload =
0..100
Required how they are open
Output message
msg.payload =
0..100
Represents how they are open
Optional
Discrete function
When set to true, this indicates that the device must either be fully open or fully closed (that means it does not support values between 0% and 100%).
Two-factor authentication
Two-factor authentication (2FA) lets you add second-factor security to voice commands. The Google Assistant can issue two types of challenges - explicit acknowledgement or personal identification number (PIN).
Init state
Initial value after Node-RED restart (until the connected equipment sends another value).
Doors
Doors can be opened and closed. Opening and Closing is a security sensitive action which can require two-factor authentication.
Input message
msg.payload =
TRUE / FALSE
Required state of the door
Output message
msg.payload =
TRUE / FALSE
Represents the state of the door
Optional
Two-factor authentication
Two-factor authentication (2FA) lets you add second-factor security to voice commands. The Google Assistant can issue two types of challenges - explicit acknowledgement or personal identification number (PIN).
Init state
Initial value after Node-RED restart (until the connected equipment sends another value).
Query Only
This attribute indicates if the device can only be queried for state information, and cannot be controlled (like sensors).
Window
Window can be opened and closed. Opening and Closing is a security sensitive action which can require two-factor authentication.
Input message
msg.payload =
TRUE / FALSE
Required state of the window
Output message
msg.payload =
TRUE / FALSE
Represents the state of the window
Optional
Two-factor authentication
Two-factor authentication (2FA) lets you add second-factor security to voice commands. The Google Assistant can issue two types of challenges - explicit acknowledgement or personal identification number (PIN).
Init state
Initial value after Node-RED restart (until the connected equipment sends another value).
Query Only
This attribute indicates if the device can only be queried for state information, and cannot be controlled (like sensors).
Thermostat
Thermostats are temperature-managing devices with set points and modes. This separates them from heaters and AC units which may only have modes and settings (for example, high/low) vs a temperature target.
Input message
msg.payload = {
mode
HEAT / COOL / HEATCOOL /ON / AUTO / FAN-ONLY /PURIFIER / ECO / DRY
Required thermostat mode
setpoint
Float number
Setpoint temperature in degrees celsius (if mode is not 'heatcool')
setpointLow
Float number
Setpoint low temperature in degrees celsius (if mode is 'heatcool')
setpointHigh
Float number
Setpoint high temperature in degrees celsius (if mode is 'heatcool')
temperature
Float number
Ambient temperature in degrees celsius
humidity
0..100
Ambient relative humidity
}
Output message
msg.payload = {
mode
HEAT / COOL / HEATCOOL /ON / AUTO / FAN-ONLY /PURIFIER / ECO / DRY
Represents thermostat mode
setpoint
Float number
Setpoint temperature in degrees celsius (if mode is not 'heatcool')
setpointLow
Float number
Setpoint low temperature in degrees celsius (if mode is 'heatcool')
setpointHigh
Float number
Setpoint high temperature in degrees celsius (if mode is 'heatcool')
temperature
Float number
Ambient temperature in degrees celsius
humidity
0..100
Ambient relative humidity
}
Optional
Two-factor authentication
Two-factor authentication (2FA) lets you add second-factor security to voice commands. The Google Assistant can issue two types of challenges - explicit acknowledgement or personal identification number (PIN).
Init state
Initial value after Node-RED restart (until the connected equipment sends another value).
Supported modes
Represents thermostat mode [HEAT / COOL / HEATCOOL / ON / AUTO / FAN-ONLY / PURIFIER / ECO / DRY]
Buffer Range Celsius
Specifies the minimum offset between heat-cool setpoints in Celsius, if heatcool mode is supported.
Command Only
Indicates if the device supports using one-way (true) or two-way (false) communication.
Query Only
This attribute indicates if the device can only be queried for state information, and cannot be controlled (like sensors).
Speaker
Adjust the volume settings for connected speaker.
Input message
msg.payload = {
on
TRUE / FALSE
Required state of the speaker
volume
0..100
Required volume of the speaker
}
Output message
msg.payload = {
on
TRUE / FALSE
Represents the state of the speaker
volume
0..100
Represents the volumen of the speaker
isMuted
TRUE / FALSE
Speaker is muted
}
Optional
Two-factor authentication
Two-factor authentication (2FA) lets you add second-factor security to voice commands. The Google Assistant can issue two types of challenges - explicit acknowledgement or personal identification number (PIN).
Volume step
The default step size for relative volume queries.
Default volume
The volume (in percentage) for the default volume as defined by the user or manufacturer. The scale must be 0-100.
Max volume
The maximum volume level, assuming a baseline of 0 (mute). The Assistant will adjust adverbial commands (e.g. 'make the tv a little louder') accordingly.
Mute / Unmute
Indicates if the device can mute and unmute the volume. This is reflected in volume state - if volume is 5, and the user mutes, the volume remains 5 and isMuted is true.
Command Only
Indicates if the device operates using one-way (true) or two-way (false) communication.
Scene
In the case of scenes, the type maps 1:1 to the trait, as scenes don't combine with other traits to form composite devices.
Output message
msg.payload
TRUE / FALSE
Activate / Deactivate the selected scene
Message Payloads
Payload type
Payload value and type for On/Off value are customizable [string / number / boolean / JSON / buffer]
Optional
Two-factor authentication
Two-factor authentication (2FA) lets you add second-factor security to voice commands. The Google Assistant can issue two types of challenges - explicit acknowledgement or personal identification number (PIN).
Scene reversible
Indicating that this scene may be reversed. This is only relevant for scenes that modify state and remember previous state. Obviously, scenes that fire specific actions may not be reversible.