Contents

Dell Edge Gateway 5200 Gateway Software User's Guide PDF

1 of 61
1 of 61

Summary of Content for Dell Edge Gateway 5200 Gateway Software User's Guide PDF

Dell EMC Edge Gateway 5200 Software User's Guide

January 2022 Rev. A00

Notes, cautions, and warnings

NOTE: A NOTE indicates important information that helps you make better use of your product.

CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid

the problem.

WARNING: A WARNING indicates a potential for property damage, personal injury, or death.

2022 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries. Other trademarks may be trademarks of their respective owners.

Chapter 1: Introduction................................................................................................................. 5

Chapter 2: Setting Up the Windows 10 Operating System..............................................................7 Boot up and log in................................................................................................................................................................7 Factory reset.........................................................................................................................................................................7 System restore and backup recovery.............................................................................................................................8

Create a recovery drive................................................................................................................................................8 Create a system image................................................................................................................................................. 8 Recover from system image......................................................................................................................................10

Security Baseline settings................................................................................................................................................10 Windows 10 IoT Enterprise LTSC basic functions..................................................................................................... 10

UART controller............................................................................................................................................................ 10 TPM support.................................................................................................................................................................. 11 RHProxy driver - I2C and GPIO.................................................................................................................................11 System shutdown and restart...................................................................................................................................12 Configure LAN network.............................................................................................................................................. 12 Mini PCI express expansion modules.......................................................................................................................12 Configure WWAN network........................................................................................................................................ 13 Configure Bluetooth.................................................................................................................................................... 13

Accessing and updating the BIOS..................................................................................................................................13 Access the BIOS settings...........................................................................................................................................14 Update the BIOS using UEFI capsule update from Windows............................................................................ 14

SuperIO Function Library................................................................................................................................................. 15 Windows SIO API......................................................................................................................................................... 15 Build the SIO sample application...............................................................................................................................17 Execute the SIO sample application........................................................................................................................ 17

Digital Input/Output Function of the Intel PCH Controller..................................................................................... 18 Build the GPIO sample application........................................................................................................................... 18 Execute the GPIO sample application..................................................................................................................... 18

Digital Input/Output Function from PCA9535 GPIO................................................................................................ 19 PCA9535 GPIO Expander API...................................................................................................................................19 Build the PCA9535 sample application.................................................................................................................. 20 Execute the PCA9535 sample application............................................................................................................. 21

Intel Active Management Technology...........................................................................................................................21 Hardware requirements.............................................................................................................................................. 21 Host setup.....................................................................................................................................................................22 Activate Intel AMT...................................................................................................................................................... 22 Check your configuration.......................................................................................................................................... 24 Install the Intel Manageability Commander tool...................................................................................................26 Manage an Intel AMT-activated system using MC............................................................................................. 27 Access Intel AMT using Mesh Commander...........................................................................................................33 KVM on storage redirection......................................................................................................................................38

COM Port and Ethernet Names for Mini PCIe Cards ............................................................................................. 40

Contents

Contents 3

Chapter 3: Setting Up the Ubuntu Operating System.................................................................. 42 Boot up and log in............................................................................................................................................................. 42 Create bootable USB stick for factory reset..............................................................................................................42 Update BIOS capsule........................................................................................................................................................42 Ubuntu 20.04 LTS basic functions................................................................................................................................43

System shutdown and restart.................................................................................................................................. 43 Ubuntu OTA update.................................................................................................................................................... 43 List installed packages................................................................................................................................................44 Update the system name...........................................................................................................................................44 Change the time zone................................................................................................................................................ 44 Root user credential....................................................................................................................................................44 Create new user...........................................................................................................................................................44 Select language............................................................................................................................................................44 Display............................................................................................................................................................................ 46 USB................................................................................................................................................................................. 46 Configure Ethernet..................................................................................................................................................... 46 Configure WiFi network............................................................................................................................................. 46 Configure Bluetooth....................................................................................................................................................47 Connect 4G or 5G WWAN........................................................................................................................................ 47 Access GPS.................................................................................................................................................................. 49 Remote login.................................................................................................................................................................49 Set up audio and microphone................................................................................................................................... 49 SSD security-erase..................................................................................................................................................... 50 Connect to the serial port..........................................................................................................................................51 Mount USB storage.................................................................................................................................................... 52 Configure watchdog................................................................................................................................................... 53 GPIO............................................................................................................................................................................... 54 TPM tasks..................................................................................................................................................................... 55 Wake events................................................................................................................................................................. 57

Isolated Canbus uFM expansion module......................................................................................................................58 EMP2-X2S1 card with isolated RS-232 uFM expansion module........................................................................... 59 EMP2-X4S2 card with isolated RS-422/485 uFM expansion module................................................................. 60

4 Contents

Introduction The Dell EMC Edge Gateway 5200 supports Windows 10 IoT Enterprise 2019 and Ubuntu 20.04 LTS. The setup procedures for each of these operating systems are detailed in the following chapters.

Figure 1. System block diagram

The following table defines the acronyms and abbreviations used throughout this document.

Table 1. Acronyms and abbreviations

Acronym or abbreviation Definition

API Application Programming Interfaces

BIOS Basic Input Output System

CPU Central Processing Unit

DI Digital Input

DO Digital Output

GPIO General Purpose Input Output

HWMon Hardware Monitor

I2C Inter Integrated Circuit

1

Introduction 5

Table 1. Acronyms and abbreviations (continued)

Acronym or abbreviation Definition

LAN Local Area Network

LTSC Long Term Servicing Channel

PCI Peripheral Component Interconnect

USB Universal Serial Bus

WDT WatchDog Timer

6 Introduction

Setting Up the Windows 10 Operating System

This chapter serves as a guide to install and use the Windows 10 IoT Enterprise 2019 operating system on the EGW-5200 hardware.

For more information on the Windows 10 operating system, see https://support.microsoft.com.

NOTE: For proper Windows boot up, please ensure the BIOS version used is 0.02.10 or above.

Topics:

Boot up and log in Factory reset System restore and backup recovery Security Baseline settings Windows 10 IoT Enterprise LTSC basic functions Accessing and updating the BIOS SuperIO Function Library Digital Input/Output Function of the Intel PCH Controller Digital Input/Output Function from PCA9535 GPIO Intel Active Management Technology COM Port and Ethernet Names for Mini PCIe Cards

Boot up and log in

Steps

1. Connect a keyboard, mouse, and monitor to the EGW-5200.

2. Power on the system. The system boots to the Windows 10 IoT Enterprise LTSC 2019 operating system.

3. Select your regional settings and keyboard layout. If needed, select the second keyboard layout. Otherwise, skip this step.

4. Connect to an available wireless or wired network. After the internet connection is established, the Windows license key is activated.

5. Read and Agree to the End User License Agreement.

6. Create a user account with a password.

7. After login, the system will reboot once for the settings to take effect.

Factory reset

About this task

Users can perform a factory reset of the Windows 10 IoT Enterprise 2019 LTSC on the EGW-5200 using the recovery operating system image on the boot partition. This resets the run-time image back to the standard Windows system, which does not contain any ODM-installed drivers. Users can download the necessary drivers from the Dell Technologies Support Site.

Steps

1. Connect a keyboard, mouse, and monitor to the system.

2. Power on the Edge Gateway and boot to the operating systems desktop.

3. Click the Start icon, hold the Shift key and click Restart.

2

Setting Up the Windows 10 Operating System 7

4. Select Troubleshoot > Reset this PC.

5. Select Reset this PC > Remove everything.

6. Select Fully clean the drive > Reset.

System restore and backup recovery

Create a recovery drive

About this task

To recover from a major issue such as hardware failure, a recovery drive is needed to reinstall Windows 10. This section explains how to create a USB recovery drive. Personal files and any applications that did not come with the system will not be backed up.

Use a minimum of 4 GB USB storage and all data in the USB storage will be deleted. Perform the following steps to create a USB-based recovery drive.

Steps

1. In the search box next to the Start button, search for Create a recovery drive and then select it. You might be asked to enter an admin password or confirm your selection.

