Digi WDNUII WDNU-II User Manual

Digi International Inc WDNU-II

user manual

TheoryofOperationsandUserManualSPF‐005GEASWDNU‐IISDRLA036DigiPartNumber:90001937RevisionControlRevisionAuthor(s)Description Date ReviewedByApprovedBy1.0TomManleyInitialdraftforcustomersubmittal 12/31/14 TravisWenzelTomWolf—TomManley,SteveStackIncorporatedGECommentsfrom01/21/15,addedSIMactivationsection,addedwebinterfacesection,formattingandediting03/16/15 TravisWenzelTomWolf1.1MattSchellinAddedCertificationSection 4/20/2015 
GEAviationWDNU‐IIRevision:—,03/16/15A036–OperationsandUserManualDigiPartNumber:90001937©2015Etherios2of27TableofContents1OvervieworPurpose.......................................................................................................................................................52Scope................................................................................................................................................................................63ReferenceMaterial..........................................................................................................................................................73.1ReferenceDocuments.............................................................................................................................................73.2Acronyms,TermsandDefinitions...........................................................................................................................74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WDNU‐IIRFInterfaces..........................................................................................................................................124.4.1Wi‐FiConnection...............................................................................................................................................124.4.2GSMConnection...............................................................................................................................................125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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6DetailedWDNU‐II‐SpecificDescription.........................................................................................................................186.1CHIP.......................................................................................................................................................................186.1.1CHIPCommands................................................................................................................................................18
GEAviationWDNU‐IIRevision:—,03/16/15A036–OperationsandUserManualDigiPartNumber:90001937©2015Etherios3of276.1.2PythonandCHIP...............................................................................................................................................186.2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7Certifications..................................................................................................................................................................277.1FCC........................................................................................................................................................................277.1.1FCC‐ApprovedAntennas...................................................................................................................................277.2Canada(IC)............................................................................................................................................................277.2.1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ManualDigiPartNumber:90001937©2015Etherios4of27
GEAviationWDNU‐IIRevision:—,03/16/15A036–OperationsandUserManualDigiPartNumber:90001937©2015Etherios5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ManualDigiPartNumber:90001937©2015Etherios6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ManualDigiPartNumber:90001937©2015Etherios7of273 ReferenceMaterial3.1 ReferenceDocumentsCustomerDocumentIDDigiPartNumberDocumentFilenameRevisionDateSourceSOW1281NAStatementofWorkforWirelessDataNetworkUnit(WDNU‐II)WDNUIIStatementofWork_SOW1281_Revx2_20140527.pdfX212/4/13GEAviation‐‐ NAWDNU‐IISOW1281&TRS1255AmendmentsWDNUIIRevDSOW1281_TRS1255Amendments_20140527.pdf GEAviationTRS1255NATechnicalRequirementsSpecificationfortheWirelessDataNetworkUnit(WDNU‐II)TRS125522‐JAN‐2015.pdfTBD01/22/15GEAviationYV2818NAInterfaceProtocolSpecificationfortheCommandHandlerSupersetoftheWirelessDataNetworkUnitYV2818_Extended_Draft01‐.doc—01/27/15GEAviationSDRLA00790001451‐88InterfaceControlDocA007‐InterfaceControlDocument.docx—03/16/15EWDSSDRLA00850001885‐01‐PRTWDNU‐IIInstallationDrawing50001885‐01‐PRT,WDNU‐IIINSTALLATIONDRAWING,REV1P.PDF1P03/11/15EWDSSDRLA018NAWDNU‐IIBITDescriptionA018‐BITDescription.docx—03/16/15EWDSSDDNASoftwareDesignDocumentWDNU‐IISoftwareDesignDocument.docx—03/16/15EWDS3.2 Acronyms,TermsandDefinitionsAcronymsandTermsDefinitionACK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GeneralElectricGEAS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EngineersIMSI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ManualDigiPartNumber:90001937©2015Etherios8of27AcronymsandTermsDefinitionPSKPre‐sharedkeyRF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WirelessDataNetworkingUnitWDNU‐II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ManualDigiPartNumber:90001937©2015Etherios9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ManualDigiPartNumber:90001937©2015Etherios10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)o 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ManualDigiPartNumber:90001937©2015Etherios11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PinName1ChassisGround228VDCPowerIn1328VDCPowerIn2428VDCPowerReturn1528VDCPowerReturn26‐15NotConnected16USB_OTG_VBUS_SOM17USB_N18USB_P19USB_OTG_ID20‐21NotConnected22PowerOffDiscreteOut–O/G23PowerOnDiscreteIn24PowerOffDiscreteOut–28V/O25Shield/Ground26‐27NotConnected28RS‐232FORCEOFF29RS‐232In30RS‐232Out31RS‐232Common32NotConnected33‐36NotConnected37USBCommon38NotConnectedQ‐1EthernetRX‐A(+)Q‐2EthernetTX‐A(+)Q‐3EthernetRX‐B(‐)Q‐4EthernetTX‐B(‐)ThebackpaneloftheWDNU‐IIprovidesthefollowingconnectionpoints: WiFiAntennaConnector:TNCAmphenol122192(orequivalent)o 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ManualDigiPartNumber:90001937©2015Etherios12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SettingsBaudrate 115200Numberofdatabits 8ParityNoneNumberofstopbits 1Flowcontrol NoneAutomaticbaudratedetection NoThis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 SubminiatureversionA(SMA)Amphenol132176(orequivalent) Matingconnector:SMAAmphenol132178(orequivalent)
GEAviationWDNU‐IIRevision:—,03/16/15A036–OperationsandUserManualDigiPartNumber:90001937©2015Etherios13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ManualDigiPartNumber:90001937©2015Etherios14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ManualDigiPartNumber:90001937©2015Etherios15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ManualDigiPartNumber:90001937©2015Etherios16of27`Breakout Test Cable28 VDC 128 VDC 2ETHERNETWDNU ON*Variable DC SupplyVariable DC SupplyWDNUBulkhead Connector GSM AntennaWi-Fi AntennaSIM CARD 1RS-232USBSIM CARD 2WDNU OFF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ManualDigiPartNumber:90001937©2015Etherios17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ManualDigiPartNumber:90001937©2015Etherios18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ManualDigiPartNumber:90001937©2015Etherios19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Description/var/data/logs/bit.logInformationaboutthepower‐onandinitiatedBIT./var/data/logs/shell.logContainstheoutputofanysystemcommandscalledfromthePythonapplication(suchas‘ifconfigwlan0up’)./var/data/logs/wpad.logContainstheoutputfromthewpa_supplicantprocessasitisrunandcontrolledbythePythonapp./var/data/logs/mmd.logContainsinformationaboutthemodem_managerprocessasitisrunandcontrolledbythePythonapp./var/data/logs/pppd.logContainsinformationaboutthepppprocessasitisrunandcontrolledbythePythonapp./var/data/logs/access.logContainsinformationaboutusersthatloginviathroughanymeans(SSH,serial,web,etc.)./var/data/logs/startup.logContainsinformationabouttheapplicationstartupprocessincludingsettingsthatareoverriddenfromtheconfig‐fs.
GEAviationWDNU‐IIRevision:—,03/16/15A036–OperationsandUserManualDigiPartNumber:90001937©2015Etherios20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://<ip_addr>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UsernamePasswordAvailablePagesReadOnlywreadonlywreadonly SystemSummary NetworkStatusOperatorwoperatorwoperator CommandInterface Wi‐FiConfiguration CellularConfigurationAdministratorwadminwadmin SoftwareUpdates
GEAviationWDNU‐IIRevision:—,03/16/15A036–OperationsandUserManualDigiPartNumber:90001937©2015Etherios21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ManualDigiPartNumber:90001937©2015Etherios22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ManualDigiPartNumber:90001937©2015Etherios23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ManualDigiPartNumber:90001937©2015Etherios24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ManualDigiPartNumber:90001937©2015Etherios25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ManualDigiPartNumber:90001937©2015Etherios26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: ElectronicfilefromDigimanufacturing LabelaffixedtotheWDNU‐II Webinterface
GEAviationWDNU‐IIRevision:—,03/16/15A036–OperationsandUserManualDigiPartNumber:90001937©2015Etherios27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PartNumberTypePeakGainPeakSystemGain3dbiDASantenna;Radiationpattern–OmniHG72703MGURB‐NMMono‐pole3dBi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.

Navigation menu