Installatie & Configuratiehandleiding. Socket Server. OpenAT applicatie

Transcriptie

1 Installatie & Configuratiehandleiding Socket Server OpenAT applicatie

2 2009 / 05 / 29 2

3 ! OPGEPAST! GEVAAR VOOR ELECTRISCHE SCHOKKEN BIJ VERWIJDERING BESCHERMEND DEKSEL VAN INDUBOX GSM IV ONDERHOUD ENKEL VOORBEHOUDEN AAN GEKWALIFICEERD TECHNISCH PERSONEEL 2009 / 05 / 29 3

4 Geschiedenis van het document Date Version Auteur 29/05/2009 V1.0 Preliminair Filip Lavaerts Creatie 10/06/2009 Vertaling Nl Dominiek Truyers Vertaling Nederlands 2009 / 05 / 29 4

5 2009 / 05 / 29 5

6 Inhoudsopgave 1. Inleiding 8 2. Algemene beschrijving 9 3. Basis Setup 9 4. Verschillende modes CSD mode 4.2 GPRS mode 4.3 SCKserv mode 5. Hoe switchen tussen de 3 modes switchen naar GPRS mode 5.2 switchen naar SCKserv mode 5.3 switchen naar CSD mode 6. DOTA upgrade (optioneel) / 05 / 29 6

7 Seriële flow zoals voorzien in deze handleiding : DTE Data Terminal Equipment TxD RxD DTR DSR RTS CTS RI DCD GND IN OUT DCE Data Communication Equipment PC POS PLC Applicatie Modem InduBox GSM IV Communicatie device 2009 / 05 / 29 7

8 1. Inleiding Deze handleiding is de referentiehandleiding voor de configuratie van de Socket Server OpenAT(*) applicatie in de InduBox GSM IV of DinBox GSM/GPRS. De applicatie werd gecreëerd voor de DinBox GSM/GPRS en de InduBox GSM IV modems van Bausch Datacom. Beide modems werden geconcipieerd rond een Sierra Wireless (Wavecom) Q24Plus GSM/GPRS modem module. Dankzij deze Socket Server applicatie, geschreven in OpenAT(*), wordt het mogelijk van een toestel dat niet IP enabled is (niet beschikt over een eigen TCP/IP stack) te verbinden met een DinBox of InduBox modem en toegankelijk te maken via een GPRSlink. (*) OpenAT is een handelsmerk van Sierra Wireless (Wavecom) 2009 / 05 / 29 8

9 2. Algemene beschrijving Datacommunicatie over CSD - Circuit Switched Data - met een GSM-modem verloopt op dezelfde wijze als datacommunicatie met een standard PSTN-modem over een POTS - Plain Old Telephone System lijn. In CSD antwoordmode (autoanswer actief via s0=1), zal de DinBox of Indubox modem een ongevraagd antwoord CONNECT 9600 sturen van zodra een successvolle verbinding werd tot stand gebracht met een opbellende originating - modem. Wanneer de opbellende - remote modem de verbinding verbreekt, zal het antwoord NO CARRIER worden gestuurd door de modem die in autoanswer staat. In het geval van GPRS is de situatie totaal verschillend. In dat geval worden data verstuurd over het TCP/IP-protocol wat wil zeggen dat alle data in pakketten worden verzonden en gerouteerd worden over een IP packet switched netwerk. Dankzij de Socket Server applicatie in OpenAT zal er een CSD antwoordmode gesimuleerd worden tussen de modem en de applicatie (bijv. elektriciteitsteller) terwijl de eigenlijke communicatie over een GPRS-link verloopt. Van zodra de applicatie in OpenAT opgestart wordt in SCKserv mode, zal er automatisch een GPRS/APN-connectie worden opgebouwd en onderhouden. Na een succesvolle GPRS/APN-connectie zal de DinBox of InduBox modem deel gaan uitmaken van een IP-netwerk (Internet of Intranet) en een IP-nummer krijgen. De geïmplementeerde OpenAT applicatie zal een TCP socket server (listener) dienst opstarten en gaan luisteren ter hoogte van een vooraf gedefinieerde POORT. Van zodra een verwijderde TCP client een verbinding gaat opbouwen met de DinBox of InduBox modem, zal het ongevraagde antwoord CONNECT 9600 worden gestuurd. Wanneer de TCP client de verbinding verbreekt, zal het antwoord NO CARRIER worden gestuurd naar de applicatie (bijv. elektriciteitsteller). Meer informatie volgt hierna over de verschillende modes en de wijze waarop er kan geswitcht worden van de ene mode naar de andere. 3. Basis Setup Wanneer de DinBox of InduBox modem in SCKSERV mode staat en dus gebruik maakt van de Socket Server applicatie in OpenAT, kan de seriële poort van de modem enkel met de volgende parameters geconfigureerd worden : Snelheid : 9600 bps Asynchroon formaat: 8N1 Flow controle : geen (geen RTS nodig vanwege de DTE) V.24 DTR-signaal : geen (geen DTR nodig vanwege de DTE) In basis is enkel het RXD-, TXD- en GND-signaal nodig om gebruik te kunnen maken van de OpenAT applicatie / 05 / 29 9

