1 Accessing embedded Web interface.
1.1 Accessing the Web interface via Ethernet over your LAN
1.2 Accessing the Web Interface via Ethernet (direct connection to your computer)
1.3 Accessing the Web Interface through Wi-Fi access point.
1.4 Accessing the Web Interface through Wi-Fi station
2 Landing Dashboard – Device home page
4 Embedded Web interface overview
10.1.1.1 Wi-Fi Station setup using Wi-Fi setup wizard
10.6.1.1 Suggested calibration procedure
11 Changing default Web Interface credentials
1 Accessing embedded Web interface
Device Web interface can be accessed from any of the available network interface: Ethernet or Wi-Fi if available on your device. We recommend using any of the following Web browser which are checked for compatibility:
- Mozilla Firefox version 93.0 or higher,
- Google Chrome version 94.0 or higher.
1.1 Accessing the Web interface via Ethernet over your LAN
Follow instructions from paragraph 4.3.1 to configure Ethernet connection of your device.
Once properly configured, you can access the Web interface from any compatible Web browser via address:
If your device is using DHCP, you may require accessing your router to retrieve device IP address attributed by your DHCP server.
1.2 Accessing the Web Interface via Ethernet (direct connection to your computer)
Follow instructions from paragraph 4.3.1 to configure Ethernet connection in static IP mode with the following parameters:
Ip: 172.16.100.1
Gateway: 0.0.0.0
Network mask: 255.255.255.0
Setup your computer in static IP mode onto the same subnet. For example:
Ip: 172.16.100.2
Gateway: 0.0.0.0
Network mask: 255.255.255.0
Spoony can be plugged directly to your computer using an Ethernet connector. Web interface will be accessible via the following address:
1.3 Accessing the Web Interface through Wi-Fi access point
This option is only available on devices with Wi-Fi extension option.
Once powered up, your device will start a Wi-Fi AP with the following characteristics:
Access Point Name: Spoony-XX-XX
Security: Open
Where XX-XX are the last four hexadecimal digits of your device GUID.
This access point has DHCP server enabled and captive portal functionality.
Setup your computer in DHCP mode and connect to the access point. You should be redirected to the device’s home page. If not, access the following address from your Web browser:
1.4 Accessing the Web Interface through Wi-Fi station
In this mode, the device is connected to your LAN through Wi-Fi. You first need to setup
Wi-Fi connection by following instructions from paragraph 4.3.2. You can also connect to
the embedded interface through Wi-Fi AP as show in paragraph 5.1.3 to setup your device
for the first time.
Once connection is established to your LAN, please refer to paragraph 5.1.1 for details on
how to access the device’s dashboard through your LAN.
2 Landing Dashboard – Device home page
This is the first page shown when connecting to your device. This page shows actual
measurements from the device as well as buttons to access other functionalities.
2.1 Landing dashboard
Figure 1 – Landing Dashboard view
Export: access to data export formulary. Only available on devices configured for local CSV data storage.
Enter: login to device administration interface.
2.2 Export page
This page allows you to export CSV files from your device (when this functionality is enabled).
Select From and To dates and time using the two calendar icons and click Export to download all files available for this period:
3 Login into the device
This page is accessed by clicking the Enter button from the Landing Dashboard page:
Enter the username and password of your device and click the Login button to access the administration interface of the device.
Your device specific username and password are indicated onto the device serial number sticker situated on the left of the device, or on the spare sticker delivered with the device:
Figure 4. a – Device login and password location fot a spoony version 1.5
Figure 4. b – Device login and password location fot a spoony version 1.5.1
For older revisions of the device, default username/password is admin/admin.
Please see paragraph 5.11 for details on how to modify default username and password for your device.
4 Embedded Web interface overview
The above capture shows main elements from the home page of the embedded administration interface:
- 1: Log out Click this button to log-out and return to Landing Dashboard,
- 2: user management. Click the Admin button to access the credentials update form,
- 3: navigation tabs. These buttons allow you to access the different pages of the interface,
- 4: device information,
- 5: network information.
5 Device information page
This page shows global device information as well as network interfaces information. An example is given below:
Figure 6 – Device information view - Detail
Figure 7 – Network information view - Detail
6 Browse tab
This tab allows exploring device’s DataPoints. This include native internal DataPoints, as well as calculated DataPoints and external DataPoints, listed through two display schemes:
- alias subtree: lists DataPoints by alias, as configured in Automation Service Index configuration,
- units subtree: lists DataPoints by Units.
Figure 8 – Browse tab global view
By expanding tree using the + buttons, you are allowed to access all DataPoints in detail and retrieve their current values:
Figure 9 – DataPoints browsing
7 Live tab
This tab allows you to display DataPoints’s values in real time. This tab has two main viewing mode available, dashboard and table.
7.1 Dashboard mode
This sub-tab shows DataPoints in a similar fashion than the Landing Dashboard, using different types of graphs and gauges:
Figure 10 – Live Dashboard view
This view can be edited to best suit user needs by clicking the button as shown below:
Figure 11 - Live Dashboard view – Edit Mode
In Edit mode, Dashboard Widgets can be moved, resized, removed, and added.
Remove widget: click the top-right icon to delete a Widget
Move widget: click and drag widget to move it around
Resize widget: click and drag the bottom-right icon to resize a widget
Add widget: select which DataPoint(s) must be displayed, Widget type and set Widget options before clicking the Add button. New widget is added at the bottom of the Dashboard and can be moved around and resized as required.
Note: The modifications will only be persistent if you click the Save button
7.2 Table mode
This sub-tab shows DataPoints list as a table. An example is given below:
Figure 12 – Live View – Table mode
8 Data Tab
This tab shows CSV files list when CSV data storage is enabled on the device. Files can
be downloaded directly from this page by double-clicking the file name:
9 API Tab
This tab contains the documentation as well as sample test interface for the device integrated HTTP API.
This API (used by the device Web interface) is accessible to end-user to develop custom application.
You can navigate through the API documentation to access the test interface and detailed documentation of the API request as shown below:
Figure 15 – API Documentation browsing (Browse API)
Figure 16 – API Documentation detail overview
10 Settings Tab
Settings Tab allows you to access device’s settings. It is divided in few sub-tabs detailed in the following paragraphs.
10.1 Basic
Figure 17 – Settings – Basic page view
Wi-Fi Station: see next paragraph for detailed Wi-Fi setup on devices equipped with Wi-Fi extension.
Date and time: this section allows to manually set device’s date and time when no NTP servers are available from your network. Use the Set to browser time button to automatically fill the date and time from your computer’s date. Click the Save button to apply modifications.
Device control: reset device (mandatory to apply configuration changes made to Services) or energy counters.
10.1.1.1 Wi-Fi Station setup using Wi-Fi setup wizard
You can start the Wi-Fi wizard by clicking the button from the Settings – Basic tab.
You will be guided to scan for Wi-Fi networks and prompted for your network passphrase if required.
Note: If your Wi-Fi network does not provide DHCP functionality, we recommend setting up Wi-Fi station manually by following instructions from paragraph 4.3.2.
10.2 Advanced
This section allows modifying Services configuration, as detailed in chapter 4. This page can be used to edit Services configuration files instead of extracting the microSD card.
Please note that device must be restarted from the Basic page (Reset button) for the changes to take effect.
Figure 18 – Settings – Advanced page view
Select a configuration file from the drop-down list to open it in the integrated editor as shown below:
Figure 19 – Settings – Advanced page view – File edit in progress
Modifications must be saved using the Save changes button before restarting the device.
10.3 Services
This page shows device Services and their status. By clicking the icon, you will be redirected to the Advanced Web page to edit related configuration file:
Figure 20 – Settings – Services page view
10.4 File Browser
This section allows you to navigate through the full content of the microSD card as if it was inserted into your computer, and to edit files directly:
Figure 21 – Settings – File Browser page view
Following actions are possible:
Open a File/Directory: double-click onto the File or Directory name in the left panel
Create a new empty directory: click the icon
Create a new empty file: click the icon
Download a file to your computer: once the file is opened in the right panel, click the
icon to download a copy of the file
Save a file to the device after modifying it: click theicon
Copy a file to the device: drag a file from your computer file browser to the left panel
Delete a file or directory: click the icon. Note that only empty directories can be deleted.
10.5 Console
This tab is reserved for use by DotVision support team for on-site diagnostic.
10.6 Calibration
This tab allows you to edit the device calibration.
Please note that device measurement accuracy is only guaranteed when using the default calibration. Devices are calibrated specifically on a per-device basis by DotVision to guarantee the best possible accuracy over the full input range of the device.
However, for specific needs, it may be desirable to alter default calibration (e.g., improving device accuracy at low input current range or optimize calibration for specific voltage ranges).
Note that default calibration data of the device can always be restored to factory settings.
Figure 22 – Settings – Calibration global view
Following calibration parameters are accessible:
- xVRMS_a: RMS voltage slope,
- xVRMS_b: RMS voltage offset,
- xIRMS_a: RMS current slope,
- xIRMS_b: RMS current offset,
- xWATT_a: active power slope,
- xWATT_b: active power offset,
- xVAR_a: reactive power slope,
- xVAR_b: reactive power offset.
with x = A, B or C for channels 1, 2 and 3 respectively.
To edit a calibration parameter, edit the value in the corresponding field and click the Write button as shown below.
Figure 23 – Calibration parameter edition
The modification takes effect immediately but will not be persistent after device reboot, unless explicitly saved.
For modifications to be persistent after device reboot, the modifications must be saved by clicking the button
The button will clear all modifications not written to the device
The button will discard all user modifications and reload the factory default calibration parameters.
10.6.1.1 Suggested calibration procedure
DotVision calibration procedure uses multi-point calibration along the whole device input range for both voltage and current channels. However, it is possible to achieve good accuracy using a standard 2-point calibration procedure with a stable AC voltage and AC current source. Calibration reference used MUST have voltage and current phase angle configurable between 0 and 90° to enable VAR (reactive power) calibration.
Recommended procedure is described below:
- Set all slopes parameters (xYYYY_a) to 1.0 and all offset parameters (xYYYY_b) to 0.0 from the Settings – Calibration page,
- Go to the Live - Table view page to access DataPoints values for IRMS, VRMS, WATT and VAR measurements, or use the device API to setup your calibration interface. Reading of those values will be required to compute calibration parameters,
- Start with voltage calibration by applying 2 known AC voltage to the device voltage measurement inputs. Recommended AC voltage values of 50 and 230VAC should be used,
Use those measurements to compute xVRMS_a and xVRMS_b calibration parameters for each channel,
- While applying nominal AC voltage at voltage measurement inputs, apply two known AC currents through the current sensors with a 0° phase angle to AC Voltage. Recommended AC current of 5% and 100% of current sensors range is recommended. For Rogowski coils calibration, due to their high linearity at high currents, AC currents of 5% and 30% can be used.
Use those measurements to compute xIRMS_a and xIRMS_b for each channel, as well as xWATT_a and xWATT_b,
- While applying norminal AC Voltage at voltage measurement inputs, apply two known AC currents through the current sensors with a 90° phase angle to AC Voltage. Use same AC current range as for the previous step,
Use those measurements to compute xVAR_a and xVAR_b.
- Report calculated calibration parameters to the Settings - Calibration page and save changes to the device.
Note 1: it is recommended to perform calibration after a warm-up period of about 10 minutes at room temperature.
Note 2: it is recommended to perform average calculation on all raw values red from the device under calibration. For WATT and VAR calibration, it may be preferable to use the difference between WATTHR and VARHR values at beginning and end of the calibration period instead of average of WATT and VAR values. Proceeding this way improves measurement accuracy as the calculated value will be intrinsically averaged over the measurement period.
11 Changing default Web Interface credentials
Default credentials can be modified by clicking “Admin” on the upper left corner of the Web interface to access relevant page:
Figure 24 – Credentials update page access
You will be directed to the following page where credentials can be modified:
Figure 25 – Credentials update form
To change your username:
- Enter new username in the dedicated field,
- Press the Save
To change your password:
- Enter your current password and your new password in the relevant fields. Note that password must also be entered into the Password Confirmation field for verification purposes,
- Press the Save
Figure 1 – Landing Dashboard view
Figure 4 – Device login and password location
Figure 6 – Device information view - Detail
Figure 7 – Network information view - Detail
Figure 8 – Browse tab global view
Figure 9 – DataPoints browsing
Figure 10 – Live Dashboard view
Figure 11 - Live Dashboard view – Edit Mode
Figure 12 – Live View – Table mode
Figure 15 – API Documentation browsing (Browse API)
Figure 16 – API Documentation detail overview
Figure 17 – Settings – Basic page view
Figure 18 – Settings – Advanced page view
Figure 19 – Settings – Advanced page view – File edit in progress
Figure 20 – Settings – Services page view
Figure 21 – Settings – File Browser page view
Figure 22 – Settings – Calibration global view
Figure 23 – Calibration parameter edition
Comments
0 comments
Please sign in to leave a comment.