PIVOYAGER - intelligens szünetmentes táp modul ( UPS ) RASPBERRY PI-hez, beépített watchdog és naptár funkcióval

PIVOYAGER - intelligens szünetmentes táp modul ( UPS ) RASPBERRY PI-hez, beépített watchdog és naptár funkcióval leírás

Futtasd a Raspberry Pi-t akkumulátorról, és vidd magaddal bárhová!

A PiVoyager egy szünetmentes tápegység (UPS) a Raspberry Pi számára, amelyet úgy terveztek, hogy szabványos Li-Ion vagy LiPo akkumulátorokkal működjön.  Programozható watchdoggal, automatikus újraindítással és valós idejű naptárral rendelkezik. A PiVoyagert Pi Zero pHAT formátumúnak tervezték, de bármelyik 40 tűs csatlakozóval rendelkező Raspberry-Pi-n működik, beleértve a Raspberry Pi 3B+-t és a Raspberry Pi 4-et is.

Ha a PiVoyager egy USB áramforráshoz (USB micro-B) és egy Li-Ion/LiPo akkumulátorhoz van csatlakoztatva, akkor egyrészt táplálja a Raspberry Pi-t, másrészt szükség esetén tölti az akkumulátort, 1000mA töltési árammal. Ha az USB tápellátás megszűnik, a PiVoyager automatikusan átvált az akkumulátorra, és egy boost átalakítónak köszönhetően továbbra is 5V-os feszültséggel (max. 2,1A) táplálja a Raspberry Pi-t.

A PiVoyager rendelkezik egy valós idejű naptárral (RTC), amely az aktuális dátum és idő tárolására konfigurálható. Az RTC tartalma mindaddig megmarad, amíg áramforrás van csatlakoztatva, még akkor is, ha a Raspberry Pi le van kapcsolva.

A mellékelt szoftvernek köszönhetően a felhasználó teljes mértékben vezérelheti és felügyelheti a PiVoyagert:

• Figyeli a tápellátás állapotát és az akkumulátor feszültségét,
• Kényszerítheti a Raspberry Pi-t, hogy egy megadott késleltetés után teljesen kikapcsoljon,
• Watchdogként működhet, kikapcsolva a Raspberry Pi-t, ha inaktívvá válik,
• A Raspberry Pi bekapcsolása egy bizonyos időpontban (riasztás),
• Áramtalanítja a Raspberry Pi-t egy bizonyos késleltetés után a leállítást követően.
• Frissíthető a firmware-t I2C-n keresztül a beépített bootloadernek köszönhetően.
• További részletekért, beleértve a szoftver letöltési utasításokat, lásd dokumentációnkat.

PIVOYAGER - intelligens szünetmentes táp modul ( UPS ) RASPBERRY PI-hez, hardver felépítése

A PiVoyager négy státusz visszajelző LED-del rendelkezik, 3 a bal alsó és 1 a bal felső sarokban:

• PG: zöld, az USB tápellátást jelzi
• CH: sárga, a töltés állapotát jelzi
• ST: piros, az általános állapotot jelzi
• 5V: kék, azt jelzi, hogy a Raspberry Pi éppen áram alatt van.

A PiVoyager-en található egy kis nyomógomb. Ha ezt a gombot 3 másodpercnél tovább nyomja meg, a Raspberry Pi kikapcsol. A leállítás után a Raspberry Pi ugyanezen gomb megnyomásával újraindítható. Lehetőség van egy JST PH csatlakozó, vagy tüske hozzáadására a PiVoyagerhez, hogy a pHAT-on található kapcsoló helyett saját nyomógombot csatlakoztasson és azzal lehessen ki/be kapcsolni.

A PiVoyager nem tartalmaz akkumulátor-védő áramkört. A kétpólusú JST PH csatlakozó (2,0 mm-es ) segítségével olyan Li-Ion vagy LiPo akkumulátort kell csatlakoztatni, amelyek saját védőáramkörrel rendelkezik. Egy alternatív 2,54 mm-es 2 tűs csatlakozóhely is rendelkezésre áll az akkumulátor csatlakoztatásához.

