moved stuff around

it's a good idea to separate the documents from the templates

6 files changed, 555 insertions, 0 deletions

diff --git a/src/HW/newt-setup/document.en.rest.txt b/src/HW/newt-setup/document.en.rest.txt
new file mode 100644
index 0000000..cf7cba1
--- /dev/null
+++ b/src/HW/newt-setup/document.en.rest.txt
@@ -0,0 +1,140 @@
+Newton and Nokia 7110 Setup
+===========================
+:CreationDate: 2003-01-28 10:09:25
+:tags: hardware
+
+Internet Settings
+-----------------
+
+For Internet Setup of NIE 2.0
+
+Protocol:
+
+    PPP
+
+Configuration:
+
+    Server
+
+User ID:
+
+    <none>
+
+Access Number:
+
+    2800
+
+When closing, disconnect:
+
+    after 1 minute
+
+Primary DNS/Name Server Address:
+
+    10.127.1.141
+
+Domain Name:
+
+    omnitel.it
+
+Modem Settings:
+
+    7110
+
+Country:
+
+    Italy
+
+Modem Settings
+--------------
+
+For Modem Modifier v2.02
+
+Modem Name:
+
+    7110
+
+Version:
+
+    1
+
+Organization:
+
+    Nokia
+
+ID the Modem:
+
+    False
+
+Use Hardware CD:
+
+    True
+
+Use Config. String:
+
+    True
+
+Use Dial Options:
+
+    True
+
+Hang Up At Disconnect:
+
+    True
+
+Supports Cellular:
+
+    **False**
+
+Supports EC:
+
+    True
+
+Supports LCS:
+
+    False
+
+Direct Connect Only:
+
+    False
+
+Connect Speeds:
+
+    2400 4800 7200 9600 12000 14400
+
+Config. Speed:
+
+    19200
+
+Command Timeout:
+
+    2000
+
+Max Chars Per Line:
+
+    40
+
+Inter-Command Delay:
+
+    50
+
+Modem ID String:
+
+Config. String No EC:
+
+    AT&FV1E0&D2&S0&C1S0=0
+
+Config. String EC Only:
+
+    AT&FV1E0&D2&S0&C1S0=0+CBST=75,0,1
+
+Config. String EC And Fallback:
+
+    AT&FV1E0&D2&S0&C1S0=0+CBST=75,0,1
+
+Config. String Cellular:
+
+Config. String Direct Connect:
+
+Smart Cr's:
+
+    checked
diff --git a/src/HW/newt-setup/document.it.rest.txt b/src/HW/newt-setup/document.it.rest.txt
new file mode 100644
index 0000000..dc24f7c
--- /dev/null
+++ b/src/HW/newt-setup/document.it.rest.txt
@@ -0,0 +1,140 @@
+Impostazioni Newton e Nokia 7110
+================================
+:CreationDate: 2003-01-28 10:09:25
+:tags: hardware
+
+Impostazioni Internet
+---------------------
+
+Per Internet Setup di NIE 2.0
+
+Protocol:
+
+    PPP
+
+Configuration:
+
+    Server
+
+User ID:
+
+    <none>
+
+Access Number:
+
+    2800
+
+When closing, disconnect:
+
+    after 1 minute
+
+Primary DNS/Name Server Address:
+
+    10.127.1.141
+
+Domain Name:
+
+    omnitel.it
+
+Modem Settings:
+
+    7110
+
+Country:
+
+    Italy
+
+Impostazioni modem
+------------------
+
+Per Modem Modifier v2.02
+
+Modem Name:
+
+    7110
+
+Version:
+
+    1
+
+Organization:
+
+    Nokia
+
+ID the Modem:
+
+    False
+
+Use Hardware CD:
+
+    True
+
+Use Config. String:
+
+    True
+
+Use Dial Options:
+
+    True
+
+Hang Up At Disconnect:
+
+    True
+
+Supports Cellular:
+
+    **False**
+
+Supports EC:
+
+    True
+
+Supports LCS:
+
+    False
+
+Direct Connect Only:
+
+    False
+
+Connect Speeds:
+
+    2400 4800 7200 9600 12000 14400
+
+Config. Speed:
+
+    19200
+
+Command Timeout:
+
+    2000
+
+Max Chars Per Line:
+
+    40
+
+Inter-Command Delay:
+
+    50
+
+Modem ID String:
+
+Config. String No EC:
+
+    AT&FV1E0&D2&S0&C1S0=0
+
+Config. String EC Only:
+
+    AT&FV1E0&D2&S0&C1S0=0+CBST=75,0,1
+
+Config. String EC And Fallback:
+
+    AT&FV1E0&D2&S0&C1S0=0+CBST=75,0,1
+
+Config. String Cellular:
+
+Config. String Direct Connect:
+
+Smart Cr's:
+
+    checked
diff --git a/src/HW/newt-setup/du2html.xsl b/src/HW/newt-setup/du2html.xsl
new file mode 120000
index 0000000..e2487e0
--- /dev/null
+++ b/src/HW/newt-setup/du2html.xsl
@@ -0,0 +1 @@
+../../../templates/du2html.xsl
\ No newline at end of file
diff --git a/src/HW/newton-7110/document.en.rest.txt b/src/HW/newton-7110/document.en.rest.txt
new file mode 100644
index 0000000..d01780e
--- /dev/null
+++ b/src/HW/newton-7110/document.en.rest.txt
@@ -0,0 +1,131 @@
+How to connect a Nokia 7110 to a Newton
+=======================================
+:CreationDate: 2003-07-14 9:41:11
+:tags: hardware
+
+After reading on the `NewtonTalk`_ mailing list an article (not present in any
+of the `two`_ `archives`_) by `Richard Avery`_ telling how he connected a
+`Nokia 6210`_ to his Newton, I decided to buy a cellular phone and try it.
+
+My choice has been a model `7110`_ (mostly because of its price...), which
+however has a built-in modem, this being necessary to use it with the Newton
+without special software. I found also the data cable **DLR-3**: note that data
+cable for lower models (**DAU-9P** and the like) doesn't allow to use the modem
+(it's possible to use 51xx and 61xx phones for data trasmission with those
+cables, but only under Windows with a software modem).
+
+Having the cable, we can test it putting it between the phone and a computer
+with a RS-232 serial port. With a terminal emulation program:
+
+In the picture you can see how to the ati (identification) commnad, the phone
+answers with its name, and to the ati2 command, it asnwers with the version
+number of its software.
+
+But the Newton has no RS-232 port!
+``````````````````````````````````
+
+Yes, this could seem a problem at first sight. On the other hand, as many know,
+with the special serial adapter (dongle) it's possible to extract a RS-422 (Mac
+serial) from the Newton; moreover, RS-422 is compatible with RS-232: just
+connect the right wires. I did it this way: (pinouts are connector side):
+
++------+------+
+|RS-232|RS-422|
++------+------+
+|1     |2     |
++------+------+
+|2     |5     |
++------+------+
+|3     |3     |
++------+------+
+|4     |1     |
++------+------+
+|5     |8 & 4 |
++------+------+
+|6     |2     |
++------+------+
+|7     |1     |
++------+------+
+|8     |2     |
++------+------+
+
+
+On the Web you can find several texts about different serial interfaces: the
+search is left as useful exercise to the reader.
+
+To test the adapter, link everything up (phone - DLR-3 - adapter just built -
+dongle - Newton) and use a terminal emulator on the Newton:
+
+The program used is `PT100`_
+
+What about the Internet?
+````````````````````````
+
+All right, at this point the only thing missing is using the phone to connect
+the Newton wirelessly to the Internet. You'll need `Newton Internet Enabler
+version 2`_, and `Modem Modifier version 2.02`_.
+
+Here you can see the settings I use (the links are to a text version of the
+same).
+
+There are some details to clear:
+
+*   2800 is the phone number of `Omnitel`_ (Vodaphone group) Internet access.
+    It seems to be the cheapest in Italy.
+
+*   There's no need for username or password, since the authentication is done
+    by the SIM card.
+
+*   The DNS number **is NOT official**: it would get sent during PPP
+    handshaking, but the Newton doesn't understand it. The information come
+    from an Italian web page (`Come accedere a Omnitelnet 2800 da Linux`_).
+    **DO NOT** use this number if you are not using Omnitel's service.
+
+*   Configuration strings have been taken form the .INF file for the 7110
+    installation under Windows.
+
+*   Someone might have noticed that the +CBST=0,0,1 command has been changed in
+    +CBST=75,0,1. This allows the phone to connect at 14400bps instead of
+    9600bps. The information comes from an Italian web page (`Portel`_). In
+    some areas, the phone will not correclty establish the data connection if
+    set for 14400bps. I have made two modem profiles, one for each speed. I
+    still need to find a way to discover which one to use without trial and
+    error (and paying for two calls).
+
+Enjoy!
+
+.. _`pt100`:
+    http://www.scrawlsoft.com/products/pt100/info.html
+
+.. _`portel`:
+    http://www.portel.it/news/news2.asp?news_id=1563
+
+.. _`richard avery`:
+    mailto:rjavery@mail.com
+
+.. _`come accedere a omnitelnet 2800 da linux`:
+    http://www.pluto.linux.it/ildp/journal/pj0003/omnitelnet2800.html
+
+.. _`newtontalk`:
+    http://www.newtontalk.net/
+
+.. _`two`:
+    http://www.chuma.org/newton/ntalk-archive/
+
+.. _`7110`:
+    http://www.nokiausa.com/phones/1,2499,;;rt7100,FF.html#7100
+
+.. _`archives`:
+    http://www.newtontalk.net/archive/
+
+.. _`nokia 6210`:
+    http://www.nokia.it/cellulari/6210/home.asp
+
+.. _`newton internet enabler version 2`:
+    http://www.unna.org/unna/apple/internet/NIE2/
+
+.. _`omnitel`:
+    http://www.omnitel.it/
+
+.. _`modem modifier version 2.02`:
+    http://www.unna.org/unna/utilites/ModemModifier2.02/
diff --git a/src/HW/newton-7110/document.it.rest.txt b/src/HW/newton-7110/document.it.rest.txt
new file mode 100644
index 0000000..05542e4
--- /dev/null
+++ b/src/HW/newton-7110/document.it.rest.txt
@@ -0,0 +1,142 @@
+Come collegare un Nokia 7110 a un Newton
+========================================
+:CreationDate: 2003-07-14 9:41:11
+:tags: hardware
+
+Dopo aver letto sulla mailing list `NewtonTalk`_ un articolo (non presente in
+nessuno dei `due`_ `archivi`_) di `Richard Avery`_ in cui diceva di essere
+riuscito a collegare un `Nokia 6210`_ al suo Newton, ho deciso di acquistare un
+cellulare e provare anch'io.
+
+La mia scelta è ricaduta sul modello `7110`_ (soprattutto a causa del
+prezzo...), che comunque contiene un modem, caratteristica essenziale per
+essere usato con il Newton senza programmi speciali. Dopo diverse disavventure
+sono riuscito a procurarmi anche l'apposito cavo **DLR-3** (acquistato da
+`NIXIE`_): notare che il cavo dati per modelli inferiori (**DAU-9P** e simili)
+non permette di utilizzare il modem (è possibile usare i modelli 51xx e 61xx
+per trasmissione dati con questi cavi, ma solo sotto Windows grazie a un
+software modem).
+
+Ottenuto il cavo, si può provarlo collegandolo tra il telefono e un computer
+con porta RS-232, usando un programma di emulazione terminale:
+
+Nell'immagine si può vedere come al comando ati (identificazione) il telefono
+risponda col proprio nome, e ad ati2 risponda con il numero di versione del
+proprio software
+
+Ma il Newton non ha una RS-232!
+```````````````````````````````
+
+Infatti, questo può risultare un problema a prima vista. D'altronde, come molti
+sanno, con l'apposito adattatore seriale (*dongle* per gli anglofoni) è
+possibile estrarre una RS-422 (seriale Mac) dal Newton; inoltre, la RS-422 è
+compatibile con la RS-232: basta collegare i fili giusti. Io ho fatto così (le
+piedinature sono lato connettore):
+
++------+------+
+|RS-232|RS-422|
++------+------+
+|1     |2     |
++------+------+
+|2     |5     |
++------+------+
+|3     |3     |
++------+------+
+|4     |1     |
++------+------+
+|5     |8 & 4 |
++------+------+
+|6     |2     |
++------+------+
+|7     |1     |
++------+------+
+|8     |2     |
++------+------+
+
+
+In rete è possibile trovare svariate spiegazioni sulle varie interfacce
+seriali: la ricerca è lasciata come utile esercizio al lettore.
+
+Per provare l'adattatore, collegate il tutto (telefono - DLR-3 - adattatore
+appena costruito - dongle - Newton) e usate un emulatore di terminale sul
+Newton:
+
+Il programma usato è `PT100`_
+
+E Internet?
+```````````
+
+D'accordo, arrivati a questo punto l'unica cosa che manca è usare il telefono
+per connettere il Newton a Internet via radio. Oltre al `Newton Internet
+Enabler versione 2`_, vi servirà `Modem Modifier versione 2.02`_.
+
+Qui sotto potete vedere le impostazioni che uso io (i link puntano a una
+versione testo delle stesse).
+
+Ci sono alcuni punti da chiarire:
+
+*   Il numero 2800 è quello del servizio Internet di `Omnitel`_. L'ho scelto
+    perché mi sembra quello più economico (`accetto volentieri`_ smentite e
+    suggerimenti)
+
+*   Il nome utente e la password non sono necessari, in quanto l'autenticazione
+    avviene tramite la carta SIM
+
+*   Il numero del DNS **non è ufficiale**: verrebbe fornito dinamicamente
+    durante l'handshaking del PPP, ma il Newton non è in grado di capirlo.
+    L'informazione viene da `Come accedere a Omnitelnet 2800 da Linux`_
+
+*   Le stringhe di configurazione sono state ricavate dai file .INF per
+    l'installazione del 7110 sotto Windows.
+
+*   Qualcuno avrà notato che il comando +CBST=0,0,1 è stato rimpiazzato da
+    +CBST=75,0,1. Questo permette di collegarsi a una velocità di 14400bps
+    anziché 9600bps. L'informazione viene da `Portel`_. È possibile che in
+    alcune zone (mi è capitato a Lucca) il telefono non prenda la linea dati se
+    configurato per 14400bps. Io ho creato due profili modem, uno a 14440bps e
+    uno a 9600bps, e scelgo quello che funziona. Devo ancora scoprire un modo
+    per decidere quale usare senza andare per tentativi (e spendere 400 lire).
+
+Buon divertimento!
+
+.. _`pt100`:
+    http://www.scrawlsoft.com/products/pt100/info.html
+
+.. _`portel`:
+    http://www.portel.it/news/news2.asp?news_id=1563
+
+.. _`accetto volentieri`:
+    mailto:dakkar@thenautilus.net
+
+.. _`newton internet enabler versione 2`:
+    http://www.unna.org/unna/apple/internet/NIE2/
+
+.. _`richard avery`:
+    mailto:rjavery@mail.com
+
+.. _`come accedere a omnitelnet 2800 da linux`:
+    http://www.pluto.linux.it/ildp/journal/pj0003/omnitelnet2800.html
+
+.. _`newtontalk`:
+    http://www.newtontalk.net/
+
+.. _`nixie`:
+    http://www.nixie.it/
+
+.. _`due`:
+    http://www.chuma.org/newton/ntalk-archive/
+
+.. _`archivi`:
+    http://www.newtontalk.net/archive/
+
+.. _`7110`:
+    http://www.nokia.it/cellulari/7110/Home.asp
+
+.. _`nokia 6210`:
+    http://www.nokia.it/cellulari/6210/home.asp
+
+.. _`modem modifier versione 2.02`:
+    http://www.unna.org/unna/utilites/ModemModifier2.02/
+
+.. _`omnitel`:
+    http://www.omnitel.it/
diff --git a/src/HW/newton-7110/du2html.xsl b/src/HW/newton-7110/du2html.xsl
new file mode 120000
index 0000000..e2487e0
--- /dev/null
+++ b/src/HW/newton-7110/du2html.xsl
@@ -0,0 +1 @@
+../../../templates/du2html.xsl
\ No newline at end of file