Java - Master Brick

Dies ist die Beschreibung der Java API Bindings für den Master Brick. Allgemeine Informationen über die Funktionen und technischen Spezifikationen des Master Brick sind in dessen Hardware Beschreibung zusammengefasst.

Eine Installationanleitung für die Java API Bindings ist Teil deren allgemeine Beschreibung.

Beispiele

Der folgende Beispielcode ist Public Domain (CC0 1.0).

Stack Status

Download (ExampleStackStatus.java)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
import com.tinkerforge.IPConnection;
import com.tinkerforge.BrickMaster;

public class ExampleStackStatus {
    private static final String HOST = "localhost";
    private static final int PORT = 4223;

    // Change XXYYZZ to the UID of your Master Brick
    private static final String UID = "XXYYZZ";

    // Note: To make the example code cleaner we do not handle exceptions. Exceptions
    //       you might normally want to catch are described in the documentation
    public static void main(String args[]) throws Exception {
        IPConnection ipcon = new IPConnection(); // Create IP connection
        BrickMaster master = new BrickMaster(UID, ipcon); // Create device object

        ipcon.connect(HOST, PORT); // Connect to brickd
        // Don't use device before ipcon is connected

        // Get current stack voltage
        int stackVoltage = master.getStackVoltage(); // Can throw com.tinkerforge.TimeoutException
        System.out.println("Stack Voltage: " + stackVoltage/1000.0 + " V");

        // Get current stack current
        int stackCurrent = master.getStackCurrent(); // Can throw com.tinkerforge.TimeoutException
        System.out.println("Stack Current: " + stackCurrent/1000.0 + " A");

        System.out.println("Press key to exit"); System.in.read();
        ipcon.disconnect();
    }
}

API

Prinzipiell kann jede Methode der Java Bindings eine TimeoutException werfen. Diese Exception wird geworfen wenn das Gerät nicht antwortet. Wenn eine Kabelverbindung genutzt wird, ist es unwahrscheinlich, dass die Exception geworfen wird (unter der Annahme, dass das Gerät nicht abgesteckt wird). Bei einer drahtlosen Verbindung können Zeitüberschreitungen auftreten, sobald die Entfernung zum Gerät zu groß wird.

Neben der TimeoutException kann auch noch eine NotConnectedException geworfen werden, wenn versucht wird mit einem Brick oder Bricklet zu kommunizieren, aber die IP Connection nicht verbunden ist.

Da Java nicht mehrere Rückgabewerte unterstützt und eine Referenzrückgabe für elementare Type nicht möglich ist, werden kleine Klassen verwendet, die nur aus Member-Variablen bestehen. Die Member-Variablen des zurückgegebenen Objektes werden in der jeweiligen Methodenbeschreibung erläutert.

Das Package für alle Brick/Bricklet Bindings und die IP Connection ist com.tinkerforge.*

Alle folgend aufgelisteten Methoden sind Thread-sicher.

Grundfunktionen

public class BrickMaster(String uid, IPConnection ipcon)

Erzeugt ein Objekt mit der eindeutigen Geräte ID uid:

BrickMaster master = new BrickMaster("YOUR_DEVICE_UID", ipcon);

Dieses Objekt kann benutzt werden, nachdem die IP Connection verbunden ist (siehe Beispiele oben).

public int getStackVoltage()

Gibt die Spannung des Stapels in mV zurück. Diese Spannung wird über den Stapel verteilt und kann zum Beispiel über eine Step-Down oder Step-Up Power Supply eingespeist werden.

public int getStackCurrent()

Gibt den Stromverbrauch des Stapels in mA zurück. Der angegebene Strom bezieht sich auf den Stromverbrauch der am Stapel angeschlossenen Verbraucher. Die Speisung kann z.B. über eine Step-Down oder Step-Up Power Supply erfolgen.

Fortgeschrittene Funktionen

public void setExtensionType(short extension, long exttype)

Schreibt den Typ der Extension in den EEPROM der angegebenen Extension. Die Extension kann entweder 0 oder 1 sein (0 ist an der Unterseite, 1 auf der Oberseite, wenn nur eine Extension verfügbar ist, ist 0 zu verwenden)

Mögliche Extensiontypen:

Typ Beschreibung
1 Chibi
2 RS485
3 WIFI
4 Ethernet
5 WIFI 2.0

Der Typ der Extension ist schon gesetzt beim Erwerb der Extension und kann über den Brick Viewer gesetzt werden. Daher ist es unwahrscheinlich, dass diese Funktion benötigt wird.

Die folgenden Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.EXTENSION_TYPE_CHIBI = 1
  • BrickMaster.EXTENSION_TYPE_RS485 = 2
  • BrickMaster.EXTENSION_TYPE_WIFI = 3
  • BrickMaster.EXTENSION_TYPE_ETHERNET = 4
  • BrickMaster.EXTENSION_TYPE_WIFI2 = 5
public long getExtensionType(short extension)

Gibt den Typ der angegebenen Extension zurück, wie von setExtensionType() gesetzt.

Die folgenden Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.EXTENSION_TYPE_CHIBI = 1
  • BrickMaster.EXTENSION_TYPE_RS485 = 2
  • BrickMaster.EXTENSION_TYPE_WIFI = 3
  • BrickMaster.EXTENSION_TYPE_ETHERNET = 4
  • BrickMaster.EXTENSION_TYPE_WIFI2 = 5
public boolean isChibiPresent()

Gibt zurück ob eine Chibi Extension zur Nutzung durch den Master Brick verfügbar ist.

public void setChibiAddress(short address)

Setzt die zugehörige Adresse (1-255) der Chibi Extension.

Es ist möglich die Adresse mit dem Brick Viewer zu setzen und diese wird im EEPROM der Chibi Extension abgespeichert. Ein Setzen bei jedem Start ist daher nicht notwendig.

public short getChibiAddress()

Gibt die Adresse zurück, wie von setChibiAddress() gesetzt.

public void setChibiMasterAddress(short address)

Setzt die Adresse (1-255) des Chibi Master. Diese Adresse wird verwendet wenn die Chibi Extension als Slave verwendet wird (z.B. wenn keine USB-Verbindung besteht).

Es ist möglich die Adresse mit dem Brick Viewer zu setzen und diese wird im EEPROM der Chibi Extension abgespeichert. Ein Setzen bei jedem Start ist daher nicht notwendig.

public short getChibiMasterAddress()

Gibt die Adresse zurück, wie von setChibiMasterAddress() gesetzt.

public void setChibiSlaveAddress(short num, short address)

Setzt bis zu 254 Slave Adressen. Gültige Adressen sind 1-255. 0 hat eine besondere Bedeutung, sie wird zur Terminierung der Liste verwendet und ist nicht als normale Slave Adresse erlaubt. Die Adressnummerierung (mittels num Parameter) muss aufsteigend ab 0 erfolgen. Beispiel: Wenn die Chibi Extension im Master Modus verwendet wird (z.B. wenn der Stapel eine USB-Verbindung hat) und es soll mit drei weiteren Chibi Stapeln kommuniziert werden, mit den Adressen 17, 23 und 42, sollten die Aufrufe (0, 17), (1, 23), (2, 42) und (3, 0) sein. Der letzte Aufruf mit (3, 0) dient der Terminierung der Liste und zeigt an, dass die Chibi Slave Adressliste in diesem Fall 3 Einträge beinhaltet.

Es ist möglich die Adressen mit dem Brick Viewer zu setzen, dieser kümmert sich dann um korrekte Adressnummerierung und Terminierung der Liste.

Die Slave Adresse werden im EEPROM der Chibi Extension abgespeichert. Ein Setzen bei jedem Start ist daher nicht notwendig.

public short getChibiSlaveAddress(short num)

Gibt die Slave Adresse für eine Adressnummerierung (mittels num Parameter) zurück, wie von setChibiSlaveAddress() gesetzt.

public short getChibiSignalStrength()

Gibt die Signalstärke in dBm zurück. Die Aktualisierung der Signalstärke wird bei jedem Empfang eines Paketes durchgeführt.

public BrickMaster.ChibiErrorLog getChibiErrorLog()

Gibt folgende Fehlerzähler der Chibi Kommunikation zurück: Underrun, CRC Fehler, kein ACK und Overflow. Bei Anstieg dieser Fehlerzähler ist es wahrscheinlich, dass entweder die Entfernung zwischen zwei Chibi Stapeln zu groß wird oder Störungen vorliegen.

Das zurückgegebene Objekt enthält die Public-Member-Variablen int underrun, int crcError, int noAck und int overflow.

public void setChibiFrequency(short frequency)

Setzt den Chibi Frequenzbereich der Chibi Extension. Mögliche Werte sind:

Typ Beschreibung
0 OQPSK 868MHz (Europe)
1 OQPSK 915MHz (US)
2 OQPSK 780MHz (China)
3 BPSK40 915MHz

Es ist möglich den Frequenzbereich mit dem Brick Viewer zu setzen und dieser wird im EEPROM der Chibi Extension abgespeichert. Ein Setzen bei jedem Start ist daher nicht notwendig.

Die folgenden Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.CHIBI_FREQUENCY_OQPSK_868_MHZ = 0
  • BrickMaster.CHIBI_FREQUENCY_OQPSK_915_MHZ = 1
  • BrickMaster.CHIBI_FREQUENCY_OQPSK_780_MHZ = 2
  • BrickMaster.CHIBI_FREQUENCY_BPSK40_915_MHZ = 3
public short getChibiFrequency()

Gibt den Frequenzbereich zurück, wie von setChibiFrequency() gesetzt.

Die folgenden Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.CHIBI_FREQUENCY_OQPSK_868_MHZ = 0
  • BrickMaster.CHIBI_FREQUENCY_OQPSK_915_MHZ = 1
  • BrickMaster.CHIBI_FREQUENCY_OQPSK_780_MHZ = 2
  • BrickMaster.CHIBI_FREQUENCY_BPSK40_915_MHZ = 3
public void setChibiChannel(short channel)

Setzt den verwendeten Kanal der Chibi Extension. Die möglichen Kanäle sind abhängig vom verwendeten Frequenzbereich:

Frequenzbereich Mögliche Kanäle
OQPSK 868MHz (Europe) 0
OQPSK 915MHz (US) 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
OQPSK 780MHz (China) 0, 1, 2, 3
BPSK40 915MHz 1, 2, 3, 4, 5, 6, 7, 8, 9, 10

Es ist möglich den Kanal mit dem Brick Viewer zu setzen und dieser wird im EEPROM der Chibi Extension abgespeichert. Ein Setzen bei jedem Start ist daher nicht notwendig.

public short getChibiChannel()

Gibt den Kanal zurück, wie von setChibiChannel() gesetzt.

public boolean isRS485Present()

Gibt zurück ob eine RS485 Extension zur Nutzung durch den Master Brick verfügbar ist.

public void setRS485Address(short address)

Setzt die zugehörige Adresse (0-255) der RS485 Extension.

Um eine RS485 Extension als RS485 Master (z.B. verbunden mit einem PC über USB) zu betreiben muss die Adresse auf 0 gesetzt werden.

Es ist möglich die Adresse mit dem Brick Viewer zu setzen und diese wird im EEPROM der RS485 Extension abgespeichert. Ein Setzen bei jedem Start ist daher nicht notwendig.

public short getRS485Address()

Gibt die Adresse zurück, wie von setRS485Address() gesetzt.

public void setRS485SlaveAddress(short num, short address)

Setzt bis zu 255 Slave Adressen. Gültige Adressen sind 1-255. 0 hat eine besondere Bedeutung, sie wird zur Terminierung der Liste verwendet und ist nicht als normale Slave Adresse erlaubt. Die Adressnummerierung (mittels num Parameter) muss aufsteigend ab 0 erfolgen. Beispiel: Wenn die RS485 Extension im Master Modus verwendet wird (z.B. wenn der Stapel eine USB-Verbindung hat) und es soll mit drei weiteren RS485 Stapeln kommuniziert werden, mit den Adressen 17, 23 und 42, sollten die Aufrufe (0, 17), (1, 23), (2, 42) und (3, 0) sein. Der letzte Aufruf mit (3, 0) dient der Terminierung der Liste und zeigt an, dass die RS485 Slave Adressliste in diesem Fall 3 Einträge beinhaltet.

Es ist möglich die Adressen mit dem Brick Viewer zu setzen, dieser kümmert sich dann um korrekte Adressnummerierung und Terminierung der Liste.

Die Slave Adresse werden im EEPROM der RS485 Extension abgespeichert. Ein Setzen bei jedem Start ist daher nicht notwendig.

public short getRS485SlaveAddress(short num)

Gibt die Slave Adresse für eine Adressnummerierung (mittels num Parameter) zurück, wie von setRS485SlaveAddress() gesetzt.

public int getRS485ErrorLog()

Gibt den CRC Fehlerzähler der RS485 Kommunikation zurück. Wenn dieser Zähler ansteigt ist es wahrscheinlich, dass der Abstand zwischen zwei RS485-Teilnehmern zu groß ist oder es Störungen gibt.

public void setRS485Configuration(long speed, char parity, short stopbits)

Setzt die Schnittstellenkonfiguration der RS485 Extension. Die Geschwindigkeit wird in Baud angegeben. Der Master Brick versucht die vorgegebene Baudrate so genau wie möglich zu erreichen. Die maximale empfohlene Baudrate ist 2000000 (2Mbit/s). Mögliche Werte für die Parität sind 'n' (keine), 'e' (gerade) und 'o' (ungerade). Mögliche Werte für Stoppbits sind 1 und 2.

Wenn die RS485 Kommunikation instabil ist (verlorene Nachrichten etc.), sollte zuerst die Baudrate verringert werden. Sehr lange Busleitungen (z.B. 1km) sollten möglichst Werte im Bereich von 100000 (100kbit/s) verwenden.

Die Werte sind im EEPROM gespeichert und werden nur beim Start angewandt. Dass bedeutet, der Master Brick muss nach einer Konfiguration neu gestartet werden.

Die folgenden Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.RS485_PARITY_NONE = 'n'
  • BrickMaster.RS485_PARITY_EVEN = 'e'
  • BrickMaster.RS485_PARITY_ODD = 'o'
public BrickMaster.RS485Configuration getRS485Configuration()

Gibt die Schnittstellenkonfiguration zurück, wie von setRS485Configuration() gesetzt.

Die folgenden Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.RS485_PARITY_NONE = 'n'
  • BrickMaster.RS485_PARITY_EVEN = 'e'
  • BrickMaster.RS485_PARITY_ODD = 'o'

Das zurückgegebene Objekt enthält die Public-Member-Variablen long speed, char parity und short stopbits.

public boolean isWifiPresent()

Gibt zurück ob eine WIFI Extension zur Nutzung durch den Master Brick verfügbar ist.

public void setWifiConfiguration(String ssid, short connection, short[] ip, short[] subnetMask, short[] gateway, int port)

Setzt die Konfiguration der WIFI Extension. Die ssid darf eine maximale Länge von 32 Zeichen haben. Mögliche Werte für connection sind:

Wert Beschreibung
0 DHCP
1 Statische IP
2 Access Point: DHCP
3 Access Point: Statische IP
4 Ad Hoc: DHCP
5 Ad Hoc: Statische IP

Wenn connection auf eine der statische IP Optionen gesetzt wird, dann müssen ip, subnet_mask und gateway als ein Array der Größe 4 angegeben werden. Dabei ist das erste Element im Array das niederwertigste Byte. Falls connection auf eine der DHCP Optionen gesetzt ist, werden ip, subnet_mask und gateway ignoriert.

Der letzte Parameter ist der Port auf den das Anwendungsprogramm sich verbindet. Der Standardport von brickd ist 4223.

Die Werte sind im EEPROM gespeichert und werden nur beim Start angewandt. Dass bedeutet, der Master Brick muss nach einer Konfiguration neu gestartet werden.

Wir empfehlen den Brick Viewer zu verwenden, um die WIFI Extension zu konfigurieren.

Die folgenden Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.WIFI_CONNECTION_DHCP = 0
  • BrickMaster.WIFI_CONNECTION_STATIC_IP = 1
  • BrickMaster.WIFI_CONNECTION_ACCESS_POINT_DHCP = 2
  • BrickMaster.WIFI_CONNECTION_ACCESS_POINT_STATIC_IP = 3
  • BrickMaster.WIFI_CONNECTION_AD_HOC_DHCP = 4
  • BrickMaster.WIFI_CONNECTION_AD_HOC_STATIC_IP = 5
public BrickMaster.WifiConfiguration getWifiConfiguration()

Gibt die Konfiguration zurück, wie von setWifiConfiguration() gesetzt.

Die folgenden Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.WIFI_CONNECTION_DHCP = 0
  • BrickMaster.WIFI_CONNECTION_STATIC_IP = 1
  • BrickMaster.WIFI_CONNECTION_ACCESS_POINT_DHCP = 2
  • BrickMaster.WIFI_CONNECTION_ACCESS_POINT_STATIC_IP = 3
  • BrickMaster.WIFI_CONNECTION_AD_HOC_DHCP = 4
  • BrickMaster.WIFI_CONNECTION_AD_HOC_STATIC_IP = 5

Das zurückgegebene Objekt enthält die Public-Member-Variablen String ssid, short connection, short[] ip, short[] subnetMask, short[] gateway und int port.

public void setWifiEncryption(short encryption, String key, short keyIndex, short eapOptions, int caCertificateLength, int clientCertificateLength, int privateKeyLength)

Setzt die Verschlüsselung der WIFI Extension. Der erste Parameter ist der Typ der Verschlüsselung. Mögliche Werte sind:

Wert Beschreibung
0 WPA/WPA2
1 WPA Enterprise (EAP-FAST, EAP-TLS, EAP-TTLS, PEAP)
2 WEP
3 Keine Verschlüsselung

Der key hat eine maximale Länge von 50 Zeichen und wird benutzt falls encryption auf 0 oder 2 (WPA/WPA2 oder WEP) gesetzt ist. Andernfalls wird dieser Parameter ignoriert.

Für WPA/WPA2 muss der Schlüssel mindestens 8 Zeichen lang sein. Wenn ein Schlüssel mit mehr als 50 Zeichen gesetzt werden soll, kann setLongWifiKey() genutzt werden.

Für WEP muss der Schlüssel entweder 10 oder 26 hexadezimale Zeichen lang sein. Es ist möglich den key_index zu setzen (1-4). Fall der key_index unbekannt ist, ist er wahrscheinlich 1.

Wenn WPA Enterprise als encryption gewählt wird, müssen eap_options und die Länge der Zertifikate gesetzt werden. Die Länge wird in Byte angegeben und die Zertifikate selbst können mit setWifiCertificate() übertragen werden. Die eap_options bestehen aus Outer Authentication (Bits 1-2), Inner Authentication (Bit 3) und Certificate Type (Bits 4-5):

Option Bits Beschreibung
Outer Authentication 1-2 0=EAP-FAST, 1=EAP-TLS, 2=EAP-TTLS, 3=EAP-PEAP
Inner Authentication 3 0=EAP-MSCHAP, 1=EAP-GTC
Certificate Type 4-5 0=CA Certificate, 1=Client Certificate, 2=Private Key

Beispiel für EAP-TTLS + EAP-GTC + Private Key: option = 2 | (1 << 2) | (2 << 3).

Die Werte sind im EEPROM gespeichert und werden nur beim Start angewandt. Das bedeutet der Master Brick muss nach einer Konfiguration neu gestartet werden.

Wir empfehlen den Brick Viewer zu verwenden, um die WLAN Verschlüsselung zu konfigurieren.

Die folgenden Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.WIFI_ENCRYPTION_WPA_WPA2 = 0
  • BrickMaster.WIFI_ENCRYPTION_WPA_ENTERPRISE = 1
  • BrickMaster.WIFI_ENCRYPTION_WEP = 2
  • BrickMaster.WIFI_ENCRYPTION_NO_ENCRYPTION = 3
  • BrickMaster.WIFI_EAP_OPTION_OUTER_AUTH_EAP_FAST = 0
  • BrickMaster.WIFI_EAP_OPTION_OUTER_AUTH_EAP_TLS = 1
  • BrickMaster.WIFI_EAP_OPTION_OUTER_AUTH_EAP_TTLS = 2
  • BrickMaster.WIFI_EAP_OPTION_OUTER_AUTH_EAP_PEAP = 3
  • BrickMaster.WIFI_EAP_OPTION_INNER_AUTH_EAP_MSCHAP = 0
  • BrickMaster.WIFI_EAP_OPTION_INNER_AUTH_EAP_GTC = 4
  • BrickMaster.WIFI_EAP_OPTION_CERT_TYPE_CA_CERT = 0
  • BrickMaster.WIFI_EAP_OPTION_CERT_TYPE_CLIENT_CERT = 8
  • BrickMaster.WIFI_EAP_OPTION_CERT_TYPE_PRIVATE_KEY = 16
public BrickMaster.WifiEncryption getWifiEncryption()

Gibt die Verschlüsselungseinstellungen zurück, wie von setWifiEncryption() gesetzt.

Bemerkung

Seit Master Brick Firmware Version 2.4.4 wird der Schlüssel nicht mehr zurückgegeben.

Die folgenden Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.WIFI_ENCRYPTION_WPA_WPA2 = 0
  • BrickMaster.WIFI_ENCRYPTION_WPA_ENTERPRISE = 1
  • BrickMaster.WIFI_ENCRYPTION_WEP = 2
  • BrickMaster.WIFI_ENCRYPTION_NO_ENCRYPTION = 3
  • BrickMaster.WIFI_EAP_OPTION_OUTER_AUTH_EAP_FAST = 0
  • BrickMaster.WIFI_EAP_OPTION_OUTER_AUTH_EAP_TLS = 1
  • BrickMaster.WIFI_EAP_OPTION_OUTER_AUTH_EAP_TTLS = 2
  • BrickMaster.WIFI_EAP_OPTION_OUTER_AUTH_EAP_PEAP = 3
  • BrickMaster.WIFI_EAP_OPTION_INNER_AUTH_EAP_MSCHAP = 0
  • BrickMaster.WIFI_EAP_OPTION_INNER_AUTH_EAP_GTC = 4
  • BrickMaster.WIFI_EAP_OPTION_CERT_TYPE_CA_CERT = 0
  • BrickMaster.WIFI_EAP_OPTION_CERT_TYPE_CLIENT_CERT = 8
  • BrickMaster.WIFI_EAP_OPTION_CERT_TYPE_PRIVATE_KEY = 16