10 Er kan gebruik gemaakt worden van de geïsoleerde 3-draads RS-232 en 2-draads RS- 485 interfaces van de InduBox GSM IV modem. 4. Verschillende modes De Socket Server applicatie in OpenAT maakt gebruik van drie verschillende werkingsmodes: 4.1 CSD mode In CSD antwoordmode (autoanswer actief via s0=1), zal de DinBox of Indubox modem zich gedragen zoals een normale standaard GSM CSD data modem. Van zodra een remote modem inbelt, zal de modem die in autoanswer staat een ongevraagd antwoord CONNECT 9600 sturen naar de applicatie (bijv. elektriciteitsteller). Wanneer de opbellende - remote modem de verbinding verbreekt, zal het antwoord NO CARRIER worden gestuurd door de modem die in autoanswer staat. Gedurende CSD data mode is de modem voor 100% transparant. Gedurende idle state mode de modem is niet aan het communiceren kan de modem een SMS-bericht ontvangen en de inhoud van het bericht checken. Meer informatie over de inhoud van het SMS-bericht volgt hierna. 4.2 GPRS mode De modem heeft dezelfde functionaliteit als in CSD mode, zoals hierboven beschreven, maar de modem heeft ook APN GPRS-parameters ontvangen via een SMS-bericht. APN server name, username, paswoord en DNS werden ingegeven, maar er is geen GPRS attachment of APN-connectie. Deze mode werd geïmplementeerd om een DOTA (Download Over The Air) upgrade mogelijk te maken via een FTP-host. Deze functionaliteit wordt hierna beschreven. Gedurende idle state mode de modem is niet aan het communiceren kan de modem een SMS-bericht ontvangen en de inhoud van het bericht checken. Meer informatie over de inhoud van het SMS-bericht volgt hierna. 4.3 SCKserv mode Van zodra de applicatie in OpenAT opgestart wordt in SCKserv mode, zal er in deze mode automatisch een GPRS/APN-connectie worden opgebouwd en onderhouden en zal er een TCP socket server (listener) dienst worden opgestart wat betekent dat de modem automatisch gaat luisteren ter hoogte van een vooraf gedefinieerde POORT De APN-connectie en de SCKserv mode zullen op regelmatige basis (om de 60 seconden) gecontroleerd worden zodat de modem altijd klaar staat voor een verwijderde TCP socket client die een verbinding wenst op te bouwen / 05 / 29 10

11 Van zodra een verwijderde TCP client een verbinding gaat opbouwen met de DinBox of InduBox modem, zal het ongevraagde antwoord CONNECT 9600 worden gestuurd. Wanneer de TCP client de verbinding verbreekt, zal het antwoord NO CARRIER worden gestuurd naar de applicatie (bijv. elektriciteitsteller). Tijdens deze geëmuleerde data mode tussen de applicatie (bijv. elektriciteitsteller) en de modem, is de modem 100% transparant. De data worden dan verder in de modem in TCP/IP pakketten ingepakt en over GPRS verzonden. Gedurende idle state mode de modem is niet aan het communiceren kan de modem een SMS-bericht ontvangen en de inhoud van het bericht checken. Meer informatie over de inhoud van het SMS-bericht volgt hierna. 5. Hoe switchen tussen de 3 modes Het switchen tussen de verschillende modes (zie beschrijving van de modes hierboven) gebeurt door het verzenden van SMS-berichten in tekstvorm. Opmerking: Elke lijn dient te worden afgesloten met een <CR><LF>. Elk karakter is gevoelig voor kleine- of hoofdletters. Default wordt CSD mode geselecteerd. Er worden geen GPRS-parameters gesaved. 5.1 Switchen naar GPRS mode Er moet een SMS met onderstaande inhoud worden gestuurd naar de modem; InduBox startup.ini Link : GPRS APN : proximus.internet.be APNUN : username APNPW : password DNS1 : DNS2 : End Wanneer de modem een SMS bericht ontvangt zoals hierboven beschreven, zal deze de ontvangen parameters saven, herstarten en zich in GPRS mode zetten. Zoals hierboven beschreven, zal deze mode op dezelfde wijze functioneren als CSD mode met dat verschil dat nu alle APN-parameters bekend zijn en voorgeprogrammeerd staan. Deze modem werd in het leven geroepen om een FTP upgrade mogelijk te maken zoals beschreven in het volgende hoofdstuk. 5.2 Switchen naar SCKserv mode Er moet een SMS met onderstaande inhoud worden gestuurd naar de modem; InduBox startup.ini 2009 / 05 / 29 11

12 Link : SCKserv APN : proximus.internet.be APNUN : username APNPW : password DNS1 : DNS2 : Port : 404 End Wanneer de modem een SMS-bericht ontvangt zoals hierboven beschreven, zal deze de ontvangen parameters saven, herstarten en zich in SCKserv mode zetten Na de GSM-registratie zal de modem automatisch een verbinding opbouwen met het GPRSnetwerk en de APN. Het ontvangen IP-adres zal naar de seriële poort worden gezonden als een ongevraagd antwoord en de socket server dienst zal automatisch worden opgestart. 5.3 Switch naar CSD mode Er kan altijd worden terug gegaan naar de default CSD mode door het sturen van onderstaand SMS-bericht naar de modem; InduBox startup.ini Link : CSD End Wanneer de modem een SMS bericht ontvangt zoals hierboven beschreven, zal deze de ontvangen parameters saven, herstarten en zich in SCD mode zetten 6. DOTA upgrade (optioneel) Een DOTA upgrade geschiedt via FTP. Er moet een SMS met onderstaande inhoud worden gestuurd naar de modem; InduBox FTP upgreade FTP : :21 User : username Pwd : password File : filename.ext Size : End Na ontvangst van de SMS zal de modem proberen een verbinding op te bouwen met een poort van de FTP-server: Wanneer de modem staat in: CSD mode: er gebeurt niets (geen GPRS-parameters) GPRS mode: de modem zal overgaan tot een GPRS attachment en een APNverbinding opzetten, 2009 / 05 / 29 12

13 SCKserv mode: socket listen dienst wordt stopgezet, de modem was reeds verbonden met het GPRS-netwerk en een APN, Na het downloaden van de file vanaf de FTP-server, zal de lengte van de file worden geverifieerd. Indien niet gelijk Het upgrade proces wordt stopgezet en de modem zal herstarten alsof er niets is gebeurd. Indien gelijk De nieuwe applicatie in OpenAT wordt opgeladen en de modem zal herstart worden / 05 / 29 13