Virtual plugin

The Virtual plugin allows the creation of virtual devices and their properties.

We will name a device created by this plugin : virtual device.

A virtual device can be created for the following needs :

Configuration

The plugin does not require any configuration, you just have to activate it :

virtual1

Equipment configuration

The configuration of virtual devices is accessible from the plugin menu :

virtual2

This is what the virtual plugin page looks like (here with already an equipment) :

virtual3

This is what the configuration page of a virtual device looks like :

virtual4

Tip

As in many places on Jeedom, putting the mouse on the far left allows a quick access menu to appear (you can always leave it visible from your profile).

Here you find all the configuration of your equipment :

At the top right you have access to 4 buttons :

Below you find the list of orders :

Tutoriel

Virtual switch

To make a virtual switch, you need to add 2 virtual commands like this :

virtual5

Then you save and there Jeedom will automatically add the virtual information command :

virtual6

Add in the orders “action” On and Off, The command Etat (this allows Jeedom to make the link with the state command).

To have a nice widget, you need to hide the status command :

virtual7

Assign a widget that manages the status feedback to the 2 action commands, for example here the light widget. To do this click on the small notched wheel in front of the control On and in the 2nd tab select light as widget :

virtual8

Save and do the same for the order Off. And you will get a nice widget that will change state when clicked :

virtual9

Virtual slider

To make a virtual slider, add a virtual command like this :

virtual12

As before after the backup, Jeedom will automatically create the info command :

virtual13

And as before, it is advisable to link the action to the status command and to hide it.

Toggle switch

This is how to make a switch of type toggle, for that you have to create a virtual command of this type :

virtual14

Then you save to see the status command appear :

virtual15

Here it is necessary in the value of the action command to put not(\#[...][...][Etat]#) (replace with your own command) and link the state to the action command (be careful, you should not hide the state command this time). You must also place the info command in binary subtype.

To do a calculation on multiple orders, it’s very easy ! Just create a virtual information type order and in the value field put your calculations. The expression tester can help you with this step to validate. For example, to average 2 temperatures :

virtual10

Several points to be done correctly :

Multiple orders

We will see here how to make an order which will turn off 2 lights. Nothing could be simpler, just create a virtual order and put the 2 orders separated by a && :

virtual11

Here, the command subtype must be the same as the controlled command subtypes, so all commands in the value field must have the same subtype (all “other”, or all “slider “, or all color).

Virtual status feedback

When using equipment which does not have a status feedback and if this equipment is controlled only by Jeedom, it is possible to have a virtual status feedback. This requires creating a virtual that takes the actions commands (ex: On & Off) of the equipment and which has an info command (the status). You must then complete the Parameter column for each action command, by selecting the name of the info command (status) and giving the value it must take.

We can also imagine a virtual one that turns on / off several lamps (actions commands separated by &&) and thus have a status of this general command.

Assigning a value by API

It is possible to change the value of virtual information by a API call :

http://#IP_JEEDOM#/core/api/jeeApi.php?apikey=#APIKEY_VIRTUEL#&type=virtual&type=virtual&id=#ID#&value=#value#

NOTE

Be careful to add a / jeedom after #IP_JEEDOM# if necessary

Nous utilisons des cookies pour vous garantir la meilleure expérience sur notre site web. Si vous continuez à utiliser ce site, nous supposerons que vous en êtes satisfait.