Das zurückgegebene Objekt enthält die Public-Member-Variablen short encryption, String key, short keyIndex, short eapOptions, int caCertificateLength, int clientCertificateLength und int privateKeyLength.

public BrickMaster.WifiStatus getWifiStatus()

Gibt den Status der WIFI Extension zurück. state wird automatisch aktualisiert, alle anderen Parameter werden nur beim Starten und nach jedem Aufruf von refreshWifiStatus() aktualisiert.

Mögliche Werte für state sind:

State Beschreibung
0 Getrennt
1 Verbunden
2 Verbindung wird aufgebaut
3 Fehler
255 Noch nicht initialisiert

Die folgenden Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.WIFI_STATE_DISASSOCIATED = 0
  • BrickMaster.WIFI_STATE_ASSOCIATED = 1
  • BrickMaster.WIFI_STATE_ASSOCIATING = 2
  • BrickMaster.WIFI_STATE_ERROR = 3
  • BrickMaster.WIFI_STATE_NOT_INITIALIZED_YET = 255

Das zurückgegebene Objekt enthält die Public-Member-Variablen short[] macAddress, short[] bssid, short channel, short rssi, short[] ip, short[] subnetMask, short[] gateway, long rxCount, long txCount und short state.

public void refreshWifiStatus()

Aktualisiert den WLAN Status (siehe getWifiStatus()). Um den Status vom WLAN Modul zu lesen, muss der Master Brick vom Datenmodus in den Kommandomodus und wieder zurück wechseln. Dieser Wechsel und das eigentliche Auslesen ist leider zeitaufwändig. Dass heißt, es dauert ein paar ms bis der Stapel mit aufgesteckter WIFI Extension wieder reagiert nachdem die Funktion aufgerufen wurde.

public void setWifiCertificate(int index, short[] data, short dataLength)

Diese Funktion kann benutzt werden um sowohl das Zertifikat als auch Benutzername und Passwort für WPA Enterprise zu setzen. Für den Benutzernamen muss Index 0xFFFF und für das Password Index 0xFFFE genutzt werden. Die maximale Länge für beide ist 32.

Das Zertifikat wird in Chunks der Größe 32 geschrieben und der Index gibt den Index des Chunk an. data_length sollte fast immer auf 32 gesetzt werden. Nur beim letzten Chunk ist eine Länge ungleich 32 möglich.

Der Startindex für CA Certificate ist 0, für Client Certificate 10000 und für Private Key 20000. Die Maximalen Dateigrößen sind jeweils 1312, 1312 und 4320 Byte.

Die Werte sind im EEPROM gespeichert und werden nur beim Start angewandt. Das bedeutet der Master Brick muss nach einer Konfiguration neu gestartet werden.

Wir empfehlen den Brick Viewer zu verwenden, um die Zertifikate, Benutzernamen und Passwort zu konfigurieren.

public BrickMaster.WifiCertificate getWifiCertificate(int index)

Gibt das Zertifikat für einen Index zurück, wie von setWifiCertificate() gesetzt.

Das zurückgegebene Objekt enthält die Public-Member-Variablen short[] data und short dataLength.

public void setWifiPowerMode(short mode)

Setzt den Stromsparmodus für die WIFI Extension. Mögliche Werte sind:

Mode Beschreibung
0 Full Speed (hoher Stromverbrauch, hoher Durchsatz)
1 Low Power (geringer Stromverbrauch, geringer Durchsatz)

Der Standardwert ist 0 (Full Speed).

Die folgenden Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.WIFI_POWER_MODE_FULL_SPEED = 0
  • BrickMaster.WIFI_POWER_MODE_LOW_POWER = 1
public short getWifiPowerMode()

Gibt den Stromsparmodus zurück, wie von setWifiPowerMode() gesetzt.

Die folgenden Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.WIFI_POWER_MODE_FULL_SPEED = 0
  • BrickMaster.WIFI_POWER_MODE_LOW_POWER = 1
public BrickMaster.WifiBufferInfo getWifiBufferInfo()

Gibt Informationen über denn WLAN Empfangsbuffer zurück. Der WLAN Empfangsbuffer hat eine maximale Größe von 1500 Byte und falls zu viele Daten übertragen werden, kann er überlaufen.

Die Rückgabewerte sind die Anzahl der Overflows, die Low-Watermark (d.h. die kleinste Anzahl an Byte die je noch frei waren im Buffer) und die Anzahl der im Moment verwendeten Bytes im Buffer.

Es sollte immer versucht werden den Buffer leer zu halten, andernfalls ist mit einer permanenten Latenz zu rechnen. Eine gute Daumenregel ist, nicht mehr als 1000 Nachrichten pro Sekunde zu verschicken.

Dabei sollten am besten nie mehr als 50 Nachrichten auf einmal ohne Pausen gesendet werden.

Das zurückgegebene Objekt enthält die Public-Member-Variablen long overflow, int lowWatermark und int used.

public void setWifiRegulatoryDomain(short domain)

Setzt den Geltungsbereich der WIFI Extension. Mögliche Werte sind:

Geltungsbereich Beschreibung
0 FCC: Kanal 1-11 (N/S Amerika, Australien, Neuseeland)
1 ETSI: Kanal 1-13 (Europa, Mittlerer Osten, Afrika)
2 TELEC: Kanal 1-14 (Japan)

Der Standardwert ist 1 (ETSI).

Die folgenden Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.WIFI_DOMAIN_CHANNEL_1TO11 = 0
  • BrickMaster.WIFI_DOMAIN_CHANNEL_1TO13 = 1
  • BrickMaster.WIFI_DOMAIN_CHANNEL_1TO14 = 2
public short getWifiRegulatoryDomain()

Gibt den Geltungsbereich zurück, wie von setWifiRegulatoryDomain() gesetzt.

Die folgenden Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.WIFI_DOMAIN_CHANNEL_1TO11 = 0
  • BrickMaster.WIFI_DOMAIN_CHANNEL_1TO13 = 1
  • BrickMaster.WIFI_DOMAIN_CHANNEL_1TO14 = 2
public int getUSBVoltage()

Gibt die USB Spannung in mV zurück. Funktioniert nicht mit Hardware Version 2.1.

public void setLongWifiKey(String key)

Setzt einen langen WLAN Schlüssel (bis zu 63 Zeichen, mindestens 8 Zeichen) für WPA Verschlüsselung. Dieser Schlüssel wird genutzt, wenn der Schlüssel in setWifiEncryption() auf "-" gesetzt wird. Im alten Protokoll war ein Payload der Größe 63 nicht möglich, dadurch wurde die maximale Schlüssellänge auf 50 gesetzt.

Mit dem neuen Protokoll ist die volle Schlüssellänge möglich. Da wir keine API brechen wollten, wurde diese Funktion zusätzlich hinzugefügt.

Neu in Version 2.0.2 (Firmware).

public String getLongWifiKey()

Gibt den Verschlüsselungsschlüssel zurück, wie von setLongWifiKey() gesetzt.

Bemerkung

Seit Master Brick Firmware Version 2.4.4 wird der Schlüssel nicht mehr zurückgegeben.

Neu in Version 2.0.2 (Firmware).

public void setWifiHostname(String hostname)

Setzt den Hostnamen der WIFI Extension. Der Hostname wird von Access Points als Hostname in der DHCP Client Tabelle angezeigt.

Das setzen eines leeren Strings stellt den voreingestellten Hostnamen wieder her.

Neu in Version 2.0.5 (Firmware).

public String getWifiHostname()

Gibt den Hostnamen zurück, wie von setWifiHostname() gesetzt.

Ein leerer String bedeutet, dass der voreingestellte Hostname genutzt wird.

Neu in Version 2.0.5 (Firmware).

public boolean isEthernetPresent()

Gibt zurück ob eine Ethernet Extension zur Nutzung durch den Master Brick verfügbar ist.

Neu in Version 2.1.0 (Firmware).

public void setEthernetConfiguration(short connection, short[] ip, short[] subnetMask, short[] gateway, int port)

Setzt die Konfiguration der Ethernet Extension. Mögliche Werte für connection sind:

Wert Beschreibung
0 DHCP
1 Statische IP

Wenn connection auf die statische IP Option gesetzt wird, dann müssen ip, subnet_mask und gateway als ein Array der Größe 4 angegeben werden. Dabei ist das erste Element im Array das niederwertigste Byte. Falls connection auf die DHCP Option gesetzt ist, werden ip, subnet_mask und gateway ignoriert.

Der letzte Parameter ist der Port auf den das Anwendungsprogramm sich verbindet. Der Standardport von brickd ist 4223.

Die Werte sind im EEPROM gespeichert und werden nur beim Start angewandt. Das bedeutet der Master Brick muss nach einer Konfiguration neu gestartet werden.

Wir empfehlen den Brick Viewer zu verwenden, um die Ethernet Extension zu konfigurieren.

Die folgenden Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.ETHERNET_CONNECTION_DHCP = 0
  • BrickMaster.ETHERNET_CONNECTION_STATIC_IP = 1

Neu in Version 2.1.0 (Firmware).

public BrickMaster.EthernetConfiguration getEthernetConfiguration()

Gibt die Konfiguration zurück, wie von setEthernetConfiguration() gesetzt.

Die folgenden Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.ETHERNET_CONNECTION_DHCP = 0
  • BrickMaster.ETHERNET_CONNECTION_STATIC_IP = 1

Neu in Version 2.1.0 (Firmware).

Das zurückgegebene Objekt enthält die Public-Member-Variablen short connection, short[] ip, short[] subnetMask, short[] gateway und int port.

public BrickMaster.EthernetStatus getEthernetStatus()

Gibt den Status der Ethernet Extension zurück.

mac_address, ip, subnet_mask und gateway werden als Array übergeben. Das erste Element des Arrays ist das niederwertigste Byte.

rx_count und tx_count sind die Anzahl der Bytes die seit dem letzten Neustart empfangen/gesendet wurden.

hostname ist der aktuell genutzte Hostname.

Neu in Version 2.1.0 (Firmware).

Das zurückgegebene Objekt enthält die Public-Member-Variablen short[] macAddress, short[] ip, short[] subnetMask, short[] gateway, long rxCount, long txCount und String hostname.

public void setEthernetHostname(String hostname)

Setzt den Hostnamen der Ethernet Extension. Der Hostname wird von Access Points als Hostname in der DHCP Client Tabelle angezeigt.

Das setzen eines leeren Strings stellt den voreingestellten Hostnamen wieder her.

Der aktuelle Hostname kann mit getEthernetStatus() herausgefunden werden.