2. When the tool opens, make sure Back up system files to the recovery drive is selected and then select Next.

3. Connect a USB drive to your PC, select it, and then select Next.

4. Select Create. Many files need to be copied to the recovery drive, so this might take a while. After successfully creating the recovery drive, click Finish.

Create a system image

About this task

After successfully logging into Windows 10, the user can create a system image which can be used to restore the system in case of a Windows OS crash or hard disk failure.

Steps

1. Select Control Panel and Navigate to Control Panel\System and Security\Backup and Restore (Windows 7).

2. In the Backup and Restore (Windows 7) window, click Create a system image in the upper-left corner.

Figure 2. Create a system image

3. Windows looks for a backup destination on a hard drive, DVD, or network location. Choose an appropriate destination. Click Next.

NOTE: In the following screenshot, a second SSD storage is used to create the backup.

8 Setting Up the Windows 10 Operating System

Figure 3. Backup destination

4. Confirm which areas or partitions of your hard drive will be included in the image file, then click the Start Backup button.

Figure 4. Confirm backup

Results

Windows creates the system image file.

Setting Up the Windows 10 Operating System 9

Figure 5. Backup completed successfully

Recover from system image

Steps

1. Connect the USB storage device that was created in Create a recovery drive on page 8.

2. Connect the hard drive or SSD that was used in Create a system image on page 8.

3. After power on, keep pressing Delete and go to the BIOS settings.

4. From Save and Exit, in Boot Override, select the USB storage device and press Enter.

5. At theChoose your Keyboard layout page, select the appropriate keyboard layout.

6. In the Choose an option window, go to Troubleshoot > Advanced Options > System Image Recovery. Follow the prompts in Windows to restore the system image file.

Results

Once the process is complete, the system restarts and boots into the updated system image.

Security Baseline settings The security settings in the image for the EGW-5200 default to those in the standard Windows 10 IoT Enterprise release. However, it is recommended to install Microsoft-provided security policies on top of this to enhance the security features in the device. Microsoft provides a set of policies called the Security Baseline with each Windows 10 release. Installing this Security Baseline is a good way to quickly enable recommended security settings on IoT devices. The Security Baseline is delivered as part of the Security Compliance Toolkit and can be downloaded from Microsoft's download center: https:// www.microsoft.com/download/details.aspx?id=55319. Detailed installation and customization instructions are available in the toolkit package.

Windows 10 IoT Enterprise LTSC basic functions The EGW-5200 provides various interfaces. The following sections provide further details on these interfaces.

UART controller

For setting the port type of serial ports 1 and 2, change the BIOS settings as detailed in the following table.

Table 2. UART controller settings

S. No Port type Connector Device node BIOS setting configuration

1 RS232/422/485 DB9 COM1 Advanced > Onboard Devices Configuration > COM1 Control, select RS232/422/485

10 Setting Up the Windows 10 Operating System

Table 2. UART controller settings (continued)

S. No Port type Connector Device node BIOS setting configuration

2 RS232/422/485 DB9 COM2 Advanced > Onboard Devices Configuration > COM2 Control, select RS232/422/485

3 RS232 DB9 COM3 Not applicable

4 RS232 DB9 COM4 Not applicable

5 Serial over LAN - COM5 Not applicable

NOTE: When some of the expansion modules are in use, the physical COM ports (COM3 and COM4) mentioned in the table

are not accessible to the user.

TPM support

Windows 10 IoT Enterprise LTSC 2019 supports TPM 2.0. For more information on TPM resources, see https:// docs.microsoft.com/windows/security/information-protection/tpm/trusted-platform-module-overview.

RHProxy driver - I2C and GPIO

The RHProxy driver enables user mode access to I2C and GPIO (GPIO from the Intel chipset). For details about Windows RHProxy, refer to Enable user mode access to GPIO, I2C, and SPI. The BIOS of the EGW-5200 is already updated with the necessary changes for enabling RHProxy for the I2C and GPIO pins.

The following table shows the I2C and GPIO-friendly names and pin mappings.

Table 3. I2C and GPIO names and pin mappings

S No. Peripheral detail Hardware signal name Name/Number to use with RHProxy

Comments

1 GPIO Pin 0 DI0 0 GPIO number to use for RHProxy: 0

2 GPIO Pin 1 DI1 1 -

3 GPIO Pin 2 DI2 2 -

4 GPIO Pin 3 DI3 3 -

5 GPIO Pin 4 DI4 4 -

6 GPIO Pin 5 DI5 5 -

7 GPIO Pin 6 DI6 6 -

8 GPIO Pin 7 DI7 7 -

9 GPIO Pin 8 I2C0_GPIO 8 I2C0 (CN43) interrupt pin

10 GPIO Pin 9 I2C1_GPIO 9 I2C1 (CN36) interrupt pin

11 GPIO Pin 10 DO0 10 -

12 GPIO Pin 11 DO1 11 -

13 GPIO Pin 12 DO2 12 -

14 GPIO Pin 13 DO3 13 -

15 GPIO Pin 14 DO4 14 -

16 GPIO Pin 15 DO5 15 -

17 GPIO Pin 16 DO6 16 -

Setting Up the Windows 10 Operating System 11

Table 3. I2C and GPIO names and pin mappings (continued)

S No. Peripheral detail Hardware signal name Name/Number to use with RHProxy

Comments

18 GPIO Pin 17 DO7 17 -

19 GPIO Pin 18 User LED 1 18 -

20 GPIO Pin 19 User LED 2 19 -

21 GPIO Pin 20 User LED 3 20 -

22 I2C Bus 0 PCH_I2C0_SDA PCH_I2C0_SCL

I2C0 Connector: CN43.

23 I2C Bus 1 PCH_I2C1_SDA PCH_I2C1_SCL

I2C1 Connector: CN36.

System shutdown and restart

Steps

1. Click the Start icon.

2. Click Power, then select Restart or Shut down.

Configure LAN network

Steps

1. Connect an Ethernet cable to the Ethernet port.

The following prompt is displayed:

Figure 6. Prompt for discoverable in network

2. Select Yes.

Mini PCI express expansion modules

The EGW-5200 supports mini PCI express expansion modules. The required Windows software package is already installed in the Windows image for the following modules. Refer to the website of the manufacturer for more details.

12 Setting Up the Windows 10 Operating System

Table 4. mPCIe expansion modules

S No. Interface details Reference link

1 EMUC-B202 (Isolated Canbus) https://www.innodisk.com/en/products/embedded-peripheral/ communication/emuc-b202

2 EMPL-G2P1 (Isolated GbE with PoE out)

https://www.innodisk.com/en/products/embedded-peripheral/ communication/empl-g2p1

3 EMP2-X4S2 (Isolated RS-422 and RS-485)

https://www.innodisk.com/en/products/embedded-peripheral/ communication/emp2-x4s2

4 EMP2-X2S1 (Isolated RS-232) https://www.innodisk.com/en/products/embedded-peripheral/ communication/emp2-x2s1

5 EMPL-G202 (Isolated GbE LAN) https://www.innodisk.com/en/products/embedded-peripheral/ communication/empl-g202

6 Intel WiFi AX210 https://ark.intel.com/content/www/us/en/ark/products/204836/intel-wi- fi-6e-ax210-gig.html

7 Sierra EM7565 (4G) https://www.sierrawireless.com/iot-solutions/products/em7565/

8 Thales MV31-W (5G) https://www.thalesgroup.com/en/markets/digital-identity-and-security/ iot/iot-connectivity/products/iot-products/mv31-w-ultra-high

Configure WWAN network

Prerequisites

Follow the procedures in the service manual to install and configure the WWAN module and the corresponding carrier USIM card for the system.

About this task

After the WWAN module and the SIM cards are installed, perform the following steps.

Steps

1. Click the Start icon.

2. Type Settings and click the Settings app.

3. Select Network & Internet.

4. Locate the WWAN connection in the WiFi section and select the entry to connect and disconnect from the WWAN adapter.

Configure Bluetooth

Steps

1. Click the Start icon.

2. Type Settings and click Settings.

