Back to Knowledge Base
How to Add a Device
Applies to CoCoCo platform v1.0.0-rc.31. Every step below was run on that version.
What is a Device?
Section titled “What is a Device?”A Device is an endpoint CoCoCo talks to: a press, an MIS database, an HTTP service or an MQTT topic. It belongs to a Network, and if that Network contains a Controller, CoCoCo reaches the Device through it. How CoCoCo talks to the Device is set by its protocols.
Before you start
Section titled “Before you start”- Create the Network the Device will belong to (see How to Create a Network).
- You need permission to create devices (
device:write).
Add a Device
Section titled “Add a Device”- In the sidebar, under IoT, click Devices.
- Click Add Device. The page New Device opens.
- Under Network, select the Network the Device belongs to.
- Enter an Identifier. It is required — if you save without one, the form shows Identifier is required.
- Optionally fill in Name, Description, Device Type, Manufacturer, Model and Serial Number.
- Active is ticked already. Leave it ticked for a Device that is in use.
- Optionally configure how CoCoCo communicates with the Device under Outbound Protocols (HTTP, JMF, SQL, MQTT) and Inbound Protocols (MQTT subscriptions, HTTP webhooks). See Protocols Explained.
- Click Save.
You’ll see Device created, and the Device’s page opens. It always shows Details. Sections for the protocols appear once protocols are configured, and Connection & Tokens appears only when the Device has an MQTT protocol.
What comes next
Section titled “What comes next”- How to Create and Manage Device Tokens
- Protocols Explained