{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"7"}},"macroMetadata":{"macroId":{"value":"c185a0af-4a15-466d-9677-900ab91b821d"},"schemaVersion":{"value":"1"},"title":"org.randombits.confluence.toc.toc.label"}},"localId":"6bf6fc00-7fd2-471e-8d99-ce7d93fe3de9"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"MQTT Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"Each Gumband Hardware Device maintains two MQTT broker connections: one to handle global gumband events (Cloud), and one to handle exhibit events (Exhibit). The purpose is to keep exhibit events on the lowest latency and most reliable connection to ensure super responsive performance and improve up time (especially when the Cloud server is remote). The hardware can also be run without a connection to the Cloud server but maintaining the Gumband messaging protocol. When a Gumband device registers through the cloud and is attached to an active exhibit, the Exhibit server IP/hostname will be returned. Note: this could be the same IP/hostname as the Cloud server in the case of an on-premises Cloud server (but it can't be the same port).","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1600,"id":"0f557dc2-0191-45b0-b798-1791e52b74fb","collection":"contentId-445711168","type":"file","height":1125}}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Cloud Server","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Firmware updates","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Device Registration","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Heartbeat","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Error/Warnings","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Logs","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Lifecycle commands (restart, shutdown, etc)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"When in Debug Mode supports all control events (for test and debug) ","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Exhibit Server","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Device Registration","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Heartbeats","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"All peripheral/property events specific to exhibits","type":"text"}]}]}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1600,"id":"3ec4b545-1ecf-4a67-b295-a80a709119b8","collection":"contentId-445711168","type":"file","height":1008}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Hardware Authentication","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The user creates a hardware auth token from the \"Auth\" tab for that hardware within the Gumband UI.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"That token needs to be written to the hardware either through the serial interface or the firmware API.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On boot the hardware will subscribe to the topic: ","type":"text"},{"text":"/authenticate","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"At this point no other subscribe or publish is allowed by the Cloud until authentication has completed","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"When an unknown hardware device attempts to open a socket with the GBTT server and subscribe to the authenticate topic (Note: The Cloud must wait for the HW to subscribe to this), the Cloud will issue a ","type":"text"},{"text":"request","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" event to this topic: ","type":"text"},{"text":"/authenticate","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"codeBlock","content":[{"text":"{\n \"text\": \"request\" \n}","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The HW responds to a request with it's authentication token in the following format:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Topic =","type":"text"},{"text":" /authenticate","type":"text","marks":[{"type":"strong"}]}]}]}]}]}]},{"type":"codeBlock","content":[{"text":"{\n \"token\": 32 char alphanumeric \n}","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If the token and hardwareId are valid, the server will respond on the ","type":"text"},{"text":"authenticate","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"topic","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"with “true”.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Topic = ","type":"text"},{"text":"/authenticate","type":"text","marks":[{"type":"strong"}]}]}]}]}]}]},{"type":"codeBlock","content":[{"text":"{\n \"text\": \"true\"\n}","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If the token is not valid, the server will respond on the ","type":"text"},{"text":"authenticate","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"topic","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"with “false”.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Topic = ","type":"text"},{"text":"/authenticate","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"codeBlock","content":[{"text":"{\n \"text\": \"false\" \n}","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If the hardwareId is not valid, the server will respond on the ","type":"text"},{"text":"authenticate","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"topic","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"with “id”.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Topic = ","type":"text"},{"text":"/authenticate","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"codeBlock","content":[{"text":"{\n \"text\": \"id\" \n}","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If the authentication fails or the HW fails to respond to the authentication request then the GBTT server ignores all data on this socket (but does not explicitly close it).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Any events/topics published without first authenticating will be responded with an ","type":"text"},{"text":"error","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"event on the ","type":"text"},{"text":"info","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" topic (see INFO). Note no other subscribe or publish is allowed during the authentication handshake or the auth will fail, so it’s important not to send anything else until this is completed.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"All topic subscriptions (other than ","type":"text"},{"text":"authenticate","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":") will be rejected until the auth sequence is completed.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Hardware Registration ","type":"text"}]},{"type":"paragraph","content":[{"type":"status","attrs":{"color":"neutral","style":"bold","text":"Updated 8/15/2023","localId":"3994116a-bbbf-4ad4-9bb0-8d38e9e58e57"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"This occurs whenever the initial connection is made to the MQTT cloud server after authentication, this contains the device capabilities only. To obtain actual property states readable topics can be polled.","type":"text"}]},{"type":"paragraph","content":[{"text":"Registration can also occur when a registration request is received from the server (the ","type":"text"},{"text":"INFO","type":"text","marks":[{"type":"strong"}]},{"text":" topic “register” command).","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Once authenticated, the HW sends Gumband registration event to the Cloud Server and Exhibit Server at the topic: ","type":"text"},{"text":"/registration","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Registration events should be logged on the server side","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Registration events have an initial JSON message body identifying the device and the total number of peripherals, followed by individual registration messages for each property of every peripheral. Outline below:","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Topic = ","type":"text"},{"text":"/registration","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"{\n \"hardwareId\": ##, // globally unique hardwareId from Gumband\n \"mac\": \"MAC_ADDRESS\",\n \"gumband_fw\": ##,\n \"user_fw\": ##,\n \"hw_ver\": ##,\n \"ip\": \"IP_ADDR\",\n \"numPeripherals\": ## \n \"exhibitIP\": \"IP_ADDR\" \n \"exhibitState\": 1/0 \n}","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Topic = ","type":"text"},{"text":"/registration/property","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"{\n \"hardwareId\": ##,\n \"peripheral\": \"lamp\", \n \"property\": \"power\",\n \"order\": ##,\n \"numProperties\": ##,\n \"type\": \"xxxxx\",\n \"length\": 1,\n \"settable\": true,\n \"gettable\": true,\n \"hidden\": true,\n \"info\":\"Mouse Over Text\"\n}","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Registration Flow","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Cloud Registration","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"b0c674cd-6f4b-45f3-b1c0-bfa7b0284b90"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Sequence","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[200.0]},"content":[{"type":"paragraph","content":[{"text":"Source","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[279.0]},"content":[{"type":"paragraph","content":[{"text":"Message","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[184.0]},"content":[{"type":"paragraph","content":[{"text":"Destination","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"1","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[200.0]},"content":[{"type":"paragraph","content":[{"text":"Gumband Hardware","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[279.0]},"content":[{"type":"paragraph","content":[{"text":"Subscribe Authenticate","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[184.0]},"content":[{"type":"paragraph","content":[{"text":"Cloud Server","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"2","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[200.0]},"content":[{"type":"paragraph","content":[{"text":"Cloud Server","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[279.0]},"content":[{"type":"paragraph","content":[{"text":"Authenticate ","type":"text"},{"text":"request","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[184.0]},"content":[{"type":"paragraph","content":[{"text":"Gumband Hardware","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"3","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[200.0]},"content":[{"type":"paragraph","content":[{"text":"Gumband Hardware","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[279.0]},"content":[{"type":"paragraph","content":[{"text":"Authenticate ","type":"text"},{"text":"token","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[184.0]},"content":[{"type":"paragraph","content":[{"text":"Cloud Server","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"4","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[200.0]},"content":[{"type":"paragraph","content":[{"text":"Cloud Server","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[279.0]},"content":[{"type":"paragraph","content":[{"text":"Authenticate response ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[184.0]},"content":[{"type":"paragraph","content":[{"text":"Gumband Hardware","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"5","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[200.0]},"content":[{"type":"paragraph","content":[{"text":"Gumband Hardware","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[279.0]},"content":[{"type":"paragraph","content":[{"text":"Subscribe SYNC ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[184.0]},"content":[{"type":"paragraph","content":[{"text":"Cloud Server","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"6","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[200.0]},"content":[{"type":"paragraph","content":[{"text":"Gumband Hardware","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[279.0]},"content":[{"type":"paragraph","content":[{"text":"Subscribe INFO ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[184.0]},"content":[{"type":"paragraph","content":[{"text":"Cloud Server","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"7","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[200.0]},"content":[{"type":"paragraph","content":[{"text":"Gumband Hardware","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[279.0]},"content":[{"type":"paragraph","content":[{"text":"Subscribe all peripheral topics","type":"text"},{"text":"1","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[184.0]},"content":[{"type":"paragraph","content":[{"text":"Cloud Server","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"8","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[200.0]},"content":[{"type":"paragraph","content":[{"text":"Gumband Hardware","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[279.0]},"content":[{"type":"paragraph","content":[{"text":"Publish REGISTRATION ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[184.0]},"content":[{"type":"paragraph","content":[{"text":"Cloud Server","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"9","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[200.0]},"content":[{"type":"paragraph","content":[{"text":"Cloud Server","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[279.0]},"content":[{"type":"paragraph","content":[{"text":"Publish exhibit HOST to INFO","type":"text"},{"text":"2","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[184.0]},"content":[{"type":"paragraph","content":[{"text":"Gumband Hardware","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"10","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[200.0]},"content":[{"type":"paragraph","content":[{"text":"Cloud Server","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[279.0]},"content":[{"type":"paragraph","content":[{"text":"Publish Debug status","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[184.0]},"content":[{"type":"paragraph","content":[{"text":"Gumband Hardware","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"11","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[200.0]},"content":[{"type":"paragraph","content":[{"text":"Gumband Hardware","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[279.0]},"content":[{"type":"paragraph","content":[{"text":"Start ","type":"text"},{"text":"Exhibit Registration","type":"text","marks":[{"type":"underline"},{"type":"link","attrs":{"href":"https://docs.google.com/document/d/1TKpZhViCZPbiN5Q2yGMN-jVY0lOid1gbDKZLlFRqZ_M/edit#heading=h.hxzm5tgghtw8"}}]},{"text":"3","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[184.0]},"content":[{"type":"paragraph","content":[{"text":"Exhibit Server","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"12","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[200.0]},"content":[{"type":"paragraph","content":[{"text":"Gumband Hardware","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[279.0]},"content":[{"type":"paragraph","content":[{"text":"Heartbeat (Every 16s)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[184.0]},"content":[{"type":"paragraph","content":[{"text":"Cloud Server","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Note:","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For Debug only","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Should be implemented on every connection but only required if the hardware does not already have a saved exhibit server address or if the address has changed","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If the hardware already holds an exhibit address this will happen in parallel with the master connection","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Exhibit Registration","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"49626adf-d988-4a87-afd4-e3f99987099d"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[99.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Sequence","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[174.0]},"content":[{"type":"paragraph","content":[{"text":"Source","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"Message","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.0]},"content":[{"type":"paragraph","content":[{"text":"Destination","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[99.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"1","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[174.0]},"content":[{"type":"paragraph","content":[{"text":"Gumband Hardware","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"Subscribe Authenticate","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.0]},"content":[{"type":"paragraph","content":[{"text":"Exhibit Server","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[99.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"2","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[174.0]},"content":[{"type":"paragraph","content":[{"text":"Exhibit Server","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"Authenticate ","type":"text"},{"text":"request","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.0]},"content":[{"type":"paragraph","content":[{"text":"Gumband Hardware","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[99.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"3","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[174.0]},"content":[{"type":"paragraph","content":[{"text":"Gumband Hardware","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"Authenticate ","type":"text"},{"text":"token","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.0]},"content":[{"type":"paragraph","content":[{"text":"Exhibit Server","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[99.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"4","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[174.0]},"content":[{"type":"paragraph","content":[{"text":"Exhibit Server","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"Authenticate response ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.0]},"content":[{"type":"paragraph","content":[{"text":"Gumband Hardware","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[99.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"5","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[174.0]},"content":[{"type":"paragraph","content":[{"text":"Gumband Hardware","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"Subscribe all peripheral topics","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.0]},"content":[{"type":"paragraph","content":[{"text":"Exhibit Server","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[99.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"6","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[174.0]},"content":[{"type":"paragraph","content":[{"text":"Gumband Hardware","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"Heartbeat (Every 16s)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.0]},"content":[{"type":"paragraph","content":[{"text":"Exhibit Server","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1280,"id":"58270add-5bf4-4fb2-8a55-cfba24a61b75","collection":"contentId-445711168","type":"file","height":887}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"INFO Messages","type":"text"}]},{"type":"paragraph","content":[{"text":"Gumband Cloud Server needs a way to signal each hardware device to send simple control commands. In this case, the information is published to the device INFO topic to which each device subscribes first (before publishing its initial authentication/registration). The INFO topic is also used during the initial handshake to share the exhibit broker host details.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Every Gumband hardware device should be subscribed to the topic: ","type":"text"},{"text":"/info","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"This subscription occurs prior to every registration","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The contents of the info topic is a 2 parameter JSON structure:","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"{\n \"command\": \"xxxx\",\n \"text\": \"xxxx\"\n}","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"8d3ddbc4-d9f9-4b20-9f34-506d8bc41318"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.67]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Command","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[153.67]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Text","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[391.67]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.67]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"host","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[153.67]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"xxx.xxx.xxx.xxx:xxxx","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[391.67]},"content":[{"type":"paragraph","content":[{"text":"Exhibit server host IP and Port","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.67]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"reboot","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[153.67]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"-","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[391.67]},"content":[{"type":"paragraph","content":[{"text":"Reboot the Gumband Hardware","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.67]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"register","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[153.67]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"-","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[391.67]},"content":[{"type":"paragraph","content":[{"text":"Request the hardware to register with the Cloud Server ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.67]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"get","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[153.67]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"-","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[391.67]},"content":[{"type":"paragraph","content":[{"text":"Request the hardware to publish all of it’s current property values","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.67]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"firmware","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[153.67]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"-","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[391.67]},"content":[{"type":"paragraph","content":[{"text":"Enter Device Firmware Update (DFU) mode on Gumband Hardware using the existing Cloud MQTT socket ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.67]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"firmware_socket","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[153.67]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"-","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[391.67]},"content":[{"type":"paragraph","content":[{"text":"Enter Device Firmware Update (DFU) mode on Gumband Hardware using a dedicated TCP socket on port 23 (this only works if that port is not already connected)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.67]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"control","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[153.67]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"true/false","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[391.67]},"content":[{"type":"paragraph","content":[{"text":"Set to true to enable debug mode whereby peripheral control messages can be sent from the Cloud","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.67]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"identify","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[153.67]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"-","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[391.67]},"content":[{"type":"paragraph","content":[{"text":"Blink the on board LED to identify this hardware device","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.67]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"error","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[153.67]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"(see below table)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[391.67]},"content":[{"type":"paragraph","content":[{"text":"Allows Gumband server to send error codes to the hardware","type":"text"}]}]}]}]},{"type":"paragraph"},{"type":"table","attrs":{"layout":"default","localId":"f2223ee0-0608-4cb7-871a-adf8fe10f170"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"\"","type":"text"},{"text":"Error","type":"text","marks":[{"type":"strong"}]},{"text":"\"","type":"text"},{"text":" Command Text","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"E_NO_HW_ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"When an MQTT message is sent to Gumband for a hardwareId that does not exist","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"NOT_AUTHED","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"When an MQTT message is sent to Gumband from a client that has not authenticated yet","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Heartbeats","type":"text"}]},{"type":"paragraph","content":[{"text":"Heartbeats are sent from the Gumband Hardware every 16 seconds and are published to the topic: ","type":"text"},{"text":"/heartbeat","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"With the payload:","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"{\n \"hardwareId\": \"\"\"\n \"uptime\": \"######\",\n \"exhibitIP\": \"\" \n \"exhibitState\": \"1/0/-1\"\n \"temp\": \"##.##\"\n \"voltage\": \"##.##\"\n}","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Board metrics","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Uptime - Time in minutes since last reboot","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Exhibit IP - The exhibit server IP currently saved on the hardware","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Exhibit State - The state of the connection from the exhibit hardware to the exhibit server (0 = No connection, 1 = Connection, -1 = Not Set) ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Temperature - Hardware temperature in degrees C (this is actually the Die temp for most current hardware)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Voltage - System supply voltage in V","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The time of the last heartbeat is displayed on the “Overview” page under “Last Updated” ","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Logs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Gumband debug, error and log messages are published to the Cloud Server at the topic:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/log/debug","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/log/error","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"And should have the message body:","type":"text"}]}]}]}]}]},{"type":"codeBlock","content":[{"text":"{\n \"text\": \"\",\n}","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Notifications","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Gumband notification messages are immediately sent to any user subscribed to hardware notifications in the main are published to the Cloud Server at the topic:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/log/notify","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"And should have the message body:","type":"text"}]}]}]}]}]},{"type":"codeBlock","content":[{"text":"{\n \"text\": \"\",\n}","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Events","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Gumband events can be viewed on the “Reports” tab and are published to the Cloud Server at the topic:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/log/event","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"And should have the message body:","type":"text"}]}]}]}]}]},{"type":"codeBlock","content":[{"text":"{\n \"text\": \"\",\n \"value\": \n}","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Properties","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Properties are user defined endpoints that control individual aspects of the application (motor speed, light color, power on/off etc.).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Properties are grouped into a specific “Peripherals” which serves only as a hierarchical organizational structure.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Writing Properties","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Any property with write permissions is a “settable” property.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For every \"settable\" property, ","type":"text"},{"text":"gumband hardware","type":"text","marks":[{"type":"em"}]},{"text":" is subscribed to:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/{peripheralName}/{propertyName}/set","type":"text","marks":[{"type":"strong"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data sent to this endpoint will be received by the gumband hardware and routed to the appropriate callback.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The message body is a raw data byte packet (not ASCII or JSON encoded)","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Reading Properties","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Every property is readable or “gettable” however a Publish can be triggered at any time by the user code so this does not need to be polled in normal operation.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Gumband hardware will publish property data to the following topic, therefore the ","type":"text"},{"text":"GBTT Broker","type":"text","marks":[{"type":"em"}]},{"text":" should be subscribed to this topic for every property exposed in the capabilities registration:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/{peripheralName}/{propertyName}","type":"text","marks":[{"type":"strong"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For every property the ","type":"text"},{"text":"gumband hardware","type":"text","marks":[{"type":"em"}]},{"text":" is subscribed to the following topic and the value of a property can be actively requested by publishing to it:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/{peripheralName}/{propertyName}/get","type":"text","marks":[{"type":"strong"}]}]}]}]}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"The “get” publish triggers a read callback which is a request to initiate a publish to the associated property but ultimately this callback is handled in user code so implementation is not guaranteed.","type":"text"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"See more ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://deeplocal.atlassian.net/wiki/spaces/GS/pages/47120392"}},{"text":" ","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Property Data Packet","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1589,"id":"fc6f31c0-e5c0-40a6-ad42-d21597f92ae4","collection":"contentId-445711168","type":"file","height":813}},{"type":"caption","content":[{"text":"Example MQTT Publish (ASCII values show in their decoded forms) ","type":"text"},{"type":"hardBreak"},{"text":"Set Property: hardware_id = 1, peripheralName = Array, propertyName = Value","type":"text"}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":2827,"id":"3dbbcaa9-3eb9-4581-a426-f9a2d517a577","collection":"contentId-445711168","type":"file","height":1738}}]}],"version":1}

Browser not supported