3. Select Devices from the Settings menu, then select Bluetooth from the menu on the left panel.

Accessing and updating the BIOS Basic Input/Output System (BIOS) is a program that provides a basic level of communication between the processor and peripherals. In addition, the BIOS also contains codes for various advanced features applied to the EGW-5200. The BIOS setup program includes menus for configuring settings and enabling features of the EGW-5200. Most users do not need to use the BIOS setup program, as the EGW-5200 ships with default settings that work well for most configurations.

Setting Up the Windows 10 Operating System 13

Access the BIOS settings

Steps

1. Enter the BIOS setup by pressing the Delete key on the keyboard when the system is powered on. The POST (Power On Self Test) message is displayed.

NOTE: The EGW-5200 controller supports a one-time boot menu allowing the selection of the boot device.

2. Enter the Boot Menu by selecting F7 at POST.

Update the BIOS using UEFI capsule update from Windows

About this task

The EGW-5200 supports UEFI capsule updates and can be updated natively within the Windows OS.

NOTE: Windows allows updating of the BIOS only if it is a newer version of the BIOS than what is already on the system.

The BIOS version number is available from the BIOS Main tab.

Figure 7. BIOS version number under Main tab

Steps

1. Download the newer version of the BIOS in .exe format from the Dell Technologies Support Site and run the executable from an elevated command prompt with administrator privileges. Windows prompts to restart the system for a firmware change.

Figure 8. Restart computer

2. Click Restart Now to restart the system. The system will start the BIOS firmware update process.

14 Setting Up the Windows 10 Operating System

Figure 9. System update progress bar

Results

After the update is complete, the BIOS screen will show the newer version details.

Figure 10. Updated BIOS

SuperIO Function Library This section describes use of the SuperIO (SIO) function library for the EGW-5200. The SIO function library includes the watchdog timer function and the hardware monitor function. The watchdog timer is a hardware mechanism provided to reset the system if the operating system or an application stalls. After starting, the watchdog timer in the application must be periodically reset before the timer expires. Once the watchdog timer expires, a hardware-generated signal is sent to reset the system. The hardware monitor is a mechanism provided to collect the wide range of information related to hardware health, including CPU temperature, board temperature, and various voltage values.

Windows SIO API

The SIO API library files and a demo program (including source code) are part of the board support package for the EGW-5200 (BSP/Sample_App_Source/SuperIO) and can be downloaded from the Dell Technologies Support Site.

SIO_WDT_Set

Sets the timeout value of the watchdog timer. SIO_WDT_Stop should be called before the expiration of watchdog timer, or the system will reset.

I32 SIO_WDT_Set (unsigned char val, int mode)

Parameters valSpecifies the value for the watchdog timer. A valid value is 1 - 255.

Setting Up the Windows 10 Operating System 15

modeSpecifies the mode of the timeout value. The valid mode of the timeout value is seconds (0) or minutes (1).

Return codes 0 if timeout value of watchdog timer is successfully set.

Negative errno if timeout value of watchdog timer is failed to set.

SIO_WDT_GetCurrentTime

Gets the current timeout value of the watchdog timer, gives remaining watchdog timer timeout value and mode.

I32 SIO_WDT_GetCurrentTime (unsigned char* pTime, int* mode)

Parameters pTImePointer variable to return the remaining watchdog time for expiry.

ModePointer variable to return the current watchdog mode.

Return codes 0 if timeout value of watchdog timer is available.

Negative errno if failed to get the current timeout value and mode of the watchdog timer.

SIO_WDT_Stop

Stops the watchdog timer.

I32 SIO_WDT_Stop ()

Parameters None

Return codes 0 if watchdog timer is successfully stopped.

Negative errno if watchdog timer fails to stop.

SIO_HWMon

Gets the hardware monitor values.

I32 SIO_HWMon (hwmon *hwmon_data)

Parameters hwmon_dataPointer to the hwmon_data structure for updating the various hardware monitor values (voltages and temperatures).

Return codes 0 if data from hardware monitor is read successfully.

Negative errno if failed to get the data from hardware monitor.

Error codes

For the various functions previously listed, the following is the Errno values in case of failure.

enum SIO_ERRORS_LIST{ ERROR_SIO_INVALID_DEVICE_HANDLE = -100, ERROR_SIO_IOCTL, ERROR_SIO_INVALID_RW_SEL, ERROR_SIO_INVALID_MODE_SEL,

16 Setting Up the Windows 10 Operating System

ERROR_SIO_WDT_NOT_ENABLED };

Build the SIO sample application

Prerequisites

Visual Studio 2019 is required for this task. Do download and install, perform the following steps:

1. Select Workloads. 2. Open Visual Studio Installer and click Modify to customize your installation. 3. Select Desktop development with C++ workload. 4. Select UWP. 5. Select Individual components, and under Complier, build tools, and runtimes, make sure that the following boxes are

checked: a. MSVC v142 -VS 2019 C++ x64/x86 buildtools (latest) is checked. b. MSVC v142 -VS 2019 C++ x64/x86 Spectre-mitigated libs (latest) is checked.

6. Make sure the SDK is installed. Download and install the corresponding WDK version.

About this task

NOTE: The sample executable binaries are built with SDK-10.0.19041.685 and WDK-10.0.19041.685 versions. The procedure

may vary slightly if using other versions.

To build the sample application, perform the following steps.

Steps

1. Open Sample_App_Source/SuperIO/superior_nct.sln in Visual Studio.

2. Change Solution configuration to Release and Solution platform to x64.

3. Under the Build menu, select Build Solution.

Execute the SIO sample application

About this task

The EGW-5200 Windows image includes pre-installed sample application binaries.

Steps

1. Open the command prompt in administrator mode.

2. Change to the following directory: C:\Program Files\Dell\EGW5200 Software tools\Application Binaries

3. Use the following commands to execute the SIO sample application:

a. To set the watchdog timer:

> superiotest wdtset

Where time is between 1 to 255, and mode is seconds or minutes.

b. To stop the watchdog timer:

> superiotest wdtstop

c. To get the remaining watchdog time and mode:

> superiotest wdtgettime

Setting Up the Windows 10 Operating System 17

d. To get hardware monitor:

> superiotest hwmon

Digital Input/Output Function of the Intel PCH Controller The EGW-5200 uses Microsofts RHProxy interface for accessing the GPIO pins from PCH chipset. All the necessary changes are done in the BIOS. For a sample program, the below Microsoft supplied source code can be used.

https://github.com/microsoft/Windows-iotcore-samples/tree/develop/BusTools/GpioTestTool

The EGW-5200 has eight DI pins, eight DO pins, and three user LEDs. For the pin details and pin numbers to be used for the sample application, refer the table in RHProxy driver - I2C and GPIO on page 11.

Build the GPIO sample application

Prerequisites

Visual Studio 2019 is required for this task. Do download and install, perform the following steps:

1. Select Workloads. 2. Open Visual Studio Installer and click Modify to customize your installation. 3. Select Desktop development with C++ workload. 4. Select UWP. 5. Select Individual components, and under Complier, build tools, and runtimes, make sure that the following boxes are

checked: a. MSVC v142 -VS 2019 C++ x64/x86 buildtools (latest) is checked. b. MSVC v142 -VS 2019 C++ x64/x86 Spectre-mitigated libs (latest) is checked.

6. Make sure the SDK is installed. Download and install the corresponding WDK version.

About this task

NOTE: The sample executable binaries are built with SDK-10.0.19041.685 and WDK-10.0.19041.685 versions. The procedure

may vary slightly if using other versions.

To build the sample application, perform the following steps.

Steps

1. Open Sample_App_Source/GPIOTestTool/windows-iot-bus-tools.sln in Visual Studio.

2. Change Solution configuration to Release and Solution platform to x64.

3. Under the Build menu, select Build Solution.

Execute the GPIO sample application

About this task

The EGW-5200 Windows image includes pre-installed sample application binaries.

Steps

1. Open the command prompt in administrator mode.

2. Change to the following directory: C:\Program Files\Dell\EGW5200 Software tools\Application Binaries

