Beijer Electronics X3 Human Machine Interface User Guide

Beijer-Electronics-logo

Beijer Electronics X3 Human Machine Interface

Beijer-Electronics-X3-Human-Machine-Interface-product

Specifications

  • Operating System: Custom OS
  • iX Developer Version: 2.52
  • Scripting Capabilities: .NET CF 3.5
  • User Interface: Modernized UI with improved Chart object and Component library
  • Media Support: Media player, PDF viewer
  • Security Features: Secure app transfer, Firewall protection, Secure remote access
  • System Management: Active Directory integration, FTP support, Business integrations
  • Drivers: Supports various industrial communication protocols, including OPC UA, Ethernet, Serial, CAN, SoftControl, and BACnet

Product Usage Instructions

Operating System and System Features:
The device runs on a custom OS supporting iX Developer with features like UI settings, USB and SD card support, multi-app support, firewall protection, and remote access capabilities.

iX Projects and iX Apps:
The iX Developer version 2.52 allows project conversion from previous versions and supports scripting capabilities using .NET CF 3.5.

User Interface & Usability:
The product offers a modernized IDE UI with an improved Chart object, Component library, HTML5 browser support, touch beep feature, and additional controls for enhanced usability.

Security and System Management:
Ensure system security by utilizing features like Secure app transfer, firewall protection, and system settings configuration via iX Developer. Active Directory integration and FTP support are available for system management.

X2 vs X3 – Software Comparison

  • This chapter provides a comparative overview of the software features in the X2 and X3 series, highlighting differences between the X2, the first release of X3, and future X3 updates. It covers key aspects such as the operating system, security, services, iX Developer compatibility, user interface improvements, system management, industrial communication protocols, and business integrations. The chapter outlines feature availability, enhancements, and limitations in each version, helping to understand the evolution of the X3 platform and its capabilities relative to the X2 series.

NOTE
Features and specifications may change as the products evolve. Always refer to the latest documentation for up-to-date information.

Operating system and system features

  X2 X3 – Initial release X3 – Future updates
Operating system Beijer Shell OS3 1.0 OS3 X
Supports iX Developer Yes Yes Yes
System settings UI Yes Yes Yes
USB support Yes Yes Yes
SD card support Yes Yes Yes
Security
Secure app transfer No Yes Yes
Secure app install from USB storage Yes No Yes
System settings protection No Yes Yes
Firewall (default: closed) No Yes Yes
Security patches No Yes Yes
Services
Multi-app support No iX Developer only Yes
Remote access (VNC) Yes No No
Secure remote access (HTTPS-proxied, authenticated VNC) No No Yes
System requirements – For more information, see App System Requirements and System Requirements. No Yes Yes

iX projects and iX apps

  X2 X3 – Initial release X3 – Future updates
iX Developer version 2.52 3.0 3. X
Project conversion from previous versions Yes Yes Yes
  X2 X3 – Initial release X3 – Future updates
Scripting capabilities Yes Yes Yes
Latest scripting framework support .NET CF 3.5 .NET 8 LTS .NET X LTS (LTS

lifecycle)

References assemblies Yes No (use NuGet instead) No (use NuGet instead)
NuGet support No Yes Yes
PC-Runtime Yes No Yes
System settings (COM, LAN A/LAN B, power saving, SNTP) Yes Yes Yes
User interface & usability
Modernized IDE UI No Yes Yes
Improved Chart object No Yes Yes
Modern Component library No Yes (enhanced look and feel) Yes (enhanced look and feel)
Improved Trend Viewer No No Yes
SVG support No No Yes
GIT-friendly projects No No Yes
HTML5 browser No Yes Yes
Media player Yes No (use Web Browser object instead) No (use Web Browser object instead)
PDF viewer Yes No (use Web Browser object instead) No (use Web Browser object instead)
Picture in picture No Yes (in Web Browser object) Yes (in Web Browser object)
QR code object Yes No (use NuGet instead) No (use NuGet instead)
Additional controls (DLL-support) Yes No (use NuGet instead) Yes
Touch beep Yes No Yes
Rotate object Yes (only for industrial PC targets) No Yes (only for industrial PC targets)
Run action Yes No No
Security and system management
  X2 X3 – Initial release X3 – Future updates
Active Directory on-premises No Yes Yes
Active Directory cloud solution No Yes Yes
Active Directory Federation Services (ADFS) cloud solution No Yes Yes
Configurable TCP ports via iX Developer Yes Yes Yes
Services
Web server Yes Yes (REST

API only)

Yes (REST

API only)

FTP support Yes No No
Secure file transfer CLI (replacing FTP) No Yes Yes
Excel report Yes Yes Yes
Print Excel report Yes No Yes
Remote alarm & distribution Yes No Yes
Business integrations
OS keyboard integration No Yes Yes
Non-Latin keyboards Yes No Yes
Brands Yes No Yes
Targets
HMI panels Yes Yes Yes
Industrial PCs Yes No Yes

Drivers (industrial communication protocols)

  X2 X3 – Initial release X3 – Future updates
Supported drivers (approximate number) 70 15 50
OPC UA Yes Yes Yes
Secure OPC UA No No Yes
Drivers with Ethernet support Yes Yes Yes
Drivers with Serial support Yes Yes Yes
Drivers with CAN support Yes No Yes
Drivers with SoftControl support Yes Yes (dependent on CODESYS) Yes
Drivers with BACnet support Yes No TBD
Drivers with expansion modules support Yes No No

X2 to X3 – Transition Guide for iX Developer

Follow this transition guide to ensure a smooth and secure transition from iX Developer 2 to iX Developer 3 on Beijer Electronics X3 HMI panels.

Prerequisites

  • Development PC
  • X2 HMI panel
  • X3 HMI panel

Instructions

  1. Review the Modified Features in iX Developer 3.0 chapter to understand changes and evaluate their impact on your project.
  2. Confirm that your driver is supported in iX Developer 3 by checking the Driver List X3 HMI Panels. If your driver is not listed here, Contact Beijer Electronics.
  3. Connect the X2 HMI panel to the development PC.
  4. If you are using an older version of iX Developer (before 2.53), follow these steps:
    • Create a project backup. Refer to Back Up the Project for instructions.
    • Download and install iX Developer 2.53 from the Beijer Electronics SmartStore.
  5. Open your project in iX Developer 2.53.
  6. Build the project and resolve any build errors that appear.
  7. Download the project to the X2 HMI panel. Refer to the Download chapter in the iX Developer 2.53 Reference Manual for download instructions.
  8. Verify the project functionality on the HMI panel.
  9. Save the project.
  10. Create a project backup. Refer to Back Up the Project for instructions.
  11. Quit iX Developer.
  12. Connect the X3 HMI panel to the development PC.
  13. Download and install iX Developer 3 from the Beijer Electronics SmartStore.
  14. Open your project in iX Developer 3.
    IMPORTANT
    When opening your project in iX Developer 3, a dialog will provide key information and recommendations for project conversion. Read this carefully and follow the instructions.
  15. Build the project and address any build errors using the How to Resolve Transition Build Errors guide.
  16. Transfer the project to the X3 HMI panel. Refer to the Transfer the iX App to the HMI Panel chapter in the iX Developer 3 User Manual for transfer instructions.
  17. Verify the project functionality in the iX App on the HMI panel.
    TIP
    In some cases, when the transferred project is run on the HMI panel, the project won’t open and an Access Denied dialog appears. See Troubleshooting for information on how to solve this issue.
  18. Save the project.
    • Now your project is fully compatible with iX Developer 3.
      TIP
    • For additional help, consult the FAQ, visit the Connected forum, or contact Beijer Electronics support.

Modified Features in iX Developer 3.0
Some features from earlier versions are not included in iX Developer 3.0 at launch. In most cases, alternative features are available. To help you understand how these changes affect your project, the features are grouped into four transition categories:

Transition categories

  • Easy = You can switch to an alternative feature with little or no effort.
  • Medium = Some effort is required to switch. Review the alternatives before transition.
  • Hard = Requires advanced knowledge. Carefully review the alternative before transition.
  • Wait = No alternative is currently available. If your project depends on this feature, wait for a future update.

Review each modified feature in the table below. Identify which changes affect your project, and decide whether to make the transition now or wait for a future version.

Transition category Modified feature Description Alternative
Easy Media player object Removed Use the Web Browser Object instead.
PDF viewer object
SMS and Printer functionality Removed in version 2.52. Save to USB, SD card, or HMI panel. Then use e-mail if required.
System settings In iX Developer 3, you cannot configure

system settings directly as in previous versions. Instead, you define System Requirements that are evaluated and then reserved by the OS3 operating system. If the requirements cannot be fulfilled, the iX App will not start.

Define the System Requirements.
USB transfer App transfer via USB is no longer supported. Use Ethernet transfer instead. See Transfer the iX App to the HMI Panel.
Target rotate Not available for X3 HMI panels. Set Target rotate to

0 (landscape orientation) instead. Follow these steps:

1.     Open the project in iX Developer 2.52.

2.     Navigate to Project >

Settings.

3.     Under Display/ Target, set Target rotate to 0.

4.     Click OK to save.

Transition category Modified feature Description Alternative
  Virtual keyboards for non-Latin languages Will be included in iX Developer 3.1. Use a Latin virtual keyboard or an external keyboard for now.
Medium QR-code object Removed due to outdated libraries. Use NuGet packages. See NuGet Packages.
Hard DLL

compatibility (third-party controls)

DLL-based support has been removed. Use NuGet packages. See NuGet Packages.
Web server features •  JavaScript SDK is deprecated.

•  REST APIs are not fully backward compatible.

•   HTTPS is required.

•  Local port 7001 is fixed.

For more information, see Web Server.
Run action Removed due to security and architectural reasons. Use Scripts instead.
FTP Removed due to security and architectural reasons. Use Transfer Client CLI instead.
Wait Watchdog Not available. Alternative will be introduced in future OS3 updates.
PC runtime Not available. Will be included in future iX Developer updates.
Transition category Modified feature Description Alternative
  Support for certain system tags The following system tags are not yet implemented:

•  ImageVersion (2x: Windows CE Image Version)

•   Internal Temperature

•  Flash Memory Life Time Used

•   Flash Memory EOL Info

•  Power LED Blink Frequency

•  Power LED Blue Intensity

•  Power LED Green Intensity

•  Power LED Red Intensity

•   LedCount

Will be included in future iX Developer updates.
VNC Removed due to security concerns. Secure VNC will be introduced in future OS3 updates.

How to Resolve Transition Build Errors

Build error Action
CS0246: The type or namespace name “SQLiteConnection” could not be found (are you missing a using directive or assemble refrence?) See Update SQLite Code.
CS0246: The type or namespace name “SQLiteException” could not be found (are you missing a using directive or assemble refrence?)
CS0246: The type or namespace name “SQLiteDataAdapter” could not be found (are you missing a using directive or assemble refrence?)
Control System.Windows.Forms.DataGrid on screen Screen5 is not supported. Double-click to suppress build error. See Replace Unsupported DataGridView Control
Control System.Windows.Forms.StatusBar on screen Screen5 is not supported. Double-click to suppress build error.  
Control System.Windows.Forms.ToolBar on screen Screen5 is not supported. Double-click to suppress build error.  
Ftp is no longer supported due to security considerations. Double-click to suppress build error. See Modified Features in iX Developer 3.0.
Key beep is no longer supported. Double-click to suppress build error. See Modified Features in iX Developer 3.0.
Password for project transfer is no longer needed but a password for the project zip archive can be used. Double-click to suppress build error. See Transfer the iX App to the HMI Panel.
Pin code is no longer supported. Double-click to suppress build error. The Service Menu in iX Runtime in iX Developer 2, where the PIN code was used, has moved to OS3. Refer to the OS3 User Guide for more information.
Printing is no longer supported. Double-click to suppress build error. See Modified Features in iX Developer 3.0.
System settings are replaced with System Requirements, and must be manually migrated. Please consult the documentation before suppressing the build error. Double- click to show settings. See Migrate System Settings from iX2 to iX3.
The keyboard culture used is unsupported and US will be used instead. Support for more cultures will be added in the future. Double- click to suppress build error. See Modified Features in iX Developer 3.0.
Build error Action
The report DatabaseReport is in .xls format, please save it as .xlsx instead. Any SQL queries in your report also need to be moved to the Queries section. See Reference Manual for more information. See Migrate Reports from iX2 to iX3.
The report Report1 is in .xls format, please save it as .xlsx instead. Any SQL queries in your report also need to be moved to the Queries section. See Reference Manual for more information. See Migrate Reports from iX2 to iX3.
Topmost window is no longer supported. Double-click to suppress build error.  
Unsupported parameter action ‘Printer’ used by Print Screen action in screen: Screen1.

Replace it with ‘File’ parameter action.

 
VNC is no longer supported due to security reasons. A potential replacement will be included in a future release as part of

OS3 platform. Double-click to suppress build error.

See Modified Features in iX Developer 3.0.
Virtual keyboard is now always enabled. Double-click to suppress build error.  
Watchdog is no longer supported. Double- click to suppress build error. See Modified Features in iX Developer 3.0.

Migrate System Settings from iX2 to iX3
When converting an iX Developer project from iX2 to iX3, you need to manually migrate the system settings.

Instructions

  1. After opening and running the project in iX Developer 3.0 for the first time, the following Build Error appears: System settings are replaced with System Requirements, and must be manually migrated. Please consult the documentation before suppressing the build error. Double-click to show settings.
  2. Double-click the build error message to open the System Requirements. Alternatively, navigate to Project > Settings > System Requirements.
  3. Click Import old System Settings to import the settings from the iX Developer 2.52 project.
  4. If some settings are not imported, click Add to manually configure them.

Replace Unsupported DataGridView Control

To fix the build error:
Control System.Windows.Forms.DataGrid on screen Screen5 is not supported. Double-click to suppress build error. you must replace the old DataGridView control with a new one.

