Beijer ELECTRONICS X2 Web HMI Panel User Manual

: October 30, 2023
: Beijer ELECTRONICS

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

Beijer ELECTRONICS X2 Web HMI Panel User Manual -
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.

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.

Beijer ELECTRONICS X2 Web HMI Panel User Manual -
Settings Beijer ELECTRONICS
X2 Web HMI Panel User Manual - Settings

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.

Beijer ELECTRONICS X2 Web HMI Panel User Manual - Change Settings From
Terminal

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

Beijer ELECTRONICS X2 Web HMI Panel User Manual -
Display Beijer
ELECTRONICS X2 Web HMI Panel User Manual - 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.