Software

1) Otevřeme si program HWg-PDMS nebo HWg-Trigger. V našem případě bude k manuálu využit program PDMS, ale úplně stejný postup je i pro program Trriger.

2) Klikneme na Help – Registration.

3) Nyní se nám otevře registrační formulář, pokračujeme tlačítkem Next.

4) V tuto chvíli můžeme vidět nový formulář, kde máme všechny svoje údaje, které jsou vedeny u naší licence. Zaškrtneme pole – Only Save to Activation File a klikneme na Commit.

5) Vybereme kam chceme txt. file uložit.

6) Jako poslední se nám zobrazí okno, které nás informuje o tom, že se soubor úspěšně uložil.

Nejdříve si ukážeme SMS příkazy v případe, že je číslo ze kterého budeme posílat příkaz na seznamu a tím pádem nepotřebujeme znát heslo.

 

1. Nastavení portal adresy SETCFG portal­_server=http://sensdesk.com/portal.php
2. Zapnutí portálu  SETCFG portal_cfg=1
3. Manual Push Push

V případě, že naše telefonní číslo není na seznamu a známe heslo bude sms příkaz vypadat takto. V tomto případě použijeme defaultní heslo 1234 .

1. Nastavení portal adresy 1234 SETCFG portal­_server=http://sensdesk.com/portal.php
2. Zapnutí portálu  1234 SETCFG portal_cfg=1
3. Manual Push 1234 Push

SensDesk podporuje ovládání výstupů pro

• Poseidon2 (3268, 3468, 4002)
• Damocles2 (MINI, 1208, 2404)
• Ares 12/14
• Ares 12 LTE
• SD-2xOutput

Rychlost reakce sepnutí relé výstupu

Všechny produkty připojené do portálu SensDesk komunikují nejméně jednou za 15 minut. To šetří síťový provoz (a peníze u GSM komunikace), ale znamená to dobu potřebnou k sepnutí relé výstupu až 0,1 až 15 minut. To je nepraktické a proto je nyní možné aktivovat z web rozhraní portálu SensDesk pro každý produkt s DO výstupy nastavení CheckPeriod (funkce CheckPush) .

Funkce CheckPeriod zajistí zkrácení doby reakce, po které se přepne relé výstup ve vzdáleném zařízení na 0,1 až 60 sekund.

Jaké výstupy lze ovládat?

DO výstupy v jednotkách Poseidon2 nebo Damocles2 mohou být vázány na lokální podmínku. Výstup může být ovládán lokální funkcí "Termostat" (spínání chladícího ventilátoru při teplotě vyšší než 30°C). Takový DO výstup nelze vzdáleně ovládat (read only).

Z portálu SensDesk lze ovládat pouze výstupy nastavené v manuálním režimu (nejsou na ně aplikovány žádné podmínky a triggery).

Ovládání DO (relé) výstupů z SensDesku

Výstupy na Sensdesku lze ovládat na stránce výstupu v SensDesku, na stránce zařízení nebo v přehledu výstupů. Výchozí hodnotou je neutrální stav:

Přesunutím přepínače na jednu nebo druhou stranu je SensDeskem vydán pokyn pro nastavení výstupu do požadované polohy:

Podle nastavení zařízení je tento pokyn vykonán ve standardní periodě Pushe (15 minut), nebo v periodě zkrácené (60s). Než je příkaz vykonán, můžete změnu stavu výstupů ještě změnit, nebo odvolat. Stránka zařízení se sama neobnovuje a je třeba ji občerstvit ručně.

CheckPeriod: Zkrácení periody reakce výstupu

Pro zrychlení reakce výstupů v zařízení na požadavky od SensDesku byla zavedena funkce CheckPush, která se zapína volbou aktivovat CheckPeriod, která je nastavena na 60s. Použití této zrychlené komunikace se nastavuje v nastavení každého zařízení zvlášť na SensDesku. Check period se uplatňuje výhradně na výstupy a její aplikování na zařízení neurychlí periodu odesílání hodnot senzorů nebo vstupů!

 

