{"_id":"543ebaedcc182e08005d0cc4","is_link":false,"user":"543b93f865bf840e00b473b2","version":{"_id":"543b943865bf840e00b473b6","__v":5,"project":"543b943865bf840e00b473b3","createdAt":"2014-10-13T08:58:32.703Z","releaseDate":"2014-10-13T08:58:32.703Z","categories":["543b943865bf840e00b473b7","543b96e1b1479b1400c42f3d","543d1cdc3a300f20000d31ee","553e061924ec240d00b1f897","553e06431a946a0d00ad6f78"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"category":{"_id":"543b943865bf840e00b473b7","version":"543b943865bf840e00b473b6","project":"543b943865bf840e00b473b3","__v":15,"pages":["543ffb2c22a3b30e001bdc37","543b965fb1479b1400c42f3a","543d1cbb5276641a00a593c3","543d3ff2a10ab32000b3aa9e","543d1fa83a300f20000d3206","543f8f8a051bdc0e00dfbf02","543d4a17a10ab32000b3aace","543ea21f3f50eb1a00ed2050","543ea6ac3f50eb1a00ed205e","543ebaedcc182e08005d0cc4","543f8cb422a3b30e001bdb48","543f838422a3b30e001bdb36","544184629c7623200053c8e7","5541356a69a03a2d00ce0b3b"],"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2014-10-13T08:58:32.718Z","from_sync":false,"order":9999,"slug":"documentation","title":"Documentation"},"__v":2,"project":"543b943865bf840e00b473b3","updates":[],"next":{"pages":[],"description":""},"createdAt":"2014-10-15T18:20:29.064Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"basic_auth":false,"results":{"codes":[]},"try":true,"auth":"never","params":[],"url":""},"isReference":false,"order":8,"body":"The table below contains a list of allowed characteristics. This will be extended over time. The philosophy has been to keep the app-adaptor API simple, so, for example, temperature is always in degrees Celsius and is a floating-point number. Apps and adaptors can easily make any conversions that are required for their own purposes. \n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Characteristic\",\n    \"h-1\": \"Unit/Type\",\n    \"h-2\": \"Description\",\n    \"0-0\": \"temperature\",\n    \"1-0\": \"humidity\",\n    \"2-0\": \"pressure\",\n    \"3-0\": \"luminance\",\n    \"4-0\": \"battery\",\n    \"5-0\": \"binary_sensor\",\n    \"6-0\": \"switch\",\n    \"0-1\": \"Celcius/float\",\n    \"0-2\": \"Temperature\",\n    \"1-1\": \"Percent/float\",\n    \"1-2\": \"Relative humidity\",\n    \"2-1\": \"Bar/float\",\n    \"2-2\": \"Atmospheric pressure\",\n    \"3-1\": \"Lux/float\",\n    \"3-2\": \"Luminance\",\n    \"4-1\": \"Percent/float\",\n    \"4-2\": \"Battery status as a percentage of fully-charged\",\n    \"5-1\": \"-/string\",\n    \"5-2\": \"Can take the values “on” and “off”\",\n    \"6-1\": \"-/string\",\n    \"6-2\": \"Can take the values “on” and “off”\",\n    \"7-0\": \"connected\",\n    \"7-1\": \"-/Boolean\",\n    \"7-2\": \"Indicates whether a device is currently connected\",\n    \"8-0\": \"voltage\",\n    \"8-1\": \"Volt/float\",\n    \"9-0\": \"current\",\n    \"9-1\": \"Ampere/float\",\n    \"10-0\": \"power\",\n    \"10-1\": \"Watt/float\",\n    \"11-0\": \"energy\",\n    \"11-1\": \"KJ/float\",\n    \"8-2\": \"Voltage\",\n    \"9-2\": \"Current\",\n    \"10-2\": \"Power\",\n    \"11-2\": \"Energy\",\n    \"12-0\": \"buttons\",\n    \"12-1\": \"-/dict\",\n    \"12-2\": \"The states of a group of buttons in the form:\\n{\\n    \\\"1\\\": \\\"string\\\",\\n    \\\"2\\\": \\\"string\\\"\\n}\\nThe string can take the values \\\"on\\\" or \\\"off\\\". There may be one or more buttons.\"\n  },\n  \"cols\": 3,\n  \"rows\": 13\n}\n[/block]\n[Next ...](doc:the-cb-command)","excerpt":"","slug":"characteristics","type":"basic","title":"Characteristics"}
The table below contains a list of allowed characteristics. This will be extended over time. The philosophy has been to keep the app-adaptor API simple, so, for example, temperature is always in degrees Celsius and is a floating-point number. Apps and adaptors can easily make any conversions that are required for their own purposes. [block:parameters] { "data": { "h-0": "Characteristic", "h-1": "Unit/Type", "h-2": "Description", "0-0": "temperature", "1-0": "humidity", "2-0": "pressure", "3-0": "luminance", "4-0": "battery", "5-0": "binary_sensor", "6-0": "switch", "0-1": "Celcius/float", "0-2": "Temperature", "1-1": "Percent/float", "1-2": "Relative humidity", "2-1": "Bar/float", "2-2": "Atmospheric pressure", "3-1": "Lux/float", "3-2": "Luminance", "4-1": "Percent/float", "4-2": "Battery status as a percentage of fully-charged", "5-1": "-/string", "5-2": "Can take the values “on” and “off”", "6-1": "-/string", "6-2": "Can take the values “on” and “off”", "7-0": "connected", "7-1": "-/Boolean", "7-2": "Indicates whether a device is currently connected", "8-0": "voltage", "8-1": "Volt/float", "9-0": "current", "9-1": "Ampere/float", "10-0": "power", "10-1": "Watt/float", "11-0": "energy", "11-1": "KJ/float", "8-2": "Voltage", "9-2": "Current", "10-2": "Power", "11-2": "Energy", "12-0": "buttons", "12-1": "-/dict", "12-2": "The states of a group of buttons in the form:\n{\n \"1\": \"string\",\n \"2\": \"string\"\n}\nThe string can take the values \"on\" or \"off\". There may be one or more buttons." }, "cols": 3, "rows": 13 } [/block] [Next ...](doc:the-cb-command)