Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

Introduction

...

It is available from the main menu under Device Management > Virtual Devices.

Click the [+] button to add a new Virtual Device.

...

There are three fields in the create form:

  1. Firmware - firmware version that will be used for this virtual device.

  2. Number of devices - number of devices to be created.

  3. Active/Inactive - when active, messages will be processed normally and incidents will be created.

Info

Firmware filed allows you to change type of sensor. Please, use firmware PS basic UK B1/3.0.1 for virtual spot sensors and CC basic UK B1/1.11.5 for car counters.

Fill in the form and click Add.

...

After creating a device, it has to be positioned using SPlace.

Click the [+] button in the position column to position the device. This will open the SPlace Web page.

...

Once Virtual Devices are created and positioned, you can start sending messages.

Virtual Devices has different behavior and data sending options in depend of thei firmware.

PS basic UK B1/3.0.1 - Virtual Sport Sensors

CC basic UK B1/1.11.5 - Virtual Car Counters

Virtual Spot Sensors

Virtual Devices can send four types of messages:

Message Type

Sending

Use

1

Heartbeat

Automatic

This messages are sent every 3 hours and are necessary for the Device Monitoring system to track the device’s health status. Heartbeat messages are enabled by default.

2

Occupancy Status Change

On-demand & periodic

Testing occupancy processing.

3

Calibration

On-demand

Testing calibration message processing.

4

User Registration

On-demand

Testing BLE tag authorization

Sending messages on-demand

To send message on-demand, click on the Send Message button.

...

Occupancy Status

Select the Occupancy Status Change message type, the next occupancy status will be displayed below, click Send.

...

User Registration

Select the User Registration message type, enter the SDI tag id and click Send.

Info

SDI tag ID is an 8-digit hexadecimal number

...

Calibration

Select the Calibration message type and click Send.

Info

Calibration messages will always contain free occupancy status.

...

Sending messages periodically

To send messages periodically, go to the individual device page by clicking on the device id from the table. Under the expandable Send Messages section, you can configure periodic sending and disable heartbeat messages.

...

Occupancy messages will now be generated by your virtual device at the specified period.

Virtual Car Counters

Virtual Car Counter can send only one type of message: Regular.

Sending messages on-demand

To send message on-demand, click on the Send Message button.

...

Enter Counter value in range 0-1023 and press button “Send”.

Info

Virtual sensors emulates real sensors behaviour. Counter value is a number of detections since the last counter overflow. If you sent Counter 5 in previous message and want to increase counter on 1 detection, you should send Counter 6 in the next message. In case if your previous message contain 1023 and you want to add 2 more detection, you should keep in mind that maximum value if 1023 and the next message must be 1 (1023 + 1 + 1 = 0 + 1 = 1).

...

Sending messages periodically

To send messages periodically, go to the individual device page by clicking on the device id from the table. Under the expandable Send Messages section, you can configure periodic sending and disable heartbeat messages.

To configure periodic sending, enable Auto-increase counter toggle, select Auto-increase counter period , Min increase step, Max increase step and click Save.

Min and max increase step configure range of random-generated value of counter incrementation. If you set the same values in the both field, the counter grows on this value each time.

Info

Keep in mind, that Incrementation step is pseudo-random. If you configure 2 virtual sensor with Min step=1 and Max step=5, it is possible, that one sensor generates sequnce of steps 1,2,4,2,1 but the second generates 5,4,5,3,4.

...

Viewing Messages

You can view raw messages sent by a device, by clicking the View Messages button on the device’s row.

...

Check out our set-up guides:

  1. HTTP Guide

  2. RabbitMQ Guide

Deleting Virtual Devices

If you reach your virtual device limit, you can delete a virtual device by clicking the Delete button.

...