Pro nastavení a ověření činnosti použijeme software Device Explorer Twin. Ten stáhneme na adrese https://github.com/Azure/azure-iot-sdks/releases/download/2016-11-17/SetupDeviceExplorer.msi Po spuštění aplikace zadáme do okna IoT Hub Connection String řetězec, který jme obdrželi při zakládání účtu MS Azure, klineme na tláčítko update a následně si vygenerujeme SAS klíč pro potřebnou dobu. V našem případě 365 dní:

Nyní se přepneme na záložku Management a založíme nová produkt s Device IP např. Poseidon24002Demo:

Vytvoření je potvrzeno oknem:

Zařízení nyní vidíme ve výpisu zařízení

Vybereme nově zadané zařízení a stiskem tlačítka SAS Token si vygenerujeme heslo:

Zde si ohlídáme že pole DeviceID obsahuje správné zařízení a pole TTL (Days) má rozumnou délku, tedy délku po jakou bude heslo platné:

Z Tokenu vykopírujeme heslo. To obsahuje vse počínaje řetězcem SharedAccessSignature sr

Nyní nastavíme jednotku Poseidon:

On MQTT page we enable MQTT protocol support. Enter server address which was assigned to us when creating MS Azure account, port add 8883 and at the same time we check Secure SSL Mode. Into field Password we enter password generated by previous step. Username is always a compound of server address and DeviceID, for example hwg.azure-devices.net/Poseidon24002Demo and Client ID is in this case on same level as DeviceID.

At the same time, you still need to allow user defined Topic and as Topic name set: devices/YOUR_DEVICE_ID/messages/events/, for example devices/Poseidon24002Demo/messages/events/:

Into Topic Value we can fill definated content using macros:

// XML template

<?xml version="1.0" encoding="utf-8" ?>
<BinaryInSet>%LOOP_IN%<Entry>
<ID>%VAL_ID%</ID>
<Name>%VAL_NAME%</Name>
<Value>%VAL_VALUE%</Value>
<State>%VAL_STATE%</State>
</Entry>%LOOP_IN_END%</BinaryInSet>

<BinaryOutputSet>%LOOP_OUT%<Entry>
<ID>%VAL_ID%</ID>
<Name>%VAL_NAME%</Name>
<Value>%VAL_VALUE%</Value>
<State>%VAL_STATE%</State>
</Entry>%LOOP_OUT_END%</BinaryOutputSet>

<SensorSet>%LOOP_SENSOR%<Entry>
<ID>%VAL_ID%</ID>
<Name>%VAL_NAME%</Name>
<Value>%VAL_VALUE%</Value>
<State>%VAL_STATE%</State>
</Entry>%LOOP_SENSOR_END%</SensorSet>

<BinaryOutputSet>%ID_OUT_3%<Entry>
<ID>%VAL_ID%</ID>
<Name>%VAL_NAME%</Name>
<Value>%VAL_VALUE%</Value>
<State>%VAL_STATE%</State>
</Entry>%ID_OUT_END%</BinaryOutputSet>

// Json template

{
"sensors": [
%LOOP_SENSOR%{"id":%VAL_ID%,
"name":"%VAL_NAME%",
"value":%VAL_VALUE%,
"state":%VAL_STATE%
},

%LOOP_SENSOR_END%,],
"inputs": [
%LOOP_IN%{"id":%VAL_ID%,
"name":"%VAL_NAME%",
"value":%VAL_VALUE%,
"state":%VAL_STATE%
},
%LOOP_IN_END%,],

"outputs": [
%LOOP_OUT%{"id":%VAL_ID%,
"name":"%VAL_NAME%",
"value":%VAL_VALUE%,
},
%LOOP_OUT_END%,]
}

 

V záložce "UDP Config" utility Hercules lze prohledat lokální segment sítě pomocí UDP Broadcastu a najít naše zařízení na tomto segmentu, případně jim přiřadit jinou IP adresu, MASKu a GateWay. Tato aplikační poznámka popisuje pouze formát hledání stávajících zařízení, nejsou zde uvedeny kódy pro zápis konfigurace do modulu.

Jak funguje hledání/nastavení zařízení

• PC program pošle všeobecnou výzvu, jakožto UDP Broadcast na port 9999 ve formátu:
  \377\377\377\377\377\377IIIIMMMMFFFFWWWWUC12345678(c)HW-server.com