A PiVoyager 3,7V névleges feszültségű, 4,2V töltési feszültségű és 1000mA töltési áramot támogató akkumulátorokat céloz meg. Az akkumulátor LOW-nak - azaz alacsony töltöttségűnek -  minősül, ha a feszültség 3,1V alá esik, és LOW állapotban marad, amíg a feszültség 3,3V fölé nem emelkedik. Indításkor a PiVoyager megtagadja a Raspberry Pi áramellátását, ha LOW állapotban van, és először megvárja, hogy az akkumulátor kellőképpen feltöltődjön.

Általánosságban elmondható, hogy a Raspberry Pi megbízható működéséhez a PiVoyagert mindig akkumulátorhoz kell csatlakoztatni, még akkor is, ha az nincs feltöltve.

PiVoyager jellemzői:

• A PiVoyager mérete 65mm x 30mm és jellemzői:
• Microchip MCP73871 LiPo/Li-Ion töltő.
• Egy Texas Instrument TPS61232 x nagy hatékonyságú boost átalakító, amely akár 2,1A-t is biztosít.
• ST STM32F030 Arm Cortex M0 mikrokontroller.
• Készenléti üzemmódban, amikor a RaspberryPi nincs áram alatt, a PiVoyager körülbelül 30 μA-t fogyaszt.
• A PiVoyager rövid vezetésű 40 tűs csatlakozóval vagy egymásba rakható hosszú vezetésű 40 tűscsatlakozóval kerül forgalomba.

• A következő Raspberry Pi GPIO-tüskéket használja ez a kártya:
  • I2C 2. és 3. tűje.
  • Opcionálisan a 26-os pin a GPIO watchdog számára.

A PiVoyager akkumulátor nélkül kerül forgalomba.

A PiVoyager nyílt forráskódú hardver.

PiVoyager Intelligens  UPS funkciók

A PiVoyager az alapvető UPS-funkciók mellett egy mikrokontrollert is tartalmaz, amely kommunikál a Raspberry Pi-vel, és további funkciókat biztosít a felhasználó számára:

a) UPS állapotfigyelés

A felhasználó bármikor megkaphatja a következő információkat:

• Az akkumulátor jelen van-e vagy sem, és töltődik-e vagy sem.
• Az USB szolgáltat-e áramot, vagy az eszköz akkumulátorról működik-e.
• Az akkumulátor aktuális feszültsége
• Azt, hogy a felhasználó megnyomta-e a gombot
• Az RTC-ben tárolt aktuális dátum és idő.

b) Programozható I2C watchdog

Definiáljon X másodperc  watchdog késleltetést. A PiVoyager ekkor elindít egy belső időzítőt, amely másodpercenként növekszik. Ha a PiVoyager bármilyen I2C parancsot kap, az időzítőt 0-ra állítja vissza. Ha azonban az időzítő valaha is eléri a X értéket, a PiVoyager teljesen kikapcsol.

Ezzel könnyen leállíthatjuk a Raspberry PI-t "tiszta leállítás"-sal a következő eljárás alkalmazásával:

1. Állítsunk be egy watchdogot 20 másodpercre (pl. a pivoyager watchdog 20 parancs segítségével).
2. Adjunk ki egy sudo halt parancsot.
3. Ez biztosítja, hogy a Raspberry Pi 20 másodperc alatt teljesen leálljon, és egyáltalán ne fogyasszon áramot. A felhasználó beprogramozhatja a PiVoyagert úgy, hogy egy adott esemény után újraindítsa a Raspberry-Pi-t (lásd lejjebb).

c) Programozható GPIO watchdog

A watchdog úgy működik, mint az I2C, azzal a különbséggel, hogy a leállítás akkor indul el, ha a Raspberry Pi GPIO26 pinje X másodpercnél hosszabb ideig alacsonyan van.

d) RTC: Valós idejű naptár

A PiVoyager valós idejű naptárat kínál, amely időt és dátumot biztosít. A naptár akkor is aktív marad, ha a Raspberry Pi le van kapcsolva, mindaddig, amíg az akkumulátor vagy az USB tápellátás működik.

