Opdrachtenset voor de High Speed Interface-88-USB (HSI-88-USB) (vanaf firmware 0.71) (Versie 1.2)

Transcriptie

1 Korte beschrijving: Opdrachtenset voor de High Speed Interface-88-USB (HSI-88-USB) (vanaf firmware 0.71) (Versie 1.2) Bij de HSI-88-USB gaat het om een Interface van de s88-terugmeldbus naar de Universal Serial Bus (USB) van de PC. Daarbij beschikt de Interface over drie s88-busstekkers. Dit biedt als voordeel een snellere busverwerking en de mogelijkheid, om drie buslijnen op de modelbaan te vormen. De drie stekkers worden als linker, midden en rechter busstekker aangeduid. Er kunnen maximaal 31*16 terugmeldcontacten worden bewaakt. Per buslijn maximaal 31*16, echter in totaal kunnen niet meer als 31*16 contacten worden ingelezen. Daarbij worden telkens 16 terugmeldingangen naar een module samengevat. De module met het nummer 1 is de eerste module aan de linker buslijn. Deze wordt t/m de laatste aangemelde module aan de linker buslijn oplopend geteld. Dan gaat het verder met de eerste module aan de buslijn in het midden. De module met het hoogste modulenummer, is de laatste module aan de rechterbuslijn. De HSI-88-USB is voorzien van een USB 1.1/2.0 full-speed aansluiting. Installatie: De HSI-88-USB wordt na het aansluiten op een vrije USB-aansluiting automatisch door het systeem herkend. Bij de HSI-88-USB gaat het om een gecombineerd apparaat (HSI-88-USB en DiCoStation). Daarom worden er achtereenvolgens twee USB-apparaten herkend. Allereerst de DiCoStation-USB, dan de HSI-88-USB. De beide apparaat-stuurprogramma s moeten altijd worden geïnstalleerd. Met iedere HSI-88-USB wordt een CD met stuurprogramma s meegeleverd. Momenteel worden de volgende besturingssystemen ondersteund: - Windows 10 (32- en 64-Bit) - Windows 8 (32- en 64-Bit) - Windows 7 (32- en 64-Bit) - Windows Vista (32- en 64-Bit) - Windows XP - Windows 2K - Windows ME - Windows 98 Anschrift Telefon Bankverbindung - 1 -

2 Opbouw van de communicatieverbinding: De verbinding met het apparaat wordt als een bestand geopend. Daarmee zou communicatie mbv. alle gangbare programmeertalen mogelijk moeten zijn. Eea. werd getest mbv. Microsoft C++ en Java. Net als bij de seriële COM-poort, zijn er speciale apparaatnamen. Deze heet echter niet COM1 maar \\.\HsiUsb1. Aan de beide backslashes, de punt en de derde backslash wordt de naam als apparaatnaam herkend. HsiUsb heet de apparaatdriver en 1 is het apparaatnummer. Het lezen en schrijven vindt plaats over die gebruikelijke bestandsfuncties. Er wordt zowel een synchrone als ook een asynchrone overdracht ondersteund. Worden via USB meerdere HSI-88-USB s aangesloten, dan worden deze door het apparaatstuurprogramma doorgenummerd. De eerst aangesloten HSI-88-USB krijgt nummer 1. De tweede nummer 2 en zo verder. De HSI-88-USB merkt deze nummers ook op na het uitschakelen. Wordt bijvoorbeeld later alleen apparaat 2 aangesloten dan zal deze onder de naam \\.\HsiUsb2 bereikbaar zijn, ook als apparaat 1 nu niet aangesloten is. Daarmee wordt zekergesteld, dat altijd eenduidig vaststaat welke concrete HSI-88-USB aangesproken wordt. Het wordt overgelaten aan de ontwikkelaar van de modelbaansoftware of hij gelijktijdig meerdere HSI-88-USB s wil ondersteunen. Het hoogste theoretische apparaatnummer is 255. Servicetool: Het apparaatnummer van de HSI-88-USB kan achteraf met de servicetool DiCoStation HSI- 88.exe worden gewijzigd. De servicetool bevindt zich eveneens op de CD, die met iedere HSI- 88-USB wordt meegeleverd en biedt de volgende mogelijkheden: - Apparaatnummer van een HSI-88-USB of een DiCoStation wijzigen. - Info-gebied over firmware- en driverversies. - Update-gebied met de mogelijkheid, HSI-88-USB en DiCoStation van nieuwe firmware te voorzien. - HSI-88 Terminal, waarmee met behulp van de in deze handleiding beschreven opdrachtenset direct met de HSI-88-USB gecommuniceerd kan worden. Anschrift Telefon Bankverbindung - 2 -

3 Verschillen t.o.v. de seriële versie: De opdrachtenset komt overeen met de seriële versie, dus de HSI-88 voor de RS232 COMpoort. Daardoor zou een adaptie van de HSI-88-USB eenvoudig mogelijk moeten zijn. Verschillend zijn slechts de volgende punten: - Andere apparaatnamen (zie hierboven) - De opdracht v geeft een variabele lengte terug. Hier wordt aanbevolen, tekens afzonderlijk af te vragen totdat wordt verkregen. Als maximale lengte is 255 gedefinieërd. Opdrachtstructuur: Er worden opdrachten en gegevens overgedragen. Het laatste teken van elke opdracht is Carriage Return. Als de TerminalMode is uitgeschakeld, worden voor-tekenloze hexbytes overgedragen (een waarde overeenkomstig een byte). Is de TerminalMode ingeschakeld, dan zijn dit ASCIItekens (een waarde = twee bytes), die als hexadecimaalwaarde worden overgedragen. TerminalMode: Opdrachtsvorm: t Opdrachtlengte: 2 bytes Antwoord: t <een ( 1 ) of uit ( 0 )> Antw. lengte: 3 bytes Na de start is de TerminalMode uitgeschakeld. Met t kan deze worden ingeschakeld, om bij wijze van voorbeeld met behulp van de servicetool DiCoStation HSI-88-USB.exe over toetsenbord en beeldscherm met de HSI-88-USB te communiceren. Anschrift Telefon Bankverbindung - 3 -

4 Initialiseren / terugmeldmodules aanmelden: Opdrachtvorm: s <Aantal modules links> <Aantal modules midden> <Aantal modules rechts> Wordt het maximaal toegestane modulegetal van 31 overschreden, dan wordt als standaardwaarde (2 modules per buslijn) ingesteld. Opdrachtlengte: TerminalMode uit: 5 bytes TerminalMode aan: 8 bytes 1 e Antwoord: s <Totaal aantal aangemelde modules> Tussen het 1 e en het 2 e antwoord worden de ingangstoestanden van de aangemelde modules ingelezen. 2 e Antwoord: i <Aantal modules, die gemeld werden> Antwoortlengte: TerminalMode uit: (6 + (aantal modules) * 3) bytes TerminalMode aan: (8 + (aantal modules) * 6) bytes Bij het 2 e antwoord wordt de inhoud van alle aangemelde modules overgedragen. Over de s -opdracht kan gedurende de loop van het programma het moduleaantal dynamisch worden gewijzigd. Na het inschakelen van de Interface, worden veranderingen aan de ingangen van de terugmeldmodules (over i ) pas vanaf de eerste s -opdracht gemeld. Anschrift Telefon Bankverbindung - 4 -

5 HSI-88-USB meldt verandering(en): Antwoord: i <Aantal modules, die gemeld worden> Antwoortlengte: TerminalMode uit: (3 + (aantal modules) * 3) bytes TerminalMode aan: (4 + (aantal modules) * 6) bytes Alleen de inhoud van die modules wordt overgedragen, aan wie zich ingangstoetstanden hebben veranderd. PC vraagt ingangstoestanden af: Opdrachtvorm: Opdrachtlengte: m 2 bytes Antwoord: m <Aantal modules, die gemeld worden> Antwoordlengte: TerminalMode uit: (3 + (aantal modules) * 3) bytes TerminalMode aan: (4 + (aantal modules) * 6) bytes De inhoud van alle aangemelde modules wordt overgedragen. Anschrift Telefon Bankverbindung - 5 -

6 Versie afvragen: Opdrachtsvorm: v Opdrachtslengte: 2 bytes Antwoord: V. x.xx / HSI-88-USB/ y.yy Win XP / (c) 2007 LDT & Falkner Antwoordlengte: variabel Het wordt aanbevolen, de tekens afzonderlijk t/m af te vragen. Als maximale antwoordlengte is 255 gedefinieërd. Betekenis: x.xx is de firmwareversie van de HSI-88-USB y.yy is de USB-driverversie in het antwoordvoorbeeld voor WindowsXP Vertaling: Jaap Kramer Technische wijzigingen en fouten voorbehouden. 04/2018 by LDT & Falkner Anschrift Telefon Bankverbindung - 6 -