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