e) Programozható ébresztő riasztó

A PiVoyager rendelkezik egy programozható ébresztővel, amellyel a Raspberry Pi egy adott dátumon vagy időpontban felébreszthető.

f) Programozható ébresztési késleltetés

A Pivoyager programozható úgy, hogy egy bizonyos késleltetési idő után automatikusan felébredjen a Raspberry Pi, miután leállt (pl. 10 másodperc után).

Vegye figyelembe, hogy ez a funkció nem használható egyidejűleg az ébresztővel.

g) Újraindítási lehetőségek

A PiVoyager a leállítás után úgy konfigurálható, hogy a következő események bármelyike után újrainduljon:

• gombnyomás (alapértelmezett)
• USB-n történő újbóli tápellátás
• Riasztás vagy ébresztési késleltetés

h) Automatikus kikapcsolás alacsony akkumulátor töltöttségi szint esetén

Alapértelmezés szerint a PiVoyager automatikusan kikapcsol 60 másodperc után, ha ez a két feltétel igazolódik:

• akkumulátorról működik  és az akkumulátor feszültsége kb. 3,1 V alá csökken.
  Ez a funkció vagy kikapcsolható, vagy a késleltetés megváltoztatható.

i) I2C bootloader

A PiVoyager tartalmaz egy I2C bootloadert, amely lehetővé teszi új firmware feltöltését az eszközre. Mivel minden nyílt forráskódúként van kiadva, akár saját firmware-t is írhatsz, ha szeretnél!

Design files:

• Schematics
• Firmware and bootloader source code
• Eagle CAD files

A hardver csatlakoztatása

Ha a PiVoyager nem rendelkezik előre beforrasztott 40 tűs GPIO-csatlakozóval, akkor először is forrasztani kell egyet a lapra. A legegyszerűbb megközelítés az, hogy először forrasztja be az 1. tűt, majd ellenőrizze, hogy a fejléc helyesen van-e elhelyezve. Ha kiigazításra van szükség, újra megolvaszthatja a forrasztást az 1. tűn, és kissé elmozdíthatja a csatlakozót. Ezután tegye ugyanezt a 40-es tűvel, szükség esetén igazítva. Ezután forraszthatja be az összes többi lábat.

Gyors tesztként, mielőtt a PiVoyagert a Raspberry Pi tetejére szerelné, táplálhatja a PiVoyagert egy USB-kábellel. A sárga LED kivételével minden LED-nek világítania kell. Miután csatlakoztatta a PiVoyagert a Raspberry Pi tetejére, győződjön meg róla, hogy az Ön által használt USB tápegység elegendő áramot biztosít a Raspberry Pi táplálásához. Soha ne táplálja egyszerre a Raspberry Pi-t és a PiVoyagert. Általánosságban elmondható, hogy a Raspberry Pi megbízható működéséhez a PiVoyagert mindig akkumulátorhoz kell csatlakoztatni, még akkor is, ha nincs feltöltve.

Ezután válasszon egy LiPo vagy Li-Ion akkumulátort, amely megfelel a következő követelményeknek:

• Névleges feszültsége 3,7 V, töltési feszültsége pedig 4,2 V.
• Beépített védelemmel rendelkezik a túlmelegedés, túltöltés és túlkisülés ellen.
• 1000mA töltési áramot fogad el.

Ha az akkumulátor 2 mm-es JST csatlakozóval van ellátva, akkor közvetlenül a PiVoyagerhez csatlakoztathatja.  Ha nem igazán tudod, hogy mit vegyél, válassz egy 2000mA kapacitású, 2mm-es JST csatlakozóval rendelkező Lithion-Ion akkumulátort 

Alternatívaként a PiVoyager egy kéttűs 0,1" csatlakozóhelyet (2,54mm) is kínál, amely alternatív akkumulátorcsatlakozó vagy akkumulátorvezetékek elhelyezésére használható. Minden esetben ellenőrizze kétszeresen az akkumulátorcsatlakozó polaritását. Néhány ritka alkalommal láttunk már fordított csatlakozójú akkumulátorokat. A lapon + és - jelek vannak, amelyek a polaritás jelzésére szolgálnak.

