Device Virtual

Introduction

The virtual device service simulates different kinds of devices to generate events and readings to the core data micro service, and users send commands and get responses through the command and control micro service. These features of the virtual device services are useful when executing functional or performance tests without having any real devices.

The virtual device service, built in Go and based on the device service Go SDK, can simulate sensors by generating data of the following data types:

• Bool, BoolArray
• Int8, Int16, Int32, Int64, Int8Array, Int16Array, Int32Array, Int64Array
• Uint8, Uint16, Uint32, Uint64, Uint8Array, Uint16Array, Uint32Array, Uint64Array
• Float32, Float64, Float32Array, Float64Array
• Binary

By default, the virtual device service is included and configured to run with all EdgeX Docker Compose files. This allows users to have a complete EdgeX system up and running - with simulated data from the virtual device service - in minutes.

Using the Virtual Device Service

The virtual device service contains 4 pre-defined devices as random value generators:

• Random-Boolean-Device
• Random-Integer-Device
• Random-UnsignedInteger-Device
• Random-Float-Device
• Random-Binary-Device

These devices are created by the virtual device service in core metadata when the service first initializes. These devices are defined by device profiles that ship with the virtual device service. Each virtual device causes the generation of one to many values of the type specified by the device name. For example, Random-Integer-Device generates integer values: Int8, Int16, Int32 and Int64. As with all devices, the deviceResources in the associated device profile of the device defind what values are produced by the device service. In the case of Random-Integer-Device, the Int8, Int16, Int32 and Int64 values are defined as deviceResources (see the device profile).

Additionally, there is an accompanying deviceResource for each of the generated value deviceResource. Each deviceResources has an associated EnableRandomization_X deviceResource. In the case of the integer deviceResources above, there are the associated EnableRandomization_IntX deviceResources (see the device profile). The EnableRandomization deviceResources are boolean values, and when set to true, the associated simulated sensor value is generated by the device service. When the EnableRandomization_IntX value is set to false, then the associated simulator sensor value is fixed.

deviceResources:
  -
    name: "Int8"
    isHidden: false
    description: "Generate random int8 value"
    properties:
      valueType: "Int8"
      readWrite: "RW"
      minimum: "-100"
      maximum: "100"
      defaultValue: "0"

For the binary deviceResources, values are generated by the function rand.Read(p []byte) in Golang math package. The []byte size is fixed to MaxBinaryBytes/1000.

Core Command and the Virtual Device Service

Use the following core command service APIs to execute commands against the virtual device service for the specified devices. Both GET and PUT commands can be issued with these APIs. GET command request the next generated value while PUT commands will allow you to disable randomization (EnableRandomization) and set the fixed values to be returned by the device.

• http://[host]:59882/api/v3/device/name/Random-Boolean-Device
• http://[host]:59882/api/v3/device/name/Random-Integer-Device
• http://[host]:59882/api/v3/device/name/Random-UnsignedInteger-Device
• http://[host]:59882/api/v3/device/name/Random-Float-Device
• http://[host]:59882/api/v3/device/name/Random-Binary-Device

Configuration Properties

Please refer to the general Common Configuration documentation for configuration properties common to all services.

For each device, the virual device service will contain a DeviceList with associated Protocols and AutoEvents as shown by the example below.

API Reference

Device Service - SDK- API Reference