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: device name
      • 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)
      • 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:


Position Tab:


Values Tab: