Subscribe to Our Youtube Channel
Related Manuals for hilscher netFIELD Compact X8MC
Summary of Contents for hilscher netFIELD Compact X8MC
- Page 1 User manual netFIELD Compact X8MC Hilscher Gesellschaft für Systemautomation mbH www.hilscher.com DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public...
-
Page 2: Table Of Contents
Overview ...................... 43 4.5.2 Onboarding using the “Basic” method ............ 45 4.5.3 Onboarding using the “Advanced” method ............. 48 netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... - Page 3 Technical data ........................ 125 Decommissioning, dismounting and disposal .............. 127 Dismounting ......................... 127 Disposal and recycling .................... 128 8.2.1 Disposal of battery .................. 128 netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public...
- Page 4 Disposal of device.................. 130 Legal notes ........................... 131 List of figures ........................ 135 List of tables......................... 138 Contacts.......................... 139 netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public...
-
Page 5: Introduction
About this document 1.1.1 Description of the contents This user manual describes the netFIELD Compact X8MC edge gateway (NFX8M-D2-N32-012) from Hilscher. It contains a description of its hardware, its technical data and a description of its web-based configuration GUI (Local Device Manager). -
Page 6: Terms And Abbreviations
It is the basic framework of the evolved netFIELD device-to-cloud communication infrastructure. netFIELD App netFIELD application Docker container from Hilscher. Runs in the IoT Edge Docker or Standard Docker of the netFIELD OS on the netFIELD Edge. netFIELD Cloud Internet-hosted platform providing APIs for cloud-to-cloud and cloud-to-edge communication. -
Page 7: Brief Description
Note that connecting the netFIELD Compact device to the netFIELD Cloud requires an account/subscription for the netFIELD Cloud services (https://www.netfield.io). Contact your local Hilscher sales representative for information on terms and conditions. Key features hardware 1.8 GHz quad-core ARM Cortex-A53 64Bit CPU (NXP i.MX8M Mini) ·... - Page 8 For more details and information about the netFIELD OS, see section netFIELD OS: Industrial IoT Operating System [} page 9]. “High Assurance Boot”: Only Hilscher-authenticated netFIELD OS core · software can run on the device at any time.
-
Page 9: Netfield Os: Industrial Iot Operating System
Linux for easy porting to most capable device types across various CPU architectures. Architecture Hilscher netFIELD OS is a secure operating system that makes it easy to program, deploy, connect and manage Edge Devices. Hilscher netFIELD OS extends the Linux kernel, with software libraries to securely connect operation technology like PLC, MES, Historians, Files or other on-premise systems with IT services like the netFIELD Portal. -
Page 10: Figure 2: Netfield Os Container Management
Device Manager, by the netFIELD OS command line interface or by a web application like portainer.io, which can be deployed as container. Figure 2: netFIELD OS container management netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 11: Figure 3: Netfield Os Inter-Container Communication
– Time admin · Onboarding in netFIELD Cloud · System and container logging Secure communication to the netFIELD Cloud services · netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... - Page 12 Management of Linux services in Local Device Manager Connectivity check for IoT Edge Docker in Local Device Manager · netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public...
-
Page 13: Safety
A supply voltage above the upper limit can cause severe damage to the · device! A supply voltage below the lower limit can cause malfunction of the · device. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 14: Risk Of Denial Of Service Due To Extensive Memory Usage Close To Limits
The device does not contain any parts that are serviceable by the user. Do not open or damage the housing. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 15: Hardware Description
OS and the device, use the power button (11). (10) USB 2.0 type A connector USB connectors [} page 26] netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 16: Dimensions
CAN and digital input/output (4DI4DO) CAN and digital inputs/ interface. outputs [} page 18] Table 3: Positions on netFIELD Compact device Dimensions Figure 5: Dimensions in millimeters netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 17: Interfaces
Secondary 100 Mbit/s Ethernet port (see position (1)). The logical name of ETH2 in netFIELD OS is eth1. The “factory setting” of the IP address of this port is 192.168.253.1/24. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 18: Can And Digital Inputs/Outputs
· Pitch: 2.54 mm · Wire cross section: AWG 20 – AWG 30 · Locking to device: Screw flange netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 19: Figure 7: Can Pin Assignment
You can list the available socket interfaces which outputs next to the usual Ethernet sockets (the can0 socket): sudo ip addr show netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... - Page 20 Hardware description 20/139 Simple test application For a simple test, we recommend to download and use the github project: https://github.com/CANopenNode/CANopenSocket netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public...
-
Page 21: Figure 8: Pin Assignment 4Di4Do
Maximal input voltage recognized as LOW VIN High Minimal input voltage recognized as HIGH Table 5: Operating and state conditions netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 22: Figure 9: Digital Input Wiring Example
The following figure shows a simple example of an output use case featuring a lamp as “consumer”: Figure 10: Digital output wiring example netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 23: Table 6: Access To Digital Input/Outputs
You can use the following command line to set the digital output OUT2 to “0”. echo 0 | sudo tee /var/platform/ied-di4o4_o2 For an example in programming language C, see https:// hilscher.atlassian.net/wiki/x/JABpKg. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 24: Supply Voltage
Table 8: Serial interface The device is shipped with a matching plug (Kunacon MAFT381065) for easy wiring: Figure 12: Plug for block connector netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... - Page 25 If the container is deployed via Docker Compose, you would have to add the following lines in the *.yml file: devices: - "/dev/ttymxc0:/dev/ttymxc0" group_add: - dialout netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public...
-
Page 26: Usb Connectors
Value Baud rate 115200 Data bits Stop bits Parity none Flow control none Table 9: Serial port settings of console netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 27: Leds
LED will be automatically controlled by the Platform Connector. Note that your custom Linux programming of the LED may thus be overridden. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 28: Tpm
The TPM is set-up as /dev/tpm0 device in the underlying Linux allowing raw API access via Linux shell and/or from application containers. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 29: Commissioning And First Steps
Portal, Manifest). DOC190701OIxxEN Table 12: Tasks for commissioning the netFIELD Compact for netFIELD Cloud usage netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 30: Standard Docker User
The netFIELD Compact device is shipped with an attached metal bracket for easy DIN top hat rail or wall mounting. Figure 13: Device mounted on DIN top hat rail netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 31: Figure 14: Mounting Device Onto Top Hat Rail
Note that you can facilitate the mounting process by pressing down the lever at the back of the mounting bracket to expand the spring-loaded clamps: Figure 15: Spring-loaded rail clamps netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 32: Figure 16: Remove Rail Clamp Screws
Ø Use the Allen wrench/key respectively screwdriver and two M4 cylinder head screws of suitable length to screw the mounting bracket to the wall. Figure 17: Wall mounted netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... - Page 33 After connecting the supply voltage, switch on the device by pressing the power button (see position (11) in section Device overview [} page 15]) for approx. one second. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public...
-
Page 34: Establish Lan Connection And Login To Local Device Manager
Via direct (one-to-one) connection at ETH 2 port (eth1 in netFIELD · Figure 18: Factory IP address settings of LAN interfaces Note: The device contains a certificate issued by Hilscher. Therefore, your browser will probably issue an "unsecure connection" warning message when connecting to the device for the first time. -
Page 35: Using Dhcp Server
On the Certificate page of the Local Device Manager, you can later upload your own trusted certificate to the device. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... - Page 36 Ø Double-click this entry to connect to the Local Device Manager of the device. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public...
-
Page 37: Establishing One-To-One Connection To Device (Without Dhcp Server)
Local Area Connection or Ethernet. (The name of the network connection may be different on your PC.) netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 38: Figure 20: Setting Ip Address Under Windows For Direct Lan Connection
Ê A connection is established and the Local Device Manager opens in your browser window. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 39: Login To Local Device Manager
Ê For security reasons, you are now forced to change the default admin password immediately. Ø In the Current password field, enter admin once again, then click Sign In button: netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 40: Figure 22: Enter Current Password Dialog
You can change the password again later in the Local Device Manager under Accounts > System Administrator > Set Password or under (user menu) > Account Settings. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 41: Set System Time
Ø To configure your local system time, open the System page of the Local Device Manager, then click the red date/time value next to System Time: netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 42: Figure 25: System Time Value
NTP servers that you want to use, e.g. ptbtime1.ptb.de. You can create a list of several servers; the system will use the first netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 43: Onboard" (Register) Device In Netfield Cloud
Connecting your device to the netFIELD Cloud requires an account/ subscription for the netFIELD Cloud services https://www.netfield.io. Contact your local Hilscher sales representative for information on terms and conditions. Before your device can be managed from the portal, it must first complete a one-time registration process, called “onboarding”. - Page 44 AMQP over WebSocket uses TCP port 443 The following sections contain step-by-step instructions for the Basic and Advanced onboarding methods. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public...
-
Page 45: Onboarding Using The "Basic" Method
Ask your portal’s system administrator for the necessary credentials. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... - Page 46 2FA; i.e. the email account or the Authenticator app. This is because in this case you will also have to enter a 2FA passcode during onboarding. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public...
- Page 47 “Basic” onboarding procedure here locally for a second time. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public...
-
Page 48: Onboarding Using The "Advanced" Method
Ø Open a new tab in your browser and change to the portal, but do not close the connection to the Local Device Manager of your device in your first browser tab. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 49: Figure 29: Add Device Mask In Netfield Portal
For information on how to configure these parameters, see section Device Navigation: Edit device settings (Update mask) in the netFIELD Portal manual (DOC190701OIxxEN). netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 50: Figure 30: Activation Code In Portal
Activation Code that you will have to enter locally on your device: Figure 30: Activation Code in portal Ø Copy the Activation Code to your clipboard. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 51: Figure 31: Advanced Onboarding Tab In Device
Ø In the API Endpoint field, enter the URL of the REST-API interface of the portal. For the Hilscher netFIELD Portal, this is: api.netfield.io If you are using a different instance of the portal, ask your portal’s system administrator for the URL. - Page 52 ð The device connects to the portal and is registered there. If the process has been successful, the following message appears: Success – Device is now onboarded. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public...
-
Page 53: Figure 32: Example Of An Api Key Permitting To Onboard Devices
Ø To copy the API Key in order to use it in the Local Device Manager of the device for the advanced onboarding process, change into the General tab. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 54: Figure 33: Copy Key To Clipboard
Ø Go to the Onboarding > Advanced page in the Local Device Manager of your local device and insert the key into the API KEY field. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 55: Local Device Manager
In the navigation panel on the left of the screen, you can select the available “standard” management pages. Many Hilscher netFIELD application containers like e.g. netFIELD App Platform Connector or netFIELD App OPC UA Client provide their own configuration GUI, which can be selected here (if deployed on your device). -
Page 56: System
The System page allows you to configure and monitor basic system parameters and resources. Figure 35: System page in Local Device Manager netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 57: Figure 36: Change Host Name Dialog
Can contain lower-case characters, digits, dashes and periods (with populated subdomains). Setting this value takes immediate effect and does not require a restart. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... - Page 58 Network Traffic link to open the Networking page providing further details about the physical and virtual network interfaces of the device. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public...
-
Page 59: Networking
The graphs in the section on top show the amount of network traffic (sending and receiving) for the last five minutes. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 60: Figure 38: Details Of Lan Interface (Eth0)
Ø You can click on an interface, e.g. eth0, in order to display further details or to configure its IP settings: Figure 38: Details of LAN interface (eth0) netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 61: Figure 39: Ipv4 Settings
Automatic (DHCP) next to IPv4. Ê The IPv4 Settings page opens. Figure 39: IPv4 Settings Ø In the Addresses dropdown-list, select Manual. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 62: Figure 40: Manual Ipv4 Settings
Proxy server for your netFIELD OS. Do not edit or remove localhost and 127.0.0.1 from the No Proxy list. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 63: Firewall
Ø To open the Firewall configuration page, click the FIREWALL link on the Networking page. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 64: Figure 41: Open Firewall Configuration Page
Local Device Manager 64/139 Figure 41: Open Firewall configuration page Ê The Firewall configuration page opens: Figure 42: Elements on Firewall configuration page netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 65: Table 14: Available Firewall Zones
Ø To add a new zone or to assign new interfaces or subnet(s)/IP address range(s) to an existing zone, click + Add Zone button. Ê The Add Zone dialog opens: netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 66: Figure 43: Add Zone Dialog
Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 67: Table 15: Elements In Add Zone Dialog
Ø Enter new subnet(s) or IP address range(s) into the Networks field. (Enter the subnet mask as CIDR Suffix and separate multiple entries with commas.) netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 68: Table 16: Columns/Elements In Allowed Services Table
Ê The Add Services dialog opens. The dialog features a list of commonly used services and their standard TCP or UDP port numbers: netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 69: Figure 44: Add Services
Name field. You can add several ports at once by separating the entries with a comma. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 70: Figure 45: Add Custom Services Dialog
To add a new port forwarding definition to a zone, proceed as follows: Ø Click the + button above the Action column. Ê The Add Forward Port dialog opens: netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 71: Figure 46: Add Forward Port Dialog
(i.e. for a zone that has already been added to your firewall). Table 18: Control elements in main toolbar netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 72: Network Proxy Settings
The No Proxy entries designate destinations that shall not be addressed via Proxy server. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 73: Figure 48: Proxy Settings Dialog Window
Ø Click the Edit Proxy button. Ê The Proxy Settings dialog opens: Figure 48: Proxy Settings dialog window netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 74: Figure 49: Using One Proxy Server For All Protocols
OS that cannot be handled by a proxy server because they are required for internal communication. You can, however, add further exceptions in the Host field. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 75: Figure 50: Separate Http/Https/Ftp Configuration
Ê This enables separate configuration fields for the HTTP, HTTPS and FTP protocols: Figure 50: Separate HTTP/HTTPS/FTP configuration Ø Enter the parameters of the individual proxy servers. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 76: Figure 51: Restart Dialog After Changing Proxy Server Configuration
Onboarding page should now display a Proxy settings changed note and the Synchronize button (if not, refresh the page by pressing F5 on your keyboard). netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 77: Figure 52: Synchronize Proxy Settings With Netfield Portal
OS. If your device is onboarded in the netFIELD Portal, do not forget to synchronize the new settings. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 78: Networking Services
However, using only the Ping test works without the device being onboarded. For more information on the iotedge check tool, see https:// docs.microsoft.com/en-us/azure/iot-edge/troubleshoot? view=iotedge-2020-11 https://github.com/Azure/iotedge/blob/ main/doc/troubleshoot-checks.md netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 79: Figure 53: Connectivity Check Tab
For more information on the checks that are being performed, see https://github.com/Azure/iotedge/blob/main/doc/troubleshoot- checks.md Note that the current netFIELD OS uses the iotedge check tool version 1.2.5. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 80: Onboarding (And Offboarding)
“offboarding” the device. By offboarding it, the device will be "deleted" in the portal and removed from the device list of the portal’s Device Manager: netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 81: Figure 55: Offboarding "Basic
Ê After successful offboarding, the following message appears: Success – Device is now deleted. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 82: Figure 56: Offboarding "Advanced
After offboarding, all application containers managed by the netFIELD Portal are automatically deleted. However, the Docker images will still present on the device. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 83: General Settings
For more information about the Remote Control function, see netFIELD Portal operating instructions manual, DOC190701OIxxEN. Ø Click Save button to save your new Web Server Settings. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 84: Default Mqtt Client Settings
JSON configuration file in the netFIELD OS (/etc/ gateway/mqtt-config.json). By default, all Hilscher netFIELD Apps use this configuration file. Other containers (i.e. non-Hilscher application containers) that do not require their own customized MQTT client settings, can also use these settings here if the configuration file is referenced accordingly in the container image (e.g. -
Page 85: Table 19: Default Mqtt Client Settings
(not recommended). Table 19: Default MQTT Client Settings Ø Click Save button to save your new Default MQTT Client Settings. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 86: Docker Network Settings
You can also add addresses of external DNS server(s) for Standard Docker and IoT Edge Docker containers here. Important: These network address settings are predefined by Hilscher. Change these default addresses only if they are not compatible with your company’s LAN address configuration, i.e. to avoid an address conflict. -
Page 87: Table 20: Standard Docker Network Settings
(Note that most netFIELD App containers deployed from the netFIELD Portal are configured to connect netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 88: Table 21: Iot Edge Docker Network Settings
The default bridge networks (docker0 and iotedge0) are indicated in blue, the user-defined custom bridge networks are indicated in green: netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 89: Remote Access
Note that your device must be onboarded in the netFIELD Cloud and connected to the Internet in order to use the remote control functions. Contact your local Hilscher sales representative for information on the terms and conditions of an account/subscription for the netFIELD Cloud services (https://www.netfield.io). -
Page 90: Figure 61: Remote Access Tab
Portal to your device. Accessing the netFIELD OS will then be possible via local LAN, SSH or Console connection only. Ø Click Save. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 91: Login
Ø To remove the message from the Sign In dialog again, go to General Settings > Login and delete the message from the text field, then click Save button. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 92: Standard Docker
(default). · Everything - All Docker images and containers are displayed (including stopped containers). netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 93: Figure 65: Expand Concise Container Details
Here you can also start, stop, restart, delete or commit the container, or change its resource limits: netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 94: Figure 66: Container Parameters With Terminal Window
Ø Select an image in the list, then click Download button. Ê The image is downloaded, extracted and displayed in the Images area. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 95: Figure 68: Run Image Dialog
Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 96: Figure 69: Expand Image Details
Ø To go back to the Standard Docker overview page, click the blue Show all images link in the page header. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 97: Iot Edge Docker
The network address settings of the IoT Edge Docker can be managed under General Settings > Docker Network Settings (see section Docker Network Settings [} page 86]). netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 98: Figure 71: Iot Edge Docker
Combined usage of 4 CPU cores: Load of the containers on the CPUs. Combined memory usage: Load of the containers on the memory. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 99: Figure 72: Container Details Expanded
Ø To go back to the IoT Edge Docker overview page, click the blue Show all containers link in the page header. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 100: Figure 74: Iot Image Expanded
Ø To show more details of an image, click on it in the list. Ê A page featuring detailed information opens: netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 101: Figure 75: Details Of Netfield Proxy Image
UI) by using docker commands with the CLI in the Terminal. See section Useful CLI commands and parameters in Terminal [} page 123] for examples. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 102: Accounts
Ø To create a new user account, click on the Create New Account button. Ê The Create New Account dialog opens: netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 103: Figure 77: Create New Account
(i.e. the account you are currently logged in with) also by selecting > Account Settings in the toolbar. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... - Page 104 OS account name (e.g. “admin”) for authentication when you login. Ø Click on the button to add an SSH key. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public...
-
Page 105: 5.10 Certificate
*.pem format to the netFIELD OS. Figure 79: Web Server Certificate page Note: The netFIELD OS contains a certificate issued by Hilscher. Note that the automatically created certificate is valid for one year. You can upload your own certificate to the netFIELD OS here. The corresponding root certificate should be rolled out on each of your PC/devices that you use for connecting to the netFIELD OS. -
Page 106: 5.11 Terminal
For working with root privileges in the CLI, use “sudo”. Examples of commands and parameters are provided in section Useful CLI commands and parameters in Terminal [} page 123]. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 107: 5.12 Operating System
“free” the required RAM for the process. You can restart the containers after having finished the OS Update. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 108: Figure 81: Os Update Page
(i.e. an account) and the deployment of the netFIELD App Platform Connector on your device. To update the operating system, proceed as follows: 1. Download the update file (or recovery file) from Hilscher to your local PC. Ø Go to the netFIELD OS Version history page https://hilscher.atlassian.net/l/cp/SBeH8aq2 and click on the link under Current version. -
Page 109: Figure 82: Selected Os Update Image
Ê The image is uploaded to the device. This might take a few minutes. After uploading has been finished, the following screen appears: Figure 83: Upload finished message netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 110: Figure 84: Os Update "Disconnected" Message
(see chapter Commissioning and first steps [} page 29]). netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 111: Backup & Restore
PC instead. Figure 85: Backup and Restore tab netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... - Page 112 This option saves all user-made settings and application data plus the currently installed netFIELD OS itself. Create Click here to create the backup file. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public...
-
Page 113: Table 22: Elements In Backup & Restore Tab
USB, as described in section Device recovery via USB [} page 119]. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 114: Factory Reset
USB, as described in section Device recovery via USB [} page 119]. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 115: 5.13 Logs
Severity (type) and Service (i.e. the “service” that issued the message). Ø Click on a message in the list to display the information in full detail. Figure 87: Logs netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 116: 5.14 Services
Ø Click on a service in the list to display further information (including the service logs) and/or to change its running state or startup settings. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 117: Figure 89: Service Details And Settings Page
Requires) are displayed as clickable links. The log messages of the service are displayed under SERVICE LOGS in the footer. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 118: Figure 90: Service Types: Timers
To remove a timer completely, you have to use the Terminal to delete it manually in the corresponding systemd configuration. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 119: Good To Know
Windows in FAT32. If you intend to use such a high-capacity stick, use a tool like e.g. HP USB STICK FORMAT to format the stick under Windows. You have downloaded the recovery image from Hilscher to your local · PC (see below for instructions). -
Page 120: Figure 92: Formatting Usb Stick
Good to know 120/139 Step-by-step instructions 1. Download the zip archive containing the recovery image from Hilscher to your local PC and unpack it. Ø Go to the netFIELD OS Version history page https://hilscher.atlassian.net/wiki/x/SYMZBg and click on the link under Current version. -
Page 121: Figure 93: Format Usb Stick Dialog Window
Ê After formatting is finished, the USB stick is labelled in the Windows Explorer by its new name “RECOVERY”. Figure 94: Formatted USB stick netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 122: Figure 95: Recovery Image On Usb Stick
DHCP, default administrator password is set to admin). You can now reconnect to the device as described in chapter Establish LAN connection and login to Local Device Manager [} page 34]. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 123: Useful Cli Commands And Parameters In Terminal
Manage IoT Edge Docker docker-iotedge <docker commands> Example To list all created containers for the IoT Edge Docker instance: docker-iotedge ps -a netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 124: External Storage Support Using Iscsi
Set serial interface remanently to RS-232: sudo bash -c 'echo "mode=rs232" > /etc/default/uart1' systemctl restart uart1-mode netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 125: Technical Data
VIN Low: +4 V recognized as LOW Minimal input voltage VIN High: +6 V recognized as HIGH Connector Kunacon PDFD254205 netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 126: Table 23: Technical Data Netfield Compact X8Mc
EN 55032/5, EN 61000-6-2, EN 61000-6-3 compatibility (EMC) Safety EN/UL/IEC 62368-1 Conformity declarations UKCA RoHS Table 23: Technical data netFIELD Compact X8MC netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 127: Decommissioning, Dismounting And Disposal
Note that you can facilitate the dismounting by pressing down the lever at the back of the mounting bracket to expand the spring-loaded clamps: netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 128: Disposal And Recycling
In Europe, the directive 2006/66/EG batteries and accumulators and waste batteries and accumulators applies. Different policies and laws may apply nationally. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 129: Removal Of Battery
8.2.2 Removal of battery If you do not want to return the device to Hilscher, you have to remove the battery and dispose of it properly prior to the disposal of the device. To remove the battery, proceed as follows: Ø... -
Page 130: Disposal Of Device
(RMA) form on www.hilscher.com. In Europe, the directive 2012/19/EU waste electrical and electronic equipment applies. Different policies and laws may apply nationally. netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... -
Page 131: Legal Notes
It cannot be ruled out that the user's manual, the accompanying texts and the netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... - Page 132 Liability disclaimer The hardware and/or software was created and tested by Hilscher Gesellschaft für Systemautomation mbH with utmost care and is made available as is. No warranty can be assumed for the performance or...
- Page 133 The customer hereby expressly acknowledges that this document contains trade secrets, information protected by copyright and other patent and ownership privileges as well as any related rights of Hilscher Gesellschaft für Systemautomation mbH. The customer agrees to treat as confidential all of the information made available to customer by Hilscher Gesellschaft für...
- Page 134 Legal notes 134/139 Systemautomation mbH and rights, which were disclosed by Hilscher Gesellschaft für Systemautomation mbH and that were made accessible as well as the terms and conditions of this agreement itself. The parties hereby agree to one another that the information that each...
-
Page 135: List Of Figures
Details of LAN interface (eth0) ................60 Figure 39: IPv4 Settings ......................61 Figure 40: Manual IPv4 Settings.................... 62 netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public... - Page 136 Figure 79: Web Server Certificate page ................105 Figure 80: Terminal........................ 106 Figure 81: OS update page ....................108 netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public...
- Page 137 Detach device from mounting bracket ..............129 Figure 100: Open device housing.................... 129 Figure 101: Position of battery in device.................. 130 netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public...
- Page 138 IoT Edge Docker Network Settings ................ Table 22: Elements in Backup & Restore tab ................. 112 Table 23: Technical data netFIELD Compact X8MC.............. 125 netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public...
-
Page 139: Contacts
Phone: +1 630-505-5301 20090 Vimodrone (MI) E-mail: us.support@hilscher.com Phone: +39 02 25007068 E-mail: info@hilscher.it Support Phone: +39 02 25007068 E-mail: it.support@hilscher.com netFIELD Compact X8MC | User manual © Hilscher 2024 DOC230301UM01EN | Revision 1 | English | 2024-06 | Released | Public...
Need help?
Do you have a question about the netFIELD Compact X8MC and is the answer not in the manual?
Questions and answers