Digi WDNUII WDNU-II User Manual

Digi International Inc WDNU-II

user manual

Download: Digi WDNUII WDNU-II User Manual
Mirror Download [FCC.gov]Digi WDNUII WDNU-II User Manual
Document ID2700081
Application ID45ejFBWnYqkO+l2swE/KpQ==
Document Descriptionuser manual
Short Term ConfidentialNo
Permanent ConfidentialNo
SupercedeNo
Document TypeUser Manual
Display FormatAdobe Acrobat PDF - pdf
Filesize90.88kB (1135954 bits)
Date Submitted2015-07-31 00:00:00
Date Available2015-07-31 00:00:00
Creation Date2015-07-29 08:32:36
Producing SoftwareAcrobat Distiller 10.1.14 (Windows)
Document Lastmod2015-07-29 08:32:36
Document TitleMicrosoft Word - user_manual_in_english_fcc__ic.(2).docx
Document CreatorPScript5.dll Version 5.2.2
Document Author: valbertson

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                      : 27
EXIF Metadata provided by EXIF.tools
FCC ID Filing: MCQ-WDNUII

Navigation menu