Neu in Version 2.1.0 (Firmware).

public void setEthernetMACAddress(short[] macAddress)

Setzt die MAC Adresse der Ethernet Extension. Die Ethernet Extension sollte mit einer vorkonfigurierten MAC Adresse ausgeliefert werden. Diese MAC Adresse steht auch auf einem Aufkleber auf der Ethernet Extension.

Die MAC Adresse kann mit getEthernetStatus() wieder ausgelesen werden.

Neu in Version 2.1.0 (Firmware).

public void setEthernetWebsocketConfiguration(short sockets, int port)

Setzt die Ethernet WebSocket-Konfiguration. Der erste Parameter setzt die Anzahl der Socket-Verbindungen die für WebSockets reserviert werden. Der mögliche Wertebereich ist 0-7. Die Verbindungen werden zwischen den normalen Sockets und den WebSockets aufgeteilt. Beispiel: Wenn die Socket-Verbindungen auf 3 gesetzt werden, stehen 3 WebSockets und 4 normale Sockets zur Verfügung.

Der zweite Parameter ist der Port für die WebSocket-Verbindungen. Der Port kann nicht der gleiche sein wie der Port des normalen Sockets.

Die Werte sind im EEPROM gespeichert und werden nur beim Start angewandt. Das bedeutet der Master Brick muss nach einer Konfiguration neu gestartet werden.

Wir empfehlen den Brick Viewer zu verwenden, um die Ethernet Extension zu konfigurieren.

Die Standardwerte sind 3 für die Anzahl der Socket-Verbindungen und 4280 für den Port.

Neu in Version 2.2.0 (Firmware).

public BrickMaster.EthernetWebsocketConfiguration getEthernetWebsocketConfiguration()

Gibt die Konfiguration zurück, wie von setEthernetConfiguration() gesetzt.

Neu in Version 2.2.0 (Firmware).

Das zurückgegebene Objekt enthält die Public-Member-Variablen short sockets und int port.

public void setEthernetAuthenticationSecret(String secret)

Setzt das Authentifizierungsgeheimnis. Das Geheimnis ist ein String aus bis zu 64 Buchstaben. Ein leerer String deaktiviert die Authentifizierung.

Für mehr Informationen zur Authentifizierung siehe das dazugehörige Tutorial.

Das Authentifizierungsgehemnis wird im EEPROM gespeichert und nur beim Start angewandt. Das bedeutet der Master Brick muss nach einer Konfiguration neu gestartet werden.

Wir empfehlen den Brick Viewer zu verwenden, um die Authentifizierung der Ethernet Extension einzurichten.

Der Standardwert ist ein leerer String (Authentifizierung deaktiviert).

Neu in Version 2.2.0 (Firmware).

public String getEthernetAuthenticationSecret()

Gibt das Authentifizierungsgeheimnis zurück, wie von setEthernetAuthenticationSecret() gesetzt.

Neu in Version 2.2.0 (Firmware).

public void setWifiAuthenticationSecret(String secret)

Setzt das Authentifizierungsgeheimnis. Das Geheimnis ist ein String aus bis zu 64 Buchstaben. Ein leerer String deaktiviert die Authentifizierung.

Für mehr Informationen zur Authentifizierung siehe das dazugehörige Tutorial.

Das Authentifizierungsgehemnis wird im EEPROM gespeichert und nur beim Start angewandt. Das bedeutet der Master Brick muss nach einer Konfiguration neu gestartet werden.

Wir empfehlen den Brick Viewer zu verwenden, um die Authentifizierung der WIFI Extension einzurichten.

Der Standardwert ist ein leerer String (Authentifizierung deaktiviert).

Neu in Version 2.2.0 (Firmware).

public String getWifiAuthenticationSecret()

Gibt das Authentifizierungsgeheimnis zurück, wie von setWifiAuthenticationSecret() gesetzt.

Neu in Version 2.2.0 (Firmware).

public short getConnectionType()

Gibt den Typ der Verbingung zurück, über welche diese Funktion aufgerufen wurde.

Die folgenden Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.CONNECTION_TYPE_NONE = 0
  • BrickMaster.CONNECTION_TYPE_USB = 1
  • BrickMaster.CONNECTION_TYPE_SPI_STACK = 2
  • BrickMaster.CONNECTION_TYPE_CHIBI = 3
  • BrickMaster.CONNECTION_TYPE_RS485 = 4
  • BrickMaster.CONNECTION_TYPE_WIFI = 5
  • BrickMaster.CONNECTION_TYPE_ETHERNET = 6
  • BrickMaster.CONNECTION_TYPE_WIFI2 = 7

Neu in Version 2.4.0 (Firmware).

public boolean isWifi2Present()

Gibt zurück ob eine WIFI Extension 2.0 zur Nutzung durch den Master Brick verfügbar ist.

Neu in Version 2.4.0 (Firmware).

public byte startWifi2Bootloader()

Startet den Bootloader der WIFI Extension 2.0. Gibt bei Erfolg 0 zurück. Danach können die writeWifi2SerialPort() und readWifi2SerialPort() Funktionen zur Kommunikation mit dem Bootloader verwendet werden, um eine neue Firmware zu flashen.

Der bootloader sollte nur über eine USB Verbindung gestartet werden. Er kann nicht über eine WIFI2 Verbindung gestartet werden, siehe die getConnectionType() Funktion.

Wir empfehlen den Brick Viewer zu verwenden, um die Firmware der WIFI Extension 2.0 zu aktualisieren.

Neu in Version 2.4.0 (Firmware).

public byte writeWifi2SerialPort(short[] data, short length)

Schreibt bis zu 60 Bytes (Anzahl zu schreibender Bytes mit length angeben) auf die serielle Schnittstelle des Bootloaders der WIFI Extension 2.0. Gibt bei Erfolg 0 zurück.

Bevor diese Funktion genutzt werden kann muss der Bootloader mit der startWifi2Bootloader() Funktion gestartet werden.

Wir empfehlen den Brick Viewer zu verwenden, um die Firmware der WIFI Extension 2.0 zu aktualisieren.

Neu in Version 2.4.0 (Firmware).

public BrickMaster.ReadWifi2SerialPort readWifi2SerialPort(short length)

Liest bis zu 60 Bytes (Anzahl zu lesender Bytes mit length angegeben) von der seriellen Schnittstelle des Bootloaders der WIFI Extension 2.0. Gibt die Anzahl der wirklich gelesenen Bytes zurück.

Bevor diese Funktion genutzt werden kann muss der Bootloader mit der startWifi2Bootloader() Funktion gestartet werden.

Wir empfehlen den Brick Viewer zu verwenden, um die Firmware der WIFI Extension 2.0 zu aktualisieren.

Neu in Version 2.4.0 (Firmware).

Das zurückgegebene Objekt enthält die Public-Member-Variablen short[] data und short result.

public void setWifi2AuthenticationSecret(String secret)

Setzt das WLAN-Authentifizierungsgeheimnis. Das Geheimnis ist ein String aus bis zu 64 Buchstaben. Ein leerer String deaktiviert die Authentifizierung. Der Standardwert ist ein leerer String (Authentifizierung deaktiviert).

Für mehr Informationen zur Authentifizierung siehe das dazugehörige Tutorial.

Um Konfigurationsänderungen für die WIFI Extension 2.0 zu übernehmen muss die saveWifi2Configuration() Funktion aufgerufen und der Master Brick danach neugestartet werden.

Wir empfehlen den Brick Viewer zu verwenden, um die WIFI Extension 2.0 zu konfigurieren.

Neu in Version 2.4.0 (Firmware).

public String getWifi2AuthenticationSecret()

Gibt das WLAN-Authentifizierungsgeheimnis zurück, wie von setWifi2AuthenticationSecret() gesetzt.

Neu in Version 2.4.0 (Firmware).

public void setWifi2Configuration(int port, int websocketPort, int websitePort, short phyMode, short sleepMode, short website)

Setzt die allgemeine Konfiguration der WIFI Extension 2.0.

Das port Parameter setzt die Portnummer auf den das Anwendungsprogramm sich verbindet. Der Standardwert ist 4223.

Das websocket_port Parameter setzt die WebSocket-Portnummer auf den das JavaScript Anwendungsprogramm sich verbindet. Der Standardwert ist 4280.

Das website_port Parameter setzt die Portnummer für die Webseite der WIFI Extension 2.0. Der Standardwert ist 80.

Das phy_mode Parameter setzt den zu verwendenden WLAN-Modus. Mögliche Werte sinf B, G und N. Der Standardwert ist G.

Die sleep_mode und website Parameter werden momentan nicht verwendet.

Um Konfigurationsänderungen für die WIFI Extension 2.0 zu übernehmen muss die saveWifi2Configuration() Funktion aufgerufen und der Master Brick danach neugestartet werden.

Wir empfehlen den Brick Viewer zu verwenden, um die WIFI Extension 2.0 zu konfigurieren.

Die folgenden Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.WIFI2_PHY_MODE_B = 0
  • BrickMaster.WIFI2_PHY_MODE_G = 1
  • BrickMaster.WIFI2_PHY_MODE_N = 2

Neu in Version 2.4.0 (Firmware).

public BrickMaster.Wifi2Configuration getWifi2Configuration()

Gibt die allgemeine Konfiguration zurück, wie von setWifi2Configuration() gesetzt.

Die folgenden Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.WIFI2_PHY_MODE_B = 0
  • BrickMaster.WIFI2_PHY_MODE_G = 1
  • BrickMaster.WIFI2_PHY_MODE_N = 2

Neu in Version 2.4.0 (Firmware).

Das zurückgegebene Objekt enthält die Public-Member-Variablen int port, int websocketPort, int websitePort, short phyMode, short sleepMode und short website.

public BrickMaster.Wifi2Status getWifi2Status()

Gibt den Client und Access Point Status der WIFI Extension 2.0 zurück.

Die folgenden Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.WIFI2_CLIENT_STATUS_IDLE = 0
  • BrickMaster.WIFI2_CLIENT_STATUS_CONNECTING = 1
  • BrickMaster.WIFI2_CLIENT_STATUS_WRONG_PASSWORD = 2
  • BrickMaster.WIFI2_CLIENT_STATUS_NO_AP_FOUND = 3
  • BrickMaster.WIFI2_CLIENT_STATUS_CONNECT_FAILED = 4
  • BrickMaster.WIFI2_CLIENT_STATUS_GOT_IP = 5
  • BrickMaster.WIFI2_CLIENT_STATUS_UNKNOWN = 255

Neu in Version 2.4.0 (Firmware).

Das zurückgegebene Objekt enthält die Public-Member-Variablen boolean clientEnabled, short clientStatus, short[] clientIP, short[] clientSubnetMask, short[] clientGateway, short[] clientMACAddress, long clientRXCount, long clientTXCount, byte clientRSSI, boolean apEnabled, short[] apIP, short[] apSubnetMask, short[] apGateway, short[] apMACAddress, long apRXCount, long apTXCount und short apConnectedCount.