• Na tuto zprávu odpoví všechna zařízení s aktivovanou funkcí UDP Config, která jsou na daném segmentu sítě. Formát odpovědi je podrobně popsán dále.
  Všechna zařízení, která odpověděla, jsou nyní nastavena do "UDP Config mode" dokud nevyprší interní timeout. To znamená, že po určitou dobu čekají na UDP rámec s novým nastavením. Dokud tento rámec nepřijde, zařízení dále pracuje normálně.
• Pokud zařízení přijme UDP rámec s novým nastavením pro daný modul a pokud rámci odpovídá kontrolní šifra, je nové nastavení síťového rozhraní zařízení uloženo a zařízení se zrestartuje. Tento dokument popisuje pouze hledání zařízeni na Ethernet síti, nikoliv změnu jejich konfigurace.

Identifikace modulu a kódování

Na původní UDP Broadcast výzvu, odpoví zařízení rámcem, ve kterém pošle své nastaveni a speciální kód. Zařízení (modul nebo HW jednotka) po odeslání tohoto rámce očekává nastavovací rámec z počítače (od programu jake je Hercules). Rámec z nastavovacího programu je po přijetí ověřen a pokud je správně zašifrovaný, je příchozí UDP rámec zařízením zpracován, jinak je ignorován. Tímto způsobem je také identifikován příjemce, pokud je rámec z PC do zařízení posílán jako UDP Broadcast. UDP rámec ale nemusí byt UDP Broadcast, odpověď lze poslat také jako Unicast výzvu, na kterou odpoví pouze vyzvané zařízení.

Popis odpovědi zařízení (modul nebo HW jednotka)

00	unsigned char	MAC[6];	// MAC address of the module
06	unsigned char	IP[4];	// IP address
0A	unsigned char	Mask[4];	// Subnet mask
0E	unsigned char	FwIP[4];	// Acceptable address range IP
12	unsigned char	FwMask[4];	// Acceptable address range MASK
16	unsigned char	Unit[2];	// Device type - more
1A	unsigned char	GW[4];	// GW address (sometime called User1)
1E	unsigned char	User2[2];	// DEVICE CTRL bits settings - more
20	unsigned char	Port[2];	// incomming TCP port number
22	unsigned char	crypt[16];	// Cryption for Write

Device type
Unit2[1]	A0 A1 A2 A3 A4 B0 B1 B2
Unit2[0]	C0 C1 C2 C3 D0 D1 D2 D3
A - Device type	5 bits	// Device FW type name (e.g. Poseidon)
B - General firmware version	3 bits	// Device FW main number (1.8.2]
C - Firmware version	4 bits	// Device FW second number (1.8.2]
D - Firmware sub-version	4 bits	// Device FW third number (1.8.2]

 

DEVICE CTRL bits settings
User2[0] & 1	bit 0	R/W	Enable TCP TEA authorization
User2[0] & 2	bit 1	R/W	Enable NVT
User2[0] & 4	bit 2	R/W	Enable TCP Setup (default on the port 99)
User2[0] & 8	bit 3	Read only	DHCP support (0 = DHCP not supported)
User2[0] & 16	bit 4	R/W	Enable DHCP, fixed IP address ignored

Z výše popsané struktury všeobecné výzvy a formátu odpovědi již vyplývá, jak použít ve Vašich kódech vyhledávání modulů. Pokud se Vám jedná o možnost zápisu konfigurace z Vašeho vlastního kódu, kontaktujte nás, zašleme Vám podrobnější informace.

Popsaný algoritmus, včetně filtru zařízení podle rozsahu MAC adres lze najít ve zdrojových kódech k aplikaci IP Relay Controller - zdrojové kódy jsou kompilovány pomocí "Borland C++ Builder 6.0".

Applications that use remote inputs and outputs over the network need to have device support added, e.g. using XML. This is easy to achieve with our HWg SDK. However, the user then still needs to connect the Poseidon or Damocles unit to the application.

To do so, one can either prompt the user for an IP address and a port, or search the network for units automatically. The latter, user-friendly method, is exactly what the Installation Wizard supports. The wizard guides the user through the process of identifying the devices, and returns one or more IP addresses of the selected devices to your application.

Source code of the wizard is available in the HWg SDK for several programming languages, together with an example application that calls the wizard.

How to use the Installation Wizard

1) Calling the wizard from your code or application

For details about calling the Installation Wizard, see the following HWg SDK examples:

• EX108: Show Install Wizard (Borland C++ Builder)
• EX208: Show Install Wizard (Microsoft Visual C++)
• EX308: Show Install Wizard (Borland Delphi)
• EX426: Show Install Wizard AX (Microsoft Visual Basic)

 

2) Wizard welcome screen

3) Searching for devices

The wizard looks for devices on the local network (via UDP Broadcast), or at a given IP address (for devices in another network or in the Internet in general).

As an example, you can enter the IP address of our public demo, poseidon.hwg.cz: Type poseidon.hwg.cz in the "Remote IP" field and press "Add Device".

4) Selecting devices from the list

The user selects one or more devices by selecting the checkboxes.

5) Displaying device details

To display the following screen with detailed information about a device, double-click the corresponding line in the table.

6) Returning to your application

By clicking Finish, the user returns to your application. The wizard passes a list of newly selected devices.

7) Adding IP addresses in your application

The SDK example also lets you try to add a new device when a device is already in use (it is marked as such in the Installation Wizard and cannot be removed).

 

 

 

Summary:

The Installation Wizard is completely free, with source code available in the HWg SDK. It is intended for SW developers and aims to simplify support for Poseidon and Damocles family of products.

Monitorovací systém Monitor one od FineConnection je určen k monitorování stavu sítě a síťové infrastruktury. Produkty rodiny Poseidon jsou s M1 plně integrovány a zaručují nejlepší funkci.

V aplikacích pro monitorování prostředí může být žádoucí upozornit správce sítě nebo servisní techniky textovou zprávou (SMS) na výskyt kritických problémů (jako je únik vody, rychlý růst teploty nebo výpadek elektřiny). Monitor one umožňuje odesílat textové zprávy pomocí externího nástroje PageGate od NotePage.

Utilita PageGate nabízí velmi rozmanité funkce a je užitečná i v řadě dalších situací, nejen ve spojení s nástrojem Monitor one. Naše testy však ukázaly, že nefunguje správně v českém prostředí (testováno na Windows XP CZ SP2 a Windows Server 2003 CZ) a může mít potíže i v jiných neanglických prostředích. V anglických systémech Windows Server 2003 EN a Windows XP testy proběhly v pořádku.

Postup nastavení

Následující postup předpokládá, že k systému je připojen správně nakonfigurovaný GSM modem. V tomto příkladu jsme použili modem Teltonica Modemcom G10.

1) Instalace PageGate a počáteční konfigurace

Na instalaci PageGate není nic neobvyklého, co by vyžadovalo podrobnější popis. Na začátku instalace vyberte z nabídky PageGate Server.







 

Po dokončení instalace spusťte PageGate Admin. Aplikace se nejprve spustí v režimu inicializace, kde je třeba nastavit některé parametry. Aby se textové zprávy správně odesílaly, je třeba zaškrtnout volby „GetAscii“, „Scheduler“ a „Connector1“. Doporučujeme ponechat výchozí cesty k adresářům.







 

2) Konfigurace Monitor one

Konfigurace nástroje Monitor one je víceméně přímočará. Nejprve v nabídce „Options“  -> „Global Configuration“ přepněte na kartu „Alerting“ a zaškrtnutím políčka „Send (SMS) alert messages...“ zapněte přeposílání upozornění.







 

Vyberte volbu „Customize“. V následujícím dialogovém okně vyberte volbu „PageGate“ a nastavte cestu k nainstalovanému nástroji PageGate.

Poté vyberte parametry, které se mají odesílat.












 

Nyní vyberte skupiny a uživatele, které chcete upozorňovat přes SMS.

Nejprve je třeba vytvořit skupiny uživatelů. V části „Alert groups“ klikněte pravým tlačítkem myši na volné místo a vyberte „Add a new Alert Group“.





 

V dialogovém okně, které se zobrazí, vyplňte číslo a název skupiny.

Podobně v části „Alert Recipients“ kliknutím pravým tlačítkem myši přidejte uživatele.

V následujícím dialogovém okně vyplňte skupinu uživatele, e-mail a uživatelské jméno, které se použije v PageGate.




 

3) Konfigurace PageGate

Spusťte PageGate Admin a dokončete konfiguraci.

V části „Program“ -> „Settings“ vyberte v nastavení „Run PageGate as“ volbu Windows Service a klikněte na „Apply“. 






 

V části „Interfaces“ -> „GetAscii“ -> „Settings“ zaškrtněte políčko „Enable“ a vyberte adresář „Polling Directory“ (tj. adresář, kde je nainstalována utilita PageGate). Potvrďte nastavení kliknutím na „Apply“.







 

V levém panelu klikněte pravým tlačítkem myši na „Carriers“ a vyberte „Add“.







 

V pravé části okna vyplňte název, jako protokol vyberte „GSM-AT“ a nastavte parametry sériového portu a modemu podle dokumentace k modemu.

Konfigurace může vypadat podobně jako na obrázku. Potvrďte nastavení kliknutím na „Apply“.





 

Poté v nabídce „Connectors“ -> „Connector1“ vyberte číslo sériového portu, ke kterému je GSM modem připojen. Potvrďte kliknutím na „Apply“.








 

Posledním krokem je přidání příjemce.

V levém panelu klikněte pravým tlačítkem myši na „Recipients“ a vyberte „Add“.






 

V pravé části vyplňte jméno a příjmení (Full Name) a uživatelské jméno (Recipient - musí se shodovat s uživatelským jménem zadaným v Monitor one).

V poli „ID/PIN“ vyplňte telefonní číslo. U všech ostatních nastavení ponechejte výchozí hodnoty a klikněte na „Apply“.

Konfigurace je nyní hotová. Jako poslední krok službu spusťte – klikněte na ikonu PageGate ve stavovém panelu (pravý dolní roh, vedle hodin) a vyberte volbu „Start“. Od této chvíle by se upozornění z Monitor one měla přeposílat jako textové zprávy (SMS).

Závěr:

Tento návod ukazuje jen jednoduchou konfiguraci SMS brány. Nástroj Monitor one nabízí mnoho možností upozorňování. Lze jej například nakonfigurovat, aby posílal SMS jen v případě důležitých upozornění nebo jen vybraným lidem.

Monitorovací systém M1 (Monitor one) od FineConnection je určen k monitorování stavu sítě a síťové infrastruktury. Produkty z rodiny Poseidon jsou do programu Monitor one plně integrovány.

Při monitorování prostředí se může objevit požadavek na sepnutí kontaktu (zapnutí sirény, majáku apod.), pokud některá z měřených veličin překročí stanovenou hodnotu.

Monitor one umožňuje při vzniku alarmového stavu spustit externí program nebo dávku. Této funkce používá tento příklad, který spouští skript switch_on.cmd při výskytu jakéhokoliv upozornění (alarmu). Tento skript kontroluje předanou zprávu o alarmovém stavu, a pokud obsahuje daný řetězec (zde „Contact“), zavolá utilitu PosDamIO, která zajistí vzdálené sepnutí výstupu po síti.

Postup nastavení

1) Konfigurace Monitor one

V Monitor one je nutné nejdříve vytvořit „Shooter“, který bude spouštět alarm.

Postup vytvoření „Shooter“ je následující:

• Pravým tlačítkem myši klikněte na ikonu zařízení Poseidon, s kterým chcete pracovat.
• Z kontextové nabídky vyberte volbu „Define Shooter (manually)“.
• V MIB browseru najděte veličinu, která vás zajímá (v tomto příkladu uvažujme teplotu, kterou reprezentuje položka sensValue ve stromu sensEntry), klikněte na ni pravým tlačítkem myši a vyberte „Inspect“.
  
  
  
  
  
  
   
• V dalším kroku vytvořte „Shooter“, a to kliknutím pravým tlačítkem myši na oblast „Shooters“ na pravé straně a výběrem volby „Add a Shooter“.
  
  
  
  
  
  
  
  
  
  
   
• Nastavte typ na „Threshold“ (hodnota v závorkách odpovídá periodě čtení v sekundách), pojmenujte jej (např. Contact) a kliknutím na tlačítko „Save“ jej uložte.
  
  
  
  
  
  
  
  
  
  
   
