HOW TO: Create an IOT Device Instance from IOT Directory tool

There are two methods to create devices:

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: