Installatie & Configuratiehandleiding
Socket Server OpenAT applicatie
Bausch Datacom – Socket Server OpenAT applicatie – referentiehandleiding – V1.0
2009 / 05 / 29
2
SCK Server V1.0 EN
Bausch Datacom – Socket Server OpenAT applicatie – referentiehandleiding – V1.0
! OPGEPAST ! GEVAAR VOOR ELECTRISCHE SCHOKKEN BIJ VERWIJDERING BESCHERMEND DEKSEL VAN INDUBOX GSM IV ONDERHOUD ENKEL VOORBEHOUDEN AAN GEKWALIFICEERD TECHNISCH PERSONEEL
2009 / 05 / 29
3
SCK Server V1.0 EN
Bausch Datacom – Socket Server OpenAT applicatie – referentiehandleiding – V1.0
Geschiedenis van het document Date Version 29/05/2009 V1.0 Preliminair 10/06/2009 Vertaling Nl
2009 / 05 / 29
Auteur Filip Lavaerts Dominiek Truyers
4
Creatie Vertaling Nederlands
SCK Server V1.0 EN
Bausch Datacom – Socket Server OpenAT applicatie – referentiehandleiding – V1.0
2009 / 05 / 29
5
SCK Server V1.0 EN
Bausch Datacom – Socket Server OpenAT applicatie – referentiehandleiding – V1.0
Inhoudsopgave
1.
Inleiding
8
2.
Algemene beschrijving
9
3.
Basis Setup
9
4.
Verschillende modes 4.1 CSD mode 4.2 GPRS mode 4.3 SCKserv mode
10
5.
Hoe switchen tussen de 3 modes 5.1 switchen naar GPRS mode 5.2 switchen naar SCKserv mode 5.3 switchen naar CSD mode
11
6.
DOTA upgrade (optioneel)
12
2009 / 05 / 29
6
SCK Server V1.0 EN
Bausch Datacom – Socket Server OpenAT applicatie – referentiehandleiding – V1.0
Seriële flow zoals voorzien in deze handleiding :
DTE
Data Terminal Equipment
DCE TxD RxD DTR DSR RTS CTS RI DCD GND
IN OUT
Data Communication Equipment
PC POS PLC
Modem InduBox GSM IV
Applicatie
Communicatie device
2009 / 05 / 29
7
SCK Server V1.0 EN
Bausch Datacom – Socket Server OpenAT applicatie – referentiehandleiding – V1.0
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
SCK Server V1.0 EN
Bausch Datacom – Socket Server OpenAT applicatie – referentiehandleiding – V1.0
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 : Asynchroon formaat: Flow controle : V.24 DTR-signaal :
9600 bps 8N1 geen (geen RTS nodig vanwege de DTE) 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. 2009 / 05 / 29
9
SCK Server V1.0 EN
Bausch Datacom – Socket Server OpenAT applicatie – referentiehandleiding – V1.0
Er kan gebruik gemaakt worden van de geïsoleerde 3-draads RS-232 en 2-draads RS485 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..
2009 / 05 / 29
10
SCK Server V1.0 EN
Bausch Datacom – Socket Server OpenAT applicatie – referentiehandleiding – V1.0
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 . • 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
SCK Server V1.0 EN
Bausch Datacom – Socket Server OpenAT applicatie – referentiehandleiding – V1.0
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 : 213.219.182.110:21 User : username Pwd : password File : filename.ext Size : 15124 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
SCK Server V1.0 EN
Bausch Datacom – Socket Server OpenAT applicatie – referentiehandleiding – V1.0
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.
2009 / 05 / 29
13
SCK Server V1.0 EN