3. Use the following commands to execute the GPIO sample application:

18 Setting Up the Windows 10 Operating System

a. To open the pin connection:

> GpioTestTool.exe

b. To set the drive mode to output:

> setdrivemode output

c. To set the DO0 pin to low:

> write 0

d. To set the DO0 pin to high:

> write 1

Similarly, the pin can be opened and set to drive mode input and the current value can be read using a read command. Use the help command for detailed usage.

Digital Input/Output Function from PCA9535 GPIO Users can opt to connect a PCA9535 GPIO expander module to one of the I2C buses of the EGW-5200.

PCA9535 GPIO Expander API

The PCA9535 GPIO modules API library files and a demo program (including source code) are included in the board support package for the EGW-5200.

PCA9535Init

This funcrtion is used to initialize the directions of the GPIO pins. Also, it opens the handle to the I2C bus and it is necessary to call this function before executing any of the other APIs.

int PCA9535Init (unsigned int i2cnumber)

Parameters i2cnumberThe I2C bus number to which the PCA9535 board is connected. Can be 0 or 1.

Return codes 0 if the initialization is successful.

Negative errno if failed.

DioSetLevel

Sets the GPIO level for output pins.

int DioSetLevel (unsigned char data, unsigned char mask)

Parameters dataThe new GPIO level to be set for the output pins.

maskGPIO output pins are changed only for those corresponding to the bits that are set to 1 in the mask. Other pin values remain unchanged.

Return codes 0 if the initialization is successful.

Negative errno if failed.

Setting Up the Windows 10 Operating System 19

DioGetLevel

Gets the current GPIO level for both input and output pins.

int DioGetLevel (unsigned int mask, unsigned int* GetPinLevel)

Parameters maskThe GPIO input pins are updated in the GetPinLevel only for the bits which are set to 1 in the mask.

GetPinLevelPointer to store the read value. The first eight bits (Bit 0 to 7) contain the GPIO input pins voltage level. The second eight bits (Bit 8 to 15) contain the GPIO output pins voltage level.

Return codes 0 if the initialization is successful.

Negative errno if failed.

Error codes

For the various functions previously listed, the following is the Errno values in case of failure.

enum errorcodes { Error_Pointer_Invalid = -100, Error_I2C_controller_NotFound, Error_I2C_Open_Failed, Error_I2C_Bus_Invalid, Error_Mutex_Failed, Error_I2CTransfer_Partial, Error_I2CTransfer_SlaveAddressNotAcknowledged, Error_I2CTransfer_ClockStretchTimeout, Error_I2CTransfer_UnknownError };

Build the PCA9535 sample application

Prerequisites

Visual Studio 2019 is required for this task. Do download and install, perform the following steps:

1. Select Workloads. 2. Open Visual Studio Installer and click Modify to customize your installation. 3. Select Desktop development with C++ workload. 4. Select UWP. 5. Select Individual components, and under Complier, build tools, and runtimes, make sure that the following boxes are

checked: a. MSVC v142 -VS 2019 C++ x64/x86 buildtools (latest) is checked. b. MSVC v142 -VS 2019 C++ x64/x86 Spectre-mitigated libs (latest) is checked.

6. Make sure the SDK is installed. Download and install the corresponding WDK version.

About this task

NOTE: The sample executable binaries are built with SDK-10.0.19041.685 and WDK-10.0.19041.685 versions. The procedure

may vary slightly if using other versions.

To build the sample application, perform the following steps.

Steps

1. Open Sample_App_Source/PCA9535/PCA9535_I2C.sln in Visual Studio.

2. Change Solution configuration to Release and Solution platform to x64.

3. Under the Build menu, select Build Solution.

20 Setting Up the Windows 10 Operating System

Execute the PCA9535 sample application

About this task

The EGW-5200 Windows image includes pre-installed sample application binaries.

Steps

1. Open the command prompt in administrator mode.

2. Change to the following directory: C:\Program Files\Dell\EGW5200 Software tools\Application Binaries

3. Use the following commands to execute the PCA9535 sample application:

a. Use the following command to execute the pca9535_interrupt.exe with two arguments ( and ):

> pca9535_interrupt.exe 0 8

b. Execute the pca9535App.exe for write functionality:

Pca9535App.exe i2c write

> pca9535App.exe i2c 0 write 0xff 0xff

c. Execute the pca9535App.exe for read functionality:

pca9535App.exe i2c read

> Pca9535App.exe i2c 0 read 0xff

Intel Active Management Technology The Intel Active Management Technology (AMT) provides persistent out-of-band connectivity that operates independent of the OS. Remote platform management applications can access Intel AMT securely, even when the platform is turned off. The only requirement is that the computer must be connected to a power supply and a network.

Figure 11. AMT block diagram

Hardware requirements

Table 5. Intel Active Management Technology hardware requirements

Device Specification

Windows OS (Host machine) Windows 10 OS. Installed with display monitor, keyboard, and mouse.

EGW-5200 (Target board) Windows 10 OS with AMT-capable system. Installed with display monitor, keyboard, and mouse.

Other hardware A router with Ethernet LAN cable (wired).

Setting Up the Windows 10 Operating System 21

Host setup

The host machine should have Microsoft Windows 10 OS installed, but it does not have to be an Intel AMT-capable system.

Install the Intel Manageability Commander (Intel MC) tool to connect to activated Intel AMT devices and perform functions such as power control, remote desktop, and more.

The following sections detail how to configure and activate Intel AMT on the EGW-5200 that has Windows 10 installed on it.

Activate Intel AMT

Prerequisites

To identify the systems with Intel Active Management Technology, run the Device Manager on the system and under ports look for an Intel AMT port.

Figure 12. Intel AMT under Ports

Make sure that Intel AMT-capable system is not already activated. To determine this, you need to run the Intel Management Security and Status (IMSS) on the system. If it is not present, download the full package of drivers from the Dell Technologies Support Site.

After downloading run the IMSS (Intel Management Security and Status) program, click the Advanced tab and verify that the Intel Management Engine status shows up as Unconfigured.

Figure 13. Intel AMT unconfigured

About this task

To activate Intel AMT on the target system, perform the following steps.

22 Setting Up the Windows 10 Operating System

Steps

1. Boot to BIOS setup and navigate to Advanced > AMT configuration. Verify that the AMT BIOS feature is enabled, save the settings, and then exit the BIOS setup.

Figure 14. AMT Configuration in BIOS

2. Initiate a reboot of the system, and while the system is booting up, press the Ctrl and P keys. Doing so will bring you to the Management Engine BIOS Extension (MEBx) login screen.

Figure 15. MEBx login screen

3. Select the MEBx login. If this is the first time MEBx is entered, the default password is admin. You will be prompted to change the default password (required to proceed). The new password must be at least eight characters long, contain at least one upper-case character, one lower-case letter, one number, and one special character. In addition, it cannot contain any unicode characters.

NOTE: A management console application can change the Intel AMT password without modifying the Intel CSME

password.

4. Select Verify Intel AMT Configuration > Manageability Feature Selection, then select Enabled.

5. Select User Consent. By default, this is set for KVM only; can be changed to none or all.

6. Select Activate Network Access and enter Y to confirm activation of the interface.

Setting Up the Windows 10 Operating System 23

Figure 16. Activate network access

7. Exit the MEBx configuration menu and allow your system to boot up to the OS.

Check your configuration

About this task

After booting up to the OS, run the IMSS (Intel Management Security and Status) program by performing the following steps.

Steps

1. Click the General tab and verify that the Intel Active Management Technology (Intel AMT) is Enabled.

24 Setting Up the Windows 10 Operating System

Figure 17. Intel AMT enabled

2. Click the Advanced tab and verify that the Intel Management Engine status is Configured.

Setting Up the Windows 10 Operating System 25

Figure 18. Intel Management Engine configured

Install the Intel Manageability Commander tool

About this task

The Intel Manageability Commander (Intel MC) tool is a remote management tool that can be used to connect with the features of Intel Active Management Technology (Intel AMT). Through this software, users can connect to activated Intel AMT devices and perform functions such as power control, remote desktop, and more.