Ha mind az akkumulátor, mind az USB áramforrás csatlakoztatva van a PiVoyagerhez, mind a négy LED-nek világítania kell. A sárga LED villogni fog, ha az akkumulátor töltődik, és folyamatosan fog világítani, ha az akkumulátor teljesen feltöltődött.

A szoftver telepítése

A PiVoyager az I2C protokoll segítségével kommunikál a Raspberry Pi-vel. Telepíteni kell egy pivoyager nevű eszközt, amely I2C segítségével kommunikál a PiVoyager hardverrel.

Az I2C-t az alábbi lépésekkel lehet engedélyezni a Raspberry Pi-n:

A parancssoron futtassa a sudo raspi-config parancsot.
A menüben válasszuk ki az 5 Interfacing Options (Interfacing beállítások) menüpontot.
Ezután válassza ki a P5 I2C opciót.
Válassza az yes-t, amikor megkérdezik, hogy engedélyezni akarja-e az I2C-t.
Válassza ki a .
Válassza az igen lehetőséget, amikor megkérdezik, hogy újra akarja-e indítani.
Ezután töltse le a pivoyager.tar.gz fájlt a weboldalunkról. Ezután a pivoyager.tar.gz fájlból kell kicsomagolnia a pivoyager futtatható fájlt. A Raspberry Pi számítógépén ezt a parancssorból a következőképpen teheti meg:

curl -O https://www.omzlo.com/downloads/pivoyager.tar.gz
tar xvf pivoyager.tar.gz

Hogy megkönnyítse az életét, helyezze át az eszközt az /usr/local/bin/ könyvtárba:

sudo mv pivoyager /usr/local/bin/

Most már használhatod az eredményül kapott pivoyager nevű futtatható programot a PiVoyager vezérlésére.

Első lépésként próbáld ki a pivoyager status beírását. A következőhöz hasonló kimenetet kell kapnia:

Status(30): stat1 stat2 5v 
Battery: discharging
VBat: 4.02V
VRef: 3.32V

A PiVoyager használata

A következő bekezdések a PiVoyagerrel elvégezhető néhány gyakori feladatot írnak le.

Kézi be- és kikapcsolás

Az oldalsó gomb több mint 3 másodpercig történő megnyomásával megszakíthatja a Raspberry-Pi áramellátását, és a PiVoyagert "készenléti üzemmódba" helyezheti. A zöld állapotjelző LED gyorsan villogni kezd, és a készülék a gomb felengedésekor készenléti üzemmódba lép.

Nem ajánlott a Raspberry-Pi áramellátását lekapcsolni, amikor az teljesen üzemel, mivel ez adatvesztéshez és az sd-kártya sérüléséhez vezethet.

A "készenléti üzemmódból" való kilépéshez nyomja meg újra röviden az oldalsó gombot.

Annak felismerése, hogy az akkumulátorral működik-e
A pivoyager status beírása a PiVoyager aktuális állapotát adja meg:

Ha a PiVoyager akkumulátorral működik, a parancs kimenete így néz ki:

Status(30): stat1 stat2 5v 
Battery: discharging
VBat: 4.02V
VRef: 3.32V

A Battery: discharging sor azt jelzi, hogy a PiVoyager akkumulátorral működik, a VBat: 4.02V pedig azt, hogy az akkumulátor jelenlegi feszültsége körülbelül 4V.

Másrészt, ha a PiVoyager USB-n fut, a parancs kimenete így néz ki:

Status(29): pg stat2 5v 
Battery: charging
VBat: 4.19V
VRef: 3.32V

Az Akkumulátor: töltés sor azt mutatja, hogy az akkumulátor jelenleg töltődik. Amikor az akkumulátor eléri a teljes töltöttségi szintet, az akkumulátor: töltés befejezve (Battery: charge complete) jelenik meg. Ezenkívül a Status (Állapot) mezőben található egy pg (a power good (jó tápellátás) kifejezés), amely azt jelzi, hogy a készülék USB-ről kap áramot.