public void setWifi2ClientConfiguration(boolean enable, String ssid, short[] ip, short[] subnetMask, short[] gateway, short[] macAddress, short[] bssid)

Setzt die Client-spezifische Konfiguration der WIFI Extension 2.0.

Das enable Parameter aktiviert oder deaktiviert den Client-Teil der WIFI Extension 2.0. Der Standardwert ist true.

Das ssid Parameter die SSID (bis zu 32 Zeichen) des Access Points zu dem die WLAN Verbindung hergestellt werden soll.

Wenn die ip, subnet_mask und gateway Parameter alle auf Null gesetzt sind, dann wird DHCP verwendet. Andernfalls kann mit diese drei Parametern eine statische IP Adresse eingestellt werden. Die Standardeinstellung ist DHCP.

Wenn das mac_address Parameter auf Null gesetzt ist, dann wird die voreingestellt MAC Adresse verwendet. Andernfalls kann mit diesem Parameter eine eigene MAC Adresse eingestellt werden.

Wenn das bssid Parameter auf Null gesetzt ist, dann verbindet sich die WIFI Extension 2.0 mit einem Access Point wenn die eingestellt SSID übereinstimmt. Andernfalls kann dieses Parameter verwendet werden, damit sich die WIFI Extension 2.0 nur dann mit einem Access Point verbindet, wenn SSID und BSSID übereinstimmen.

Um Konfigurationsänderungen für die WIFI Extension 2.0 zu übernehmen muss die saveWifi2Configuration() Funktion aufgerufen und der Master Brick danach neugestartet werden.

Wir empfehlen den Brick Viewer zu verwenden, um die WIFI Extension 2.0 zu konfigurieren.

Neu in Version 2.4.0 (Firmware).

public BrickMaster.Wifi2ClientConfiguration getWifi2ClientConfiguration()

Gibt die Client Konfiguration zurück, wie von setWifi2ClientConfiguration() gesetzt.

Neu in Version 2.4.0 (Firmware).

Das zurückgegebene Objekt enthält die Public-Member-Variablen boolean enable, String ssid, short[] ip, short[] subnetMask, short[] gateway, short[] macAddress und short[] bssid.

public void setWifi2ClientHostname(String hostname)

Setzt den Client Hostnamen (bis zu 32 Zeichen) der WIFI Extension 2.0. Der Hostname wird von Access Points als Hostname in der DHCP Client Tabelle angezeigt.

Um Konfigurationsänderungen für die WIFI Extension 2.0 zu übernehmen muss die saveWifi2Configuration() Funktion aufgerufen und der Master Brick danach neugestartet werden.

Wir empfehlen den Brick Viewer zu verwenden, um die WIFI Extension 2.0 zu konfigurieren.

Neu in Version 2.4.0 (Firmware).

public String getWifi2ClientHostname()

Gibt den Client Hostnamen zurück, wie von setWifi2ClientHostname() gesetzt.

Neu in Version 2.4.0 (Firmware).

public void setWifi2ClientPassword(String password)

Setzt das Client-Passwort (bis zu 63 Zeichen) für WPA/WPA2 Verschlüsselung.

Um Konfigurationsänderungen für die WIFI Extension 2.0 zu übernehmen muss die saveWifi2Configuration() Funktion aufgerufen und der Master Brick danach neugestartet werden.

Wir empfehlen den Brick Viewer zu verwenden, um die WIFI Extension 2.0 zu konfigurieren.

Neu in Version 2.4.0 (Firmware).

public String getWifi2ClientPassword()

Gibt das Client-Passwort zurück, wie von setWifi2ClientPassword() gesetzt.

Bemerkung

Seit WIFI Extension 2.0 Firmware Version 2.1.3 wird das Passwort nicht mehr zurückgegeben.

Neu in Version 2.4.0 (Firmware).

public void setWifi2APConfiguration(boolean enable, String ssid, short[] ip, short[] subnetMask, short[] gateway, short encryption, boolean hidden, short channel, short[] macAddress)

Setzt die Access-Point-spezifische Konfiguration der WIFI Extension 2.0.

Das enable Parameter aktiviert oder deaktiviert den Access-Point-Teil der WIFI Extension 2.0. Der Standardwert ist true.

Das ssid Parameter die SSID (bis zu 32 Zeichen) des Access Points.

Wenn die ip, subnet_mask und gateway Parameter alle auf Null gesetzt sind, dann wird ein DHCP Server aktiviert. Andernfalls kann mit diese drei Parametern eine statische IP Adresse eingestellt werden. Die Standardeinstellung ist DHCP.

Das encryption Parameter legt den Verschlüsselungsmodus fest. Mögliche Werte sind Open (keine Verschlüsselung), WEP oder WPA/WPA2 PSK. Der Standardwert ist WPA/WPA2 PSK. Mit der setWifi2APPassword() Kann das Verschlüsselungspasswort gesetzt werden.

Das hidden Parameter legt fest, oder der Access Point seine SSID versteckt oder zeigt. Der Standardwert ist false.

Das channel Parameter gibt den Kanal (1 to 13) des Access Points and. Der Standardwert ist 1.

Wenn das mac_address Parameter auf Null gesetzt ist, dann wird die voreingestellt MAC Adresse verwendet. Andernfalls kann mit diesem Parameter eine eigene MAC Adresse eingestellt werden.

Um Konfigurationsänderungen für die WIFI Extension 2.0 zu übernehmen muss die saveWifi2Configuration() Funktion aufgerufen und der Master Brick danach neugestartet werden.

Wir empfehlen den Brick Viewer zu verwenden, um die WIFI Extension 2.0 zu konfigurieren.

Die folgenden Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.WIFI2_AP_ENCRYPTION_OPEN = 0
  • BrickMaster.WIFI2_AP_ENCRYPTION_WEP = 1
  • BrickMaster.WIFI2_AP_ENCRYPTION_WPA_PSK = 2
  • BrickMaster.WIFI2_AP_ENCRYPTION_WPA2_PSK = 3
  • BrickMaster.WIFI2_AP_ENCRYPTION_WPA_WPA2_PSK = 4

Neu in Version 2.4.0 (Firmware).

public BrickMaster.Wifi2APConfiguration getWifi2APConfiguration()

Gibt die Access-Point-Konfiguration zurück, wie von setWifi2APConfiguration() gesetzt.

Die folgenden Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.WIFI2_AP_ENCRYPTION_OPEN = 0
  • BrickMaster.WIFI2_AP_ENCRYPTION_WEP = 1
  • BrickMaster.WIFI2_AP_ENCRYPTION_WPA_PSK = 2
  • BrickMaster.WIFI2_AP_ENCRYPTION_WPA2_PSK = 3
  • BrickMaster.WIFI2_AP_ENCRYPTION_WPA_WPA2_PSK = 4

Neu in Version 2.4.0 (Firmware).

Das zurückgegebene Objekt enthält die Public-Member-Variablen boolean enable, String ssid, short[] ip, short[] subnetMask, short[] gateway, short encryption, boolean hidden, short channel und short[] macAddress.

public void setWifi2APPassword(String password)

Setzt das Access-Point-Passwort (bis zu 63 Zeichen) für den eingestellten Verschlüsselungsmodus, siehe setWifi2APConfiguration().

Um Konfigurationsänderungen für die WIFI Extension 2.0 zu übernehmen muss die saveWifi2Configuration() Funktion aufgerufen und der Master Brick danach neugestartet werden.

Wir empfehlen den Brick Viewer zu verwenden, um die WIFI Extension 2.0 zu konfigurieren.

Neu in Version 2.4.0 (Firmware).

public String getWifi2APPassword()

Gibt das Access-Point-Passwort zurück, wie von setWifi2APPassword() gesetzt.

Bemerkung

Seit WIFI Extension 2.0 Firmware Version 2.1.3 wird das Passwort nicht mehr zurückgegeben.

Neu in Version 2.4.0 (Firmware).

public short saveWifi2Configuration()

alle Konfigurationsfunktionen der WIFI Extension 2.0 ändern die Werte nicht dauerhaft. Nach einer Konfiguration muss diese Funktion aufgerufen werden, um die Werte dauerhaft zu speichern.

Die Werte sind im EEPROM gespeichert und werden nur beim Start angewandt. Das bedeutet der Master Brick muss nach einer Konfiguration neu gestartet werden.

Neu in Version 2.4.0 (Firmware).

public short[] getWifi2FirmwareVersion()

Gibt die aktuelle Version der WIFI Extension 2.0 Firmware zurück (major, minor, revision).

Neu in Version 2.4.0 (Firmware).

public void enableWifi2StatusLED()

Aktiviert die grüne Status LED der WIFI Extension 2.0.

Neu in Version 2.4.0 (Firmware).

public void disableWifi2StatusLED()

Deaktiviert die grüne Status LED der WIFI Extension 2.0.

Neu in Version 2.4.0 (Firmware).

public boolean isWifi2StatusLEDEnabled()

Gibt true zurück falls die grüne Status LED der WIFI Extension 2.0 aktiviert ist.

Neu in Version 2.4.0 (Firmware).

public void setWifi2MeshConfiguration(boolean enable, short[] rootIP, short[] rootSubnetMask, short[] rootGateway, short[] routerBSSID, short[] groupID, String groupSSIDPrefix, short[] gatewayIP, int gatewayPort)

Benötigt WIFI Extension 2.0 Firmware 2.1.0.

Set die Mesh-Konfiguration der WIFI Extension 2.0.

Das enable Parameter aktiviert oder deaktiviert den Mesh-Teil der WIFI Extension 2.0. Der Standardwert ist false. Der Mesh-Teil kann nicht zusammen mit dem Client- und Access-Point-Teil aktiviert werden.

Wenn die root_ip, root_subnet_mask und root_gateway Parameter alle auf Null gesetzt sind, dann wird DHCP verwendet. Andernfalls kann mit diese drei Parametern eine statische IP Adresse eingestellt werden. Die Standardeinstellung ist DHCP.

Wenn das router_bssid Parameter auf Null gesetzt ist, dann verbindet sich die WIFI Extension 2.0 mit einem Access Point wenn die eingestellt SSID übereinstimmt, siehe setWifi2MeshRouterSSID(). Andernfalls kann dieses Parameter verwendet werden, damit sich die WIFI Extension 2.0 nur dann mit einem Access Point verbindet, wenn SSID und BSSID übereinstimmen. Die BSSID kann auch verwendet werden, um eine Verbindung mit einer verstecken SSID herzustellen.

Die group_id und group_ssid_prefix Parameter identifizieren in bestimmtes Mesh-Netzwerk und alle WIFI Extension 2.0 mit der gleichen Gruppeneinstellung gehören um gleichen Mesh-Netzwerk.

Die gateway_ip und``gateway_port`` Parameter geben an, wie der Mesh-Gateway (brickd) erreicht werden kann.

Um Konfigurationsänderungen für die WIFI Extension 2.0 zu übernehmen muss die saveWifi2Configuration() Funktion aufgerufen und der Master Brick danach neugestartet werden.

Wir empfehlen den Brick Viewer zu verwenden, um die WIFI Extension 2.0 zu konfigurieren.

Neu in Version 2.4.2 (Firmware).

public BrickMaster.Wifi2MeshConfiguration getWifi2MeshConfiguration()

Benötigt WIFI Extension 2.0 Firmware 2.1.0.

Gibt das Mesh Konfiguration zurück, wie von setWifi2MeshConfiguration() gesetzt.

Neu in Version 2.4.2 (Firmware).

Das zurückgegebene Objekt enthält die Public-Member-Variablen boolean enable, short[] rootIP, short[] rootSubnetMask, short[] rootGateway, short[] routerBSSID, short[] groupID, String groupSSIDPrefix, short[] gatewayIP und int gatewayPort.

public void setWifi2MeshRouterSSID(String ssid)

Benötigt WIFI Extension 2.0 Firmware 2.1.0.

Setzt die Mesh-Router-SSID der WIFI Extension 2.0. Diese wird verwendet um den Mesh Router festzulegen.

Zu beachten ist, dass zwar 32 Zeichen als SSID übergeben werden können, aber im Moment davon nur die ersten 31 Zeichen genutzt werden bedingt durch einen Bug in der verwendeten Mesh-Bibliothek.

Um Konfigurationsänderungen für die WIFI Extension 2.0 zu übernehmen muss die saveWifi2Configuration() Funktion aufgerufen und der Master Brick danach neugestartet werden.

Wir empfehlen den Brick Viewer zu verwenden, um die WIFI Extension 2.0 zu konfigurieren.

Neu in Version 2.4.2 (Firmware).

public String getWifi2MeshRouterSSID()

Benötigt WIFI Extension 2.0 Firmware 2.1.0.

Gibt das Mesh-Router-SSID zurück, wie von setWifi2MeshRouterSSID() gesetzt.

Neu in Version 2.4.2 (Firmware).

public void setWifi2MeshRouterPassword(String password)

Benötigt WIFI Extension 2.0 Firmware 2.1.0.

Setzt das Mesh-Router-Passwort (bis zu 64 Zeichen) für WPA/WPA2 Verschlüsselung. Das Password wird für die Verbindung zum Mesh Router verwendet.

Um Konfigurationsänderungen für die WIFI Extension 2.0 zu übernehmen muss die saveWifi2Configuration() Funktion aufgerufen und der Master Brick danach neugestartet werden.

Wir empfehlen den Brick Viewer zu verwenden, um die WIFI Extension 2.0 zu konfigurieren.

Neu in Version 2.4.2 (Firmware).

public String getWifi2MeshRouterPassword()

Benötigt WIFI Extension 2.0 Firmware 2.1.0.

Gibt das Mesh-Router-Password zurück, wie von setWifi2MeshRouterPassword() gesetzt.

Neu in Version 2.4.2 (Firmware).

public BrickMaster.Wifi2MeshCommonStatus getWifi2MeshCommonStatus()

Benötigt WIFI Extension 2.0 Firmware 2.1.0.

Gibt den allgemeinen Mesh-Status der WIFI Extension 2.0 zurück.

Die folgenden Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.WIFI2_MESH_STATUS_DISABLED = 0
  • BrickMaster.WIFI2_MESH_STATUS_WIFI_CONNECTING = 1
  • BrickMaster.WIFI2_MESH_STATUS_GOT_IP = 2
  • BrickMaster.WIFI2_MESH_STATUS_MESH_LOCAL = 3
  • BrickMaster.WIFI2_MESH_STATUS_MESH_ONLINE = 4
  • BrickMaster.WIFI2_MESH_STATUS_AP_AVAILABLE = 5
  • BrickMaster.WIFI2_MESH_STATUS_AP_SETUP = 6
  • BrickMaster.WIFI2_MESH_STATUS_LEAF_AVAILABLE = 7

Neu in Version 2.4.2 (Firmware).

Das zurückgegebene Objekt enthält die Public-Member-Variablen short status, boolean rootNode, boolean rootCandidate, int connectedNodes, long rxCount und long txCount.

public BrickMaster.Wifi2MeshClientStatus getWifi2MeshClientStatus()

Benötigt WIFI Extension 2.0 Firmware 2.1.0.

Gibt den Mesh-Client-Status der WIFI Extension 2.0 zurück.

Neu in Version 2.4.2 (Firmware).

Das zurückgegebene Objekt enthält die Public-Member-Variablen String hostname, short[] ip, short[] subnetMask, short[] gateway und short[] macAddress.

public BrickMaster.Wifi2MeshAPStatus getWifi2MeshAPStatus()

Benötigt WIFI Extension 2.0 Firmware 2.1.0.

Gibt den Mesh-AP-Status der WIFI Extension 2.0 zurück.

Neu in Version 2.4.2 (Firmware).

Das zurückgegebene Objekt enthält die Public-Member-Variablen String ssid, short[] ip, short[] subnetMask, short[] gateway und short[] macAddress.

public short[] getAPIVersion()

Gibt die Version der API Definition (Major, Minor, Revision) zurück, die diese API Bindings implementieren. Dies ist weder die Release-Version dieser API Bindings noch gibt es in irgendeiner Weise Auskunft über den oder das repräsentierte(n) Brick oder Bricklet.

public boolean getResponseExpected(short functionId)

Gibt das Response-Expected-Flag für die Funktion mit der angegebenen Funktions IDs zurück. Es ist true falls für die Funktion beim Aufruf eine Antwort erwartet wird, false andernfalls.

Für Getter-Funktionen ist diese Flag immer gesetzt und kann nicht entfernt werden, da diese Funktionen immer eine Antwort senden. Für Konfigurationsfunktionen für Listeners ist es standardmäßig gesetzt, kann aber entfernt werden mittels setResponseExpected(). Für Setter-Funktionen ist es standardmäßig nicht gesetzt, kann aber gesetzt werden.

Wenn das Response-Expected-Flag für eine Setter-Funktion gesetzt ist, können Timeouts und andere Fehlerfälle auch für Aufrufe dieser Setter-Funktion detektiert werden. Das Gerät sendet dann eine Antwort extra für diesen Zweck. Wenn das Flag für eine Setter-Funktion nicht gesetzt ist, dann wird keine Antwort vom Gerät gesendet und Fehler werden stillschweigend ignoriert, da sie nicht detektiert werden können.

Siehe setResponseExpected() für die Liste der verfügbaren Funktions ID Konstanten für diese Funktion.

public void setResponseExpected(short functionId, boolean responseExpected)

Ändert das Response-Expected-Flag für die Funktion mit der angegebenen Funktion IDs. Diese Flag kann nur für Setter-Funktionen (Standardwert: false) und Konfigurationsfunktionen für Listeners (Standardwert: true) geändert werden. Für Getter-Funktionen ist das Flag immer gesetzt.

Wenn das Response-Expected-Flag für eine Setter-Funktion gesetzt ist, können Timeouts und andere Fehlerfälle auch für Aufrufe dieser Setter-Funktion detektiert werden. Das Gerät sendet dann eine Antwort extra für diesen Zweck. Wenn das Flag für eine Setter-Funktion nicht gesetzt ist, dann wird keine Antwort vom Gerät gesendet und Fehler werden stillschweigend ignoriert, da sie nicht detektiert werden können.

Die folgenden Funktions ID Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.FUNCTION_SET_EXTENSION_TYPE = 3
  • BrickMaster.FUNCTION_SET_CHIBI_ADDRESS = 6
  • BrickMaster.FUNCTION_SET_CHIBI_MASTER_ADDRESS = 8
  • BrickMaster.FUNCTION_SET_CHIBI_SLAVE_ADDRESS = 10
  • BrickMaster.FUNCTION_SET_CHIBI_FREQUENCY = 14
  • BrickMaster.FUNCTION_SET_CHIBI_CHANNEL = 16
  • BrickMaster.FUNCTION_SET_RS485_ADDRESS = 19
  • BrickMaster.FUNCTION_SET_RS485_SLAVE_ADDRESS = 21
  • BrickMaster.FUNCTION_SET_RS485_CONFIGURATION = 24
  • BrickMaster.FUNCTION_SET_WIFI_CONFIGURATION = 27
  • BrickMaster.FUNCTION_SET_WIFI_ENCRYPTION = 29
  • BrickMaster.FUNCTION_REFRESH_WIFI_STATUS = 32
  • BrickMaster.FUNCTION_SET_WIFI_CERTIFICATE = 33
  • BrickMaster.FUNCTION_SET_WIFI_POWER_MODE = 35
  • BrickMaster.FUNCTION_SET_WIFI_REGULATORY_DOMAIN = 38
  • BrickMaster.FUNCTION_SET_LONG_WIFI_KEY = 41
  • BrickMaster.FUNCTION_SET_WIFI_HOSTNAME = 43
  • BrickMaster.FUNCTION_SET_STACK_CURRENT_CALLBACK_PERIOD = 45
  • BrickMaster.FUNCTION_SET_STACK_VOLTAGE_CALLBACK_PERIOD = 47
  • BrickMaster.FUNCTION_SET_USB_VOLTAGE_CALLBACK_PERIOD = 49
  • BrickMaster.FUNCTION_SET_STACK_CURRENT_CALLBACK_THRESHOLD = 51
  • BrickMaster.FUNCTION_SET_STACK_VOLTAGE_CALLBACK_THRESHOLD = 53
  • BrickMaster.FUNCTION_SET_USB_VOLTAGE_CALLBACK_THRESHOLD = 55
  • BrickMaster.FUNCTION_SET_DEBOUNCE_PERIOD = 57
  • BrickMaster.FUNCTION_SET_ETHERNET_CONFIGURATION = 66
  • BrickMaster.FUNCTION_SET_ETHERNET_HOSTNAME = 69
  • BrickMaster.FUNCTION_SET_ETHERNET_MAC_ADDRESS = 70
  • BrickMaster.FUNCTION_SET_ETHERNET_WEBSOCKET_CONFIGURATION = 71
  • BrickMaster.FUNCTION_SET_ETHERNET_AUTHENTICATION_SECRET = 73
  • BrickMaster.FUNCTION_SET_WIFI_AUTHENTICATION_SECRET = 75
  • BrickMaster.FUNCTION_SET_WIFI2_AUTHENTICATION_SECRET = 82
  • BrickMaster.FUNCTION_SET_WIFI2_CONFIGURATION = 84
  • BrickMaster.FUNCTION_SET_WIFI2_CLIENT_CONFIGURATION = 87
  • BrickMaster.FUNCTION_SET_WIFI2_CLIENT_HOSTNAME = 89
  • BrickMaster.FUNCTION_SET_WIFI2_CLIENT_PASSWORD = 91
  • BrickMaster.FUNCTION_SET_WIFI2_AP_CONFIGURATION = 93
  • BrickMaster.FUNCTION_SET_WIFI2_AP_PASSWORD = 95
  • BrickMaster.FUNCTION_ENABLE_WIFI2_STATUS_LED = 99
  • BrickMaster.FUNCTION_DISABLE_WIFI2_STATUS_LED = 100
  • BrickMaster.FUNCTION_SET_WIFI2_MESH_CONFIGURATION = 102
  • BrickMaster.FUNCTION_SET_WIFI2_MESH_ROUTER_SSID = 104
  • BrickMaster.FUNCTION_SET_WIFI2_MESH_ROUTER_PASSWORD = 106
  • BrickMaster.FUNCTION_SET_SPITFP_BAUDRATE_CONFIG = 231
  • BrickMaster.FUNCTION_SET_SPITFP_BAUDRATE = 234
  • BrickMaster.FUNCTION_ENABLE_STATUS_LED = 238
  • BrickMaster.FUNCTION_DISABLE_STATUS_LED = 239
  • BrickMaster.FUNCTION_RESET = 243
public void setResponseExpectedAll(boolean responseExpected)

Ändert das Response-Expected-Flag für alle Setter-Funktionen und Konfigurationsfunktionen für Listeners diese Gerätes.

public void setSPITFPBaudrateConfig(boolean enableDynamicBaudrate, long minimumDynamicBaudrate)

Das SPITF-Protokoll kann mit einer dynamischen Baudrate genutzt werden. Wenn die dynamische Baudrate aktiviert ist, versucht der Brick die Baudrate anhand des Datenaufkommens zwischen Brick und Bricklet anzupassen.

Die Baudrate wird exponentiell erhöht wenn viele Daten gesendet/empfangen werden und linear verringert wenn wenig Daten gesendet/empfangen werden.

Diese Vorgehensweise verringert die Baudrate in Anwendungen wo nur wenig Daten ausgetauscht werden müssen (z.B. eine Wetterstation) und erhöht die Robustheit. Wenn immer viele Daten ausgetauscht werden (z.B. Thermal Imaging Bricklet), wird die Baudrate automatisch erhöht.

In Fällen wo wenige Daten all paar Sekunden so schnell wie Möglich übertragen werden sollen (z.B. RS485 Bricklet mit hoher Baudrate aber kleinem Payload) kann die dynamische Baudrate zum maximieren der Performance ausgestellt werden.

Die maximale Baudrate kann pro Port mit der Funktion setSPITFPBaudrate(). gesetzt werden. Falls die dynamische Baudrate nicht aktiviert ist, wird die Baudrate wie von setSPITFPBaudrate() gesetzt statisch verwendet.

Die minimale dynamische Baudrate hat einen Wertebereich von 400000 bis 2000000 Baud.

Standardmäßig ist die dynamische Baudrate aktiviert und die minimale dynamische Baudrate ist 400000.

Neu in Version 2.4.6 (Firmware).

public BrickMaster.SPITFPBaudrateConfig getSPITFPBaudrateConfig()

Gibt die Baudratenkonfiguration zurück, siehe setSPITFPBaudrateConfig().

Neu in Version 2.4.6 (Firmware).

Das zurückgegebene Objekt enthält die Public-Member-Variablen boolean enableDynamicBaudrate und long minimumDynamicBaudrate.

public long getSendTimeoutCount(short communicationMethod)

Gibt den Timeout-Zähler für die verschiedenen Kommunikationsmöglichkeiten zurück

Die Kommunikationsmöglichkeiten 0-2 stehen auf allen Bricks zur verfügung, 3-7 nur auf Master Bricks.

Diese Funktion ist hauptsächlich zum debuggen während der Entwicklung gedacht. Im normalen Betrieb sollten alle Zähler fast immer auf 0 stehen bleiben.

Die folgenden Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.COMMUNICATION_METHOD_NONE = 0
  • BrickMaster.COMMUNICATION_METHOD_USB = 1
  • BrickMaster.COMMUNICATION_METHOD_SPI_STACK = 2
  • BrickMaster.COMMUNICATION_METHOD_CHIBI = 3
  • BrickMaster.COMMUNICATION_METHOD_RS485 = 4
  • BrickMaster.COMMUNICATION_METHOD_WIFI = 5
  • BrickMaster.COMMUNICATION_METHOD_ETHERNET = 6
  • BrickMaster.COMMUNICATION_METHOD_WIFI_V2 = 7

Neu in Version 2.4.3 (Firmware).

public void setSPITFPBaudrate(char brickletPort, long baudrate)

Setzt die Baudrate eines spezifischen Bricklet Ports ('a' - 'd'). Die Baudrate hat einen möglichen Wertebereich von 400000 bis 2000000.

Für einen höheren Durchsatz der Bricklets kann die Baudrate erhöht werden. Wenn der Fehlerzähler auf Grund von lokaler Störeinstrahlung hoch ist (siehe getSPITFPErrorCount()) kann die Baudrate verringert werden.

Wenn das Feature der dynamische Baudrate aktiviert ist, setzt diese Funktion die maximale Baudrate (siehe setSPITFPBaudrateConfig()).

EMV Tests werden mit der Standardbaudrate durchgeführt. Falls eine CE-Kompatibilität o.ä. in der Anwendung notwendig ist empfehlen wir die Baudrate nicht zu ändern.

Die Standardbaudrate für alle Ports ist 1400000.

Neu in Version 2.4.3 (Firmware).

public long getSPITFPBaudrate(char brickletPort)

Gibt die Baudrate für einen Bricklet Port zurück, siehe setSPITFPBaudrate().

Neu in Version 2.4.3 (Firmware).

public BrickMaster.SPITFPErrorCount getSPITFPErrorCount(char brickletPort)

Gibt die Anzahl der Fehler die während der Kommunikation zwischen Brick und Bricklet aufgetreten sind zurück.

Die Fehler sind aufgeteilt in

  • ACK-Checksummen Fehler,
  • Message-Checksummen Fehler,
  • Framing Fehler und
  • Overflow Fehler.

Die Fehlerzähler sind für Fehler die auf der Seite des Bricks auftreten. Jedes Bricklet hat eine ähnliche Funktion welche die Fehler auf Brickletseite ausgibt.

Neu in Version 2.4.3 (Firmware).

Das zurückgegebene Objekt enthält die Public-Member-Variablen long errorCountACKChecksum, long errorCountMessageChecksum, long errorCountFrame und long errorCountOverflow.

public void enableStatusLED()

Aktiviert die Status LED.

Die Status LED ist die blaue LED neben dem USB-Stecker. Wenn diese aktiviert ist, ist sie an und sie flackert wenn Daten transferiert werden. Wenn sie deaktiviert ist, ist sie immer aus.

Der Standardzustand ist aktiviert.

Neu in Version 2.3.2 (Firmware).

public void disableStatusLED()

Deaktiviert die Status LED.

Die Status LED ist die blaue LED neben dem USB-Stecker. Wenn diese aktiviert ist, ist sie an und sie flackert wenn Daten transferiert werden. Wenn sie deaktiviert ist, ist sie immer aus.

Der Standardzustand ist aktiviert.

Neu in Version 2.3.2 (Firmware).

public boolean isStatusLEDEnabled()

Gibt true zurück wenn die Status LED aktiviert ist, false sonst.

Neu in Version 2.3.2 (Firmware).

public BrickMaster.Protocol1BrickletName getProtocol1BrickletName(char port)

Gibt die Firmware und Protokoll Version und den Namen des Bricklets für einen gegebenen Port zurück.

Der einzige Zweck dieser Funktion ist es, automatischen Flashen von Bricklet v1.x.y Plugins zu ermöglichen.

Das zurückgegebene Objekt enthält die Public-Member-Variablen short protocolVersion, short[] firmwareVersion und String name.

public short getChipTemperature()

Gibt die Temperatur in °C/10, gemessen im Mikrocontroller, aus. Der Rückgabewert ist nicht die Umgebungstemperatur.

Die Temperatur ist lediglich proportional zur echten Temperatur und hat eine Genauigkeit von +-15%. Daher beschränkt sich der praktische Nutzen auf die Indikation von Temperaturveränderungen.

public void reset()

Ein Aufruf dieser Funktion setzt den Brick zurück. Befindet sich der Brick innerhalb eines Stapels wird der gesamte Stapel zurück gesetzt.

Nach dem Zurücksetzen ist es notwendig neue Geräteobjekte zu erzeugen, Funktionsaufrufe auf bestehende führt zu undefiniertem Verhalten.

public BrickMaster.Identity getIdentity()

Gibt die UID, die UID zu der der Brick verbunden ist, die Position, die Hard- und Firmware Version sowie den Device Identifier zurück.

Die Position kann '0'-'8' (Stack Position) sein.

Eine Liste der Device Identifier Werte ist hier zu finden. Es gibt auch eine Konstante für den Device Identifier dieses Brick.

Das zurückgegebene Objekt enthält die Public-Member-Variablen String uid, String connectedUid, char position, short[] hardwareVersion, short[] firmwareVersion und int deviceIdentifier.

Konfigurationsfunktionen für Listener

public void setStackCurrentCallbackPeriod(long period)

Setzt die Periode in ms mit welcher der StackCurrentListener Listener ausgelöst wird. Ein Wert von 0 deaktiviert den Listener.

Der StackCurrentListener Listener wird nur ausgelöst wenn sich die Stromstärke seit der letzten Auslösung geändert hat.

Der Standardwert ist 0.

Neu in Version 2.0.5 (Firmware).

public long getStackCurrentCallbackPeriod()

Gibt die Periode zurück, wie von setStackCurrentCallbackPeriod() gesetzt

Neu in Version 2.0.5 (Firmware).

public void setStackVoltageCallbackPeriod(long period)

Setzt die Periode in ms mit welcher der StackVoltageListener Listener ausgelöst wird. Ein Wert von 0 deaktiviert den Listener.

Der StackVoltageListener Listener wird nur ausgelöst wenn sich die Spannung seit der letzten Auslösung geändert hat.

Der Standardwert ist 0.

Neu in Version 2.0.5 (Firmware).

public long getStackVoltageCallbackPeriod()

Gibt die Periode zurück, wie von setStackVoltageCallbackPeriod() gesetzt

Neu in Version 2.0.5 (Firmware).

public void setUSBVoltageCallbackPeriod(long period)

Setzt die Periode in ms mit welcher der USBVoltageListener Listener ausgelöst wird. Ein Wert von 0 deaktiviert den Listener.

Der USBVoltageListener Listener wird nur ausgelöst wenn sich die Spannung seit der letzten Auslösung geändert hat.

Der Standardwert ist 0.

Neu in Version 2.0.5 (Firmware).

public long getUSBVoltageCallbackPeriod()

Gibt die Periode zurück, wie von setUSBVoltageCallbackPeriod() gesetzt

Neu in Version 2.0.5 (Firmware).

public void setStackCurrentCallbackThreshold(char option, int min, int max)

Setzt den Schwellwert für den StackCurrentReachedListener Listener.

Die folgenden Optionen sind möglich:

Option Beschreibung
'x' Listener ist inaktiv
'o' Listener wird ausgelöst wenn die Stromstärke außerhalb des min und max Wertes ist
'i' Listener wird ausgelöst wenn die Stromstärke innerhalb des min und max Wertes ist
'<' Listener wird ausgelöst wenn die Stromstärke kleiner als der min Wert ist (max wird ignoriert)
'>' Listener wird ausgelöst wenn die Stromstärke größer als der min Wert ist (max wird ignoriert)

Der Standardwert ist ('x', 0, 0).

Die folgenden Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.THRESHOLD_OPTION_OFF = 'x'
  • BrickMaster.THRESHOLD_OPTION_OUTSIDE = 'o'
  • BrickMaster.THRESHOLD_OPTION_INSIDE = 'i'
  • BrickMaster.THRESHOLD_OPTION_SMALLER = '<'
  • BrickMaster.THRESHOLD_OPTION_GREATER = '>'

Neu in Version 2.0.5 (Firmware).

public BrickMaster.StackCurrentCallbackThreshold getStackCurrentCallbackThreshold()

Gibt den Schwellwert zurück, wie von setStackCurrentCallbackThreshold() gesetzt.

Die folgenden Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.THRESHOLD_OPTION_OFF = 'x'
  • BrickMaster.THRESHOLD_OPTION_OUTSIDE = 'o'
  • BrickMaster.THRESHOLD_OPTION_INSIDE = 'i'
  • BrickMaster.THRESHOLD_OPTION_SMALLER = '<'
  • BrickMaster.THRESHOLD_OPTION_GREATER = '>'

Neu in Version 2.0.5 (Firmware).

Das zurückgegebene Objekt enthält die Public-Member-Variablen char option, int min und int max.

public void setStackVoltageCallbackThreshold(char option, int min, int max)

Setzt den Schwellwert für den StackVoltageReachedListener Listener.

Die folgenden Optionen sind möglich:

Option Beschreibung
'x' Listener ist inaktiv
'o' Listener wird ausgelöst wenn die Spannung außerhalb des min und max Wertes ist
'i' Listener wird ausgelöst wenn die Spannung innerhalb des min und max Wertes ist
'<' Listener wird ausgelöst wenn die Spannung kleiner als der min Wert ist (max wird ignoriert)
'>' Listener wird ausgelöst wenn die Spannung größer als der min Wert ist (max wird ignoriert)

Der Standardwert ist ('x', 0, 0).

Die folgenden Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.THRESHOLD_OPTION_OFF = 'x'
  • BrickMaster.THRESHOLD_OPTION_OUTSIDE = 'o'
  • BrickMaster.THRESHOLD_OPTION_INSIDE = 'i'
  • BrickMaster.THRESHOLD_OPTION_SMALLER = '<'
  • BrickMaster.THRESHOLD_OPTION_GREATER = '>'

Neu in Version 2.0.5 (Firmware).

public BrickMaster.StackVoltageCallbackThreshold getStackVoltageCallbackThreshold()

Gibt den Schwellwert zurück, wie von setStackVoltageCallbackThreshold() gesetzt.

Die folgenden Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.THRESHOLD_OPTION_OFF = 'x'
  • BrickMaster.THRESHOLD_OPTION_OUTSIDE = 'o'
  • BrickMaster.THRESHOLD_OPTION_INSIDE = 'i'
  • BrickMaster.THRESHOLD_OPTION_SMALLER = '<'
  • BrickMaster.THRESHOLD_OPTION_GREATER = '>'

Neu in Version 2.0.5 (Firmware).

Das zurückgegebene Objekt enthält die Public-Member-Variablen char option, int min und int max.

public void setUSBVoltageCallbackThreshold(char option, int min, int max)

Setzt den Schwellwert für den USBVoltageReachedListener Listener.

Die folgenden Optionen sind möglich:

Option Beschreibung
'x' Listener ist inaktiv
'o' Listener wird ausgelöst wenn die Spannung außerhalb des min und max Wertes ist
'i' Listener wird ausgelöst wenn die Spannung innerhalb des min und max Wertes ist
'<' Listener wird ausgelöst wenn die Spannung kleiner als der min Wert ist (max wird ignoriert)
'>' Listener wird ausgelöst wenn die Spannung größer als der min Wert ist (max wird ignoriert)

Der Standardwert ist ('x', 0, 0).

Die folgenden Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.THRESHOLD_OPTION_OFF = 'x'
  • BrickMaster.THRESHOLD_OPTION_OUTSIDE = 'o'
  • BrickMaster.THRESHOLD_OPTION_INSIDE = 'i'
  • BrickMaster.THRESHOLD_OPTION_SMALLER = '<'
  • BrickMaster.THRESHOLD_OPTION_GREATER = '>'

Neu in Version 2.0.5 (Firmware).

public BrickMaster.USBVoltageCallbackThreshold getUSBVoltageCallbackThreshold()

Gibt den Schwellwert zurück, wie von setUSBVoltageCallbackThreshold() gesetzt.

Die folgenden Konstanten sind für diese Funktion verfügbar:

  • BrickMaster.THRESHOLD_OPTION_OFF = 'x'
  • BrickMaster.THRESHOLD_OPTION_OUTSIDE = 'o'
  • BrickMaster.THRESHOLD_OPTION_INSIDE = 'i'
  • BrickMaster.THRESHOLD_OPTION_SMALLER = '<'
  • BrickMaster.THRESHOLD_OPTION_GREATER = '>'

Neu in Version 2.0.5 (Firmware).

Das zurückgegebene Objekt enthält die Public-Member-Variablen char option, int min und int max.

public void setDebouncePeriod(long debounce)

Setzt die Periode in ms mit welcher die Schwellwert Listeners

ausgelöst werden, wenn die Schwellwerte

weiterhin erreicht bleiben.

Der Standardwert ist 100.

Neu in Version 2.0.5 (Firmware).

public long getDebouncePeriod()

Gibt die Entprellperiode zurück, wie von setDebouncePeriod() gesetzt.

Neu in Version 2.0.5 (Firmware).

Listener

Listener können registriert werden um zeitkritische oder wiederkehrende Daten vom Gerät zu erhalten. Die Registrierung kann mit "add*Listener" Funktionen eines Geräteobjekts durchgeführt werden.

Der Parameter ist ein Listener Klassen Objekt, z.B.:

device.addExampleListener(new BrickMaster.ExampleListener() {
    public void property(int value) {
        System.out.println("Value: " + value);
    }
});

Die verfügbaren Listener Klassen mit den Methoden welche überschrieben werden können werden unterhalb beschrieben. Es ist möglich mehrere Listener hinzuzufügen und auch mit einem korrespondierenden "remove*Listener" wieder zu entfernen.

Bemerkung

Listener für wiederkehrende Ereignisse zu verwenden ist immer zu bevorzugen gegenüber der Verwendung von Abfragen. Es wird weniger USB-Bandbreite benutzt und die Latenz ist erheblich geringer, da es keine Paketumlaufzeit gibt.

public class BrickMaster.StackCurrentListener()

Dieser Listener kann mit der Funktion addStackCurrentListener() hinzugefügt werde. Ein hinzugefügter Listener kann mit der Funktion removeStackCurrentListener() wieder entfernt werden.

public void stackCurrent(int current)

Dieser Listener wird mit der Periode, wie gesetzt mit setStackCurrentCallbackPeriod(), ausgelöst. Der Parameter ist die Stromstärke des Sensors.

Der StackCurrentListener Listener wird nur ausgelöst wenn sich die Stromstärke seit der letzten Auslösung geändert hat.

Neu in Version 2.0.5 (Firmware).

public class BrickMaster.StackVoltageListener()

Dieser Listener kann mit der Funktion addStackVoltageListener() hinzugefügt werde. Ein hinzugefügter Listener kann mit der Funktion removeStackVoltageListener() wieder entfernt werden.

public void stackVoltage(int voltage)

Dieser Listener wird mit der Periode, wie gesetzt mit setStackVoltageCallbackPeriod(), ausgelöst. Der Parameter ist die Spannung des Sensors.

Der StackVoltageListener Listener wird nur ausgelöst wenn sich die Spannung seit der letzten Auslösung geändert hat.

Neu in Version 2.0.5 (Firmware).

public class BrickMaster.USBVoltageListener()

Dieser Listener kann mit der Funktion addUSBVoltageListener() hinzugefügt werde. Ein hinzugefügter Listener kann mit der Funktion removeUSBVoltageListener() wieder entfernt werden.

public void usbVoltage(int voltage)

Dieser Listener wird mit der Periode, wie gesetzt mit setUSBVoltageCallbackPeriod(), ausgelöst. Der Parameter ist die USB Spannung in mV.

Der USBVoltageListener Listener wird nur ausgelöst wenn sich die USB Spannung seit der letzten Auslösung geändert hat.

Funktioniert nicht mit Hardware Version 2.1.

Neu in Version 2.0.5 (Firmware).

public class BrickMaster.StackCurrentReachedListener()

Dieser Listener kann mit der Funktion addStackCurrentReachedListener() hinzugefügt werde. Ein hinzugefügter Listener kann mit der Funktion removeStackCurrentReachedListener() wieder entfernt werden.

public void stackCurrentReached(int current)

Dieser Listener wird ausgelöst wenn der Schwellwert, wie von setStackCurrentCallbackThreshold() gesetzt, erreicht wird. Der Parameter ist der Stromverbrauch des Stapels in mA.

Wenn der Schwellwert erreicht bleibt, wird der Listener mit der Periode, wie mit setDebouncePeriod() gesetzt, ausgelöst.

Neu in Version 2.0.5 (Firmware).

public class BrickMaster.StackVoltageReachedListener()

Dieser Listener kann mit der Funktion addStackVoltageReachedListener() hinzugefügt werde. Ein hinzugefügter Listener kann mit der Funktion removeStackVoltageReachedListener() wieder entfernt werden.

public void stackVoltageReached(int voltage)

Dieser Listener wird ausgelöst wenn der Schwellwert, wie von setStackVoltageCallbackThreshold() gesetzt, erreicht wird. Der Parameter ist die Spannung des Stapels in mV.

Wenn der Schwellwert erreicht bleibt, wird der Listener mit der Periode, wie mit setDebouncePeriod() gesetzt, ausgelöst.

Neu in Version 2.0.5 (Firmware).

public class BrickMaster.USBVoltageReachedListener()

Dieser Listener kann mit der Funktion addUSBVoltageReachedListener() hinzugefügt werde. Ein hinzugefügter Listener kann mit der Funktion removeUSBVoltageReachedListener() wieder entfernt werden.

public void usbVoltageReached(int voltage)

Dieser Listener wird ausgelöst wenn der Schwellwert, wie von setUSBVoltageCallbackThreshold() gesetzt, erreicht wird. Der Parameter ist die Spannung des Sensors.

Wenn der Schwellwert erreicht bleibt, wird der Listener mit der Periode, wie mit setDebouncePeriod() gesetzt, ausgelöst.

Neu in Version 2.0.5 (Firmware).

Konstanten

public static final int BrickMaster.DEVICE_IDENTIFIER

Diese Konstante wird verwendet um einen Master Brick zu identifizieren.

Die getIdentity() Funktion und der EnumerateListener Listener der IP Connection haben ein deviceIdentifier Parameter um den Typ des Bricks oder Bricklets anzugeben.

public static final String BrickMaster.DEVICE_DISPLAY_NAME

Diese Konstante stellt den Anzeigenamen eines Master Brick dar.