Page Comparison

Anchor
_v4vmcuhs54af _v4vmcuhs54af

Setting Up Gumband

Anchor
_vrsg3e55v55a _vrsg3e55v55a

Setting the Hardware ID

1. Create a Gumband object. This must be declared as a global object.

2. Initialize the Gumband Infrastructure

3. Set the Hardware ID. This is a unique value generated and assigned in the Gumband UI for each registered Hardware device. It is required to link Hardware to a specific Exhibit.

...

*Note: See API Reference for detailed API documentation

Anchor
_mumfdj3t5fha _mumfdj3t5fha

Setting the Username and Password

1. Set the Gumband Master control server username

2. Set the Gumband Master control server password

...

*Note: See API Reference for detailed API documentation

Anchor
_faxjur8pzla2 _faxjur8pzla2

Creating a Property (Publish)

Publish properties send information or I/O data to the Gumband Server. Publish properties can be things such as buttons state, switch state, dial position, etc.

...

*Note: See API Reference for detailed API documentation

Anchor
_ckmpf06ql7gf _ckmpf06ql7gf

Creating a Peripheral (Subscribe)

Subscribe properties receive information or other data from the Gumband Server. Subscribe properties are things such as LED colour, LED brightness, relay state, motor speed, motor position, etc.

...

*Note: See API Reference for detailed API documentation

Anchor
_5pzw3tpyw5i7 _5pzw3tpyw5i7

Handling Data

Anchor
_a49mq0n4y5w3 _a49mq0n4y5w3

Publishing Property Data

1. Publish some arbitrary data (e.g. data from an encoder).

   1. Obtain data. In this case we call a function where data from the encoder is decoded (line 89).

   2. Call publish() with the peripheral and property names we created earlier, as well as the decoded data.

2. Publish a single byte of data (e.g. button state).

   1. Obtain data. In this case we call a function that reads the button state (line 97).

   2. Call publish() with the peripheral and property names we created earlier, as well as the button state data.

3. Publish an array of data (e.g. the last few encoder positions).

   1. Obtain data. In this case, we call a function where data from the encoder is decoded and the last five encoder values are stored (line 109).

   2. Call publish with the peripheral and property names we created earlier, as well as the decoded data and the length of the array where that data is stored.

...

*Note: See API Reference for detailed API documentation

Anchor
_zi62pp9t6ij3 _zi62pp9t6ij3

Publishing Event and Debug Data

Publish an event message to the Gumband event log using event().

...

*Note: See API Reference for detailed API documentation

API Reference