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 :
The plugin does not require any configuration, you just have to activate it :
The configuration of virtual devices is accessible from the plugin menu :
This is what the virtual plugin page looks like (here with already an equipment) :
This is what the configuration page of a virtual device looks like :
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 :
To make a virtual switch, you need to add 2 virtual commands like this :
Then you save and there Jeedom will automatically add the virtual information command :
Add in the orders “action”
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 :
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 :
Save and do the same for the order
Off. And you will get a nice widget that will change state when clicked :
To make a virtual slider, add a virtual command like this :
As before after the backup, Jeedom will automatically create the info command :
And as before, it is advisable to link the action to the status command and to hide it.
This is how to make a switch of type toggle, for that you have to create a virtual command of this type :
Then you save to see the status command appear :
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 :
Several points to be done correctly :
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
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).
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.
It is possible to change the value of virtual information by a API call :
Be careful to add a / jeedom after #IP_JEEDOM# if necessary