Beijer ELECTRONICS X2 Web HMI Panel User Manual
- October 30, 2023
- Beijer ELECTRONICS
Table of Contents
Beijer ELECTRONICS X2 Web HMI Panel User Manual
Foreword
The information in this document is valid for the latest versions of the panel
images at the time the document was released. For information and updates, see
https://www.beijerelectronics.com.
Copyright © 2023 Beijer Electronics AB. All rights reserved.
The information in this document is subject to change without notice and is
provided as available at the time of printing. Beijer Electronics AB reserves
the right to change any information without updating this publication. Beijer
Electronics AB assumes no responsibility for any errors that may appear in
this document. All examples in this document are only intended to improve
understanding of the functionality and handling of the equipment. Beijer
Electronics AB cannot assume any liability if these examples are used in real
applications.
In view of the wide range of applications for this software, users must
acquire sufficient knowledge themselves in order to ensure that it is
correctly used in their specific application. Persons responsible for the
application and the equipment must themselves ensure that each application is
in compliance with all relevant requirements, standards, and legislation in
respect to configuration and safety. Beijer Electronics AB will accept no
liability for any damage incurred during the installation or use of equipment
mentioned in this document. Beijer Electronics AB prohibits all modification,
changes, or conversion of the equipment.
Head Office Beijer Electronics AB Box 426 201 24 Malmö, Sweden
www.beijerelectronics.com / +46 40 358600
1. Introduction
1.1. Safety Precautions
Both the installer and users of the HMI panel must read and understand this manual.
1.2. References
The installation, technical data, as well as cut-out and outline dimensions of the panels, are described in the Installation Manual for each HMI panel. Please refer to the Installation Manual for further information.
NOTE
Current documentation and software updates can be found on
https://www.beijerelectronics.com
1.3. Open Source Software Notice
To obtain the source code under GPL, LGPL and other open source licenses that are contained in this product, please contact opensource@beijerelectronics.com. In addition to the source code, all referred license terms, warranty disclaimers and copyright notices may be disclosed upon request.
2. Boot
- Apply power to the HMI panel.
- Within 1520 seconds, the Browser will appear. If a start address is defined in the configuration, it will be loaded automatically. Otherwise, you will be directed to the configuration. The X2 web is pre-configured from factory with a URL to a HTML5 demo page.
2.1. First Time Boot
When powering up the X2 web device, first time from delivery, a dialog is shown in order to change the default Configtool user password, or PIN. The procedure is as follows:
-
At Login as Configtool User, input the factory default PIN (The default password from factory is 1234).
-
In the subsequent step, it is required to input the Admin password. This password is an additional password, similar to the PUK code on a mobile phone SIM card. The Admin password is printed on the flyer, included in the shipment.
NOTE
The admin password can later be changed in the Settings. -
With correctly stated Admin password, input the new PIN/Configtool User password, two times consecutively.
The PIN/Configtool User password is now changed.
3. Navigation
To reach the right-click context menu, tap the touch surface and keep it pressed for at least 1.5 seconds. A drop-down menu will show with navigation commands. The following commands are currently implemented:
- Back
- Forward
- Reload
The right-click context menu can be disabled or enabled from the Settings.
4. Settings
Normally, the X2 web device will browse the default URL on start-up. To access the device settings:
- Touch the upper, approximately one centimetre area, of the display, and hold it for at least 1.5 seconds.
- After holding the touch for 1.5 seconds, a button will appear in the upper central part of the screen.
- Tap/Click on the button to go to Settings. Tap/Click outside the button to make the Settings button disappear again.
4.1. Change Passwords
To change the config tool user password, in the Settings menu, go to the Display tab and click the Change Configtool password button. The change password feature requires being logged in as admin. The application will restart and prompt the user to select either admin or configtool user followed by input of the old password. Changing the configtool user password, requires the admin password, followed by the new password entered twice. The new password entered must be at least four characters in length. There is no limitation on the maximum password length.
NOTE
Any limitations stated above are reflected in the config tool app for changing
passwords. If using the OS built in ‘passwd’ command, there are no
limitations.
4.2. Change Settings From Terminal
The X2 web has some additional settings, some of which are only available to
be edited from a terminal. The built-in editor in X2 web is vi. A basic manual
for the various vi commands can be found here:
https://cs.stanford.edu/people/miles/vi.html
The file /etc/beijer/misc.conf contains general settings.
NOTE
Any changes made to the OS, file system etc, is solely on behalf of the owner.
Beijer Electronics AB shall not be held responsible for any damages caused by
connecting to the device as a root user.
The file /etc/beijer/touch.conf only contains the result from touch calibration. It is recommended to use the built-in touch calibration app instead.
4.2.1. Network
The following parameters can be set:
- IP address
- Subnet mask
- Default gateway
- DNS settings for the Ethernet port on the HMI panel
- LAN A / LAN B One config per port (separate tabs in the top of the UI)
- Method DHCP or Static.
- IP
- Net mask
- Gateway
- DNS 1
- DNS 2
- Save Saves the new settings.
The default setting is DHCP.
4.2.2. Diagnostics
Displays the following list of parameters for the panel:
- CPU load
- System uptime
- Memory total
- Memory usage
4.3. Settings Tabs
4.3.1. General
- Model Model name of the device model.
- Software Version Currently installed software version.
4.3.2. Display
NOTE
Depending on the size of the screen, users may have to scroll down to find all
setting parameters in the Display tab.
4.3.3. Network
The following parameters can be set:
- IP address
- Subnet mask
- Default gateway
- DNS settings for the Ethernet port on the HMI panel
- LAN A / LAN B One config per port (separate tabs in the top of the UI)
- Method DHCP or Static.
- IP
- Net mask
- Gateway
- DNS 1
- DNS 2
- Save Saves the new settings.
The default setting is DHCP.
4.3.4. Diagnostics
Displays the following list of parameters for the panel:
- CPU load
- System uptime
- Memory total
- Memory usage
4.3.5. Licenses
Shows a full table of all the licenses used in the software in terms of:
- Package
- Version
- License
5. Image Update
The HMI panel comes pre-loaded on delivery with an image.
5.1. Updating the Panel Image Using USB/SD Card
To update the image in an HMI panel, use a USB flash drive or an SD card. This makes it possible to upgrade the panel image without the use of a PC. Do the following:
- Download the system-beijerraucb file and store it in the root on a USB flash drive or SD card.
- Attach the USB flash drive or SD card to the device, a dialog will show to install the new version.
- A dialog will notify when the update is finished.
- Detach the USB flash drive or SD card and reboot the device.
- Check the new version number in the Settings.
NOTE
The X2 web allows updating either from USB, SD card or via file transfer and
manual install, using the command rauc install system-beijer.raucb.
6. Certificate Utility and Allow list
Connecting the X2 web browser to a server over TLS, which lacks a CA root authority signed SSL certificate is prohibited. To bypass X2 web from blocking, either the URL can be added to a whitelist or users can install the server certificate on the X2 device as a valid server certificate. If a user connects to a web server, where the server lacks a valid certificate, the user will be notified by a message on the screen, `Insecure Page’. The notifier will be displayed for 10 seconds.
6.1. Adding Certificate From File
In order to add certificates from a file, the following has to apply:
- The USB flash drive or SD card is either vfat or ext3 formatted.
- The USB flash drive or SD card contains a certificate folder with *.crt files.
Attach the USB flash drive or SD card to the X2 web device and go to the Certificate Util/Allowlist dialog. All certicates found on the drive will be listed in the upper list. Select which certificate to be added, followed by clicking on the Add button. If the operation succeeded, the browser will restart. If the operation failed, users will be notified.
6.2. Add Current URL to the Allow List
To add the current URL address to the allow list, simply check the Add current URL to allow list checkbox, followed by clicking the Add button. White-listed URL domain addresses are listed in the lower list box. Existing, white-listed, URLs can be removed by selecting it and clicking the Remove button.