Perform the following steps to install Intel MC on a host machine.

Steps

1. Download the latest Intel MC installer package from the Download Center at https://downloadcenter.intel.com.

26 Setting Up the Windows 10 Operating System

Figure 19. Intel MC installer package

2. Double-click the download file to open it, then double-click the installer, IMCInstaller .msi , to launch the Intel MC installer.

3. Click Install to install Intel MC and follow the installer prompts, then click Finish to complete the Intel MC installation.

4. Once the Intel MC installation completes, you must install the required electron sub-component as described below. The Intel MC desktop icon and start menu shortcut will not work until electron is installed.

NOTE: Intel MC is tested and verified only with version 8.5.5 of electron (for Win32 and IA32). Use this version for both

32-bit and 64-bit platforms. Other versions of electron are not tested or supported.

To install electron (required):

a. In a web browser, go to https://github.com/electron/electron/releases/tag/v8.5.5 . b. Scroll down and select electron-v8.5.5-win32-ia32.zip. The file is downloaded to your system. c. Open the zip file and copy all files and subfolders to your Intel MC installation folder (by default this is c:/Program Files

(x86)/Intel/Intel Manageability Commander). d. Once the installations of Intel MC and electron are complete, use the Intel MC desktop icon or start menu shortcut to

launch Intel MC.

Manage an Intel AMT-activated system using MC

About this task

As the Intel Active Management Technology (AMT) is activated, you can now manage the AMT system through the Intel Manageability Commander (MC) tool. Perform the following steps using the host machine.

Steps

1. Launch the Intel Manageability commander tool using the Intel MC desktop icon or start menu shortcut.

2. Go to File and then select Add Computer.

3. Enter the hostname as the IP Address of the AMT-activated system. Enter the alias name you wish to manage (any name). Uncheck the use TLS. Then click OK.

Setting Up the Windows 10 Operating System 27

Figure 20. Add Computer

4. Click Connect and log in with username admin and the password is the MEBX login password used.

Figure 21. MC login

After connecting, the screen will show the status of the system. The left-hand menu also lists the other tasks that can be accomplished using MC.

28 Setting Up the Windows 10 Operating System

Figure 22. MC task menu

5. Under System Status > Active Features, click the blue line and check all boxes (Redirection Port, Serial-over-LAN, IDE-Redirection, and KVM Remote Desktop). Then Click OK.

Figure 23. MC Active Features

6. Under System Status > Remote Desktop, click the blue line, and set the session timeout value to 0 minutes (no timeout). Click OK.

Figure 24. Remote Desktop settings

Setting Up the Windows 10 Operating System 29

7. In the left-hand side of the menu, click on Remote Desktop and click the Power Action drop-down. Here you can run the power control commands (Power up, Power down, Reset, Sleep, Force Reset, Power up to BIOS, Reset to BIOS, and so on).

Figure 25. Power settings

8. You can also view the remote desktop screen by clicking Connect to Remote Desktop. This feature utilizes the hardware keyboard, video, and mouse capability of Intel AMT to provide out-of-band remote control of the device.

Figure 26. Out-of-band remote desktop

30 Setting Up the Windows 10 Operating System

9. The Serial Over LAN (SOL) allows the serial character stream of the serial port to be redirected over a LAN connection. It enables the console redirection for BIOS and EFI, as well as the operating system (text-based) on remotely managed systems. You can do two things through Serial Over LAN (SOL):

a. Run PUTTY on a specified COM port at 115200 bauds in the target machine (Intel AMT-capable system), and you can see that everything you type in Intel MC through SOL will be displayed in PUTTY.

b. Connect SOL in Intel MC and cause a Reboot to BIOS. In this case, the BIOS sends VT100 codes. You can see BIOS menu screen.

Figure 27. Serial Over LAN

10. Click on Alarm Clocks. Set the alarm clock on the target system for waking up the system at a specific time or time intervals.

Figure 28. Alarm Clock

11. Click Network Settings from the menu to see the details of network status, IP address, MAC address, net masking, and so on.

Setting Up the Windows 10 Operating System 31

Figure 29. Network Settings

12. Click Event Log to view all Intel AMT events of the system that you have connected to the host.

Figure 30. Event Log

13. Click Audit Log to review changes that other users have made to the Intel AMT.

Figure 31. Audit Log

32 Setting Up the Windows 10 Operating System

14. Click Hardware Information to view the Platform, Baseboard, and BIOS information.

Figure 32. Hardware Information

Access Intel AMT using Mesh Commander

Prerequisites

Download the latest version of Mesh Commander tool from the website.

About this task

To access the activated Intel AMT, there is alternate tool called Mesh Commander, an open source web-based remote management tool that supports many OOB features, including remote desktop, Serial-over-Lan (SoL), and more. It runs on all common platforms.

Steps

1. Launch the Mesh Commander tool.

2. Select Add Computer and enter the information of the activated Intel AMT system. Provide a Friendly Name for the computer. Hostname is your configured Intel AMT system's IP address, Username is admin, and Password is the MEBx login password.

Figure 33. Add Computer

3. After creating, click Connect. The system status displays. The left-hand menu also lists the other tasks that can be accomplished using Mesh Commander.

Setting Up the Windows 10 Operating System 33

Figure 34. Mesh Commander System Status

4. Under System Status > Active Features, click the blue line and check all boxes (Redirection Port, Serial-over-LAN, IDE-Redirection, KVM Remote desktop). Click OK.

5. Under System Status > Remote Desktop, click the blue line and set the session timeout value to 0 minutes (no timeout). Click OK.

6. On the System Status screen, click the Power Action drop-down to control the power commands.

Figure 35. Power Actions

7. In the left-hand side of the menu, click Remote Desktop and click Connect to connect to a remote desktop.

34 Setting Up the Windows 10 Operating System

Figure 36. Remote Desktop

8. In the left-hand side of the menu, click Serial-over-LAN (SoL). This feature allows the serial character stream of the serial port to be redirected over a LAN connection. It enables the console redirection for BIOS and EFI, as well as the operating system (text-based) on remotely managed systems.

Figure 37. Serial-over-LAN

9. In the left-hand side of the menu, click Event Log, which shows all Intel AMT events of the system that is connected to the host.

Setting Up the Windows 10 Operating System 35

Figure 38. Event Log

10. In the left-hand side of the menu, click Audit Log to review the changes that other users have made to the Intel AMT.

Figure 39. Audit Log

11. In the left-hand side of the menu, click Wake Alarms to set the alarm clock on the target system for waking up the system at a specific time or time intervals.

36 Setting Up the Windows 10 Operating System

Figure 40. Wake Alarms

12. In the left-hand side of the menu, click Network Settings to see the details of network status, IP address, MAC address, Net masking, and so on.

Figure 41. Network Settings

13. In the left-hand side of the menu, click Hardware Information to see the Platform, Baseboard, BIOS information, and more.

Setting Up the Windows 10 Operating System 37

Figure 42. Hardware Information

KVM on storage redirection

About this task

A remote console can open a session with an Intel AMT platform and control the platform, using a mouse and keyboard, and display at the console what is displayed on the local monitor. The following steps detail how to use the remote desktop session and mount an ISO file in the host machine on the target system.

Steps

1. After configuring Intel AMT on the target system, use the Mesh Commander tool to connect to the remote desktop session.

2. Click the IDE-R to view a panel to mount an ISO image file in the host machine to mount onto the target system.

NOTE: This ISO file can be any ISO file. An Ubuntu 20.04 ISO file is used as an example. We can select an ISO file

available in any USB storage or local file system.

Figure 43. Storage Redirection

38 Setting Up the Windows 10 Operating System

3. After starting the redirection of the .ISO image file, a media redirection session is opened in the target system.

Figure 44. Media redirection session opened

4. Open file explorer in the target system to view the ISO image mounted on the drive.

Figure 45. File Explorer view

5. Click Stop IDE-R Session to unmount the ISO image from the remote session.

Setting Up the Windows 10 Operating System 39

Figure 46. Unmount ISO image

COM Port and Ethernet Names for Mini PCIe Cards Table 6. Mini PCIe card details

S.No mPCie module Isolated COM A (port type)

Isolated COM B (port type)

Remarks

1 EMP2-X4S2 RS422/RS485 RS422/RS485 Total of four COM ports are detected in the Device Manager. However, only two COM ports can be accessed. Assume that the first COM port of EMP2- X4S2 is COM X, as seen in the device manager, then, based on the cable tag:

RS-422 A - COM X

RS-422 B - COM X+1

RS-485 A - COM X+2

RS-485 B - COM X+3

2 EMP2-X2S1 RS232 RS232 Total of two COM ports are detected in the Device Manager. Assume that the first COM port of EMP2-X2S1 is COM X, then, based on the cable tag:

Isolated COM A - COM X

Isolated COM B - COM X+1

For EMP2-X2S1:

Both EMP2-X2S1 and EMP2-X4S2 use the same VID and DID. By default, the EMP2-X2S1 module uses the driver files of the EMP2-X4S2 module, and so the device manager shows four COM ports. To overcome this issue, manually install the EMP2-X2S1 Windows 10 64-bit driver package.

40 Setting Up the Windows 10 Operating System

For EMPL-G2P1 and EMPL-G202:

Get the Ethernet name from Control Panel > Network and Internet > Network Connections, based on the MAC address of the Ethernet ports.

Setting Up the Windows 10 Operating System 41

Setting Up the Ubuntu Operating System This chapter serves as a guide to install and use the Ubuntu 20.04 LTS operating system on the EGW-5200 hardware.

For more information on the Ubuntu 20.04 LTS operating system, see https://releases.ubuntu.com/20.04/.

Topics:

Boot up and log in Create bootable USB stick for factory reset Update BIOS capsule Ubuntu 20.04 LTS basic functions Isolated Canbus uFM expansion module EMP2-X2S1 card with isolated RS-232 uFM expansion module EMP2-X4S2 card with isolated RS-422/485 uFM expansion module

Boot up and log in

Steps

1. Connect a keyboard, mouse, and monitor to the EGW-5200.

2. Power on the system. The system boots to the Ubuntu 20.04 LTS operating system.

3. Log in to the sysem. At initial login, the user must change the password of the default account.

NOTE: The default username/password is ubuntu/ubuntu.

Create bootable USB stick for factory reset

About this task

Perform this task for recovery of the system.

Steps

1. Install the image. Download the Ubuntu desktop image 21.10 or a newer version from the Canonical website:

https://ubuntu.com/download/desktop

2. To create a bootable USB stick on Ubuntu, perform the steps in the following tutorial:

https://ubuntu.com/tutorials/create-a-usb-stick-on-ubuntu#1-overview

To create a bootable USB stick on Windows, perform the steps in the following tutorial:

https://ubuntu.com/tutorials/create-a-usb-stick-on-windows#1-overview

Update BIOS capsule

Steps

1. Save the capsule file EGW5200-firmware.cab to the USB root disk.

2. Boot to Ubuntu and open the terminal. Enter the following command and press y to restart the system.

3

42 Setting Up the Ubuntu Operating System

To update with the same version:

$ fwupdmgr install EGW5200-firmware.cab --allow-reinstall

To update to a newer version:

$ fwupdmgr install EGW5200-firmware.cab

3. The system starts to install the firmware update, as shown in the following figure:

Figure 47. Firmware update

4. Wait for the update to finish, and then the system BIOS updates to the version specified.

Ubuntu 20.04 LTS basic functions

System shutdown and restart

Steps

1. Shutdown command:

$ sudo shutdown -h now

2. Reboot command:

$ sudo shutdown -r now

Ubuntu OTA update

About this task

OTA update command:

$ sudo apt update $ sudo apt upgrade

Setting Up the Ubuntu Operating System 43

List installed packages

About this task

List installed packages command:

$ apt list --installed

Update the system name

About this task

Update system name command:

$ sudo nmcli general hostname

Change the time zone

About this task

Reference the time and date help information with the following command:

$ sudo timedatectl --help

Root user credential

About this task

Root user credential command:

$ sudo su -

Create new user

About this task

Add user command:

$ sudo adduser

Select language

Steps

1. Use the following command to select your preferred language, then select .

$ sudo dpkg-reconfigure locales

44 Setting Up the Ubuntu Operating System

Figure 48. Configuring locales

2. Select your target language and select again.

Figure 49. Default locale for system environment

3. Log out and log in, then use the $ locale command to confirm your language settings.

Figure 50. Confirm locale

Setting Up the Ubuntu Operating System 45

Display

About this task

Acquire screen output from the D-SUB/DVI/DP ports.

USB

About this task

The Ubuntu OS detects USB devices from the six USB ports on the front I/O panel.

Use the dmesg | grep usb command to check USB devices status.

Configure Ethernet

Steps

1. The Ethernet cards function in DHCP client mode by default. Use the $ip addr command to confirm.

NOTE: The Ethernet card names for port1, port2, and port3 are eno1, enp3s0, and enp4s0, respectively.

2. To set up a static IP address, use the following commands:

a. nmcli con down b. nmcli con mod ipv4.addresses /24 c. nmcli con mod ipv4.gateway d. nmcli con mod ipv4.dns e. nmcli con mod ipv4.method manual f. nmcli con up

3. To roll back to dynamic IP by DHCP, use the following commands:

a. nmcli con down b. nmcli con mod ipv4.method auto c. nmcli con up

Configure WiFi network

About this task

Use the following commands to connect an AP using a WiFi interface (wlp6s0).

Steps

1. Scan APs:

$ nmcli dev wifi list

2. Create a connection to the target SSID. If the AP requires a password, add a password parameter:

$ sudo nmcli dev wifi connect $ sudo nmcli dev wifi connect password " "

3. To disconnect from the target SSID:

$ sudo nmcli con down

46 Setting Up the Ubuntu Operating System

Configure Bluetooth

About this task

Use the following commands to power on Bluetooth and scan target devices.

Steps

1. Enter bluetoothctl mode:

$ bluetoothctl

2. Power on Bluetooth:

$ power on

3. Scan Bluetooth devices:

$ scan on

Figure 51. Scan Bluetooth devices

4. Trust target device by MAC address:

$ trust

5. Pair with target device by MAC address:

$ pair

6. Connect target device by MAC address:

$ connect

7. Disconnect target device by MAC address:

$ disconnect

8. Unpair with target device by MAC address:

$ remove

Connect 4G or 5G WWAN

Steps

1. Insert your USIM card into the SIM 2 slot. Use the following commands to check the modem status:

$ mmcli -L

Setting Up the Ubuntu Operating System 47

Figure 52. Check modem status

In this example, the modem number is 0.

$ mmcli -m 0

Figure 53. Modem 0 status

2. If your USIM card requires a PIN code, the Status is locked. Use the following command to enter your PIN code, change the state to registered, and allow the USIM card to access a cell site.

$ sudo mmcli -i --pin=

3. Use the following nmcli command to register an auto connection for the target modem and the USIM card:

$ sudo nmcli c add type gsm ifname con-name apn

Use the following settings: The IF NAME is the primary port of the mmcli modem log. The CONNECTION NAME is assigned by the user. The APN NAME must be provided by your USIM card ISP owner.

If the Telecom provider is emome:

$ sudo nmcli c add type gsm ifname cdc-wdm0 con-name cdc-wdm0 apn emome

4. Use the following command to remove auto connection by CONNECTION NAME:

$ sudo nmcli c delete

5. Use the following commands to enable and disable the WWAN service of nmcli:

Enable:

$ nmcli r wwan0 on

Disable:

$ nmcli r wwan0 off

Next steps

If your USIM card is not detected by the 5G modem module, it may be misaligned with the eSIM slot. Perform the following steps to switch to the physical slot (SIM 2).

1. Use the following commands:

$ sudp apt install minicom $ sudo minicom -D /dev/ttyUSB0

48 Setting Up the Ubuntu Operating System

2. Use the following AT command to switch the SIM slot:

