Indice
ComApps
Le Comapps
Le comapps sono dei programmi, in qualsiasi linguaggio, che servono per interrogare un dispositivo di misura e leggerne i dati.
Per poterlo fare bisogna innanzitutto che il dispositivo abbia apposite API per poterlo interrogare, una volta che abbiamo i dati li dobbiamo formattare in un apposito formato leggibile da MeterN, ne abbiamo parlato qui .
MeterN ha già delle comapss preconfezionate realizzate e messe a disposizione dall'autore, basta solo impostare i propri dati, altre dobbiamo realizzarle da noi, a questo scopo possiamo aiutarci studiando i vari esempi messi a disposizione dall'autore al seguente LINK.
Le comapps devono essere tutte archiviate in una directory, meglio se fuori dalla directory che contiene MeterN cosi in caso di reinsatallazione e/o aggiornamento non verranno modificate o cancellate.
Comapss standard
- pool123s Se avete installato e funzionante 123solar questa comapss si intefaccia con l'altro applicativo e passa i dati necessari a MeterN
- remotepool123s come il precedente ma legge i dati su un sito remoto dove è installato 123solar
- houseenergy E' una comapps che legge vari meter, imposta vari Meter Id (i meter id sono fissi in quanto servono per calcolare i dati)
Comapss autoprodotte
Le comapps sono di due tipi, alla fine fanno le stesse cose, ma le fanno in modo diverso:
- Pooler = leggono continuamente i dati direttamente dal meter (un dato alla volta)
- Daemon = sono dei programmi che leggono tutti i dati dal meter li parcheggiano su un file di supporto da dove vengono letti mediante un pooler
per capire la differenza di funzionamento facciamo un esempio comparativo, supponiamo di dover leggere 4 dati da un meter (W prodotti, Wh prodotti, W consumati, Wh consumati).
Con un pooler si devono fare 4 cicli di lettura sul meter (tipicamente un SDM o uno Shelly)
Con un Daemon si fa un solo ciclo di lettura sul meter e poi si legge 4 volte il file di supporto.
Il primo è da preferire se si leggono uno o due dati, il secondo è molto più performante se si devono leggere molti dati inoltre è molto utile nei casi in cui si debbano leggere dati da siti web dove ci sono limiti al numero di letture orarie e/o giornaliere
Struttura delle comapps
Pooler
Sono file singoli che vengono attivati direttamente da MeterN e si interfacciano direttamente col meter
Programma | Descrizione | Esempio |
---|---|---|
pooler.php | programma che legge i dati dal meter e li passa a MeterN | shelly1.php |
Daemon
qui la cosa si fa più strutturata, dobbiamo sempre avere:
Programma | Descrizione | Esempio |
---|---|---|
com_daemon.php | Avvia il daemon_loop | shelly0_daemon.php |
daemon_loop.php | legge i dati dal meter | shelly0_loop.php |
daemon.php | pooler che legge i dati dal file di supporto | shelly0.php |
Ogni pooler o daemon dovrà gestire tanti parametri ( il nome con cui MeterN richiama il dato) tamti quanti sono i dati che si vogliono gestire. questo parametro verrà richiamato da MeterN e sarà inserito nella configurazione dei vari meter.
Creare una comapps
Comapps pooler
Dobbiamo posizionare il programma nella directory che conterrà tutte le comapps, ma lo dobbiamo fare come amministratore, tutta la procedura andrebbe fatta seguendo il flusso senza interromperla per non perdere i diritti di amministratore senza accorgersene.
Procedere nel seguente modo:
sudo -s cd /var/www/comapps
Con il nostro editor preferito creiamo il file:
poolshelly.php
Al suo interno andremo a inserire il seguente codice:
#!/usr/bin/php <?php } // This script will output a ShellyEM counter into a meterN compatible format // Configure, then ln -s /var/www/comapps/poolshelly.php /usr/bin/poolshelly and chmod +x poolshelly.php // Request Main command with 'poolshelly {energy | energy1 | power | power1}' // Shelly IP $IP = '192.168.xxx.yyy'; // Shelly request $url = "http://"."$IP"."/status"; // meterN config $METERID = 1; // No edit is needed below $GP = null; if ($argv[1] == 'power') { $GP = $memarray['emeters'][0]['power']; echo "$METERID($GP*W)\n"; } elseif ($argv[1] == 'energy') { echo "$METERID($KWHT*Wh)\n"; } else { } } elseif ($argv[1] == 'power1') { $GP = $memarray['emeters'][1]['power']; echo "$METERID($GP*W)\n"; } elseif ($argv[1] == 'energy1') { echo "$METERID($KWHT*Wh)\n"; } else { } } } else { } } else { } ?>
dobbiamo inoltre rendere il file eseguibile dal sistema, per far questo eseguiamo i seguenti passaggi:
cd /var/www/comapps chown www-data:www-data poolshelly.php chmod a+x /var/www/comapps/poolshelly.php
a questo punto dobbiamo creare un link simbolico per poter richiamare il programma
ln -s /var/www/comapps/poolshelly.php /usr/bin/poolshelly
ora siamo pronti per l'operazione più importante, testare il software creato prima di darlo in pasto a MeterN.
Dalla shell, con riga di comando lanciare tutte le opzioni previste nel software per assicurarsi che diano il risultato voluto, se avete previsto la gestione degli errori, generateli, per assicurarvi che il software li gestisca correttamente, nell'esempio precedente:
poolshelly energy poolshelly energy1 poolshelly power poolshelly power1 poolshelly
l'ultimo genera l'errore di nessuna opzione richiesta e visualizza le opzioni possibili.
Comapps daemon
Come detto in precedenza dobbiamo creare 3 programmi, per tenere in ordine i programmi, se non già fatto, creeremo una directory dove posizionare i com_daemon che in effetti non servono a manipolare i dati ma ad avviare i daemon_loop.
sudo -s cd /var/www/comapps mkdir -v daemon
Daemon_loop
Iniziamo ora a creare il programma di loop che andrà a leggere il nostro meter nello specifico si tratta di uno Shelly EM con una sola pinza che legge immissioni e prelievi distinguendoli con i valori positivi per i prelievi e negativi per le immissioni, il file lo chiameremo shelly_3_loop.php
shelly_3_loop.php
#!/usr/bin/php <?php } // Beware, only use a tmpfs as /dev/shm (ramfs) ! // This script will perform a loop to continuosly request data to ShellyEM meter and put data into a Shelly_n_log.txt file // Request the follow data {energy | power | volt | ampere | cosphi | energy1 | power1 }' // **** Measurements performed with a single clamp that measures import + ed export - ****** // by Walter62 rev 00 on 02/07/23 $IP = '192.168.xxx.yyy'; // Shelly IP for import export energy $CH = 0; // Channel "0 = import" or "1 = export" which you want use for volt-ampere-cosphi $MID = 3; // meterN config // No edit is needed below $url = "http://"."$IP"."/status"; // Shelly request $filelog = "shelly_" . $MID . "_log.txt"; // Temporary file for dataset exaple "selly_1_log.txt" while (true) { $remotedata = ""; //print_r($remotedata); if ($GP <0){ $GP_0 = 0; } else { $GP_0 = $GP; $GP_1 = 0; } //channel 0 ==> Import //$GP_0 = round($memarray['emeters'][0]['power'],1); //W //Channel 1 ==> Export //$GP_1 = round($memarray['emeters'][1]['power'],1); //W //$KWHT_1 = round($memarray['emeters'][1]['total_returned'],1); // Wh //channel $CH $dataarray[0] = $MID . '_0(' . $GP_0 . '*W)'; // n_0(nnn*W) $dataarray[1] = $MID . '_0(' . $KWHT_0 . '*Wh)'; $dataarray[2] = $MID . '_1(' . $GP_1 . '*W)'; $dataarray[3] = $MID . '_1(' . $KWHT_1 . '*Wh)'; $dataarray[4] = $MID . '_V(' . $VOLT . '*V)'; $dataarray[5] = $MID . '_A(' . $AMP . '*A)'; $dataarray[6] = $MID . '_PHI(' . $PHI . '*phi)'; } else { } } } } ?>
Dato che con una pinza leggo sia il valore di energia importata che esportata ma con valore negativo, ho disabilitato la lettura del canale e dalla riga 34 alla 40 vado a leggere il valore di energia letto dalla pinza e in funzione che sia positivo o negativo assegno al canale appropriato il valore assoluto quindi positivo per entrambi i canali.
Ora che abbiamo il file compilato lo salviamo in:
/var/www/comapps
daemon
Ora passiamo alla stesura del programma che si occuperà di leggere i dati e renderli disponibili a MeterN, lo chiameremo shelly_3.php, il contenuto dovrà essere il seguente:
shelly_3.php
#!/usr/bin/php <?php } // This script will read output file of the ShellyEM counter and will expos the data to MeterN // Configure, then ln -s /var/www/comapps/shelly_n.php /usr/bin/shelly_n and chmod +x shelly_n.php // Request Main command with 'shelly_1 {energy | power | volt | ampere | cosphi | energy1 | power1 }' // by Walter62 rev 00 on 02/07/23 $MID = 3; // meter to call - shelly_n = shelly_3 $filelog = "shelly_" . $MID . "_log.txt"; // Temporary file for dataset exaple "selly_2_log.txt" // No edit is needed $help = "Usage: shelly_3 { energy | power | volt | ampere | cosphi | energy1 | power1 }\n"; } if ($argv[1] == 'power'){ }elseif ($argv[1] == 'energy'){ }elseif ($argv[1] == 'power1'){ }elseif ($argv[1] == 'energy1'){ }elseif ($argv[1] == 'volt'){ }elseif ($argv[1] == 'ampere'){ }elseif ($argv[1] == 'cosphi'){ } else{ } echo "$outstr"; ?>
Com_daemon
Adesso abbiamo i due programmi che che leggono i dati dal contattore e li trasmettono a meter su richiesta, dobbiamo però assicurarci che ad ogni avvio del sistema, o meglio, ad ogni avvio di MeterN si avvii anche il programma daemon_loop (il daemon lo avvia MeterN quando gli serve il dato).
Dato che è più pulito avviare il programma quando MeterN è in esecuzione ci appoggiamo al com_daemon e quindi creiamo il software necessario:
shelly_3_daemon.php
#!/usr/bin/php <?php /* Check shelly_3_loop.php path bellow Then ln -s /path to/shelly_3_daemon.php /usr/bin/shelly_3_daemon Start and stop the daemon via metern/config/config_daemon.php And request values with shelly_3 command */ } $cdpid = null; } } else { $cdpid = null; } } if ($argv[1] == 'start') { $command = 'php /var/www/comapps/shelly_3_loop.php' . '> /dev/null 2>&1 & echo $!;'; } else { echo "shelly_3_daemon seem to be running as $cdpid"; } } else if ($argv[1] == 'stop') { } } else { echo "Usage : shelly_3_daemon {start | stop}\n"; } } else { echo "Usage : shelly_3_daemon {start | stop}\n"; } ?>
come per il pooler rendiamo i files eseguibili dal sistema, per far questo eseguiamo i seguenti passaggi:
sudo -s cd /var/www/comapps chown www-data:www-data shelly_3.php chown www-data:www-data shelly_3_loop.php chown www-data:www-data shelly_3_daemon.php chmod a+x /var/www/comapps/shelly_3.php chmod a+x /var/www/comapps/shelly_3_loop.php chmod a+x /var/www/comapps/shelly_3_daemon.php
creiamo i link simbolici per poter richiamare i programmi
ln -s /var/www/comapps/shelly_3.php /usr/bin/shelly_3 ln -s /var/www/comapps/shelly_3_loop.php /usr/bin/shelly_3_loop ln -s /var/www/comapps/shelly_3_daemon.php /usr/bin/shelly_3_daemon
ora siamo pronti per testare il software creato prima di darlo in pasto a MeterN.
Dalla shell, con riga di comando lanciare tutte le opzioni previste nel software per assicurarsi che diano il risultato voluto, se avete previsto la gestione degli errori, generateli, per assicurarvi che il software li gestisca correttamente, nell'esempio precedente:
poolshelly energy poolshelly energy1 poolshelly power poolshelly power1 poolshelly
l'ultimo genera l'errore di nessuna opzione richiesta e visualizza le opzioni possibili.
Configurazione ComApps in MeterN
Quando tutto funziona possiamo abilitare i vari programmi in MeterN, per far ciò dobbiamo modificare un file di sistema (sistema di MeterN) in questo modo:
cd /var/www/metern/config nano allowed_comapps.php
alle voci esistenti aggiungere altre voci all'array dopo l'ultima esistente
$ALLWDCMD[n] = 'poolshelly energy'; $ALLWDCMD[n] = 'poolshelly power'; ...... ...... $ALLWDCMD[n] = 'shelly_3 energy'; $ALLWDCMD[n] = 'shelly_3 power'; $ALLWDCMD[n] = 'shelly_3 volt'; $ALLWDCMD[n] = 'shelly_3 ampere'; $ALLWDCMD[n] = 'shelly_3 cosphi'; ...... ...... $ALLWDCMD[n] = 'shelly_3_daemon start'; $ALLWDCMD[n] = 'shelly_3_daemon stop';
la struttura è la seguente:
- [n] = il numero tra parentesi quadre deve essere un numero progressivo che segue quelle già presenti
- poolshelly = link simbolico che richiama il nostro programma
- energy = opzione da richiamare
inserire tante voci quante sono le opzioni che MeterN dovrà richiamare.
Bene, ora che tutte le ComApps sono utilizzabili da MeterN ci occuppiamo di istruire MeterN ad avviare tutte le com_daemon ad ogni avvio, per far questo basta inserirle nel file di configurazione di MeterN che si chiama “config_daemon.php”, procediamo come segue:
cd /var/www/metern/config nano config_daemon.php
si aprirà il file in modifica, se non è mai stato usato prima troveremo al suo interno due righe commentate che danno un esempio di come inserire il comando, nell'esempio sotto sono le righe 5 e 9.
<?php // Manage com. apps daemon as 'http' user if needed //$out = exec("com_daemon stop"); } else { //Start //$out = exec("com_daemon start"); } ?>
come mostrato nell'esempio, dove si vuole far avviare due com_daemon, si dovranno inserire per ogni com_daemon una riga nella sezione “stop” e una nella sezione “start”, nellesempio sono le rige 6 e 7 per lo stop e 10 e 11 per lo start