Az állapotjelzők önmagukban is megjeleníthetők a pivoyager status flags beírásával. Egy bash szkript felhasználhatja ezt az információt arra, hogy felismerje, hogy USB tápellátásról vagy egyébként akkumulátorról üzemelünk:

if ./pivoyager status flags | grep "pg"; then  
   echo "We are running on USB"
fi

Az óra beállítása és kiolvasása

A PiVoyager rendelkezik "Valós idejű naptárral". A naptár 2019. június 18. 9:04pm UTC-re történő beállításához egyszerűen írja be a következőt: "A naptár 2019. június 18. 9:04pm UTC:

pivoyager date 2019-06-18T21:04:00Z 

Az idő az RFC3339 szabvány szerint van formázva.

Ezután a pivoyager date beírásával visszaolvashatja a naptárat. A naptár mindaddig naprakész marad, amíg a PiVoyager akkumulátorról vagy USB-ről van táplálva. Az idő UTC-ben jelenik meg a félreértések elkerülése érdekében.

A pivoyager status flags beírásával ellenőrizheti, hogy az RTC inicializálva van-e. Ha az inits flag jelen van, az azt jelenti, hogy a naptár be lett állítva.

Ha a Raspberry PI rendelkezik érvényes rendszeridővel, pl. az NTP-n keresztül, akkor a PiVoyager RTC-je a pivoyager date sync beírásával szinkronizálható erre az időre. Ez hasznos a riasztások programozásához (lásd alább).

A Raspberry PI szabályozott leállítása

Amikor leállítod a Raspberry-Pi-t, például a shutdown now beírásával, nyugalmi állapotba kerül, ahol továbbra is 30-50mA-t fogyaszt, néha többet is, a csatlakoztatott perifériáktól függően. A PiVoyager "watchdog" segítségével teljesen lekapcsolhatja a Raspberry-Pi áramellátását, így jelentős energiát takaríthat meg, különösen, ha akkumulátorral működik.

Feltételezve, hogy 20 másodpercig tart a Raspberry Pi kikapcsolása, a következőképpen programozhatod a teljes áramtalanítást:

pivoyager watchdog 25
shutdown now

Itt a pivoyager watchdog 25 parancs azt mondja a PiVoyager-nek, hogy 25 másodperc múlva teljesen lekapcsolja a Raspberry-Pi  áramellátását (5 másodperces tartalékot hagyunk).

Alapértelmezés szerint a Raspberry Pi automatikusan újraindul, amikor a felhasználó megnyomja az oldalsó gombot. De más lehetőségek is lehetségesek, például ébresztéskor vagy egy előre meghatározott késleltetés után, ahogy azt alább leírtuk.

Ha a Raspberry Pi leállításkor akkumulátorról működik, akkor lehet, hogy szeretné, ha automatikusan újraindulna, amikor az USB tápellátás visszaáll. Ezt úgy érhetjük el, hogy a kikapcsolási parancsok kiadása előtt engedélyezzük a power-wakeup opciót az alábbiak szerint:

pivoyager enable power-wakeup
pivoyager watchdog 25
shutdown now

UPS szkript futtatása

Az előző elemeket összeillesztve írhatunk egy bash példaszkriptet, amely UPS-szkriptként működik, és a következő műveleteket hajtja végre:

1. Várjon, amíg a Raspberry Pi akkumulátorról működik.
2. Figyelmeztesse a felhasználókat és várjon 30 másodpercet.
3. Teljes leállítást kezdeményez.

Így kapunk egy bash szkriptet, amelyet minden egyes alkalommal végre kell hajtani, amikor a Raspberry Pi elindul:

#!/bin/bash

# This should point to the pivoyager executable
PIVOYAGER=/usr/local/bin/pivoyager

while true;
do 
   # Phase 1: Check every 5 seconds if we are USB powered. 
   #          If we are not on USB power, go to phase 2.
   while $PIVOYAGER status flags | grep "pg";
   do
      sleep 5
   done


   # Phase 2: Do something before shutdown. (optional) 
   #          e.g. send an email, warn users, etc.
   wall "We are now running on battery. Save your work now! We will initiate a shutdown in 30 seconds."
   sleep 30



   # Just check if power was miraculously restored.
   if ! $PIVOYAGER status flags | grep "pg"; then
      break
   else
      wall "Power was restored. Shutdown aborted!"
   fi
