There are a number of methods to create devices:
- Create one entity/device at a time by using the web interface (recommended for tests or if you have to register few devices) THE ONE PRESENTED IN THIS PAGE
- create an entity/device from a model, from web interface or from Proc.Logic/IoT App
- Create a set of Entities/devices from the Device Table Loader which permits to load excel file from which the devices are created
- Create a set of Entities/devices by creating a scrioo with Proc.Logic / IoT App
- Create all the devices at once (bulk load) using a CSV file in which are specified the information of the devices and their sensors: see HOW TO: Create as set of Devices with BulkProcessing
Path in Snap4City: “MENU -> IOT Directory and Devices > IoTDevices > New Device”
Type of user: Area Manger
Notes/Features:
- It is connected to the Model
- Use this method for testing or if you have a few sensors. Each device must be inserted by hand; therefore, this procedure should be used only in the case of a few devices or test devices. For bulk loading, see the section below.
Guidelines to create a new device:
- IoT Broker Tab:
- ContextBroker: choose the broker according to the Organization
- Kind: choose if the device is a sensor or an actuator
- Protocol: ngsi (default value)
- Format: json (default value)
- Info Tab:
- Name: as device name, IoT Device ID, the ID (it is the unique ID of the device). If you need more names, you can add Static Attributes of the Device.
- We suggest for device nomenclature: always insert an indicative prefix of the Device Model (e.g. “[deviceID]” -> “FlorenceAirQuality_[deviceID]” where deviceID is a string that identifies the single device)
- We suggest for test devices insert the prefix TEST_ before the name
- Model: the reference IoTModel of the device
- Once you have selected the model, the other fields are automatically populated
- Name: as device name, IoT Device ID, the ID (it is the unique ID of the device). If you need more names, you can add Static Attributes of the Device.
- Position Tab:
- Select the position of the device on the map or manually enter its geographical coordinates
- Values Tab:
- Automatically populated by the IoTModel
Example:
Florence Charging Stations (open data municipality of Florence) – Florence organization
IoT Broker Tab:
Info Tab (the Name is the ID, Device ID, Device Name):
Position Tab:
Values Tab: