user manual
Theory of Operations and User Manual SPF‐005 GEAS WDNU‐II SDRL A036 Digi Part Number: 90001937 Revision Control Revision 1.0 — Author(s) Tom Manley Tom Manley, Steve Stack 1.1 Matt Schellin Description Initial draft for customer submittal Incorporated GE Comments from 01/21/15, added SIM activation section, added web interface section, formatting and editing Added Certification Section Date 12/31/14 03/16/15 4/20/2015 Reviewed By Travis Wenzel Travis Wenzel Approved By Tom Wolf Tom Wolf Table of Contents Overview or Purpose ....................................................................................................................................................... 5 Scope................................................................................................................................................................................ 6 Reference Material .......................................................................................................................................................... 7 3.1 Reference Documents ............................................................................................................................................. 7 3.2 Acronyms, Terms and Definitions ........................................................................................................................... 7 WDNU‐II Overview........................................................................................................................................................... 9 4.1 General Description ................................................................................................................................................ 9 4.2 Physical Description ................................................................................................................................................ 9 4.3 WDNU‐II Interfaces ............................................................................................................................................... 10 4.3.1 Radio Power On Discrete .................................................................................................................................. 11 4.3.2 Radio Power Off Discretes ................................................................................................................................ 12 4.3.3 Ethernet Interface ............................................................................................................................................. 12 4.3.4 Universal Serial Bus (USB) Serial ....................................................................................................................... 12 4.3.5 RS‐232 Interface ................................................................................................................................................ 12 4.4 4.4.1 Wi‐Fi Connection ............................................................................................................................................... 12 4.4.2 GSM Connection ............................................................................................................................................... 12 WDNU‐II Functional Description.................................................................................................................................... 13 5.1 Network Interfaces ............................................................................................................................................... 13 5.1.1 Ethernet ............................................................................................................................................................ 13 5.1.2 Wi‐Fi .................................................................................................................................................................. 13 5.1.3 Cellular .............................................................................................................................................................. 14 5.2 WDNU‐II RF Interfaces .......................................................................................................................................... 12 Services ................................................................................................................................................................. 15 5.2.1 Command‐Line Interface (CLI) .......................................................................................................................... 16 5.2.2 Command Handler Interface Protocol (CHIP) ................................................................................................... 16 5.2.3 Web User Interface ........................................................................................................................................... 16 5.3 Network Interface Configuration .......................................................................................................................... 16 5.4 Python ................................................................................................................................................................... 17 5.5 Startup Sequence .................................................................................................................................................. 17 Detailed WDNU‐II‐Specific Description ......................................................................................................................... 18 6.1 6.1.1 CHIP ....................................................................................................................................................................... 18 CHIP Commands ................................................................................................................................................ 18 GE Aviation WDNU‐II Revision: —, 03/16/15 A036 – Operations and User Manual Digi Part Number: 90001937 © 2015 Etherios 2 of 27 6.1.2 6.2 Python and CHIP ............................................................................................................................................... 18 Web Interface ....................................................................................................................................................... 20 6.2.1 Login .................................................................................................................................................................. 21 6.2.2 System Summary (read‐only) ............................................................................................................................ 21 6.2.3 Network Status (read‐only) ............................................................................................................................... 22 6.2.4 Command Interface (operator) ......................................................................................................................... 22 6.2.5 Wi‐Fi Configuration (operator) ......................................................................................................................... 23 6.2.6 Cellular Configuration (operator)...................................................................................................................... 23 6.2.7 Software Updates (admin) ................................................................................................................................ 24 6.3 LRU Update Procedure via Web Interface ............................................................................................................ 24 6.4 SIM Activation ....................................................................................................................................................... 26 Certifications .................................................................................................................................................................. 27 7.1 7.1.1 7.2 7.2.1 FCC ........................................................................................................................................................................ 27 FCC‐Approved Antennas ................................................................................................................................... 27 Canada (IC) ............................................................................................................................................................ 27 IC Approved Antennas ...................................................................................................................................... 27 Table of Figures Figure 1: WDNU‐II Top and Side Views ...................................................................................................................................................... 9 Figure 2: Amphenol TVP‐00‐RQF‐17‐2‐P WDNU‐II Front Panel Connector ............................................................................................. 10 Figure 3: Ethernet Quadrax Contact Detail Showing Pin Orientation and Numbering ............................................................................ 10 Figure 4: Major Functional Components ................................................................................................................................................. 13 Figure 5: Wi‐Fi Network Configuration using the Web User Interface .................................................................................................... 14 Figure 6: Mobile Configuration using the Web User Interface ................................................................................................................ 15 Figure 7: Example Test Configuration Setup ............................................................................................................................................ 16 Figure 8: Sample app.log.......................................................................................................................................................................... 20 Figure 9: Login Page ................................................................................................................................................................................. 21 Figure 10: System Summary Page ............................................................................................................................................................ 21 Figure 11: Network Status Page ............................................................................................................................................................... 22 Figure 12: Command Interface Page........................................................................................................................................................ 22 Figure 13: Wi‐Fi Configuration Page ........................................................................................................................................................ 23 Figure 14: Cellular Configuration Page .................................................................................................................................................... 23 Figure 15: Software Update Page ............................................................................................................................................................ 24 Figure 16: Software Update Screen ......................................................................................................................................................... 25 Figure 17: Update Success ....................................................................................................................................................................... 25 Table of Tables Table 1: Assignments for the Main Connector on the Front Panel.......................................................................................................... 11 Table 2: RS‐232 Port Settings ................................................................................................................................................................... 12 Table 3: Log File Descriptions................................................................................................................................................................... 19 Table 4: Web Interface Access Levels ..................................................................................................................................................... 20 GE Aviation WDNU‐II Revision: —, 03/16/15 A036 – Operations and User Manual Digi Part Number: 90001937 © 2015 Etherios 3 of 27 GE Aviation WDNU‐II Revision: —, 03/16/15 A036 – Operations and User Manual Digi Part Number: 90001937 © 2015 Etherios 4 of 27 1 Overview or Purpose This document is the user manual for the Wireless Data Network Unit (WDNU‐II). It assumes the reader has some general knowledge of the product, which can be gained from other documents. The goal of this document is to describe the various ways to interact with and use the WDNU‐II. GE Aviation WDNU‐II Revision: —, 03/16/15 A036 – Operations and User Manual Digi Part Number: 90001937 © 2015 Etherios 5 of 27 2 Scope This Subcontractor Data Requirements List (SDRL) document applies to the Wireless Data Network Unit‐II for the Aircraft Health Management System as defined in the specification listed in the references. The information within this document is intended to be informative and explanatory. It is based on the actual design artifacts and should not be considered authoritative. GE Aviation WDNU‐II Revision: —, 03/16/15 A036 – Operations and User Manual Digi Part Number: 90001937 © 2015 Etherios 6 of 27 3 Reference Material 3.1 Reference Documents Customer Document ID SOW1281 Digi Part Number Document Filename Revision Date Source NA 12/4/13 NA TRS1255 NA WDNU II Statement of Work_SOW1281_Revx2_20140527.pdf WDNU II Rev D SOW1281_TRS1255 Amendments_20140527.pdf TRS1255 22‐JAN‐2015.pdf X2 ‐‐ TBD 01/22/15 GE Aviation GE Aviation GE Aviation YV2818 NA YV2818_Extended_Draft01‐.doc — 01/27/15 GE Aviation SDRL A007 90001451‐ 88 50001885‐ 01‐PRT NA NA Statement of Work for Wireless Data Network Unit (WDNU‐II) WDNU‐II SOW1281 & TRS1255 Amendments Technical Requirements Specification for the Wireless Data Network Unit (WDNU‐II) Interface Protocol Specification for the Command Handler Superset of the Wireless Data Network Unit Interface Control Doc A007 ‐ Interface Control Document.docx — 03/16/15 EWDS 50001885‐01‐PRT, WDNU‐II INSTALLATION DRAWING, REV 1P.PDF A018 ‐ BIT Description.docx WDNU‐II Software Design Document.docx 1P 03/11/15 EWDS — — 03/16/15 03/16/15 EWDS EWDS SDRL A008 SDRL A018 SDD WDNU‐II Installation Drawing WDNU‐II BIT Description Software Design Document 3.2 Acronyms, Terms and Definitions Acronyms and Terms ACK Definition Acknowledge AP Access Point ARP Address Resolution Protocol BIT Built‐In Test CHIP Command Handler Interface Protocol CLI command‐line interface DC Direct Current DHCP Dynamic Host Configuration Protocol EWDS Etherios Wireless Design Services GE GEAS General Electric General Electric Aviation Systems GSM Global System for Mobile HDD Hardware Design Document HTTPS Hypertext Transfer Protocol Secure ICCID Integrated Circuit Card Identifier ICMP Internet Control Message Protocol ID Identifier or Identification I/O Input/Output IEEE Institute of Electrical and Electronics Engineers IMSI International Mobile Subscriber Identity IP Internet Protocol LRU Line Replaceable Unit OTG On‐The‐Go NA Not Applicable PC Personal Computer GE Aviation WDNU‐II Revision: —, 03/16/15 A036 – Operations and User Manual Digi Part Number: 90001937 © 2015 Etherios 7 of 27 Acronyms and Terms PSK RF Definition Pre‐shared key Radio Frequency SDRL Subcontractor Data Requirements List SDD Software Design Document SIM Subscriber Identity Module SMA SubMiniature version A SOW Statement of Work SSH Secure Shell SSID Service set identification STD Standard TBD To Be Determined TNC Threaded Neill‐Concelman TRS Technical Requirements Specification UBIFS Unsorted Block Image File System UDP User Datagram Protocol UI User Interface USB Universal Serial Bus VBUS Virtual Bus VPN Virtual Private Network WDNU WDNU‐II Wireless Data Networking Unit Enhanced Wireless Data Networking Unit Wi‐Fi Wireless Fidelity (IEEE 802.11) WPA Wireless Fidelity (Slang) Protected Access WPA2 Wireless Fidelity (Slang) Protected Access II GE Aviation WDNU‐II Revision: —, 03/16/15 A036 – Operations and User Manual Digi Part Number: 90001937 © 2015 Etherios 8 of 27 4 WDNU‐II Overview 4.1 General Description The WDNU‐II provides the wireless bridge between the host and access points while the aircraft is on the ground. Operation of the WDNU‐II occurs when the host provides power, enables the device and requests connection via either Wi‐Fi or GSM. Physically, the subsystem is comprised of a WDNU‐II Line Replaceable Unit (LRU) that connects to a Wi‐Fi and GSM antenna providing optimized Wi‐Fi and GSM connectivity and range. 28V DC power is supplied to the WNDU‐II by the aircraft power system. A control signal is provided by the host system for the WNDU‐II to enable itself. The WNDU‐II will provide an Ethernet interface direct to the host. The host will transmit and receive data in standard Ethernet packets to and from the WNDU‐II. The WDNU‐II supports VPN connections over the Wi‐Fi and GSM interfaces to provide data security. The WDNU‐II may also be configured as a Wi‐Fi access point that will accept up to 4 simultaneously connected Wi‐Fi clients. 4.2 Physical Description The physical configuration of the WDNU‐II is shown in Figure 1. The information comes from SDRL A008, Digi Part Number 50001885‐01‐PRT. Figure 1: WDNU‐II Top and Side Views GE Aviation WDNU‐II Revision: —, 03/16/15 A036 – Operations and User Manual Digi Part Number: 90001937 © 2015 Etherios 9 of 27 4.3 WDNU‐II Interfaces The following information comes from SDRL A007, Digi Part Number 90001451‐88. The electrical signal interface is provided by a set of contacts in a connector on the outer panel of the WDNU and by a set of antenna connectors on the opposite panel as show in Figure 2 and Figure 3. The connector on the outer panel of the WDNU‐II provides the following connection points: 38 Size 22 contacts and one Quadrax contact. LRU connector: Amphenol TVP‐00‐RQF‐17‐2‐p (or equivalent) Aircraft I/O mating connector: Amphenol TV06‐RQF‐17‐2‐S (or equivalent) Figure 2: Amphenol TVP‐00‐RQF‐17‐2‐P WDNU‐II Front Panel Connector Figure 3: Ethernet Quadrax Contact Detail Showing Pin Orientation and Numbering GE Aviation WDNU‐II Revision: —, 03/16/15 A036 – Operations and User Manual Digi Part Number: 90001937 © 2015 Etherios 10 of 27 Table 1 presents an extract of the pin assignments for the main connector on the front panel. Table 1: Assignments for the Main Connector on the Front Panel Pin ID 6 ‐ 15 16 17 18 19 20‐21 22 23 24 25 26‐27 28 29 30 31 32 33‐36 37 38 Q‐1 Q‐2 Q‐3 Q‐4 Pin Name Chassis Ground 28 VDC Power In 1 28 VDC Power In 2 28 VDC Power Return 1 28 VDC Power Return 2 Not Connected USB_OTG_VBUS_SOM USB_N USB_P USB_OTG_ID Not Connected Power Off Discrete Out – O/G Power On Discrete In Power Off Discrete Out – 28V/O Shield/Ground Not Connected RS‐232 FORCEOFF RS‐232 In RS‐232 Out RS‐232 Common Not Connected Not Connected USB Common Not Connected Ethernet RX‐A (+) Ethernet TX‐A (+) Ethernet RX‐B (‐) Ethernet TX‐B (‐) The back panel of the WDNU‐II provides the following connection points: WiFi Antenna Connector: TNC Amphenol 122192 (or equivalent) WiFi Antenna mating connector: TNC Amphenol 122116, straight plug (or equivalent) GSM Antenna Connector: Subminiature version A (SMA) Amphenol 132176 (or equivalent) GSM Antenna mating connector: SMA Amphenol 132178 (or equivalent) 4.3.1 Radio Power On Discrete The radio power on signal is an Open/Ground discrete output from the host used to turn the WDNU‐ II on or off. When asserted (grounded), power to the WDNU‐II is applied and the system is on. When de‐asserted (open), the WDNU‐II is off. GE Aviation WDNU‐II Revision: —, 03/16/15 A036 – Operations and User Manual Digi Part Number: 90001937 © 2015 Etherios 11 of 27 4.3.2 Radio Power Off Discretes The radio provides two discrete power off signals. These signals are described as: WDNU_OFF1 is a 28VDC/Open discrete output from the WDNU‐II to indicate whether the WDNU‐II is on or off. When the host turns the WDNU‐II on with the radio power on discrete, the radio power off discrete will be open to signal that the WDNU‐II is on. When the WDNU‐ II is off this signal will be pulled up to the aircraft supply voltage (28VDC nominal). WDNU_OFF2 is an Open/Ground discrete output from the WDN‐II to indicate when the WDNU‐II is on or off. When the host turns the WDNU‐II on with the radio power on discrete, the radio power off discrete will be grounded (and able to sink up to 20ma) to signal that the WDNU‐II is on. When the WDNU‐II is off this signal will be open. 4.3.3 Ethernet Interface The WDNU‐II provides one Ethernet interface for communications with the host. The Ethernet channels will support the IEEE‐STD‐802.3 10/100 Ethernet protocol with auto‐negotiation. The cable configuration specified is a crossover connection. 4.3.4 Universal Serial Bus (USB) Serial The WDNU‐II provides one USB Serial interface with Virtual Bus (VBUS) and identification (ID) control lines. The data bus communication protocol is defined in the USB standard. 4.3.5 RS‐232 Interface A RS‐232 serial communication interface has been included through the main connector to the host. The settings for the RS‐232 interface are shown in Table 2. Table 2: RS‐232 Port Settings RS‐232‐Port Settings Baud rate Number of data bits Parity Number of stop bits Flow control Automatic baud rate detection 115200 None None No This RS‐232 FORCEOFF pin controls the operation state of the RS‐232 Data Bus. When pulled to ground, the RS‐232 Data Bus is enabled. The RS‐232 Data Bus is disabled when this pin is left floating. 4.4 WDNU‐II RF Interfaces The WDNU‐II has two external coaxial connections for the GSM and Wi‐Fi transceivers. 4.4.1 Wi‐Fi Connection TNC Amphenol 122192 (or equivalent) Mating connector: TNC Amphenol 122116, straight plug (or equivalent) 4.4.2 GSM Connection GE Aviation WDNU‐II Revision: —, 03/16/15 Subminiature version A (SMA) Amphenol 132176 (or equivalent) Mating connector: SMA Amphenol 132178 (or equivalent) A036 – Operations and User Manual Digi Part Number: 90001937 © 2015 Etherios 12 of 27 5 WDNU‐II Functional Description The WDNU‐II is a gateway product which runs a server that allows the host to connect to a remote server over a secure connection. This section describes some of the features of the WDNU‐II, which are illustrated in Figure 4. Figure 4: Major Functional Components 5.1 Network Interfaces The WDNU‐II has Ethernet, Wi‐Fi (802.11 b/g/n, 2.4GHz only) and cellular (GSM 3G) network interfaces. 5.1.1 Ethernet The Ethernet interface is factory configured with a static IP address of 192.168.114.1 and subnet mask of 255.255.0.0. ARP and ICMP are both enabled on the interface. Three main services are provided on the Ethernet interface. These services are the Command‐Line Interface (CLI), the Command Handler Interface Protocol (CHIP), and the web user interface (web UI). The general use case for the Ethernet port is the host communicates with the WDNU‐II using CHIP. 5.1.2 Wi‐Fi The Wi‐Fi interface is not enabled by default, but can be configured with any of the available services on the Ethernet interface. It can be configured to operate in station mode, access point (AP) mode, or concurrent mode which is simultaneous client and AP mode. By default the CLI, CHIP and web interface are not supported on the Wi‐Fi interface, but the CLI and web interface can be enabled on AP mode via a configuration update. When configured in station mode, the WDNU‐II can scan and connect to nearby access points and use DHCP to get an IP address. When in AP mode, it will broadcast an SSID for Wi‐Fi stations to find and connect to. When in concurrent mode the device suffers a throughput penalty so the device should be configured in station mode or AP mode when concurrent operation is not necessary. When configured as an AP in either AP mode or concurrent mode, the AP interface has an IP address of 192.168.3.1 and the DHCP server will hand out addresses in the 192.168.3.0/24 subnet in the range 192.168.3.10 – 192.168.3.85. This network configuration can be changed via a software update of the configuration partition. ARP and ICMP are both enabled on the AP interface. GE Aviation WDNU‐II Revision: —, 03/16/15 A036 – Operations and User Manual Digi Part Number: 90001937 © 2015 Etherios 13 of 27 To configure Wi‐Fi via the web interface: 1. Login to the WDNU‐II web interface and select Wi‐Fi Configuration in the navigation bar. The screen shown in Figure 5 will be displayed. 2. Select STATION, ACESS POINT or CONCURRENT to enable the Wi‐Fi interface in one of the desired operational modes. If station or concurrent mode was selected, the WDNU‐II can scan for Wi‐Fi networks and add each one to the ‘Available Networks’ dropdown list. 3. To connect to a WPA‐PSK or WPA2‐PSK network; select the approach SSID from the list, enter the passphrase and press Connect. 4. To disable any of the interfaces select DISABLED from the dropdown. 5. To configure the AP for WPA2‐PSK operation entered the desired SSID and passphrase and press Configure. Figure 5: Wi‐Fi Network Configuration using the Web User Interface 5.1.3 Cellular The GSM cellular interface does not support the CLI, CHIP or web interfaces. It is used by the host to connect to a remote server when there are not any Wi‐Fi access points available or when the operator defines it as the primary communication path. The WDNU‐II contains two SIM card slots which are populated with an AT&T SIM and a Vodafone SIM. The cellular interface can be configured via the CLI, CHIP or the web UI services using either the Ethernet or Wi‐Fi interfaces (if enabled). Figure 6 illustrates the configuration of the cellular connection using the web UI. GE Aviation WDNU‐II Revision: —, 03/16/15 A036 – Operations and User Manual Digi Part Number: 90001937 © 2015 Etherios 14 of 27 To configure cellular connection using the web UI: (See Figure 6) 1. Login to the WDNU‐II web interface, then select Cellular Configuration from the navigation bar and select Enabled to enable the cellular interface. 2. Enter 1 or 2 to select the SIM Card, and enter the APN, username and password (if required). 3. Click Apply Updates to configure the cellular interface and establish a data connection. 4. Select Disabled from the dropdown to disable the cellular interface completely. Figure 6: Mobile Configuration using the Web User Interface 5.2 Services This section describes the services that are available on some of the network interfaces. To access these interfaces an example of a basic test configuration setup is detailed in Figure 7. Equipment Needed: 1. WDNU‐II board loaded with pre‐installed SIM cards 2. Off the shelf GSM antenna 3. Off the shelf Wi‐Fi antenna 4. 2 DC power supplies 5. Digital Test cable for WDNU‐II 6. Windows PC with operating system of XP or higher GE Aviation WDNU‐II Revision: —, 03/16/15 A036 – Operations and User Manual Digi Part Number: 90001937 © 2015 Etherios 15 of 27 Breakout Test Cable WDNU USB Wi-Fi Antenna RS-232 Bulkhead Connector ETHERNET WDNU OFF WDNU ON* GSM Antenna SIM CARD 1 SIM CARD 2 28 VDC 2 Variable DC Supply 28 VDC 1 Variable DC Supply Figure 7: Example Test Configuration Setup 5.2.1 Command‐Line Interface (CLI) The command‐line interface provides a means interacting with the WDNU‐II. It is available via the RS232 and USB serial interfaces, or over Ethernet or Wi‐Fi AP (when enabled) using SSH. The serial interfaces require username/password authenticated access but the communication is not encrypted. The CLI interface can be accessed from Windows machine using a terminal program called PuTTY using serial mode or SSH mode. On a Linux machine, PuTTY or another serial or SSH client can be used. This terminal provides unfettered access to the Linux operating system. It can be used to run custom python scripts or view system details not available via the CHIP CLI or web interface. 5.2.2 Command Handler Interface Protocol (CHIP) CHIP provides many of the same configuration and status commands that are available through the command‐line interface, but in a more defined and consistent format. The available commands in CHIP are defined in the Command Handler Interface Protocol Specification for the Wireless Data Network Unit (YV2818). The CHIP service is available on UDP port 49000. 5.2.3 Web User Interface The WDNU‐II provides a collection of web pages for interacting with the WDNU‐II. Much of the information available on the web pages is also available through the CLI and CHIP services. The WDNU‐II web UI is available via HTTPS on port 443 and can be accessed by a modern web browser like Internet Explorer, Firefox or Chrome. The web interface is described in more detail in Section 6.2. 5.3 Network Interface Configuration The WDNU‐II has a custom set of factory default configuration settings. The WDNU‐II uses these configurations every time it boots up. Configuration changes are not persistent from one boot to the next. The custom defaults include setting the Ethernet IP address to 192.168.114.1, auto‐running the WDNU‐II Python application, etc... The Ethernet and Wi‐Fi settings are described in more detail in Section 5.1. Default settings can be customized via a software update of the /opt/config UBIFS partition using the CLI. GE Aviation WDNU‐II Revision: —, 03/16/15 A036 – Operations and User Manual Digi Part Number: 90001937 © 2015 Etherios 16 of 27 5.4 Python The WDNU‐II can be customized using the Python programming language. The Python interpreter can be invoked from the CLI with the python command. A Python application was developed for the WDNU‐II to support the CHIP service. The CHIP Python application can only be updated with a complete system update. 5.5 Startup Sequence During boot the WDNU‐II tests RAM, flash, and the validity of the firmware image. It also runs BIT, where it tests the power subsystem and physical and logical connections to the Wi‐Fi and cellular interfaces and both SIM cards. BIT is described further in SDRL A018. The results of the BIT test can be retrieved with the ‘Transmit BIT Results CHIP’ command. Once booted, the Wi‐Fi transceiver is off, the cellular radio is off and the CHIP server application is running. The WDNU‐II uses the factory default settings on every boot, which is described in Section 5.3. GE Aviation WDNU‐II Revision: —, 03/16/15 A036 – Operations and User Manual Digi Part Number: 90001937 © 2015 Etherios 17 of 27 6 Detailed WDNU‐II‐Specific Description 6.1 CHIP CHIP stands for the Command‐Handler Interface Protocol. It was developed by GE for use on a communication network between a client and server. It defines the protocol used for communication between the host and the WDNU‐II. It is defined in document YV2818. 6.1.1 CHIP Commands CHIP contains a number of commands that can be used by the host to configure the WDNU‐II, get BIT status, and setup a VPN. 6.1.1.1 Generic Command One of the commands is the ‘generic’ command. This command can be used to execute a standard Linux CLI command over the CHIP protocol. The command can be up to 1020 characters long and the response is the same as if the command had been executed directly on the command line, including blank lines and newline characters. The maximum size of the response data is 1022 characters and the response will be truncated to 1022 characters if necessary. 6.1.1.2 Transmit BIT Status This command reports on the BIT status of the power subsystem and Wi‐Fi and cellular interfaces. Note that this command switches the active SIM card. 6.1.1.3 Configure Wi‐Fi The Wi‐Fi radio can be configured by enabling the interface with the ‘Wi‐Fi Interface Control’ command, and then configuring the interface with the ‘Set Wi‐Fi Mode’ and ‘Set Wi‐Fi Tx Power’ commands. 6.1.1.4 Configure GSM The GSM radio can be configured by enabling the interface with the ‘GSM Interface Control’ command, and then configuring it with the ‘Set Active SIM Card’ command. 6.1.1.5 Configure VPN The VPN can be set up by executing this CHIP command sequence: 1. Set Global VPN Mode. 2. Set VPN Tunnel Options. 3. Set VPN Phase 1 Proposal Options. 4. Set VPN Phase 2 Proposal Options. 5. Set VPN Interface ID. 6.1.2 Python and CHIP The Python application implements the CHIP interface on the WDNU‐II. This means the Python application is responsible for accepting CHIP command messages, translating the commands to the native format, executing the commands, and sending back the responses in CHIP ACK or data messages. GE Aviation WDNU‐II Revision: —, 03/16/15 A036 – Operations and User Manual Digi Part Number: 90001937 © 2015 Etherios 18 of 27 6.1.2.1 Python application The Python application and supporting libraries are packaged into a single binary which is started automatically on system boot. The CHIP server listens for a CHIP client on UDP port 49000. When a UDP message is received, the server creates a thread to execute the CHIP request handler. The CHIP request handler does general validation of the request message, and then executes the appropriate CHIP command handler routine. 6.1.2.2 Logging The Python application logs debugging information to /var/data/logs/app.log[.X]. The files are limited in size to 100KB each, and to a total number of 5 files. The active log file is always “app.log”. When this file reaches 100KB, the oldest log file is removed, “app.log.3” is renamed to “app.log.4”, “app.log.2” is renamed to “app.log.3”, etc… and a new app.log file is created. The application logs information about both internal state as well as chip and web commands received. It will also log any errors encountered in the process of executing. There are also a number of additional logs with more specific information that work in a similar manner. See Table 3 for a list of log file descriptions. Table 3: Log File Descriptions Log Location /var/data/logs/bit.log /var/data/logs/shell.log /var/data/logs/wpad.log /var/data/logs/mmd.log /var/data/logs/pppd.log /var/data/logs/access.log /var/data/logs/startup.log GE Aviation WDNU‐II Revision: —, 03/16/15 Description Information about the power‐on and initiated BIT. Contains the output of any system commands called from the Python application (such as ‘ifconfig wlan0 up’). Contains the output from the wpa_supplicant process as it is run and controlled by the Python app. Contains information about the modem_manager process as it is run and controlled by the Python app. Contains information about the ppp process as it is run and controlled by the Python app. Contains information about users that log in via through any means (SSH, serial, web, etc.). Contains information about the application startup process including settings that are overridden from the config‐fs. A036 – Operations and User Manual Digi Part Number: 90001937 © 2015 Etherios 19 of 27 Figure 8 shows an example of the format for the logs from app.log: Figure 8: Sample app.log 6.2 Web Interface The WDNU‐II has a web interface available via HTTPS on port 443. It can be accessed with a modern web browser like Chrome or Firefox by typing https://into the address bar. The following sections are a break‐down of the web interface functionality and how to effectively use the web interface. Table 4 shows valid username and passwords for accessing the web interface. Table 4: Web Interface Access Levels Access Level Read Only Username wreadonly Password wreadonly Operator woperator woperator Administrator wadmin wadmin GE Aviation WDNU‐II Revision: —, 03/16/15 A036 – Operations and User Manual Digi Part Number: 90001937 Available Pages System Summary Network Status Command Interface Wi‐Fi Configuration Cellular Configuration Software Updates © 2015 Etherios 20 of 27 6.2.1 Login The WDNU‐II web interface is only accessible with a valid username and password (see Figure 9). There are three access levels when using the web interface, admin, operator and read‐only. The following sections describe one of the pages featured in the web interface along with the required access‐level to reach it. For a comprehensive look at the web pages access levels along with usernames and passwords see Table 4. Figure 9: Login Page 6.2.2 System Summary (read‐only) Figure 10 provides static information about the WDNU‐II system as a whole including system identification information and BIT status/results. Figure 10: System Summary Page GE Aviation WDNU‐II Revision: —, 03/16/15 A036 – Operations and User Manual Digi Part Number: 90001937 © 2015 Etherios 21 of 27 6.2.3 Network Status (read‐only) Figure 11 features a dynamic view into the systems network configuration and current status. The networking interfaces of interest here include Ethernet (host system digital interface), Wi‐Fi client/station (external), cellular and Wi‐Fi access point. Figure 11: Network Status Page 6.2.4 Command Interface (operator) The Command Interface page (see Figure 12) is a fully interactive way to send raw CHIP commands and view their responses. Based on the selected CHIP command from the top drop‐down menu, the arguments below will be generated per the CHIP spec (YV2818). Each line in “Responses” table can be clicked on to show a more detailed breakdown of the response. Figure 12: Command Interface Page GE Aviation WDNU‐II Revision: —, 03/16/15 A036 – Operations and User Manual Digi Part Number: 90001937 © 2015 Etherios 22 of 27 6.2.5 Wi‐Fi Configuration (operator) Although the main interface into the WDNU‐II for configuring the system is through CHIP, the Wi‐Fi Configuration page (see Figure 13) provides a simplified mechanism for quickly configuring both Wi‐ Fi station and access‐point. Figure 13: Wi‐Fi Configuration Page 6.2.6 Cellular Configuration (operator) Similar to the Wi‐Fi Configuration page, the Cellular Configuration page (see Figure 14) provides an alternative mechanism for quickly configuring the WDNU‐II for connecting to a cell tower. This page also allows the operator to change the currently active SIM card. Figure 14: Cellular Configuration Page GE Aviation WDNU‐II Revision: —, 03/16/15 A036 – Operations and User Manual Digi Part Number: 90001937 © 2015 Etherios 23 of 27 6.2.7 Software Updates (admin) The Software Update page (see Figure 15) will allow any administrator to overwrite one or many of the flash partitions running on the WDNU‐II. These updates should be built using instructions provided by Etherios. Regardless of what is in the update package it must be GPG signed in order to work. The most common uses of this page will be updating the entire WDNU‐II software or only the “config‐image” to change WDNU‐II configuration and behavior. Figure 15: Software Update Page 6.3 LRU Update Procedure via Web Interface The WDNU‐II root file system (rootfs), config file system, u‐boot, kernel, updaterd, and the bootscript can all be updated using the CLI, Chip command, or the web UI. The first step is to build the new software images. The build process is described in the Software Design Document (SDD). Once the new image is built the WDNU‐II can be updated via the web interface using the following steps: 1. Navigate to the WDNU‐II web interface, login to the device as the admin level user (wadmin currently) and use the navigation bar on the left to visit the Software Update page. A screen similar to that shown in Figure 16 will appear: GE Aviation WDNU‐II Revision: —, 03/16/15 A036 – Operations and User Manual Digi Part Number: 90001937 © 2015 Etherios 24 of 27 Figure 16: Software Update Screen This will provide current version of the firmware that is loaded on the image, as well as give the option to choose and update image file. 2. Click Choose File and select the update image. This should populate the file name into the page (see Figure 17). 3. Click Update to begin the process. A green notification at the top of the screen will appear when the upload has completed. After the upload is completed a reboot must be triggered manually using the reboot button shown in the screen capture. Figure 17: Update Success GE Aviation WDNU‐II Revision: —, 03/16/15 A036 – Operations and User Manual Digi Part Number: 90001937 © 2015 Etherios 25 of 27 6.4 SIM Activation GE will handle the activation of the SIM cards for the WDNU‐II. The SIM activation process will require the ICCID and/or the IMSI from each SIM card. This information can be retrieved from the following places: GE Aviation WDNU‐II Revision: —, 03/16/15 Electronic file from Digi manufacturing Label affixed to the WDNU‐II Web interface A036 – Operations and User Manual Digi Part Number: 90001937 © 2015 Etherios 26 of 27 7 Certifications 7.1 FCC Per FCC 15.19(a)(3) and (a)(4) This device complies with part 15 of the FCC Rules. Operation is subject to the following two conditions: (1) This device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation. Changes or modifications not expressly approved by the party responsible for compliance could void the user's authority to operate the equipment 7.1.1 FCC‐Approved Antennas The WDNU‐II can be installed utilizing the following antenna and system gain. The EUT may only operate using and antenna of the same type and lesser net system gain then approved. Description 3dbi DAS antenna; Radiation pattern – Omni Part Number HG72703MGURB‐ NM Type Mono‐pole Peak Gain 3 dBi Peak System Gain 0 dBi 7.2 Canada (IC) This device complies with Industry Canada license‐exempt RSS standard(s). Operation is subject to the following two conditions: (1) this device may not cause interference, and (2) this device must accept any interference, including interference that may cause undesired operation of the device. Le présent appareil est conforme aux CNR d'Industrie Canada applicables aux appareils radio exempts de licence. L'exploitation est autorisée aux deux conditions suivantes : (1) l'appareil ne doit pas produire de brouillage, et (2) l'utilisateur de l'appareil doit accepter tout brouillage radioélectrique subi, même si le brouillage est susceptible d'en compromettre le fonctionnement. 7.2.1 IC Approved Antennas This radio transmitter (IC: 1846A‐WDNUII) has been approved by Industry Canada to operate with the antenna types listed in the table above with the maximum permissible system gain and required antenna impedance for each antenna type indicated. Antenna types not included in this list, having a system gain greater than the maximum gain indicated for that type, are strictly prohibited for use with this device. Le présent émetteur radio (IC: 1846A‐WDNUII) a été approuvé par Industrie Canada pour fonctionner avec les types d'antenne énumérés ci‐dessous et ayant un gain admissible maximal et l'impédance requise pour chaque type d'antenne. Les types d'antenne non inclus dans cette liste, ou dont le gain est supérieur au gain maximal indiqué, sont strictement interdits pour l'exploitation de l'émetteur. GE Aviation WDNU‐II Revision: —, 03/16/15 A036 – Operations and User Manual Digi Part Number: 90001937 © 2015 Etherios 27 of 27
Source Exif Data:
File Type : PDF File Type Extension : pdf MIME Type : application/pdf PDF Version : 1.5 Linearized : Yes Author : valbertson Create Date : 2015:07:29 08:32:36-07:00 Modify Date : 2015:07:29 08:32:36-07:00 XMP Toolkit : Adobe XMP Core 5.2-c001 63.139439, 2010/09/27-13:37:26 Format : application/pdf Creator : valbertson Title : Microsoft Word - user_manual_in_english_fcc__ic.(2).docx Creator Tool : PScript5.dll Version 5.2.2 Producer : Acrobat Distiller 10.1.14 (Windows) Document ID : uuid:df84ab27-bdd6-4fad-a258-cb77d3957056 Instance ID : uuid:8ae01d86-2cd8-4b0e-9c10-1060a821f192 Page Count : 27EXIF Metadata provided by EXIF.tools