Instructions

  1. Go to Home and expand the Objects group
  2. Click Add Control.
  3. Deselect the DataGridView and click OK.
  4. Reload the project
  5. Open Add Control again and add a DataGridView.
  6. Update the script to reference the new DataGridView.

Migrate Reports from iX2 to iX3

  1. Open the Project Folder and navigate to Reports > Template and open the .xls template files.
  2. In Excel, select File > Save As and change the file extensions to .xlsx.
  3. In Excel, check if there is sheet named <#Config>.Beijer-Electronics-X3-Human-Machine-Interface-fig- (1)
    • If not, go to step 7.
    • If yes, continue with step 4:
  4. Open the project in iX Developer 3.
  5. Go to the Reports Configuration Page and select the Queries tab.
  6. Add all the queries from the <#Config> sheet manually, as shown in the example screenshot.Beijer-Electronics-X3-Human-Machine-Interface-fig- (2)
  7. In iX Developer 3, go to the Reports Configuration Page and select the Reports tab.
  8. Replace the existing .xls files with the updated .xlsx files in the Reports list.

Update SQLite Code
This guide explains how to update code from System.Data.SQLite to Microsoft.Data.Sqlite.
Original Code: System.Data.SQLite
The example below uses System.Data.SQLite to retrieve data from a table:

  • // System.Data.SQLite
  • public DataTable Select(string tablename)
  • {
  • DataTable dt = new DataTable();

Beijer-Electronics-X3-Human-Machine-Interface-fig- (3)

Key steps

  1. Connect to the database (ConnectToDataBase).
  2. Use SQLiteDataAdapter to execute the query and fill the DataTable.
  3. Handle errors with a try-catch block.
  4. Disconnect from the database after use.

Updated Code: Microsoft.Data.Sqlite
This example uses Microsoft.Data.SQLite for the same operation:

Beijer-Electronics-X3-Human-Machine-Interface-fig- (4)Beijer-Electronics-X3-Human-Machine-Interface-fig- (5)

Key updates

  1. Use string interpolation ($””) to build SQL queries.
  2. Replace SQLiteDataAdapter with SQLiteCommand.
  3. Use ExecuteReader and dt.Load(reader) to load data.
  4. Manage resources using statements.

Troubleshooting

Problem Reason Solution
Access Denied OS3

environment

Ensure all necessary changes are completed before deploying your application in an OS3-enabled environment. Refer to X2 to
dialog is not X3 – Transition Guide for iX Developer.
appears prepared.  
when opening the app on the HMI

panel.

   
File paths in scripts are not updated. Modify your existing iX scripts to accommodate the updated file access permissions. Writing to the installation folder of your application is no longer permitted.
Save locations are incorrect. If your scripts save files to the installation folder, update them to use a writable location. Use the predefined variable

GlobalsBase.Environment.Application.CommonApplicationData to

    retrieve the correct path.

TIP
For additional support, visit the Connected forum or contact Beijer Electronics support.

FAQs

Are iX3 scripts compatible with iX2?

Yes, to a high degree. Key differences include: *Reference assemblies are not compatible. *Certain namespaces have changes. *SQLite usage has changed

How do I script with FlexCel in iX3?

Use the DocumentFormatOpenXml.dll NuGet package instead of FlexCel.

How do I convert existing DLLs (e.g., OpenNetCF, FlexCel) to NuGet in iX3?

Refer to Install NuGet Packages in the iX Developer User Guide.

How do I install NuGet packages in iX3?

Refer to Install NuGet Packages in the iX Developer User Guide.

Does iX3 support SVG vector graphics?

No native support is available. Some SVG NuGet packages exist, but most use LGPL licenses. Licensing advice cannot be provided.

Why do I get warnings about Opacity, Radius, or Rotation?

X3 HMI panels use WinForms, which does not support some WPF graphical effects. These limitations exist for performance reasons. Users not requiring high performance may test WPF.

Can the Web Server in iX3 read/write tags?

Yes

Can I change the Web Server port in iX3?

No. Port 7001 is fixed.

Why can’t I ping the HMI panel?

For security reasons, ping functionality has been removed.

Can I save my username and password during project transfer?

No. However, a password handler can simplify this process.

Do I need to buy a new license for iX3?

No. You can use the same license as in iX 2.40 or later.

What is the difference between Test Mode and Production Mode?

*Test Mode – Faster build, slower runtime—use during development. *Production Mode – Slower build, faster runtime—use for final deployment.

Documents / Resources

PDF thumbnailX3 Human Machine Interface
User Guide · X3 Human Machine Interface, X3, Human Machine Interface, Interface

References

Ask a Question

Use this section to ask about setup, compatibility, troubleshooting, or anything missing from this manual.

Ask a Question

Ask about setup, compatibility, troubleshooting, or anything missing from this manual. Name and email are optional.