Über die Kommando-Schnittstelle - oder auch "Konsole" - können Befehle zur Konfiguration und zum Austausch von Daten eingegeben werden. Es sind zwei Funktionen, die die Kommandoschnittstelle erfüllt:

• Konfiguration: Alle Einstellungen zur Konfiguraiton lassen sich über die Kommandoschnittstelle machen
   
• "API" - Application Programming Interface: Ein externer Mikrocontroller kann über einen einfachen, aber mächtigen Befehlssatz das Avisaro Produkt steuern: Dateien öffnen, Daten lesen und schreiben, TCP/IP Verbindungen bedienen, etc ...

Konfiguration

Die Konfiguration erfolgt über Befehle aus der Kommandoschnittstelle. Die Befehle können auf zwei Arten an das Avisaro Gerät geschickt werden:

1. bei Logger oder WLAN Logger: Die Befehle zur Konfiguration werden in eine "Batch-Datei" geschrieben. Diese Batch Datei namens 'autorun.txt' wird auf die SD_Karte gespeichert und beim Neustart des Avisaro Geräts immer ausgeführt. Dies ist ein sehr einfacher Weg das Modul zu konfigurieren.
2. bei WLAN Logger oder WLAN Device: über das WLAN Web Interface, das sich online über WLAN offen läßt. Hier können Sie direkt die Parameter per Menüführung einstellen.
3. bei allen Geräten: Über die Datenschnittstelle (RS232, CAN, ...). An der Datenschnittstelle können die Befehle direkt eingegeben werden. Zu beachten ist, dass die meisten Scripte die Datenschnittstelle umleiten. Das heißt dieser Weg steht nur zur Verfügung, wenn das Script vorher deaktiviert wurde. 

Batch-Datei "autorun.txt"

Zur einfachen Konfiguration werden alle Einstellungen in eine gewöhnliche Textdatei mit dem Namen "autorun.txt" geschrieben. Beispiel:

prot rs232
rs232 115200 8 N 1 N
load script1.txt
run auto

Beachte: Wichtig ist, dass die letzte Zeile mit 'Enter' abgeschlossen wird.

Dieses Beispiel setzt die Datenschnittstelle auf RS232 und stellt die Baudrate ein. Dann wird das Script 'script1.txt' geladen (dies muss dann ebenfalls auf der SD Karte sein). Abschließend wird das Script auf 'automatisches Ausführen nach dem Start' gestellt.

Fast alle Einstellungen werden intern im Flash gespeichert - die Autorun.txt muss also nur einmal ausgeführt werden und kann dann vom Datenträger gelöscht werden.

1. autorun.txt Datei erzeugen und auf Speicherkarte speichern
2. Avisaro Logger ausschalten und Speicherkarte einlegen
3. Avisaro Logger einschalten und ca. 10 Sekunden warten. In dieser Zeit werden die Befehle in der autorun.txt Datei abgearbeitet
4. Avisaro Logger ausschalten und autorun.txt von Datenträger löschen

Die wichtigsten Befehle zur Konfiguration

Folgende Befehle sind hilfreich bei der Konfiguration der Module: (eine vollständige Liste aller Befehle finden Sie hier:  details)

Beschreibung: Stellt die Datenschnittstelle ein (also z.B. CAN, RS232, I2C, ...) ( details)

Beschreibung: Zur Einstellung der RS232 Schnittstellenparameter ( details)

Zur Einstellung der CAN Schnittstellenparameter ( details)

Beschreibung: Stellt die interne Uhr (bei "Cube" und "Box" batteriegepuffert) ( details)

Beschreibung: Läd ein neues Script. Script-Datei muss auf Speicherkarte sein. ( details)

Setzt das Produkt in den Auslieferungszustand zurück. Alle Einstellungen werden gelöscht, die Ausführung des Scripts wird gestoppt (die LEDs am Gehäuse leuchten auch nicht mehr). ( details)

Konfiguration der Schnittstelle über WEB-Administratorseite

Am einfachsten stellen Sie die Schnittstelle bei allen WLAN-fähigen Avisaro Devices mittels der Administratorseite um. Folgen Sie diesen Schritten:

1. Öffnen Sie den Browser, wählen Sie die IP Ihres Avisaro Devices an und loggen Sie sich ein.

2. Gehen Sie unter Data Interface in dem Menü auf Ihre Schnittstelle.

3. Passen Sie die Parameter an die Bedürfnisse der Umgebung an. Schließen Sie mit 'submit' wieder ab.

4. Rebooten Sie das Device entweder durch Stromunterbrechung oder unter Generals der Button 'Reboot'

WLAN

Die Parameter für die WLAN-Schnittstelle sind die Folgenden.

Typ: 802.11 b/g

Sicherheit: WEP + WPA

Reichweite: ca. 300m (Outdoor)

SSID: avisaro

Channel: 11

Mode: adhoc

Encryption: none

Zur Konfiguration: Öffnen Sie eine Browser und geben Sie die IP 192.168.0.74 ein. Dann loggen Sie sich mit Benutzernamen und Passwort ein. Wenn Sie es noch nicht geändert haben, sind es der Benutzername: 'admin' und das Initialpasswort: '1234'. Zu Ihrem Schutz sollten Sie es aber umgehend ändern und sich gut merken. Achtung: Es gibt keine Hintertür bei verlorenen Passwörtern. Dann müssen Sie sich direkt an Avisaro wenden.

"API" - Programmierschnittstelle

Für den Betrieb an einer programmierbaren Einheit ("Mikrocontroller" oder "SPS") stehen leistungsfähige Befehle zur Verfügung.

"Handles" und mehr ...

Die Schnittstelle erlaubt es mehrer Operationen parallel zu machen. Es können also mehrer Dateien geöffnet seien oder auch mehrere TCP/IP Verbindungen.

Es gibt daher das Konzept von "Handles" - das sind eindeutige Nummern, mit denen eine Aktion einer bestimmten Datei zugeordnet werden kann.

Dateien lesen

Um eine Datei zum Lesen zu öffnen, wird sie zunächst mit 'open' geöffnet. Dabei wird eine Handlenummer vom Benutzer vorgegeben. Beispiel:

open 1 text.txt

Folgende Operationen mit der Handlenummer 1 beziehen sich nun auf diese Datei. Nun kann der Inhalt der Datei Stück für Stück ausgelesen werden:

read 1 10

Liest 10 Bytes aus der Datei. Alternative kann mit "stream 1" die ganze Datei in einem Rutsch ausgelesen werden. Mehr Details zu diesem Thema:  Details

Dateien schreiben

Um eine Datei zum Schreiben zu öffnen, wird sie zunächst mit 'new' erzeugt. Um an eine vorhandene Datei Daten anzuhängen, kann der Befehl 'appd' genutzt werden. Beispiel:

new 1 text.txt

Folgende Operationen mit der Handlenummer 1 beziehen sich nun auf diese Datei. Um einen kleinen Block Daten zu schreiben:

write 1 Hallo

Um einen größeren Block zu schreiben, kann stream' verwendet werden:

stream 1


Hallo Welt. Dies ist ein Text
aus mehreren Zeilen


+++ 

Mit der Stopsequenz wird der Streaming Modus ausgeschaltet ( Details).