AT^SWITCH_SLOT=0

NOTE: Value 0: physical USIM slot (SIM 2); Value 1: eSIM slot.

Access GPS

Steps

1. Access the modem console (ttyUSB0) using minicom:

$ sudp apt install minicom $ sudo minicom -D /dev/ttyUSB0

2. Enter the following AT commands to enable the GPS function:

AT+GPS?

Return result of 1 indicates that the modem module supports the GPS function.

AT+GPS=1

If modem feedback is GPS is enabled, module reboot, reboot device one and use the $ sudo minicom -D /dev/ ttyUSB0 command a second time.

3. To access TTFF and CN GPS data, use the following AT commands:

AT^GPS_START=0 AT+GPS_INFO

Remote login

About this task

The SSH server runs by default on port 22. Use your PC/NB to open a SSH connection (using terminal tools such as PuTTY or MobaXterm) to the EGW-5200. The PC/NB and EGW-5200 share a network connection under a local network.

Set up audio and microphone

Steps

1. Install ALSA utilities:

$ sudo apt install alsa-utils

2. Adjust audio and microphone volume by alsamixer:

$ alsamixer

3. Prepare an audio .wav file and connect to the speaker on the device:

$ aplay xxx.wav

Setting Up the Ubuntu Operating System 49

4. Connect to the microphone on the device and start to record audio after entering the following command. Use ctrl + c to stop the recording.

$ arecord xxx.wav

5. To replay the .wav file recording:

$ aplay xxx.wav

SSD security-erase

About this task

CAUTION: Performing this task will permanently swipe the disk content.

Steps

1. Check out your target disk to be mounted as /dev/sdx:

$ sudo lshw

Figure 54. $ sudo lshw

2. Confirm that the target disk is not frozen. To check:

$ sudo hdparm -I /dev/sdx

Figure 55. Example: target disk is frozen

If the target disk is frozen,

a. Use the following commands to enter the system into standby mode:

$ sudo su - $ echo -n mem > /sys/power/state

The power button LED blinks when the system is in standby mode. b. Press the power button once to wake up the system. c. Use the hdparm command a second time, and status is now not frozen, as shown in the following figure:

50 Setting Up the Ubuntu Operating System

Figure 56. Disk not frozen

3. Set up a security password before executing the security-erase:

$ sudo hdparm --user-master u --security-set-pass /dev/sdx

Figure 57. Set security password

4. Run the security-erase command with the password:

$ sudo hdparm --user-master u --security-erase /dev/sdx

Figure 58. Security erase

Results

When the security-erase is finished, all data on the /dev/sdx disk is swiped (0x00).

Connect to the serial port

Steps

1. Connect suitable DB9 cables to the device COM ports.

Map COM1 port to /dev/ttyS0. Map COM2 port to /dev/ttyS1. Map COM3 port to /dev/ttyS2. Map COM4 port to /dev/ttyS3.

2. Set the control mode as RS232/RS422/RS485 from the BIOS menu. Map the pins according to the following table:

Table 7. DB9 connector pin definitions

Pin Signal name

RS-232 RS-422 RS-485

1 DCD TXD422 485DATA

2 RXD TXD422+ 485DATA+

3 TXD RXD422+ N/S

4 DTR RXD422- N/S

5 GND N/S N/S

Setting Up the Ubuntu Operating System 51

Table 7. DB9 connector pin definitions (continued)

Pin Signal name

RS-232 RS-422 RS-485

6 DSR N/S N/S

7 RTS N/S N/S

8 CTS N/S N/S

9 RI N/S N/S

3. Execute the following command on two systems, where # is the port number corresponding to the port being used:

$ sudo chmod 777 /dev/ttyS#

4. To test COM port loopback, use the following commands.

a. Data receive command:

$ cat < /dev/ttyS#

b. Data transmit command:

$ echo "test" > /dev/ttyS#

