HOW TO: Create an Entity/IoT Device Instance from Entity/IoT Directory tool


Warning message

You can't delete this newsletter because it has not been sent to all its subscribers.

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


  • 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
  • Position Tab:
    • Select the position of the device on the map or manually enter its geographical coordinates
  • Values Tab:
    • Automatically populated by the IoTModel


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: