Allestimento base e accessori
•
•
•
•
•
•
Un personal computer dotato di scheda di rete con connettore RJ45 sul quale sia installato un sistema operativo Microsoft Windows 95 / 98 / 2000 / ME / XP / NT4.0.,
Linux o Solaris
Netmaster
Alimentatore 12÷24Vcc 1A
Cavo ethernet incrociato (solo per collegamento “PC <> NetMaster”)
Cavo ethernet diritto + Hub (solo per collegamento “PC <> Rete <> NetMaster”)
Cavo seriale RS232, codice Elsist: CBL043*000 (necessario solo se deve essere aggiornato il sistema operativo della Tini o deve essere cambiato l’indirizzo IP).
Quali sono le operazioni necessarie per lo sviluppo di applicazioni Java ?
Nel presente documento riportiamo gli steps necessari per poter sviluppare
applicazioni in linguaggio Java su Netmaster.
a)
b)
c)
d)
f)
Installare su PC la piattaforma Java 2, Standard Edition
Installare su PC le Java Communications API
Installare su PC il software TINI
Installare su PC il software NETMASTER
Accesso alla scheda TINI con FTP e TELNET
Installare la piattaforma Java 2, Standard Edition
Scaricare dal sito internet http://java.sun.com/products/j2se/ l'ultima versione
del Java 2 Software Development Kit. Installare il software Java lanciando
l'eseguibile jdk1_2_2-001-win.exe. La directory base di questa installazione
(esempio C:\PROGRAMMI\JDK1.2.2) d'ora in poi la chiameremo JAVA_HOME.
Quali sono le operazioni necessarie per il ricaricamento del Sistema
Operativo della Tini ?
Nel presente documento riportiamo gli steps necessari per caricare il S.O. su
una scheda Tini. Ricordiamo comunque che il S.O. è già precaricato su tutti i
Netmaster rilasciati dalla nostra fabbrica, quindi queste operazioni sono necessarie unicamente in caso si debba eseguire un upgrade al S.O. od in caso di
perdita dello stesso.
a)
b)
c)
d)
Installare la piattaforma Java 2, Standard Edition
Installare la Java Communications API
Installare su PC il software TINI
Trasferire il S.O. nella scheda TINI
Installare su PC il software TINI
La sottodirectory JRE presente in JAVA_HOME d'ora in poi la chiameremo
JRE_HOME. In questa directory ci sono gli stessi file che durante l'installazione
vengono installati in \JAVASOFT\etc..
Copiare la versione desiderata del sistema operativo TINI in una directory
situata nello stesso percorso in cui si è installato il jdk (esempio
C:\PROGRAMMI), la directory base di questa installazione d'ora in poi la
chiameremo TINI_HOME.
Installare le Java Communications API
Trasferire il Sistema Operativo nella scheda TINI
Scaricare dal sito internet http://www.javasoft.com/products/javacomm/ il
package in formato ZIP delle Java Communications API (javacomm20win32.zip). Scompattare il package in una directory (esempio
C:\PROGRAMMI\JAVACOMM20) che, d'ora in poi, chiameremo COMMAPI. In
questa directory troverete i seguenti files:
Per eseguire questa operazione avete bisogno di un cavo null-modem (es. nostro cod. CBL043*000). Collegare il cavo alla porta "A" di Netmaster e, dall'altro
lato alla porta RS-232 del vostro computer. E' molto importante verificare le
connessioni del cavo, dal momento che la maggior parte dei problemi in questa
fase sono ad esso relazionati.
Alimentare Netmaster. Editare il programma JavaKit.bat presente nella directory TINI_HOME con le seguenti istruzioni (Nota che è case sensistive, specialmente un errore sulla scrittura di JavaKit è un problema ricorrente).
@ECHO OFF
SET JAVA_HOME=C:\PROGRAMMI\JDK1.2.2
SET TINI_HOME=C:\PROGRAMMI\SFW099A020\TINI1.02
%JAVA_HOME%\BIN\JAVA -classpath %TINI_HOME%\BIN\TINI.JAR JavaKit
Ora occorre:
Copiare il file win32com.dll dalla directory COMMAPI alla directory
%JRE_HOME%\bin.
Copiare il file comm.jar dalla directory COMMAPI alla directory
%JRE_HOME%\lib\ext.
Copiare il file javax.comm.properties dalla directory COMMAPI alla directory
%JRE_HOME%\lib.
Installare su PC il software TINI
Copiare la versione desiderata del sistema operativo TINI in una directory
situata nello stesso percorso in cui si è installato il jdk (esempio
C:\PROGRAMMI), la directory base di questa installazione d'ora in poi la
chiameremo TINI_HOME.
Installare su PC il software NETMASTER
Copiare il software sfw100 in una directory situata nello stesso percorso in cui si
è installato il jdk (esempio C:\PROGRAMMI). Questo software contiene tutte le
classi java per la gestione delle periferiche hardware di Netmaster, è presente
inoltre una serie di esempi che illustrano lo sviluppo di applicazioni su NETMASTER.
Accesso a Netmaster con FTP e TELNET
Per poter collegare Netmaster ad una rete ethernet bisogna prendere atto che il
dispositivo viene fornito con l'indirizzo di IP preconfigurato:
192.168.0.121 e subnet mask 255.255.255.0
Se questa situazione è compatibile con la vostra rete locale, sarà solamente
necessario collegare la porta ethernet di Netmaster alla rete attraverso un Hub,
e sarete pronti per la connessione tramite telnet.
Altrimenti, se vi necessita dover cambiare l'indirizzo, avete due possibilità:
a) Collegare la porta ethernet del vostro PC a Netmaster direttamente attraverso un cavo "cross", collegarsi via telnet e cambiare l'indirizzo IP con il
comando ipconfig.
b) Collegare la porta seriale RS-232 del vostro PC alla porta "A" di Netmaster
attraverso uncavo null-modem (esempio il ns cod. CBL043*000), avviare JavaKit.bat (o qualunque programma terminale settato a 115200 bps, parity none,
8 data bit, 1 stop bit) e cambiare l'indirizzo attraverso il comando ipconfig.
Nota: l’ipotesi b) può essere utilizzata solo se si vuole cambiare l’indirizzo
partendo da una situazione di compatibilità.
Esempio per cambiare l'indirizzo IP :
ipconfig -a 192.168.0.130 -m 255.255.255.0
Se si vuole memorizzare l’indirizzo IP nella Flash Eprom, occorre aggiungere al
comando ipconfig, l’opzione -C:
ipconfig -a 192.168.0.130 -m 255.255.255.0 -C
Lanciare JavaKit.bat. Dal programma "JavaKit", selezionare la COM a cui è
connesso Netmaster. Assicurarsi che la velocità selezionata sia 115200 e
premere il pulsante "OPEN PORT". Agendo sul pulsante "RESET" viene forzato
un reset alla scheda TINI, questa procedura avvia il "loader" che permette il
dialogo con la scheda ed il caricamento del firmware.
Nella finestra di testo del programma JavaKit apparirà:
TINI loader 05-15-00 17:45
Copyright (C) 2000 Dallas Semiconductor. All rights reserved.
Digitando "H" o "?" apparirà un elenco dei comandi disponibili.
Ora occorre azzerare completamente le memorie FLASH e RAM, utilizzando i
comandi:
Z AA
B 18
(cambia il banco a 18)
F0
(scrive “0” in tutto il banco, ne cancella il contenuto)
Ora occorre trasferire il sistema operativo nella memoria FLASH. Selezionare
dal menù File la voce Load File, e caricare il file %TINI_HOME%\bin\tini.tbin.
Questa operazione durerà parecchi secondi.
Ora occorre trasferire l'interprete comandi nella memoria FLASH. Selezionare
dal menù File la voce Load File, e caricare il file %TINI_HOME%\bin\slush.tbin.
Se tutto è stato caricato la scheda TINI è pronta per eseguire la Java VM e
l'interprete di comandi slush. Digitare il comando:
E
Sul terminale dovrebbe apparire un messaggio del tipo:
----> TINI Boot <---TINI OS 1.02b
API Version 8009
Copyright (C) 1999 - 2001 Dallas Semiconductor Corporation
=
[ slush initialization complete. ]
Hit any key to login.
Digitando un "RETURN" verrà visualizzata la versione dello slush e la richiesta
del login e della password, con un messaggio del tipo:
Welcome to slush. (Version 1.02b)
TINI login:
TINI password:
Esistono due account di default: "guest" con password "guest" e "root" con
password "tini". Per avere accesso alla configurazione della scheda occorre
effettuare il login come "root". Effettuato il login apparirà il prompt dello slush
con un messaggio del tipo:
TINI />
Digitare "help" per ottenere un elenco dei comandi disponibili, utilizzando
"help+comando" si ottiene un aiuto dettagliato del comando specifico.
MNL109A100
Basic equipment and accessories
•
•
•
•
•
•
A PC equipped with RJ45 ethernet card; on PC must be loaded any following operating system: Microsoft Windows 95 / 98 / 2000 / ME / XP / NT4.0., Linux or Solaris
Netmaster
A power supply device with 12÷24Vdc 1A output voltage
Crossed ethernet cable ( for “PC <> NetMaster” connection only)
Uncrossed ethernet cable + Hub ( for “PC <> Network <> NetMaster” connection only)
RS232 serial cable, Elsist code CBL043*000 (It is necessary only for upgrade the TINI operating system or change TINI IP address)
Which are the necessary operations for the development of java applications ?
In this document we remind you the necessary steps to be able to develop
applications, in Java language, on a Netmaster:
a)
b)
c)
d)
f)
Install Java 2 Platform, Standard Edition
Install Java Communications API
Install the TINI software
Install the Netmaster software
Netmaster FTP and TELNET connection
Which are the necessary operations to reload Tini Operating System ?
In this document we remind you the necessary steps to be able to upload the
O.S. on a Tini board. Please note that tho O.S. is still loaded on all Netmaster
released by our factory, so these operations are needed only if you need to
upgrade the O.S. or in case of loosing data.
a)
b)
c)
d)
Install Java 2 Platform, Standard Edition
Install Java Communication API
Install the TINI software
Transfer the O.S. to the Tini board
Install Java 2 Platform, Standard Edition
Install the TINI software
Get the latest release of the Java 2 Software Development Kit for your operating system from Sun's web site http://java.sun.com/products/j2se/ . Install the
Java 2 software. The base directory of this installation will be further referred
to as JAVA_HOME. This is the directory where you should find these files
(when a typical installation is done):
Copy the desired version of the TINI operating system in a directory located on
the same path where the jdk package is installed. (I.e. C:\PROGRAMS). This
directory will be subsequently referred as TINI_HOME.
The subdirectory JRE present in the JAVA_HOME directory will be further
referred to as JRE_HOME. In this directory there are the same files that during the installation are installed in \JAVASOFT\etc. directory.
Install Java Communications API
Download the Java Communications API implementation from Sun's web site
at http://www.javasoft.com/products/javacomm/. Unzip the package. The directory where you unzip the files will be subsequently referred as COMMAPI.
Now you will:
Copy win32com.dll from COMMAPI to your %JRE_HOME%\jre\bin directory.
Copy comm.jar from COMMAPI to your %JRE_HOME%\jre\lib\ext directory.
Copy javax.comm.properties from COMMAPI to your %JRE_HOME%\jre\lib
directory.
Install the TINI software
Copy the desired version of the TINI operating system in a directory located
on the same path where the jdk package is installed. (ie C:\PROGRAMS).
This directory will be subsequently referred as TINI_HOME.
Install the Netmaster software
Copy the sfw100 software in a directory located on the same path where the
jdk package is installed. (ie C:\PROGRAMS). This software contains all the
java classes to manage the Netmaster I/O hardware, some examples are
also availble to show how to develop applications on Netmaster.
Netmaster FTP and TELNET connection
To be able to connect to the Netmaster by the Ethernet network, you must
knowledge that Netmaster is factory set to the following IP Address:
192.168.0.121 and subnet mask 255.255.255.0
If this situation is compatible with your Local Area Network, you need only to
connect the Ethernet port of Netmaster to an Hub, and you are ready to establish a telnet connection with it.
Otherwise, if you need to change the IP Address, you have two possibilities:
a) Connect your PC to Netmaster through a cross ethernet cable (point-topoint) and then connect via telnet and change the original IP Address with the
command ipconfig.
b) Connect your PC RS-232 Port to Netmaster port "A" through a null modem
cable (i.e. our code CBL043*000), start JavaKit.bat (or any terminal program
set to 115200 bps, parity none, 8 databit, 1 stop bit) and then change the original IP Address with the command ipconfig.
Note: the case b) may be useful if you desire to change the address starting
from a compatible situation.
Example for change the IP Address:
ipconfig -a 192.168.0.130 -m 255.255.255.0
If you need to store the IP address permanently into Flash Eprom, you must
add the option -C to the ipconfig command:
ipconfig -a 192.168.0.130 -m 255.255.255.0 -C
Transfer the firmware on the Tini board
To make this operation you need a null-modem cable (i.e. our code
CBL043*000). Connect the cable to port "A" of Netmaster and the other side of
cable to the RS-232 port of your computer. It is very important to check your
cable since the majority of communication problems are related to that. Attach
power to the Netmaster. Jump to your TINI_HOME and modify the JavaKit.bat
file with this line in it. (Note that this is case sensitive, especially JavaKit - a
common mistake.)
@ECHO OFF
SET JAVA_HOME=C:\PROGRAMS\..\JDK1.2.2
SET TINI_HOME=C:\PROGRAMS\..\SFW099A020\TINI1.02
%JAVA_HOME%\bin\java -classpath %TINI_HOME%\bin\tini.jar JavaKit
This runs JavaKit, the program you will use to interact with your TINI Board. You
will use JavaKit often, so a batch file saves time. Double-click the batch file you
have just created. If everything was installed properly, you should be able to
scroll through the combo box at the bottom and see the COM ports you have on
your computer.
In JavaKit, select the COM port you will be using for the serial I/O. This is
whatever COM port you have attached your adapter to on your computer. Make
sure the speed is selected as 115200. Press the OPEN PORT button. When the
RESET button becomes enabled, hit it. This sends a reset signal to the TINI
Board. The reset circuitry of the TINI Board is connected to the DTR signal of
the RS232 cable. By hitting reset, JavaKit generates a short pulse on the DTR
line so that the board is going into the power on reset internal procedure. This
procedure starts the "loader" that allows us to communicate with the board and
download the firmware.
In the text area above a prompt should appear along with the words:
TINI loader 05-15-00 17:45
Copyright (C) 2000 Dallas Semiconductor. All rights reserved.
Type "H" or "?" to have a complete list of available commands.
Next, clear the heap by doing the following:
Z AA
B 18
(changes to bank 18)
F0
(fills bank 18 with 0's, effectively erasing it)
Now you need to transfer the OS into the TINI Flash EPROM:
From File menu select Load File and load the file: %TINI_HOME%\bin\tinitbin.
This operation will take some seconds.
From File menu select Load File and load the file:
%TINI_HOME%\bin\slush.tbin.
If everything is loaded, the TINI board is ready to execute the Java VM and the
slush command interpreter. Type the command:
E
You should see output similar to:
----> TINI Boot <---TINI OS 1.02b
API Version 8009
Copyright (C) 1999 - 2001 Dallas Semiconductor Corporation
[ slush initialization complete. ]
Hit any key to login.
Press "RETURN", the slush version and a login request will be prompted:
Welcome to slush. (Version 1.02b)
TINI login:
TINI password:
There are two default accounts on this revision of slush, 'guest' with the
password 'guest' and 'root' with the password 'tini'. Login with the account root,
you should see the output:
TINI />
Type "help" to get help. Type "help " to have help on a specific command. Try
"help ipconfig".
MNL109A100