Components
An exhibit's Components page in the Gumband UI.
Exhibit Components represent the real-world software applications and hardware devices connected to Gumband that operate your exhibit and publish data to the Gumband Cloud. Exhibits may contain any number of components, from a single software application communicating through the Gumband SDK to an array of software, microcontrollers, presence sensors, and more.
You can connect and manage individual components with your exhibit’s Components page, which provides helpful tools for setting up, monitoring, and debugging your exhibit.
Currently every exhibit created on Gumband will have a default Custom Software component, to which you can connect an SDK.
Component Details
Custom Hardware Component Details in the Gumband UI
You can access metadata and controls for each component by selecting it in your exhibit's Components page, which opens a sheet containing the Component Details for that component.
Component Details includes a heads-up view of key information about each component—such as connection status, IP and MAC addresses, SDK version, and when that component was first connected to Gumband—as well as links to pages where you can interact with component data and properties.
Custom Software and Hardware information.
By selecting your component’s Connection Status or Info areas, you can access more detailed metadata and status information about your Component. Different components may display different information, based on what is relevant to that type of component.
Component Authorization
Component Authorization allows you to manage API access tokens for your components. You can access the Authentication panel from the Component Details sheet, where you can generate, view, and manage tokens used for API integration with your exhibit's components.
The Authentication panel displays your component's unique Component ID, which is used to associate generated tokens with that specific component.
Managing Tokens
The Tokens section provides tools for creating and managing API access tokens. Each token is listed with:
- The first few characters of the token (with the remainder masked for security)
- A custom label or name for easy identification
- The creation date of the token
- A delete option to revoke access
To generate a new token, select the Generate button. You'll be prompted to provide a descriptive Token Name—such as "Production Server," "Development Environment," or "API Integration Token"—to help you identify the token's purpose.
Once generated, the full token value will be displayed in a confirmation dialog. This is the only time you will be able to view the complete token. Be sure to save it in a secure location, as you cannot retrieve it again later. If needed, you can generate a new token at any time.
Hardware Properties
Custom Hardware properties in the Gumband UI.
The Component Details sheet allows you to access custom properties for Hardware Components. Custom properties are configuration and management parameters defined by a developer during your exhibit’s setup.
Your component’s properties may be readable, writeable, or read-write and employ a variety of input types from Gumband’s UI that provide direct access to your component’s data. These may include, for example, a readout of device temperature, a trigger to reboot your device, or a text input for reading and updating an LED’s color assignment.
Learn more about custom properties and the Gumband HDK in our Hardware Developer docs here.
Hardware system properties in the Gumband UI.
Hardware components running on the Gumband HDK also will include a set of default system properties defined by your device. These include read-only properties such as temperature and voltage, as well as write-only properties, such as a reboot command. The system properties see you may vary, depending on your device and firmware.