NOTE: The port number (#) must be different between data receive and data transmit.

Mount USB storage

Steps

1. Plug your USB storage into the device and use the following command to identify the disk as /dev/sdxx:

$ sudo fdisk -l

Figure 59. Identify USB storage

2. Create a directory to be the mount point:

$ mkdir /tmp/storage

3. Mount storage on /tmp/storage:

$ sudo mount /dev/sdb1 /tmp/storage $ sudo umount /tmp/storage

52 Setting Up the Ubuntu Operating System

Figure 60. Mount USB storage

Configure watchdog

Steps

1. Install watchdog service:

$ sudo apt update $ sudo apt install watchdog

2. Edit /etc/default/watchdog:

$ sudo vim /etc/default/watchdog

Edit watchdog_module parameter as below:

#load module before starting watchdog watchdog_module="w83627hf_wdt"

3. Edit /etc/watchdog.conf:

$ sudo vim /etc/watchdog.conf

Ensure that the following parameters exist in the configuration and are not disabled as comment code.

retry-timeout = 60 repair-maximum = 1 watchdog-device = /dev/watchdog interval = 1 logtick = 1 log-dir = /var/log/watchdog realtime = yes priority = 1

Add a new parameter:

# To set the watchdog device timeout, default is 60 seconds watchdog-timeout = 20

4. Reboot the device once, then use the following commands to confirm that the driver and service are working:

$ dmesg | grep -i w83627hf_wdt

Figure 61. View watchdog

$ modinfo w83627hf_wdt

Setting Up the Ubuntu Operating System 53

Figure 62. Watchdog info

$ service watchdog status

Figure 63. Watchdog status

5. To test the watchdog device, force the Linux kernel to crash:

$ sudo sysctl -w kernel.sysrq=1 $ sudo su - $ echo c > /proc/sysrq-trigger

The system hangs and watchdog reboots the system after 20 seconds (if watchdog-timeout = 20).

GPIO

About this task

The EGW-5200 is equipped with eight Digital in and eight Digital out. To access the registers to read and write to them, perform the following steps.

Steps

1. Run the following command:

$ sudo su -

2. Export GPIO:

$ echo 343 > /sys/class/gpio/export

The 343 GPIO is USER_LED_1.

Figure 64. Export GPIO

54 Setting Up the Ubuntu Operating System

3. Check the GPIO direction and value using the following commands:

$ cat /sys/class/gpio/gpio343/direction $ cat /sys/class/gpio/gpio343/value

4. Set the GPIO value using the following command:

$ echo {0 or 1} > /sys/class/gpio/gpio343/value

Figure 65. Set GPIO value

Results

The low level triggers the USER_LEDs. When the value is 0, the USER_LED is illuminated, as shown in the following figure.

Figure 66. GPIO USER_LED illuminated

TPM tasks

About this task

If TPM is turned on, the device node (/dev/tpm0) exists.

Figure 67. TPM on

If TPM is turned off, the device node (/dev/tpm0) does not exist.

Setting Up the Ubuntu Operating System 55

Figure 68. TPM off

TPM can be enabled/disabled from the BIOS Advanced menu > TPM 2.0 Configuration > Security Device Support.

Clear TPM

About this task

If a tpm2_clear command fails, use the following command to make the BIOS reset TPM:

$ echo 5 | sudo tee /sys/class/tpm/tpm0/ppi/request $ reboot

Then try the tpm2_clear command again.

List PCR values

About this task

Use the following command:

$ sudo tpm2_pcrread

Results

The tpm2_pcrlist is renamed to tpm2_pcrread.

Get random data by TPM

About this task

Use the following command:

$ sudo tpm2_getrandom -o

For example:

$ sudo tpm2_getrandom -o random.out 20

Get hash by TPM

About this task

Use the following command:

sudo tpm2_hash -g -o

For example:

$ echo "Dell" > message $ sudo tpm2_hash -g sha1 -o hash.bin message

56 Setting Up the Ubuntu Operating System

Wake events

Trigger Ubuntu OS to enter S3 status

Steps

1. Use the following command:

$ sudo su

2. Use the following command:

$ echo mem > /sys/power/state

3. Use a USB keyboard to enter any key to wake up the Ubuntu OS.

NOTE: Use a physical keyboafd to wake up the system. If the keyboard is on a remote SSH session, the box does not

wake up.

Use RTC as wake event

Steps

1. Use the following command:

$ sudo rtcwake -u -s -m

2. The can use the mem parameter to enter S3, and the off parameter can enter S5.

Wake-on-LAN

Steps

1. Make Ubuntu OS of target device enter S3 or S5.

2. Using another Ubuntu OS device that is working under the same local network, use the following commands:

$ sudo apt install wakeonlan $ wakeonlan

For example:

$ wakeonlan 00:30:64:3a:ad:80

Results

The target device is waked up as a result of the WoL function.

Wake-on-WLAN

Steps

1. Use the following command to check the AX210 WiFi card WoWLAN status:

$ iw phy0 wowlan show

Setting Up the Ubuntu Operating System 57

2. If WoWLAN is disabled, use the following command to enable it:

$ sudo iw phy0 wowlan enable magic-packet

3. Use the ifconfig command to make sure your WiFi card (wlp6s0) is connected on a SSID to get an IP address. Record the IP and WiFi MAC address.

4. Use another WiFi client device that is connected to the same SSID and trigger WoL magic packet to wake up the target device. For example, use an Android smart phone to install the WoL tool (https://play.google.com/store/apps/details? id=de.ralischer.wakeonlan&hl=zh_TW&gl=US), then enter the IP and MAC address of the WiFi card of the target device. Trigger the WoL magic packet using the tool to wake up the target device.

Isolated Canbus uFM expansion module

Steps

1. Download the utility tool (EMUC-B202.zip) from the Innodisk official website: EMUC-B202 Driver

2. Unzip the file and copy the driver package onto your platform with the Ubuntu environment.

3. Unzip Linux/EMUC-B202_API_Linux_ .zip, using the following commands:

$ cd EMUC-B202-W1_CAN_API_V2.3.7_Linux/Loopback_EMUC2 $ sudo chmod +x emuc_64 $ sudo ./emuc_64

Figure 69. EMUC-B202 API

4. Edit the setup.ini file for different test cases, as detailed in the following table.

Table 8. Setup.ini settings

Parameter Settings

COM Port 0 = auto scan (Windows), 1 = auto scan (Linux)

Baud rate 4 = 100K, 5 = 125K, 6 = 250K, 7 = 500K, 8 = 800K, 9 = 1M

Interval 1, 2, ..., 1000 [ms], sending interval between each frame

Test time 0 = once, 1, 2, ..., 60 [min], length of test time

Test file Pattern.txt file includes ID and data used for sending test frames.

58 Setting Up the Ubuntu Operating System

Table 8. Setup.ini settings

Parameter Settings

Log file Log.txt is used for saving the test result.

5. Before starting the test, prepare a special port cable that can jump each pin. Connect cable-A and cable-B as below:

Cable-A-pin2 and cable-B-pin2 are connected using a cable.

Cable-A-pin7 and cable-B-pin7 are connected using a cable.

EMP2-X2S1 card with isolated RS-232 uFM expansion module

About this task

Map the pins according to the following table.

Table 9. RS-232 pin assignment

Signal Pin

CD 1

RXD 2

TXD 3

DTR 4

GND 5

DSR 6

RTS 7

CTS 8

RI 9

The EMP2-X2S1 uFM card supports two RS-232 ports, however there are four ports from the OS, as shown in the red box in the following figure:

Figure 70. RS-232 ports

Use the first two ports, ttyS5 and ttyS6, as shown in the green box, for the RS-232 port function. The test method references the "serial port" section.

Setting Up the Ubuntu Operating System 59

EMP2-X4S2 card with isolated RS-422/485 uFM expansion module

About this task

Map the pins according to the following table.

Table 10. RS-422/485 pin assignment

RS-422 full duplex Pin RS-485 half duplex

- 1 -

TX+ 2 D+

RX+ 3 -

- 4 -

GND 5 GND

- 6 -

RX 7 -

TX 8 D

- 9 -

Steps

1. Download the latest driver (EMP2-X4S2_Linux_driver_ .zip) from the Dell Technologies Support Site. Unzip the file and copy the driver package on your platform with the Ubuntu environment.

2. Use the following cd commands in the driver directory.

$ sudo apt install make gcc $ sudo make clean $ sudo make $ openssl req -new -x509 -newkey rsa:2048 -nodes -days 36500 -outform DER -keyout "MOK.priv" -out "MOK.der" -subj "/CN=$(hostname) module signing key/" $ kmodsign sha512 MOK.priv MOK.der xr17v35x.ko $ sudo make install $ sudo vim /etc/modules-load.d/modules.conf

3. Add xr17v35x into the file to make Ubuntu auto load this driver during boot up.

$ sudo vim /etc/modules-load.d/modules.conf

4. Add blacklist 8250_exar into the file to make the standard serial port driver not conflict with xr17v35x.

$ sudo vim /etc/modprobe.d/blacklist.conf

NOTE: This step is to roll back the modifications of modules.conf/blacklist.conf by the EMP2-X2S1 driver if you

previously used the EMP2-X2S1 card.

$ sudo mokutil --import MOK.der

Enter your password twice.

$ sudo reboot

While the BIOS loads GRUB, the device displays a blue screen for MokManager. On this screen, perform the following

steps:

a. Select Enroll MOK.

60 Setting Up the Ubuntu Operating System

b. Use the menus to finish the enrolling process.

c. Use the same password used when running mokutil.

d. Save the key.

e. Reboot again.

5. For RS-422, use RS-422 cables with the EMP2-X4S2 card.

For the RS-422 port-to-port test, connect the RS-422-A and RS-422-B as detailed in the following: RS-422-A-pin2 and RS-422-B-pin3 are connected with a cable. RS-422-A-pin3 and RS-422-B-pin2 are connected with a cable. RS-422-A-pin7 and RS-422-B-pin8 are connected with a cable. RS-422-A-pin8 and RS-422-B-pin7 are connected with a cable.

6. After the RS-422 hardware is prepared, open two terminal windows.

For the first terminal window:

$ sudo minicom -D /dev/ttyXR0

For the second terminal window:

$ sudo minicom -D /dev/ttyXR1

Type some words in the first terminal to confirm that you can see the words displayed in the second terminal.

7. For RS-485, use RS-485 cables with the EMP2-X4S2 card.

For the RS-485 port-to-port test, connect the RS-485-A and RS-485-B as detailed in the following: RS-485-A-pin2 and RS-485-B-pin2 are connected with a cable. RS-485-A-pin8 and RS-485-B-pin8 are connected with a cable.

8. After the RS-485 hardware is prepared, open two terminal windows.

For the first terminal win

Manualsnet FAQs

If you want to find out how the Edge Gateway 5200 Dell works, you can view and download the Dell Edge Gateway 5200 Gateway Software User's Guide on the Manualsnet website.

Yes, we have the Software User's Guide for Dell Edge Gateway 5200 as well as other Dell manuals. All you need to do is to use our search bar and find the user manual that you are looking for.

The Software User's Guide should include all the details that are needed to use a Dell Edge Gateway 5200. Full manuals and user guide PDFs can be downloaded from Manualsnet.com.

The best way to navigate the Dell Edge Gateway 5200 Gateway Software User's Guide is by checking the Table of Contents at the top of the page where available. This allows you to navigate a manual by jumping to the section you are looking for.

This Dell Edge Gateway 5200 Gateway Software User's Guide consists of sections like Table of Contents, to name a few. For easier navigation, use the Table of Contents in the upper left corner.

You can download Dell Edge Gateway 5200 Gateway Software User's Guide free of charge simply by clicking the “download” button in the upper right corner of any manuals page. This feature allows you to download any manual in a couple of seconds and is generally in PDF format. You can also save a manual for later by adding it to your saved documents in the user profile.

To be able to print Dell Edge Gateway 5200 Gateway Software User's Guide, simply download the document to your computer. Once downloaded, open the PDF file and print the Dell Edge Gateway 5200 Gateway Software User's Guide as you would any other document. This can usually be achieved by clicking on “File” and then “Print” from the menu bar.