Could someone please translate this Dutch text into English.
This is a program to type to each other and to play each other's Midi
equipment remotely over the phone line.
Thanks......Julian.





HANDLEIDING GEBRUIK CHATMIDI

1. Het hoe en waarom van het programma
2. Eisen en benodigdheden
3. Gebruik van het programma
4. Een normale sessie
5. De CHATMIDI.INF-file

1. Het hoe en waarom van het programma

Met dit programma is het mogelijk om via de telefoonlijn midisigna-
len te versturen. Je kunt dus, als je in het bezit bent van een
modem en van een MIDI-gestuurde synthesizer samen met iemand anders
"op afstand" te spelen. Je kunt tegelijk spelen en berichten naar
elkaar doorgeven. Hetgeen je intikt, wordt ook op de computer van de
ander zichtbaar en hetgeen je speelt, wordt ook op de synthesizer
van de ander hoorbaar.

Dit programma draait op een Atari-ST (monochroom). Voor de IBM-
compatibles is een gelijksoortig programma beschikbaar, genaamd
PT.EXE. Je hoeft dus niet dezelfde computer te hebben om toch geza-
melijk te kunnen spelen.

De snelheid van de modem is van belang. Bij 1200 baud is de vertra-
ging via het modem circa 1/40 seconde per noot. Bij 2400 baud is
dat 1/80 seconde. Wanneer je teveel MIDI-signalen tegelijk naar het
modem stuurt, kan er dus een hoorbare vertraging optreden.
Realtime-messages van de synthesizer worden automatisch weggefil-
terd en niet via het modem verstuurd. System-exclusive-messages kun
je beter niet versturen. Door de verschillende mogelijke lengtes van
deze messages kan het programma vreemd reageren.

Je kunt het programma ook als een eenvoudige terminal gebruiken.
Deze terminal is meer bedoeld om bijvoorbeeld modems in te stellen
of te testen, dan om regelmatig BBS's mee te bellen. Up- en
download-mogelijkheden bezit het programma bijvoorbeeld niet. Voor
een echt terminalprogramma kun je beter UNITERM of andere program-
ma's gebruiken.

2. Eisen en benodigdheden

Wat je aan jouw kant aan hardware nodig hebt is een Atari-ST
(monochroom) en een modem. De benodigde software bestaat uit vier
files:
CHATMIDI.PRG  (het eigenlijke programma);
CHATMIDI.RSC  (de resourcefile);
CHATMIDI.INF  (de file met vooraf in te stellen waarden);
CHATMIDI.TXT  (deze handleiding).
De eerste twee files moeten aanwezig zijn en in dezelfde directory
staan. De derde file is optioneel, maar moet bij gebruik in dezelfde
directory staan als de eerste twee files.
3. Gebruik van het programma

Start het programma op de normale manier door CHATMIDI.PRG dubbel
aan te klikken. Als eerste loopt het programma de CHATMIDI.INF-file
door (zie ook paragraaf 5). Vervolgens verschijnt de copyright-
mededeling, met daarin de vrije geheugenruimte. Op dat moment moet
er nog minimaal 10 kByte vrij geheugen zijn, voor de buffers.
Na deze mededeling kun je uit het menu de volgende keuzen maken:

windows: Chat/MIDI:
Hiermee open je de Chat/MIDI vensters. Het bovenste venster is het
REMOTE-venster. Alles, dat aan de andere kant wordt ingetikt, zal in
dat venster worden weergegeven. Het onderste venster in het LOCAL-
venster. Alles, dat je hier intikt zal aan de andere kant op het
scherm verschijnen. Tegelijkertijd zullen jouw MIDI-signalen via de
telefoonlijn naar de andere kant worden verstuurd en vice-versa.
Indien op het moment, dat deze keuze gemaakt wordt er al vensters
geopend zijn, zullen deze automatisch worden gesloten.
De breedte van de vensters is 78 kolommen. De diepte van het REMOTE-
venster is 9 rijen, en die van het LOCAL-venster is 10 rijen. Indien
je bij de laatste kolom bent, springt de cursor naar de volgende
regel, ook al zit je midden in een woord. Indien je bij de laatste
rij bent, zal de tekst een regel omhoog scrollen. 
Je kunt de vensters op de normale manier via de sluitbox sluiten. De
inhoud wordt daarbij niet bewaard.

windows: Terminal:
Hiermee open je het Terminal-venster. Dit venster kan worden ge-
bruikt voor simpele terminal-opdrachten, zoals controle van de
modem. Het venster is 78 kolommen breed en 15 rijen diep. Ook hier
springt de cursor naar de volgende regel, na de 78'ste kolom en
scrolt de inhoud omhoog bij de laatste rij. Je kunt het venster op
de normale manier sluiten. De inhoud wordt daarbij niet bewaard.

windows: Quit:
Hiermee beeindig je het programma. Eventueel geopende vensters wor-
den automatisch gesloten.

settings: RS232:
Hiermee wordt aangegeven, op welke manier de signalen via het modem
verzonden worden. De mogelijkheden zijn baudrate (RS232_BAUD), pari-
ty (RS232_PRTY), het aantal databits (RS232_DATA) en het aantal
stopbits (RS232_STOP). Er is geen flowcontrol mogelijk. Het instel-
len vindt plaats door in het formulier de gewenste button aan te
klikken. Met behulp van de MIDICHAT.INF-file kunnen vooraf de ge-
wenste waarden worden ingesteld.
settings: Modem:
Hiermee kun je strings als opdrachten naar het modem zenden, te
weten: initialisatie (MODEM_INIT), verbinding leggen (MODEM_DIAL),
ophangen (MODEM_HANG) en antwoorden (MODEM_ANSW). De strings kunnen
door de gebruiker in het formulier aangepast worden en vooraf inge-
steld worden met behulp van de MIDICHAT.INF-file.
Je stuurt een signaal naar de modem door de bijbehorende TO MODEM-
button aan te klikken. De reactie van het programma op de gekozen
buttons is verschillend. Bij initialisatie en ophangen blijft  het
formulier op het scherm aanwezig, klaar voor een volgende opdracht.
Bij verbinding leggen of antwoorden (op de verbinding van een ander)
verwacht het programma na enkele seconden een data-carrier-signaal.
Er verschijnt een nieuw formulier, waarin gevraagd wordt of na
ontvangst van dat signaal naar het Terminal-venster of naar het
Chat/MIDI-venster (default) gesprongen moet worden. Als dan het
data-carrier-signaal wordt ontvangen. springt het programma automa-
tisch naar het gewenste venster, normaal het Chat/MIDI-venster. In-
dien er na enige tijd geen data-carrier-signaal ontvangen wordt,
kan de gebruiker via de button QUIT het formulier verlaten.

Het teken ~ wordt gebruikt om aan te geven, dat 1,5 seconde gepau-
seerd moet worden en wordt zelf niet verstuurd. Daarmee bestaat de
mogelijkheid om via ~+++~ de modem over te schakelen van verbinding
naar local-mode.
De vooraf ingestelde strings passen bij een Hayes-compatible modem.
Als je het MODEM-formulier wilt verlaten zonder iets te doen, moet
de button QUIT worden aangeklikt.

settings: Screen:
Hiermee kan worden ingesteld, hoe het programma reageert op inkomen-
de of uitgaande Returns. Met inkomende Returns wordt niets gedaan,
en aan uitgaande Returns wordt een Linefeed toegevoegd. Deze instel-
lingen kunnen worden gewijzigd, maar zijn op de bovenstaande manier
mede bruikbaar voor PT.EXE.

settings: Midifilter:
Hiermee kan de gebruiker aangeven, welke MIDI-signalen wel of niet
naar de ander doorgezonden moeten worden. Door de betreffende STOP-
button aan te klikken worden ze niet doorgezonden, door de THRU-
button aan te klikken worden ze wel doorgezonden.
4. Een normale sessie

Een normale sessie kan als volgt verlopen. De een belt de ander
(voice) op en overlegt of alles goed ingesteld is. Daarmee bedoel ik
niet alleen de RS232- en Modem-instellingen, maar ook de instellin-
gen van de synthesizer (hetzelfde MIDI-kanaal, dezelfde soort klank,
enz). Vervolgens wordt de modem-verbinding gelegd. Daarvoor moet in
het modemformulier de een de ATD-opdracht (MODEM_DIAL) naar het
modem sturen en de ander de ATA-opdracht (MODEM_ANSW). Als het pro-
gramma een data-carrier-signaal detecteert, springt het programma
naar het gewenste venster, normaal de Chat/MIDI-vensters. Begroet
vervolgens uw partner door een welkomswoord in te tikken. Op die
manier weten beiden of de verbinding gelukt is.

5. De CHATMIDI.INF-file

Met behulp van dit bestand kunnen een aantal instellingen van te
voren ingegeven worden, zodat ze niet telkens na het starten van het
programma veranderd hoeven te worden. Indien deze file niet bestaat
of als een instelling niet opgegeven wordt, zal er een standaard-
waarde gebruikt worden. De vorm waarin deze instellingen aangegeven
worden is simpel: TREFWOORD = waarde. Zinnen zonder het =-teken
kunnen als commentaar in CHATMIDI.INF opgenomen worden.
Indien het programma het trefwoord niet herkent of de waarde niet
snapt verschijnt een waarschuwing. Door dan ABORT aan te klikken
stopt het programma. Door CONTINUE aan te klikken wordt dit tref-
woord overgeslagen en loopt het programma verder.
De mogelijke trefwoorden zijn (met standaardwaarden):

RS232_BAUD = 1200                  (300, 1200, 2400, 4800 of 9600)
RS232_PRTY = N                     (N(one), E(ven), O(dd))
RS232_DATA = 8                     (8 of 7)
RS232_STOP = 1                     (1, 2 of 3)
MODEM_INIT = ATE0H0V1X4S0=0
MODEM_DIAL = ATD
MODEM_HANG = ~+++~ATH0
MODEM_ANSW = ATA