done

# Phase 3: Initiate the shutdown.
#          - Enable automatic power on once USB power is restored.
#          - Program full power cut in 25 seconds.
$PIVOYAGER enable power-wakeup
$PIVOYAGER watchdog 25
sudo shutdown now

Ezt a fenti szkriptet másold be a nano szövegszerkesztő segítségével a UPS.sh fájlba

Majd futtasd a Raspberry PI indításakor

Időpontra ébredés (Wake-up beállítás)

A Raspberry Pi-t be lehet programozni úgy, hogy minden nap egy adott időpontban (vagy akár az aktuális hónapon belül egy adott időpontban) induljon el automatikusan. Ehhez inicializálni kell a PiVoyager RTC-jét, ahogy azt néhány bekezdéssel fentebb leírtuk.

Például, ha minden nap 12:15-kor szeretnénk felébreszteni a Raspberry Pi-t, akkor be kell írnunk:

pivoyager alarm *-12-15-00

Ha az előzőekben leírtak szerint kezdeményezzük a szabályozott leállítást, a Raspberry Pi újraindul, amikor az RTC elérte a 12:15-öt.

Ahelyett, hogy egy bizonyos időpontban ébredne fel, be lehet programozni az eszközt úgy, hogy egy másodpercekben kifejezett késleltetés után indítsa el a Pi-t. Például, ha azt szeretnénk megmondani a PiVoyager-nek, hogy egy órával a kikapcsolás után indítsa el a Raspberry Pi-t, akkor beírhatjuk a pivoyager wakeup 3600 parancsot. Vegye figyelembe, hogy az ébresztési funkció és a riasztás kölcsönösen kizárják egymást: nem lehet mindkettő egyszerre aktív.

Egy GPIO watchdog használata, alternatívaként

Alapértelmezés szerint a PiVoyager az I2C-t használja watchdogként a korábban leírtak szerint. Alternatívaként lehetőség van a 26-os GPIO pin 26 (BCM) watchdogként való használatára: a pin-t 1-re (HIGH) állítjuk, és ha egy előre meghatározott számú másodpercnél hosszabb ideig 0-ra (LOW) megy, a PiVoyager lekapcsolja a Raspberry Pi áramellátását. Vegyük figyelembe, hogy amikor a Raspberry Pi -t a felhasználó leállítja egy olyan paranccsal, mint a sudo halt, az összes pin általában nullára áll vissza. Ez tehát kiváltaná a GPIO watchdogot, és teljesen kikapcsolná a Raspberry Pi-t.

Tegyük fel, hogy azt szeretnénk, hogy a Raspberry Pi 15 másodperc múlva teljesen kikapcsoljon, amint a GPIO 26-os pin (BCM) LOW-ra vált. Így tudjuk ezt beállítani, hogy ez megtörténjen:

gpio -g mode 26 output
gpio -g write 26 1
pivoyager enable gpio-watchdog
pivoyager watchdog 15; pivoyager disable i2c-watchdog

A példa feltételezi, hogy a gpio segédprogram telepítve van a Raspberry Pi-re (wiringpi). Az egyetlen trükk itt az, hogy a pivoyager watchdog 15 parancs alapértelmezés szerint engedélyezi az i2c watchdogot. Ezért ezt az opciót azonnal ki kell kapcsolnunk a pivoyager disable i2c-watchdog parancsával.

A Raspberry-Pi leállítása gombnyomással

A PiVoyager gombjának 3 másodpercnél hosszabb ideig történő megnyomása a Raspberry-Pi "kemény" kikapcsolását eredményezi, amit a legtöbb ember nem akar. Jobb alternatíva a rövid gombnyomás érzékelése és egy ellenőrzött leállítás elindítása.

Ha egy PiVoyager-t csatlakoztatsz egy Raspberry Pi-hez, és beírod a "pivoyager status" parancsot, akkor egy ehhez hasonló kimenetet kapsz:

