Skip to content

Data Types~

There are 5 major data types that openHASP uses when communicating over MQTT:

Boolean~

Properties with a boolean data type accept these values and are case insensitive:

  • true / ON / 1 / yes
  • false / OFF / 0 / no

The return value will be either 1/0 or on/off depending on the context.

Integer~

Numeric properties have integer values with a variable minimum and maximum input value.
Certain object properties also support negative values.

Details

int8 (signed) supports values ranging from -128 to 127.
uint8 (unsigned) supports values ranging from 0 to 255.
int16 (signed) supports values ranging from -32768 to 32767.
uint16 (unsigned) supports values ranging from 0 to 65535.

String~

Properties that accept textual input. When sending raw text in the MQTT payload or as command parameter no quotes are needed.
Only when a text value is included in a jsonl or json command, it needs to be quoted accoring to JSON rules.

JSON Object~

Some properties can be set or retrieved in JSON format too. The JSON object has several keys that have a boolean, integer or string data type.

Example: {"cover":"cover.my_room","position":"50"}

Colors~

Color values can be:

  • Short names (from table below)
  • RGB hex code (#rrggbb)
  • Short hex code (#rgb)
  • RGB565 number format (0..65535)
Hex Code Short Name Hex Code Short Name
#00FFFF
 Cyan or Aqua
#FFC0CB
 Pink
#00FF00
 Lime
#DDA0DD
 Plum
#008000
 Green
#DA70D6
 Orchid
#008080
 Teal
#EE82EE
 Violet
#0000FF
 Blue
#FF00FF
 Magenta or Fuchsia
#000080
 Navy
#800080
 Purple
#808000
 Olive
#4B0082
 Indigo
#CD853F
 Peru
#B00000
 Blush
#A0522D
 Sienna
#FF0000
 Red
#A52A2A
 Brown
#FF6347
 Tomato
#800000
 Maroon
#FA8072
 Salmon
#FFFFFF
 White
#FF7F50
 Coral
#FFFAFA
 Snow
#FFA500
 Orange
#FFFFF0
 Ivory
#FFD700
 Gold
#FAF0E6
 Linen
#FFFF00
 Yellow
#F5F5DC
 Beige
#F0E68C
 Khaki
#F0FFFF
 Azure
#FFE4C4
 Bisque
#C0C0C0
 Silver
#F5DEB3
 Wheat
#808080
 Gray or Grey
#D2B48C
 Tan
#000000
 Black

Setting Color~

Examples: 

1
2
3
4
p0b2.value_color=13891
p1b5.text_color=silver
p2b3.bg_color=#C042A3
p2b4.border_color=#9f9

Return values~

When retrieving the color of an object, both the HTML representation as the RGB values are returned separately.

The format will be a json object with components:

  • color : 6 digit hexadecimal code preceeded by a hash # sign.
  • r : byte value for red (0..255)
  • g : byte value for green (0..255)
  • b : byte value for blue (0..255)

For example, the color returned by a color picker change event is: 

1
{"color":"#00fff6","r":0,"g":255,"b":246}

Variables~

Some properties can be set with variable data at plate runtime. Use the strings below to retrieve data:

  • %ip% - IP address of the plate
  • %hostname% - hostname (nodename)
  • %ssid% - SSID of the network connected to
  • %model% - plate model (set in the firmware)
  • %version% - firmware version number
Last update: 2023-12-09