JPTrain JPTrainBeta versie 25 mei 2015
Android client voor GBtrainHost Inhoud 1.
Benodigd voor JPTrain ........................................................................... 3
2.
Installatie JPTrain ................................................................................... 3 2.1
3.
Conversie van oude versie(s) .......................................................... 3
Eerste kennismaking met JPTrain .......................................................... 4 3.1
Opstarten JPTrain ........................................................................... 4
4.
Mogelijkheden met JPTrain .................................................................... 7
5.
Verbinden met GBtrainHost .................................................................... 9 5.1
Automatisch zoeken naar GBtrainHost ............................................ 9
5.2
Succesvolle verbinding ..................................................................11
5.3
Met een bepaalde host verbinden ...................................................11
5.4
Schakelen tussen twee GBtrainHost ..............................................12
5.5
GBtrainHost access code ..............................................................14
5.6
Andere opties bij verbinden............................................................14
5.6.1
Scantijd bij zoeken ..................................................................15
5.6.2
Poort nummer GBtrainHost ......................................................16
5.6.3
Naam ........................................................................................16
JPTrain V3.0.1.Beta
Mei 2015
Pagina 1 van 28
5.6.4
Automatisch verbinden ............................................................16
6 Aanmaken van locs ....................................................................................17 6.1
Aanmaken en beheren van Locs ....................................................17
6.2 Aanmaken nieuwe loc .........................................................................19 6.2.1
Functies voor de loc .................................................................23
6.2.2 Functies locs aanpassen ..............................................................23 6.2.3 Tekst van de toets aanpassen .....................................................25 6.2.4 Afbeelding gebruiken voor een functie ........................................26 6.2.5 Automatisch schakelen van een functie.......................................27 6.2.6 Set functie ...................................................................................28 6.2.7 Del toest ......................................................................................28
JPTrain V3.0.1.Beta
Mei 2015
Pagina 2 van 28
1. Benodigd voor JPTrain
Android 4.0.3 of hoger op een Smart Phone of Tablet met een scherm van minimaal 4” WiFi netwerk Een PC met GBtrainHost Treinaansturings computer Modelspoorbaan
2. Installatie JPTrain Om te installeren dient de Smart Phone of Tablet een internet verbinding te hebben, de download van het programma dient met Google Chrome of Firefox gedaan te worden. De Smart Phone of Tablet dient toestemming te hebben om te installeren van onbekende bronnen.
DIT IS DE BETA VERSIE: JPTrainBeta Het programma is te downloaden van: http://members.upc.nl/j.vanputten5/
2.1 Conversie van oude versie(s) Deze versie van JPTrain heeft een nieuwe data structuur. Er is een nieuwe loc en accessoire database. Het oude loc database bestand, locdb.txt is nu vervangen door jplocdb.txt. Bij de eerste keer opstarten van deze nieuwe versie van JPTrain wordt er onderzocht of er een versie van locdb.txt aanwezig is. Zo ja dan worden bepaalde gegevens geconverteerd naar de nieuwe versie:
Loc nummer Loc naam Loc afbeelding
Alle overige gegevens, waaronder functietoetsen definitie dienen opnieuw ingevuld te worden. Deze worden naar de standaard functietoetsen gezet. De accessoire database kan niet worden geconverteerd en moet opnieuw worden aangemaakt. Alle gegevens staan wel in dezelfde map. Deze versie kan verder gewoon naast de oude versie van JPTrain betaan
JPTrain V3.0.1.Beta
Mei 2015
Pagina 3 van 28
3. Eerste kennismaking met JPTrain Deze applicatie is voor bedienen van een Modelspoorbaan. Er kunnen zowel treinen als accessoires mee bediend worden met extra mogelijkheden. In dit eerste hoofdstuk wordt een korte kennismaking gedaan. Verderop in deze handleiding wordt dieper op alle mogelijkheden en instellingen van JPTrain gegaan. Voor het werken met JPTrain dient GBtrainHost te werken en moeten deze in hetzelfde WiFi netwerk functioneren. Voor het eerste gebruik dient met een trein te hebben met DCC id. 3. (ook wel loknummer genoemd) Installeer JPTrain conform de instructie in hoofdstuk 2
3.1 Opstarten JPTrain Nu kan JPTrain opgestart worden door gebruikmaking van de app:
Na het opstarten verschijnt het volgende scherm:
JPTrain V3.0.1.Beta
Mei 2015
Pagina 4 van 28
Om nu te verbinden met GBtrainHost, selecter:
Zodra de verbinding er is veranderd het scherm als volgt:
Om nu een loc te bedienen, ga naar de locbediening:
JPTrain V3.0.1.Beta
Mei 2015
Pagina 5 van 28
Het scherm gaat over naar de locbediening:
Om nu de loc met ID 3 te laten rijden:
Dit is alles om:
Verbinding te laten maken met GBtrainHost Loc met ID 3 te laten rijden
JPTrain V3.0.1.Beta
Mei 2015
Pagina 6 van 28
4. Mogelijkheden met JPTrain Binnen JPTrain zijn de volgende mogelijkheden
Gegevens kunnen op meerdere manieren worden beheerd: o Lokaal op de smart phone/tablet o Via een windows share, waarbij de smart phone/tablet dezelfde gegevens delen o De mogelijkheid om treinen, die binnen GBtrainHost bekend zijn, op de tablet te gaan gebruiken
Automatisch verbinden met GBtrainHost o Standaard wordt er nu gezocht naar de GBtrainHost en verbonden, er kan nog wel een specifiek nummer worden ingegeven.
Beheren en bedienen van treinen met de volgende mogelijkheden: o Trein ID 1 t/m 10239 o Trein kan een naam krijgen o Trein kan een afbeelding of foto krijgen o Trein selectie door middel van: Selectie uit lijst Door voorgeprogrammeerde toets (10 stuks) Een na laatst bediende trein opnieuw te bedienen o Lichtbediening o Trein reservering o Functie bediening van de trein Functienummer 1 t/m 10239 Functie aan/uit Functie automatisch uit na 1 of 3 seconden Functieknop met of nummer of tekst of afbeelding o Macro (set) functie, dit zijn meerdere functies die bediend worden door middel van een knop o Volledige trein editor
Beheren en bedienen van accessoires met de volgende mogelijkheden: o Accessoire ID 1 t/m 9999 o Totaal aantal te bedienen accessoires: 5 x 45 o Wisselbediening o Seinbediening o Ontkoppelrailbediening
JPTrain V3.0.1.Beta
Mei 2015
Pagina 7 van 28
o Wissel/Sein en ontkoppelrail ook omgedraaid (inverse) te bedienen o Automatisch uitlezen van railcontacten Optioneel met beep geluid of Optioneel met het voorlezen van het contact nummer o Mogelijk om onder een knop een Macro te maken om meerdere accessoires tegelijk te bedienen. o Volledige accessoires editor
Sporenplan grafische bediening o Het is ook mogelijk om een sporenplan grafisch te bedienen, deze functie is geheel gelijk aan het PC programma GBswitch, inclusief de daar gebruikte bestanden o Het grafische sporenplan geeft ook aan waar de treinen rijden indien het PC programma GBomatic wordt gebruikt o Er zijn twee schermen voor sporenplan bediening o Het totaal aantal sporenplannen, of stations (Zie GBswitch) binnen sporenplannen is onbeperkt.
Chat mogelijkheid o Gelijk en samenwerkend met de chat functie binnen het PC programma GBinfoPoint o Beep geluid mogelijk als er een bericht binnenkomt o Mogelijk om het bericht direct te laten voorlezen
Trein automatisch laten rijden o Trein automatisch laten rijden van een bepaalde plek naar een andere plek. Hiervoor wordt gebruik gemaakt van het bestand dat ook wordt gebruikt voor GBtrainOmatic met een paar kleine beperkingen.
Alle mogelijkheden worden in aparte hoofdstukken uitgelegd.
JPTrain V3.0.1.Beta
Mei 2015
Pagina 8 van 28
5. Verbinden met GBtrainHost JPTrain zoekt automatisch de GBtrainHost op, hiernaast kan ook met een bepaalde GBtrainHost worden verbonden, of geschakeld worden tussen twee verschillende GBtrainHost.
5.1 Automatisch zoeken naar GBtrainHost Voor het automatisch zoeken naar de host hoeft enkel maar op de knop verbinden te worden gedrukt:
Ga naar Setup: 1 Selecteer binnen Setup optie: 2 Klik op verbinden met GBtrainHost: 3 Bij 4 staat, na een succesvolle verbinding het IP nummer van GBtrainHost. Bij 5 staat de naam van de tablet, zoals deze verschijnt binnen GBtrainHost, deze naam is aanpasbaar, zie hiervoor paragraaf
Zodra op de knop zoeken host wordt gedrukt, gaat er gezocht worden naar de GBtrainHost. Eerst wordt er een poging gedaan om direct te verbinden met het laatst bekende IP nummer van de GBtrainHost, of het ingegeven nummer. Als er niet direct een verbinding kan worden gemaakt, gaat er naar een host worden gezocht. Het volgende sc herm verschijnt:
JPTrain V3.0.1.Beta
Mei 2015
Pagina 9 van 28
1 = Het zoekbereik waarbinnen gezocht gaat worden naar de GBtrainHost. Hier is een voorbeeld gegeven, deze waarden zijn afhankelijk uw netwerk. 2 = De voortgang van het zoeken, zodra de GBtrainHost is gevonden wordt het zoeken stopgezet en verbonden met de GBtrainHost 3 = Het zoeken naar de host kan worden onderbroken met Zoeken onderbreken Indien er een succesvolle verbinding met GBtrainHost wordt opgebouwd
JPTrain V3.0.1.Beta
Mei 2015
Pagina 10 van 28
5.2 Succesvolle verbinding Indien de verbinding met GBtrainHost succesvol kan worden opgebouwd, verandert het icoon van verbinden en wordt het client nummer weergegeven, zoals dit bekend is binnen GBtrainHost:
5.3 Met een bepaalde host verbinden Soms is het wenselijk om alleen naar een bepaalde host te verbinden. Volg de stappen hieronder:
Het volgende invulscherm verschijnt:
JPTrain V3.0.1.Beta
Mei 2015
Pagina 11 van 28
Vul bij 1 het ip nummer van de GBtrainHost waarmee verbonden met worden gevolgd door een “#” Als voorbeeld:
192.168.11.7#
Alleen met deze host wordt verbonden, er wordt niet gezocht naar een andere GBtrainHost. Hierna op 2 drukken om te verbinden. Deze knop heeft exact dezelfde functie als in het eerdere scherm.
5.4 Schakelen tussen twee GBtrainHost Soms komt het voor dat er snel geschakeld moet worden tussen twee verschillende GBtrainHost in hetzelfde netwerk. Ga naar het scherm voor het invullen van de ipnummers:
Vul dit als volgt in:
Vul de beide ipnummers van de GBtrainHosts, gescheiden door een “;”, in, in dit voorbeeld: “192.168.11.7;192.168.11.23”
JPTrain V3.0.1.Beta
Mei 2015
Pagina 12 van 28
Let op, beide GBtrainHost moeten in hetzelfde netwerk zijn! Verlaat het scherm door de exit knop (2) en niet door nu te verbinden:
Door nu op (1) te drukken wordt er verbonden met het eerste ipnummer, bij (2) met het tweede ipnummer. Er worden automatisch bij de ipnummers “#” geplaatst. Deze niet zelf toevoegen. Het wordt gedaan omdat er alleen maar met deze GBtrainHosts verbonden mag worden. LET OP ! Indien de GBtrainHost gebruikt maakt van een access code, dient deze voor beide GBtrainHost gelijk te zijn, of ze dienen allebei geen access code te hebben.
JPTrain V3.0.1.Beta
Mei 2015
Pagina 13 van 28
5.5 GBtrainHost access code Het kan zijn dat GBtrainHost is beveiligd met een access code. Zodra JPTrain een verbinding opbouwt met GBtrainHost en deze heeft een access code, zal er worden gevraagd naar de access code. Het scherm voor de access code komt automatisch naar voren:
Vul hier de Access Code in. Indien er al een Access Code is ingevuld en deze komt overeen met de gevraagde code, dan zal direct worden verbonden met de GBtrainHost.
5.6 Andere opties bij verbinden Ga naar het scherm voor het invullen van de opties
JPTrain V3.0.1.Beta
Mei 2015
Pagina 14 van 28
Nu kan in het volgende scherm worden ingevuld:
1 = IPnummer host, zie hiervoor eerder het hoofdstuk 2 = Scantijd bij het automatisch zoeken naar hosts 3 = Port nummer GBtrainHost 4 = Naam 5 = Indien aangevinkt automatisch verbinden bij opstarten JPTrain
5.6.1 Scantijd bij zoeken Als er automatisch gezocht wordt naar een GBtrainHost (indien niet met een “#” gewerkt wordt), wordt hier ingegeven hoelang er gedaan mag worden over een poging tot het verbinden met een bepaald nummer. De opgegeven tijd is in milliseconden. Aan de hand van een voorbeeld uitleg. Zoals hier aangegeven is het IPnummer 192.168.7.13 Het zoeken zal dan gaan over de nummers: 192.168.7.1 t/m 192.168.7.254. Er gaat dan een teller lopen van 1 t/m 254 en bij elk nummer zal een poging worden gedaan tot verbinding. Zodra er een GBtrainHost is gevonden zal het stoppen zoeken en verbonden worden met deze GBtrainHost De scantijd is de tijd per nummer (van de 1 t/m 254) dat er een poging wordt gedaan om te verbinden. Bij kortere tijd zal de scan sneller gaan, maar een succesvolle verbinding kan moeilijker tot stand worden gebracht, een langere tijd is er meer kans op succes. Een waarde van 100 (milliseconden) volstaat in de meeste gevallen. Altijd wordt er eerst een poging gedaan om het laatst bekende ipnummer te gebruiken voor de verbinding. Er kan maximaal naar 254 nummers gezocht worden. Heeft het netwerk op dit punt een aparte configuratie dan dient er met een vast ipnummer te worden gewerkt,
JPTrain V3.0.1.Beta
Mei 2015
Pagina 15 van 28
5.6.2 Poort nummer GBtrainHost GBtrainHost werkt met een poort nummer. Het standaard poort nummer is 1001. Indien binnen GBtrainHost een ander poort nummer is gedefineeerd dient dit hier te worden aangepast. Bij het gebruik van twee GBtrainHosts dienen bij allebei hetzelfde poortnummer gebruikt te worden.
5.6.3 Naam Hier kan de naam worden ingegeven, deze wordt ook weergegeven binnen GBtrainHost. Het is handig, voor herkenning, om hier een duidelijke naam te gebruiken. Gebruik bijvoorbeeld hier uw eigen naam.
5.6.4 Automatisch verbinden Als deze functie is aangevinkt, wordt er bij het starten van JPTrain gelijk verbinding gemaakt met de GBtrainHost, zonder interactie van de gebruiker. Deze functie wordt automatisch uitgeschakeld bij het gebruik van twee GBtrainHosts en is dan dus niet beschikbaar.
JPTrain V3.0.1.Beta
Mei 2015
Pagina 16 van 28
6 Aanmaken van locs Hier wordt het aanmaken van locs uitgebreid behandeld. Het is niet noodzakelijk om een verbinding te hebben met GBtrainHost
6.1 Aanmaken en beheren van Locs Er is een volledige grafische editor voor het beheren en aanmaken van treinen. Deze kan op de volgende manier worden gestart:
Start de setup door middel van: 1 Ga naar de editor door: 2 Het scherm wordt als volgt:
JPTrain V3.0.1.Beta
Mei 2015
Pagina 17 van 28
1 = Aanmaken nieuwe loc 2 = Kopiëren geselecteerde loc naar nieuwe loc 3 = Functie Set editor, wordt apart behandeld 4 = Geselecteerde loc verwijderen 5 = Ongedaan maken van alle wijzigingen 6 = Alles opslaan
7 = Selectie loc 8 = Naam van de loc 9 = Afbeelding selectie voor de loc
10 = Functies een scherm terug 11 = Functies een regel terug 12 = Functies een regel vooruit 13 = Functies een scherm vooruit
JPTrain V3.0.1.Beta
Mei 2015
Pagina 18 van 28
14 = Toetsnummer van de locbediening 15 = Werkelijke functienummer van de locdecoder van de trein 16 = Tekst van de toets van de locbediening (icoon staat op X) 17 = Afbeelding voor de toets van de locbediening, tekst(16) is niet meer zichtbaar 18 = Automatisch uitzetten van de locfunctie na bepaalde tijd 19 Set (verzameling van functies) Bij actief verdwijnen 15 t/m18
6.2 Aanmaken nieuwe loc Voor het toevoegen van een nieuwe loc, op de + drukken:
Gelijk verschijnt het invulscherm voor de nieuwe loc:
JPTrain V3.0.1.Beta
Mei 2015
Pagina 19 van 28
Hier vullen we de loc ID bij (1) in. Deze ID is gelijk aan het locnummer van de decoder (Het DCC nummer). Dit is een verplicht veld en kan naderhand niet worden gewijzigd. Er mag ook een loc naam worden ingevuld bij (2) is niet verplicht. Dit is ook naderhand aan te passen. En er kan aangegeven worden bij (3) hoeveel functies de loc standaard heeft. Dit is ook naderhand aan te passen. En druk OK De basis van de loc wordt nu aangemaakt met de volgende gegevens: Loc ID: in dit voorbeeld 55, voor nieuwe locs is deze tekst groen. Loc functies: 1 t/m 16 Loc teksten voor de functies: 1 t/m 16 Geen loc naam Geen loc afbeelding Deze gegevens zijn al voldoende om een loc te kunnen bedienen.
JPTrain V3.0.1.Beta
Mei 2015
Pagina 20 van 28
Door nu op de
te drukken wordt de loc opgeslagen en is te bedienen:
Het is belangrijk om te weten dat alle locs en gegevens worden opgeslagen, niet alleen de loc die nu nieuw is toegevoegd. Het nieuwe loc nummer veranderd van groen naar zwart en is nu gelijk te bedienen in het scherm van de loc bediening. Qua bediening ziet deze loc er nu als volgt uit:
De loc kan een naam worden gegeven in het veld achter het nummer:
JPTrain V3.0.1.Beta
Mei 2015
Pagina 21 van 28
Een loc kan ook een afbeelding/foto krijgen, dit wordt behandeld in hoofdstuk: X.X
JPTrain V3.0.1.Beta
Mei 2015
Pagina 22 van 28
6.2.1 Functies voor de loc Standaard is het aantal toetsen en functies bij een loc 16. Deze definities kunnen worden doorlopen met :
10 = Functies een scherm terug, is 6 regels 11 = Functies een regel terug 12 = Functies een regel vooruit 13 = Functies een scherm vooruit, is 6 regels Als er verder vooruit wordt gegaan, verschijnen de nummers boven de 16:
Boven de 16 zijn de velden niet ingevuld. Bij het opslaan van een loc worden alle regels opgeslagen, tot en met de laatste regel, die ingevuld is. Het aantal toetsen heeft geen beperking.
6.2.2 Functies locs aanpassen Bij normale loc bediening is de toets van de functie gelijk aan de interne functie in de loc. Met andere woorden, toets 1 bediend functie 1, toets 2 functie 2 enz. Toets 1 t/m 16 zijn vooraf ingevuld met functie 1 t/m 16 en de tekst, die in de toets verschijnt, ook met 1 t/m 16. Binnen het aanmaken van een loc is het mogelijk om dit aan te passen
JPTrain V3.0.1.Beta
Mei 2015
Pagina 23 van 28
Standaard ziet het scherm er zo uit:
Dit kan aangepast worden naar het gewenste functienummer bij de toets.
Nu wordt door toets 1 functie 13 in de loc bediend en door toets 2 functie 9 Het functienummer kan maximaal 10239 zijn. Er is geen controle of functienummers meerdere keren voorkomen. Regels diegeen functie hebben (lege regels), hier toets 2:
Krijgen geen toets bij de loc bediening:
Belangrijk ! Let er wel op dat alle apparatuur de functie nummers aankunnen, sommige hebben op dit punt een beperking. Overtuig u ervan dat het mogelijk is.
JPTrain V3.0.1.Beta
Mei 2015
Pagina 24 van 28
6.2.3 Tekst van de toets aanpassen De tekst van een toets kan aangepast worden:
In de bediening wordt dit:
JPTrain V3.0.1.Beta
Mei 2015
Pagina 25 van 28
6.2.4 Afbeelding gebruiken voor een functie In plaats van tekst is het ook mogelijk om een afbeelding (icoon) te gebruiken Hier een lijst van alle icoontjes:
Door in de regel op het veld van de Icoon de drukken , verschijnt de lijst waaruit gekozen kan worden:
JPTrain V3.0.1.Beta
Mei 2015
Pagina 26 van 28
Er kan door de lijst heen gescrolled worden. Als er een icoon wordt gekozen, verschijnt deze in de regel van de toets. Het veld met de tekst van de functie verdwijnt:
Indien er geen icoon wordt gewenst, dient het icoon met het rode kruis te worden geselecteerd:
Het tekstveld zal dan weer gebruikt kunnen worden.
6.2.5 Automatisch schakelen van een functie Het is mogelijk om een bepaalde functie na 1 seconde of 3 seconde weer automatisch uit te laten zetten. Dit kan bereikt worden door op de functie regel in het veld Auto te klikken De keuze is:
Zowel het aan signaal als het uit signaal wordt naar de GBtrainHost gezonden Bij de loc bediening verschijnt in de toets linksboven een aanduiding met 1 of 3
JPTrain V3.0.1.Beta
Mei 2015
Pagina 27 van 28
6.2.6 Set functie Onder een toets kan een verzameling van commando’s worden gezet. Het aanmaken van een Set wordt in hoofdstuk 6.3 behandeld. Door op de set te drukken veranderd de functie regel in:
In het Tekst veld kan nu het gewenste set worden geselecteerd. Hier een voorbeeld van een lijst van sets:
De loc bediening wordt :
6.2.7 Del toest Deze toets maakt heel de regel van de functie leeg.
JPTrain V3.0.1.Beta
Mei 2015
Pagina 28 van 28