iobroker.radar v1.2.1

Tests: Linux/Mac: Windows:

==============

ioBroker radar Adapter für Netzwerk und Bluetooth-Geräte, HP Drucker und ECB-Kurse

Mit diesem Adapter kann man testen ob Geräte via Netzwerk oder Bluetooth verfügbar sind.

Er kann folgendes aufspüren oder anzeigen:

• Geräte IP oder Netzwerkadressen
• Bluetooth normal oder Bluetooth LE
• HP drucker tintenfüllstände
• ECB Umrechnungskurse zum Euro
• UWZ Wetterwarnungen

Er benutzt ping und weitere tools unter linux wie auch fping und arp-scan und diese müssen mit

sudo apt-get install fping arp-scan

installiert werden. Für Bluetooth verwendet es neben Noble http://www.nirsoft.net/utils/bluetooth_viewer.html unter Windows und hcitool auf Linux. Noble ist nun optional und wenn es nicht installiert werden kann wird der Adapter trotzdem laufen. Für bluetooth support unter linux bitte immer folgendes installieren:

sudo apt-get install bluetooth bluez libbluetooth-dev libudev-dev libcap2-bin
sudo setcap cap_net_raw+eip $(eval readlink -f `which node`)

Der BT-Adapter id (0,1,2,...) kann, wenn mehrere BT dongles verwendet werden im Adapterkonfig gesetzt werden. Somit kjann radar zum Beispiel eionen anderen Dongle verwenden als ein anderer adapter wie ble.

Bei Raspi's mit Bluetooth schlage ich vor das interne Bluetooth (und auch WLan falls der Raspi über den Netzwerkanschluss betrieben wird) auszuschalten und nur einen Bluetooth 4.0 USB-Stecker zu verwenden! Dieser ist viel besser und empfängt/sendet auf 3 mal weiteren Entfernungen! Falls sie keinen USB-BT-Adapter haben kann natürlich mit verringerter Leistung der interne BT-Adapter verwendet werden.

Ist nur ein BT-Adapter vorhanden ist die id immer 0!

IP-MAC-Adressen können auch angegeben werden, diese werden aber nur verwendet wenn das Programm 'arp-scan' installiert ist. Am Raspi kann das mit 'sudo apt-get install arp-scan' installiert werden. Es können mehrere MAC-Adressen durch ',' getrennt angegeben werden. Die arp-scan Kommandozeile ist normal 'arp-scan -lgq --retry=4' und der Teil --retry=4 kann geändert werden, entweder retry höher setzten wenn das eine oder andere Geät sehr spät antwortet oder eine andere Schnittstelle wählen falls ifconfig das notwendig macht, z.b auf --interface=br0 --retry=4 wenn ein anderes interface (br0 in diesem Fall) verwendet werden soll.

Wenn sie Arp-scan, hcitool oder l2ping benutzen müssen sie ioBroker als root laufen lassen!!!!! Siehe https://github.com/ioBroker/ioBroker/issues/47 Bei neueren Installationen läuft ioBroker nicht als 'root' sondern als 'iobroker' user. In diesem Fall ist es notwendig iobroker als Benutzer für 'sudo' einzuritchen. Das erledigt man mit dem Kommando

sudo visudo

Und man fügt dort in eine Zeile unter '# User privilege specification'

iobroker    ALL=(ALL:ALL) NOPASSWD: ALL

ein. visudo funktioniert am Raspi wie Nano, auf manchen anderen Rechnern wie vi.

Wenn ein Name mit '-' endet wird er nicht zu whoHere dazugerechnet, erscheint aber unter allHere. Wenn ein Gerät eine IP-Adresse hat und der Name mit HP- beginnt wird versucht alle 500 scans (einstellbar) den Tiuntenfüllstand vom HP-Drucker auszulesen.

Je nach settings für External Network in Sekunden (wenn 0 dann ausgeschaltet) wird die externe IP-Adresse abgefragt und als IP4 abgelegt. Wenn die Abfrage nicht gelingt (von 3 verschiedenen Servern) wird ein Status-Flag auf 0 gesetzt. Der Status kann auch 1 oder 2 sein je nachdem ob die IP von einem oder mehreren Servern zurückgegeben worden ist. Damit kann erkannt werden wenn keine Verbindung zum externen Netzwerk besteht (Status=0) und falls eine besteht die externe IPV4-Adresse ausgelesen werden was ermöglicht dass dynamisch DNS upgedated werden können. Default Delay ist 300 Sekunden (=5 Minuten), ich würde nicht unter 60 (1 Minute) gehen da bei jeder Abfrage 2-3 Webseiten abgefragt werden.