Status(13): pg stat2 5v
Battery: charging
VBat: 4.20V
VRef: 3.31V

Ha most röviden megnyomod a gombot a PiVoyager alaplapon, akkor egy extra flag jelzi a gomb megnyomását, így:

Status(141): pg stat2 5v button
Battery: charging
VBat: 4.12V
VRef: 3.30V

Ezt a gombállapotjelzőt bármikor törölheti a gomb megnyomása után a pivoyager clear button beírásával.

Ez a flag kihasználható egy egyszerű bash szkripttel, amely ellenőrzi a Raspberry Pi gomb állapotát és leállítást kezdeményez, például:

while true; do  
  if ./pivoyager status | grep 'button'; then
     sudo shutdown now
  fi  
  sleep 5
done

Ahhoz, hogy kihasználjuk a PiVoyager azon képességét, hogy teljesen lekapcsolja a Raspberry Pi áramellátását és gombnyomásra újraindítsa, a szkriptet ki kell egészíteni egy watchdog timeouttal, például:

while true; do  
  if ./pivoyager status | grep 'button'; then
     pivoyager watchdog 15
     sudo shutdown now
  fi  
  sleep 5
done

Ez a szkript könnyen bővíthető további funkciókkal, és indítható a rendszerindításkor az UPS esetében fentebb leírt modell szerint.

Segítség kérése

A pivoyager help beírásával sok hasznos információhoz juthat:

This is pivoyager version 0.1, (c) Omzlo P.C. [omzlo.com]
Syntax: pivoyager <command> (options...)
Valid commands are:
       alarm:  Get current alarm date, or set it (alarm <alarm-pattern>).
                The format of <alarm-pattern> is day-hour-minute-second, where:
                - day is "Mon", "Tue", ... "Sun" to select a day of the week.
                - day is 1-31 to identify a day of the month
                - day is "*" to ignore the day
                - hour is 0-24 to select an hour, or "*" to ignore
                - minute is 0-59 to select a minute or "*" to ignore
                - second is 0-59 to select a second or "*" to ignore

       clear:  Clear a status bit (clear <flags>).
                The value <flags> can be either "button" or "alarm".

        date:  Get the current RTC time, or set it (date <utc-time-RFC3339>.
                Use 'date sync' to use the current operating system date for the RTC.
                Time is typically expressed as UTC time to avoid any ambiguity.
                See RFC3339 for a valid date format.

     disable:  Disable configuration options for watchdog and wakeup.
                See 'enable' command for options.

      enable:  Enable configuration options for watchdog and wakeup
                Options are:
                - "i2c-watchdog" enable i2c based watchdog.
                - "gpio-watchdog" enable GPIO 26 watchdog (pin 37 on 40-pin header).
                - "timer-wakeup" enable wakeup after timer, as set with wakeup command.
                - "alarm-wakeup" enable wakeup on alarm.
                - "power-wakeup" wakeup if USB power goes up (only if it was down during shutdown).
                - "button-wakeup" wakeup if user presses button.
                - "low-battery-shutdown" shutdown if the battery is low, after timer expires.
                Note: "timer-wakeup" cancels "alarm-wakeup".

       flash:  Flash the new firmware file in 'bin' format (flash example.bin).
                Note: the PiVoyager must be in bootloader mode for this command to succeed.
                      Bootloader mode is activated by first removing all power to the PiVoyager and
                      then powering the device while simulaneously pressing the button.
                      Once in bootloader mode, the device leds will blink in sequence.

        help:  Prints this message.

  low-battery-timer:  Get or set how much time to wait (in seconds) before shutting down when the battery is low.
                Note: By default this timer is set to 60 seconds.

      status:  Get the current UPS status of the PiVoyager.
                - "status flags" shows system status flags.
                - "status battery" shows battery status (e.g. "charging").
                - "status volatge" shows battery and reference voltage.
                - "status" shows all of the above.

      wakeup:  Get wakeup information, or set wakeup time (wakeup <seconds>)
                Note: "wakeup" sets an alarm, overriding any alarm previously set.

    watchdog:  Get watchdog information, or set watchdog time (watchdog <seconds>)