• Kliknutím vyberte ikonu označující nově vytvořený „Shooter“, v pravém okně MIB browseru klikněte pravým tlačítkem myši na „SensValue“ a vyberte „Add to the selected Shooter“.
  
  
  
  
  
  
  
  
  
  
   
• Parametr „Instance“ je poslední číslo v SNMP adrese proměnné.
  Produkty Poseidon používají pořadí senzoru – ".1" pro první senzor, ".3" pro třetí senzor.
• Pro sledovaný senzor je třeba zadat prahovou hodnotu (pozor, Poseidon vrací v proměnné sensValue teplotu ve °C vynásobenou 10) a operátor.
• Po uložení Shooteru tlačítkem „Add/Modify“ je možné okno MIB browseru zavřít.

2) Vytvoření skriptu

Nyní napíšeme jednoduchý skript, který v případě alarmu zjistí, na kterém zařízení alarm je, a pokud chceme sepnout kontakt, tak jej sepne.

Monitor one umí skriptu předat několik parametrů. Nás v tomto případě zajímá IP adresa zařízení Poseidon, na kterém se alarm vyskytl, a obsah chybového hlášení. V chybovém hlášení je totiž obsažen název „Shooteru“, který alarm vyvolal. Pomocí něj pak filtrujeme požadavky na sepnutí kontaktu.

Skript může mít následující podobu:

@echo off
set IP=%1
set MESSAGE=%2
echo %MESSAGE% | find /C "Contact"
echo %ERRORLEVEL%
if %ERRORLEVEL% EQU 0 posdamio.exe -o 1=ON %IP%
goto eof
:eof

Uložte skript s příponou .cmd. Pro fungování skriptu je nutné, aby program PosDamIO.exe byl ve stejném adresáři jako skript.

Pokud jste pojmenovali „Shooter“ jinak, je třeba tento název použít místo řetězce „Contact“ ve skriptu. Více informací viz AN29: PosDamIO ovládá výstupy z příkazového řádku. Úpravou skriptu lze dosáhnout i filtrování podle jména zařízení nebo spínání jiných kontaktů při alarmu z jiného „Shooteru“.

3) Aktivace „Shooteru“ v Monitor one

Nyní zbývá nastavit spouštění skriptu a spustit "Shooter" pro dané zařízení.

• Chování programu Monitor one se nastavuje v nabídce Option -> Global Configuration. V dialogovém okně vyberte kartu „Alerting“ a na ní zaškrtněte volbu „Execute a program or a script“.
  
  
  
  
  
  
  
  
  
  
   
• Klikněte na odkaz „Customize“. V následujícím dialogovém okně vyberte soubor se skriptem (switch_on.cmd) a zaškrtněte políčka „4 IP address“ a „5 Event Message“.
• Zavřete dialogová okna a vraťte se zpět na mapu sítě.
  
  
  
  
  
  
  
  
  
   
• Klikněte levým tlačítkem na ikonu Poseidon, na kartě „Background Shooters“ vyberte vytvořený „Shooter“, klikněte na něj pravým tlačítkem myši a vyberte volbu „Start this Shooter...“.

Závěr:

Zkontrolujte nastavení tak, že na nastaveném senzoru přivodíte nějakou alarmovou situaci. Po krátké době Poseidon aktivuje příslušný výstup. Sepnutí kontaktu se projeví cvaknutím a rozsvícením LED (Poseidon 3268).

Skript se volá při každé alarmové situaci. Pokud však v popisu alarmu není uveden text „Contact“, utilita PosDamIO pro ovládání výstupu se nespustí.
Vhodnou úpravou skriptu lze dosáhnout větší variability řešení, případně spínat další kontakty atp. To je však nad rámec této aplikační poznámky, která má sloužit spíše k naznačení možného postupu při řešení podobných úkolů.

Poznámka:

Monitor one umí reagovat kromě počátku alarmu i na jeho konec. To lze dobře využít k tomu, abychom sepnutý kontakt opět rozepnuli.