Der Adapter generiert mit arp-scan und Noble (wenn vorhanden) nun auch AllUnknownBTs und AllUnknownIPs JSON-Variablen welche die gefundenen aber nicht im adapter gescannten IP-, MAC- und BT-Adressen listet. Damit können neue devices erkannt werden und potentielle scripts können checken ob sich neue Geräte am Wlan angemeldet haben. Bei IP-Geräten wird die MAC-Adresse, der Hersteller und die IP-Namen unter neden die Adtesse im Netz verwendbar ist angezeigt. Beide Variablen enthalten arrays mit den unbekannten devices. AllUnknownIPs ist ein Array von Strings die mit '; ' getrennt die gefundene IP-Adresse, die MAC-Adresse, den Hersteller (wenn bekannt) des Lan-Adapters und den Reverse-IP-Namen der IP-Adresse enthält. Somit sollten Geräte leicht identifiziert werden können. Bei AllUnknownBTs ist es ein Array von Objekten welche die BT-Adresse, den Herstellernamen falls bekannt und die Signalstärke (rssi, je niedriger desto weiter weg is das device) enthält.

Wenn die IP-adresse mit 'http' beginnt interpretiert radar sie als web-adresse (url) und fragt die Adresse ab anstatt ping zu verwenden. Damit kann der Status eines Webservers (wie z.B. http(s)://iobroker.net) geprüft werden. Bei https kann aber ein Fehler bei den Schlüsseln auch als 'nicht vorhanden' gemeldet werden. So meldet https://forum.iobroker.net abwesend da das Forum nicht im domainschlüssel gelistet ist. Das vorige Beispiel ohne 'forum.' funktioniert.

Für Unwetterwarnungen muss im ioBroker-admin der Längen- und Breitengrad konfiguriert sein damit der Adapter den UWZ-Area_Code findet. Es kann das Intervall (in Sekunden) zwischen den Abfragen angegeben werden, default ist 30 Minuten (1800 Sekunden). Wenn der Wert von Max Messages >0 ist dann werden genau so viele states erzeugt die entweder leer sind oder Meldungen enthalten. Wenn 0 angegeben wird (als default) wird nur ein State erzeugt welcher dann für jede Meldung eine Zeile enthält. Jede Meldung besteht aus dem Meldungs-Text und am Ende eine severity-einstufung. Es kann eingestellt werden ob der der lange (mit genauer Beschreibung für Orte mit Gewitter) oder kurze Warnungstext angezeigt wird.

Important/Wichtig

• Adapter requires node >= v4.3.*!

Changelog

1.2.1

• Added code to use defaults for missing adapter config for those who upgrade from 1.1.x

Changelog

1.2 - Jan 2019

• Added possibility to select the BT-module number the adapter will use. Thius is important if you have multiple adapters running on different BT-modules!
• If you update from older version please add --retry=4 to the arp-scan command line and set the bluetooth hci to 0!
• Added arp-scan command line into configuration and added Admin v3.x style
• Allowed radar to be run as other user than root, see above what is necessary to do before installation!
• changed noble to '@abandonware/noble' as default to try to get V10 compatibility
• Removed ECB-Funtion because ECB moved to variable https site and the simple tools cannot resolve the data anymore. Hope that systemstatus adapter will be able to do so.
• arp-scan --retry was set to 4 to reduce traffic, it can be changed lower or higher with arp-scan command line
• if you upgrade your radar and nothing appears in the arp-scan command line please enter --retry=3 (or 4).
• HTTP checks can also use HTTPS now
• Vendor name is grabbed but maybe later than on first scan because free API allows only one vendor check/second and 1000/day. If you have 30 devices on IP or BT this means it will take about 40 seconds to grab vendors and they should be visible in 2nd or 3rd scan. The adapter caches the vendor information so no further requests happen until adapter restart or new device on BT or network.
• For HP printers the adapter collects now all individual inks in an '.ink' subfolder to reduce the number of items/printer.
• Please run ioBroker as root! Some functions like l2ping or arp-scan and noble may not function!
• Reduced the minimum scan interval to 15 seconds, if not all IP's or BT's are found please increase!
• Removed problem when no location is specified in iobroker-admin and UWZ-code cannot be found

Changelog

1.1.3

• Repository rename to ioBroker.radar to fulfill ioBroker requirements!

1.1.2

• when number of UWS messages is <0 then do not use a \n but \<br> as line separator for easy web display
• Added new long or short text selector in adapter config
• Changed AllUnknownIP/BTs behaviour to exclude if possible known or double values

1.1.1

• Added UWZ Weather warning
• Changed listing of unkown IP's and BT's to remove double entries

Changelog

1.0.2

• Made it first official version

Changelog

0.7.4

• More Bluetoot debug messages if debug enabled
• l2ping problem resolved

Changelog

0.7.3

• Officejext 6?00 Series support für Tintenfüllstände hinzugefügt
• Testing enabled

0.7.2

• Wenn die ip-adresse mit 'http' beginnt interpretiert radar sie als web-adresse und fragt die Adresse ab anstatt ping zu verwenden. Damit kann der Status eines Webservers (wie z.B. http://iobroker.net) geprüft werden.

Changelog

0.7.1

• Wenn hcitool vorhanden ist wird auch mit l2ping nach Bluetooth-Adressen gesucht. Damit wird die Verfügbarkeit von Bluetooth auf Linux weiter verbessert.

0.7.0

• Arp-scan und Noble BT scan kreieren 'AllUnknown*' Variablen die die IP/Mac-Adressen und BT-Adressen listen welche gefunden werden aber nicht in der Device-Liste sind!

0.6.3

• Scan External IP und External Network Status eingeführt.

0.6.1

• Der Gerätename wird überprüft und ' ' oder '.' werden durch '_' ersetzt. Damit werden keine ungültigen Datenpunkte erzeugt.

0.6.0

• Loglevel info loggt nur wenn sich whoHere ändert
• HP-Printer Tintenfüllstand sollte nun auch bei OfficeJet funktionieren
• ECB (European Central Bank) Wechselkurse können abgefragt werden

0.5.0

• Der Adapter nimmt jetzt auch Netzwerk-MAC-Adressen (auch mehrere pro Gerät)

0.4.3

• Bug fixes to 0.4.1
• Der Adapter löscht auch nicht verwendete States/Objekte die der Adapter (mit dieser Instanz) erzeugt hat und die aber nicht mehr gescannt werden.

0.4.1

• Habe für Windows 'Bluetoothview' integriert. Damit ist es auch ohne Noble möglich BT-Devices zu scannen.
• BT LE (wie G-Tags) funktionieren leider nicht damit. Unter Umständen muss das Gerät 'gekoppelt' werden.

0.3.3

• Es werden nur die Objekte erzeugt welche IP oder BT-Adressen haben.
• Der code verwendet jetzt Promises woimmer möglich und die Verwendung/Abhängigkeit von den Modulen 'request' und 'async' wurde eliminiert.
• Der Adapter startet nun auch wenn Noble nicht voll installiert ist, die Noble-BT-LE Scans sind dann einfach nicht vorhanden.

0.2.1

• Implementierung von anyBelow10 wo angezeigt wird ob im Drucker irgendeine Farbe auf/unter 10% Füllstand ist.
• Implementierung von Ausschluß aus whoHere wenn Name mit - endet

0.2.0

• First public release, working fine on Raspberry

0.1.0

• Ok, my first working version on Raspberry!

Install

Installieren über ioBroker.admin

On Linux install fping and arp-scan (with me it worked like sudo apt-get install fping arp-scan)

if fping is available the tool will use ping and fping to check on IP availabilit. if arp-scan is available it will use it to scan mac addresses.

Also make sure that hcitool is installed, normally part of bluez.

Configuration

Jedes Gerät bekommt einen Namen und es wird entweder wird als Ausgang oder Eingang definiert ('output' oder 'input' bzw 'o' oder 'i' ins Feld schreiben). Beginnt der Name des Geätes mit HP- dann nimmt radar an es handelt sich um einen HP-Drucker und es versucht auch (alle 500 scan-Versuche) den Tintenstand auszulesen!

Wenn ein Gerätename mit - endet (z.B. Internet-) dann wird er nicht in whoHere/countHere gelistet. Damit können Geräte oder andere Devices vom Anwesenheitscheck ausgeklammert werden.

Todo

Installation

Auf Linux sollte das tool 'fping' und arp-scan (z.B. mit sudo apt-get install fping arp-scan) installiert werden welches zusätzlich zum normalen ping verwendet wird. Auf Windows sollte das bin.zip nach node_modules\iobroker.radar extrahiert werden da eventuell node_modules\iobroker.radar\bin\bluetoothview\BluetoothView.exe von npm nicht installiert wird.

License

The MIT License (MIT)

Copyright (c) 2014-2016, bluefox dogafox@gmail.com

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.