DEVICE SETTINGS
ACTIONS
NOTIFICATIONS
Go to the device settings (the “Settings” icon in the top right corner of the
screen). In the “Name and icon” section you can change the name of the de-
vice under which it is displayed in the wBox application. In the “Device Se-
ttings” section it is possible to turn off the LED diode built into the device.
Rainfall, especially in the nal stages, is discontinuous. The “Sustain time”
option allows to maintain the rainfall signaling for some time, despite the
drying of the sensor surface. This is to lter out multiple end-of-rain noti-
cations. Default value: 5min.
The controller allows you to display a system notication on a phone with
the wBox application installed on the particular trigger, eg. when it starts
raining.
Notications only work when the controller has a stable Internet access
and the “Remote access” option is enabled (default setting).
Notications are added similarly to “Actions” - ll in the form elds and in
the “Execute” tab select “Notication” as “Result”. Conrm with the “Save”
button.
When adding an action in the “When” tab select “Starts raining” or “Stops
raining” as “Trigger type”.
In the “Execute” tab select “Control other device” as “Result”, conrm. Click
on the “Select device” icon. The device will search the network for compa-
tible devices and display them in a list. Choose the device you want to con-
trol. If the device is not listed you must use the general API control method
described below or update the rmware in target device.
Then in the “Call API” eld enter the API command that the driver will call.
The most popular API control commands /s/ for switchBox and shutterBox
are presented below:
Switching on the circiut via switchBox: 1
Switching off the circuit via switchBox: 0
Opening the awning via shutterBox: u
Closing the awning via shutterBox: d
By default, the action will be triggered once, when the trigger condition is
met. It is also possible to repeatedly call a given action by selecting one of
the repeat options and setting the interval.
If the device was not on the found list or you want to control another devi-
ce in the network, select “Call URL” as “Action type”.
In the “URL” eld, enter the API command preceded by the http protocol
prex and the IP address of the wBox device which will be controlled. The
IP address can be found in the device settings. Caution! All the controllers
must be in the same subnet, usually the subnet of a home router.
The most popular API commands for switchBox and shutterBox are pre-
sented below. It was assumed that the IP address of the device which will
be controlled is: 192.168.1.123
Switching on the circuit via switchBox: http://192.168.1.123/s/1
Switching off the circuit via switchBox: http://192.168.1.123/s/0
Opening the awning via shutterBox: http://192.168.1.123/s/u
Closing the awning via shutterBox: http://192.168.1.123/s/d
In the “Summary” tab name the action, check its correctness and conrm
the entry with the “Save” button.
A detailed description of how to control other controllers of the wBox se-
ries is available in the “Extended instructions for wBox devices”, while all
the technical documentation API of the wBox controllers is available at:
http://technical.blebox.eu
The added action will be displayed on the list. By expanding its details it is
possible to preview the status of its last execution.
4
5
6
3WIFI CONNECTION AND SERVICE CONNECTION
(AP) SETTINGS
Go to the WiFi network settings (“Settings” icon in the top right corner of
the screen, “Connection” section), where you can connect the device to the
home WiFi network to be able to control the device via it or from anywhere
in the world. To do this, select the network name from the list of availa-
ble networks and press “Connect”. If required, enter your WiFi password.
When connecting the device to the home network, the phone / tablet may
disconnect from the device’s network.
After reconnecting the phone to the controller’s WiFi network, check the
“WiFi Client status” and “Remote access status” elds. The controller is
equipped with a network connection supervision system which in case of
problems with connection to the WiFi or the Internet will report the pro-
blem and its possible causes. If the network is working properly both elds
will be set to “Connected”.
In order to communicate with the device from outside the local WiFi ne-
twork, from anywhere in the world, via the wBox application, the device
automatically connects to the BleBox cloud system service by default. The
remote access system is fully encrypted and secure, the data are transmit-
ted by European servers from reputable companies. It is possible to disable
the remote access service - after clicking the “Congure” button, toogle
the switch next to the “Remote access” option. Remember that disabling
“Remote access” will result in no access to the controller from outside the
local network as well as disabling the notications and external integration
systems, therefore we recommend that you leave this option enabled (de-
fault setting). event log
Enabling the “Event log” option will cause the device to record events (e.g.
about sent notications set in the “Actions” section) in the BleBox cloud
system. This allows the history of the events to be viewed later also when
the controller is ofine.
After completing the WiFi network conguration, you can disconnect from
the device network and connect the phone / tablet directly to your home
WiFi network. Control from the wBox application will work in the same
way as when the phone / tablet is connected to the device’s network. If as a
user you leave the local network, eg leaving your home or enclosing mobile
data, the wBox application will signal this status as “Remote mode”. In this
case, you will have access to the device data, but for security reasons set-
tings options will not be available.
In the “Service connection (AP)” section, you can change the name
and give the password of the WiFi network emitted by the devi-
ce. Remember that changing the network name or password can
cause disconnection with the device immediately after clicking
the “”Save”” button, so you should reconnect to the WiFi network.
It is also possible to completely disable the access point emit-
ted by the device. To do this move the “Access point” slider to
the off position and conrm the selection with the ”Save” button.
Attention! If the controller does not have a stable connection to the WiFi
network (“WiFi client status”: “Connected”, without any error warnings),
restarting the access point will not be possible - in this situation, the only
solution is to reset the controller to the factory settings. Disabling the ac-
cess point is recommended only after the complete driver conguration
and making sure that the entire system is working properly.”
In order for the notication to be displayed on the phone it is necessary to
allow the controller to display notications. Go to the main menu of the
wBox application, to the “Notications” tab. Then go to the settings (the
“Settings” icon in the upper right corner of the screen). Find the device on
the list and select “Action notication” from the drop-down list next to the
device name. You can also select other types of available notications or
μPortal notications. Conrm the change of preferences with the “Save”
button in the upper right corner of the screen.
If notications are not displayed despite their conguration check in the
phone system settings (Android / iOS) whether the wBox application is
authorized to display system notications.
The controller allows you to send control commands to other BleBox
controllers via the WiFi network through the API. Each action will be
deployed on particular trigger, eg. when it starts raining.