Nejdůležitějším krokem je nastavení Monitor one, aby informoval o konci alarmu. Tato volba je v nabídce Option -> Global Configuration. V dialogovém okně vyberte kartu „Alerting“ a na ní zaškrtněte volbu „Enable Reverse alerting“. Nyní je ještě nutné patřičně upravit skript. To lze udělat mnoha způsoby, jeden z nich následuje. @echo off set IP=%1 set MESSAGE=%2 echo %MESSAGE% | find /C "normal" if %ERRORLEVEL% EQU 0 (call :SetOFF) else (call :SetON) goto eof :SetON echo %MESSAGE% | find /C "Contact" if %ERRORLEVEL% EQU 0 posdamio.exe -o 1=ON %IP% goto eof :SetOFF echo %MESSAGE% | find /C "Contact" if %ERRORLEVEL% EQU 0 posdamio.exe -o 1=OFF %IP% goto eof :eof

Vlastnosti utility

• Verze pro Linux i Windows
• Zdrojové kódy utility jsou součástí HWg SDK
• Veškerá komunikace se zařízeními pomocí XML rozhraní
  • Utilita upravuje XML soubory před odeslání do stavu, jak je vyžaduje zařízení (viz podrobný manuál produktu)

List of parameters

C:\>PosDamIO
Use: posdamio [OPTIONS] IP_ADDRESS [PORT (default: 80)]
Options:
-g, --get Get actual values and print list
-o, --output X=Y Set output X (1..64) to value Y (0, 1, OFF, ON)
-f, --filename SETUP.XML File with configuration for uploading to the
remote device (max. 20000 bytes)
-v, --values VALUES.XML File to store actual values in XML format
-s, --setup SETUP.XML File to store remote device configuration
-t, --text DATA.TXT File to store actual values in text format
-u, --user USER HTTP authorization user
-p, --password PASSWORD HTTP authorization password

-h, --help Print this help and exit
--version Display version information and exit
--error-level Print error levels and exit

Příklady použití

• PosDamIO -g 192.168.0.41
  Vypíše aktuální hodnoty senzorů, vstupů a výstupů na obrazovku
• PosDamIO -o 1=ON 192.168.0.41 8080
  Nastaví na zařízení s IP adresou 192.168.0.41 a HTTP portem 8080 výstup 1 na log. 1
• PosDamIO -g -v c:\data\values.xml 192.168.0.41
  Vypíše na obrazovku nastavení senzorů, vstupů a výstupů a zároveň stáhne a uloží na disk ze zařízení soubor values.xml
• PosDamIO -g -t c:\data\values.txt -u USR -p PSW 192.168.0.41
  Vypíše na obrazovku nastavení senzorů, vstupů a výstupů ze zařízení, které chrání přístup k XML souborům nastaveným HTTP jménem a heslem. Zároveň stáhne a uloží na disk v textové podobě soubor values.txt, který obsahuje totéž, co se vypisuje na obrazovku.
• PosDamIO -o 2=0 -v c:\data\values.xml 192.168.0.41
  Nastaví na zařízení s IP adresou 192.168.0.41 výstup 2 na log. 0, po nastavení stáhne a uloží na disk soubor values.xml. Ten tak lze použít pro ověření provedení nastavení výstupu.
• PosDamIO -s Pos_outdoor_setup.xml 192.168.0.41
  Stáhne a uloží na disk ze zařízení soubor setup.xml pod názvem Pos_outdoor_setup.xml, soubor obsahuje celou konfiguraci zařízení.
• PosDamIO -f Pos_outdoor_setup.xml 192.168.0.41
  Vezme z disku konfigurační soubor Pos_outdoor_setup.xml a odešle jej do zařízení, jako setup.xml. Soubor obsahuje kompletní konfiguraci zařízení, lze tak jednotlivá zařízení naklonovat.
• Využití Errorlevel návratové hodnoty v .bat souboru
  Podle výsledku nastavení výstupu řídí dávkový soubor

-----------
@echo off
PosDamIO.exe -o 1=0 192.168.1.6
if errorlevel 1 goto error1
if errorlevel 0 goto noerror
:error1
echo PosDamIO error (errorLevel = %errorlevel%)
goto end
:noerror
echo PosDamIO OK
goto end
:end
pause
-----------

Tip: Změny konfigurace, jako je přejmenování vstupu nebo senzoru, případně zařízení, lze provést snadno ručně ve staženém setup.xml nebo values.xml a poté soubor odeslat zpět do zařízení.