MANUALE DI INSTALLAZIONE SOLARLOGGER



1. Procedura per la configurazione del RaspberryPi® Wheezy

La presente guida riguarda l'installazione e la configurazione di 123Solar su sistema operativo Raspbian Wheezy con lettura diretta dei dati tramite bus RS485 da Inverter tipo ABB (PowerOne)

E' quindi necessario che abbiate installato sul vostro Raspberry il sistema operativo Raspbian Wheezy come descritto nella apposita guida sul wiki

Nel caso vogliate utilizzare anche dei contatori Modbus, collegati sullo stesso bus dell'inverter ABB/Power-ONE, è necessario applicare al software Aurora una patch per gestire le code sul bus in modo compatibile con il software sdm120c. L'ultima versione rilasciata per tale patch è relativa alla versione 1.9.0 di Aurora. In tal caso sarà necessario installare questa precedente versione e non l'ultima release come indicato in questa GUIDA

Portarsi sulla home

cd /home/pi

Acquisire i diritti di amministratore

sudo -s

scaricare il programma Aurora 1.9.3 (verificare che sia l'ultima versione)

wget http://www.curtronics.com/Solar/ftp/aurora-1.9.3.tar.gz

Scompattiamo l'archivio

tar -xzvf aurora-1.9.3.tar.gz
rm -v aurora-1.9.3.tar.gz

Installiamo portandoci sulla dir aurora- 1.9.3

cd aurora-1.9.3
make
make install
cd /..

1.2.1. Installazione di 123Solar

Portarsi sulla directory www del web server

sudo -s
cd /var/www

Scaricare il programma 123solar 1.6.8 e il file per avviare il servizio (per entrambi verificare che sia l'ultima versione e modificare se necessario)

wget http://www.123solar.org/downloads/123solar/123solar1.6.8.tar.gz

Scompattiamo l'archivio

tar -xzvf 123solar1.6.8.tar.gz

eliminiamo il file tar

rm -v 123solar1.6.8.tar.gz

installiamo il servizio

cd /etc/systemd/system
wget http://www.123solar.org/downloads/123solar/123solar.service
systemctl enable 123solar.service

abilitare la USB per l'user www-data

cd /..
usermod -a -G uucp www-data

verificare che sia stato impostato correttamente digitando “groups www-data” che deve restituire come minimo “www-data:www-data uucp”

Impostare i permessi per Aurora, per prima cosa verificare il percorso del programma:

find / -name aurora

restituisce il percorso in cui si trova aurora che dovrebbe essere /usr/local/bin/aurora se non lo fosse adeguare di conseguenza il percorso sul comando seguente

chmod a+x /usr/local/bin/aurora

1.2.2. Configurazione di 123Solar

Aprite un browser su un pc della stessa rete e digitate

verrà chiesto il login a cui risponderete con admin e password che potete scegliere a piacimento e si aprirà il menù di configurazione di 123solar.

A questo punto per risolvere un problema di autenticazione al secondo accesso abbandoniamo la procedura di configurazione cliccando sul pulsante “Back” e chiudere il browser.

Torniamo sul raspberry e proseguiamo come segue:

Impostazione dei permessi di accesso

Configuriamo ora le directory di 123solae e MetrN sul webserver

sudo -s
cd /etc/apache2/sites-available
nano default

Il file deve essere come il seguente (correggere dove serve)

file=default

<VirtualHost *:80>
ServerAdmin webmaster@localhost
DocumentRoot /var/www
<Directory />
Options FollowSymLinks
AllowOverride All
</Directory>
<Directory /var/www/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order allow,deny
allow from all
</Directory>
<Directory /var/www/123solar/admin>
AllowOverride None
AuthType basic
AuthName “123solar Password Protected Area”
AuthBasicProvider file
AuthUserFile /var/www/123solar/config/.htpasswd
require valid-user
</Directory>
<Directory /var/www/metern/admin>
AllowOverride None
AuthType basic
AuthName “meterN Password Protected Area”
AuthBasicProvider file
AuthUserFile /var/www/metern/config/.htpasswd
require valid-user
</Directory>
ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/
<Directory “/usr/lib/cgi-bin”>
AllowOverride None
Options +ExecCGI -MultiViews +SymLinksIfOwnerMatch
Order allow,deny
Allow from all
</Directory>
ErrorLog ${APACHE_LOG_DIR}/error.log
# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

ctrl+O per salvare e ctrl+X per uscire

Riprendiamo la configurazione

Aprite un browser su un pc della stessa rete e digitate

si aprirà il menù di configurazione di 123solar.

Selezionare “Main configuration” compilati i campi salvare”Save main cfg.” e quindi cliccare su “Back” per tornare al menu.

Selezionare ora “Configure your inverter(s)”

PS.: fra le opzioni notate una voce = Y3 e l3 modificatela in Y5 e l5 se avete problemi di instabilita ̀ del monitoraggio, altrimenti lasciatela pure i valori standard.

Compilati i campi salvare cliccando ”Save inverter cfg.” e quindi cliccare su “Back”tornare al menu.

Se si vuole inviare i dati si Pvoutput selezionare ora “Pvoutput configuration”

compilati i campi salvare”Save inverter cfg.” e quindi cliccare su “Back”tornare al menu

concluse le impostazioni cliccare sul pulsante evidenziato che che passa da “OFF” ad “ON” avviando 123solar.

Chiudere il browser

A causa delle caratteristiche dell'hardware, per avviare e fermare automaticamente 123solar e ovviare ad una non perfetta compatibilità della modalità Hi-speed della porta USB con il mio convertitore RS485-USB è necessario modificare manualmente alcune parti del sistema. Le seguenti modifiche sono quelle che mi hanno dato maggior stabilità. I passaggi sono:

  • Settare la modalità di comunicazione per la porta USB
  • Settare la velocità della porta USB
  • Impostare l'avvio e lo stop per 123solar

1.3.1. Modifica della modalità di comunicazione della porta USB


nelle ultime versioni di Raspbian questa parte non è più necessaria, la lascio in caso di necessità
NB: Attenzione questa procedura è necessaria solo se ci sono problemi di blocco del Raspberry durante il monitoraggio con il convertitore USB-seriale

Digitare:

sudo -s
cd /boot
nano cmdline.txt

Si apre il file in modifica, modificare in modo che risulti esattamente come di seguito:

Codice:

file: cmdline.txt


dwc_otg.lpm_enable=0 dwc_otg.speed=1 console=ttyAMA0,115200 kgdboc=ttyAMA0,115200 console=tty1 root=/dev/mmcblk0p2 rootfstype=ext4 elevator=deadline rootwait

ctrl+O per salvare e ctrl+X per uscire

Mi raccomando va scritto tutto in una sola riga senza andare a capo, non ci devono essere spazi a inizio e fine riga.

1.3.2. Impostare la velocità della porta USB e lo START DI 123solar

Per far questo ci appoggiamo ad un servizio di sistema, “rc.local” che ad ogni avvio esegue il codice presente al suo interno, rispetto all'utilizzo di crontab, rc.local fa ripartire il monitoraggio a qualsiasi ora a seguito di un riavvio improvviso del sistema. (ricordarsi di attivare l' auto-pooling in 123solar admin)

sudo -s
cd /etc
​nano rc.local

A questo punto modificare il contenuto del file in modo che sia come segue:

file: rc.local


#!/bin/sh -e
#
# rc.local
#
# This script is executed at the end of each multiuser runlevel.
# Make sure that the script will “exit 0” on success or any other
# value on error.
#
# In order to enable or disable this script just change the execution
# bits.
#
# By default this script does nothing.
# Print the IP address
_IP=$(hostname -I) || true
if [ “$_IP” ]; then
printf “My IP address is %s\n” “$_IP”
fi
stty -F /dev/ttyUSB0 19200 # imposta la velocità della seriale a 19200
sudo /usr/bin/curl http://localhost/123solar/scripts/boot123s.php # avvia 123solar al riavvio
exit 0

ctrl+O per salvare e ctrl+X per uscire

Attenzione a non inserire spazi (barra spaziatrice) a fine riga o su righe vuote

Aattenzione questa procedura non è aggiornata da oltre un anno

Le procedure descritte nel presente paragrafo non sono strettamente necessarie al funzionamento del sistema ma risultano utili in particolari situazioni

1.5.1. Installazione servizio di invio mail da 123solar

(Procedura scritta con il supporto di “Borghese” che ringrazio)

Iniziamo con installare i programmi necessari:

sudo -s
cd /..
apt-get update
apt-get upgrade
apt-get install msmtp msmtp-mta ca-certificates

editare il file di configurazione

cd /etc
​nano msmtprc

all'interno scrivere quanto segue, modificare la parte in blu:

file: msmtprc


# Impostazioni account

defaults
tls on
tls_starttls on
tls_trust_file /etc/ssl/certs/ca-certificates.crt

account default
host smtp.gmail.com
port 587
auth on
user youraccount@gmail.com
password password
from youraccount@gmail.com
#logfile /var/log/msmtp.log

ctrl+O per salvare e ctrl+X per uscire

L'ultima riga serve a verificare eventuali errori di comunicazione, se l'invio di mail non funziona regolarmente togliete il “#” e inviate una mail sul file msmtp.log troverete i messaggi di sistema con gli eventuali errori.

Verificare e modificare i permessi e il proprietario di /etc/msmtprc devono essere esattamente settati a -rw——- 1 www-data root

sudo -s
cd /etc
ls -l msmtprc

Se serve modificarli, editarequanto segue:

chmod -v 0600 msmtprc
chown -v www-data:root msmtprc
ls -l msmtprc

verificare se ora è esattamente uguale a -rw——- 1 www-data root

Modificare ora i files php.ini

cd /etc/php5/apache2
​nano php.ini

Cercare la riga sendmail_path in php.ini e modificarla come segue:

file: php.ini

sendmail_path = “/usr/bin/msmtp -C /etc/msmtprc -t”

ctrl+O per salvare e ctrl+X per uscire

se necessario togliere il “;” davanti alla riga e salvare

cd /etc/php5/cli
nano php.ini

Cercare la riga sendmail_path in php.ini e modificarla come segue:

file: php.ini

sendmail_path = “/usr/bin/msmtp -C /etc/msmtprc -t”

ctrl+O per salvare e ctrl+X per uscire

se necessario togliere il “;” davanti alla riga e salvare

Verificare il contenuto di resolv.conf:

cd /etc
nano resolv.conf

Il contenuto deve essere esattamente come segue altrimenti modificarlo:

file: resolv.conf

domain lan
search lan
nameserver 192.168.x.x (assicurarsi che sia l'IP del tuo router)

ctrl+O per salvare e ctrl+X per uscire

Attenzione si presume che il raspberry sia connesso al router via rete lan e non wi-fi

Riavviare il raspberry

shutdown -r now

impostare 123solar admin e testare la mail

FAQ

Come testare la mail da riga di comando:

Se volete testare la mail da riga di comando digitare quanto segue:

cd /..
echo -e "Subject: Test MailrnrnThis is a test mail" | msmtp --from=default -t username@gmail.com

(il secondo comando deve essere scritto tutto su una riga)

Dove verificare eventuali errori di trasmissione delle mail:

I file di log si trovano in “/var/log/” vedere il contenuto dei seguenti file:

mail.err – mail.info – mail.log – mail.warn – msmtp.log

La mail continua a non arrivare:

Gmail considera alcuni indirizzi come spam, verificate la cartella spam e se il messaggio è li apritelo e mettete l'indirizzo mail tra i vostri contatti, questo istruirà Gmail che non si tratta di spam.

1.5.2. Installazione EZL70 su Raspberry

Procedura scritta con il supporto di “Miki8989” che ringrazio

Per chi avesse la necessità di utilizzare la EZL70 o simili per leggere i dati dall'inverter al posto del convertitore RS485-USB descrivo di seguito la procedura di installazione:

per prima cosa bisogna settare i parametri di configurazione della EZL, a questo scopo vi viene in aiuto la guida di MizioB “EZL70”.

  • Connettere la EZL alla rete di casa
  • Aprite la pagina di configurazione del router e impostate, come fisso, l'IP su cui si è aggangiata la EZL
  • Sempre per l'IP assegnato alla EZL aprite la porta 1470 (la procedura per questa operazione dipende dal vs. router) troverete degli esempi da pag. 9 a pag.10 della guida “EZL70”
  • A questo punto dovete settare i parametri comiunicazione sulla EZL70, seguite la guida “EZL70” a pag. 6 e 7
  • Terminata la configurazione passiamo a settare il Raspberry.

installare socat

sudo -s
cd /..
apt-get install socat

preparare lo script di comunicazione

cd /var/www
mkdir MyScripts (se avete già questa directory saltate la riga)
cd MyScripts
nano EZL.sh

si apre l'editor di testo, sul nuovo file inserire il seguente codice

file: EZL.sh

#!/bin/bash
# avvio servizio socat su convertitori EZL, CSW, ecc
while true; do socat pty,link=/dev/ttyEZL0,raw,echo=0,waitslave tcp:192.168.x.x:1470; done &
exit

ctrl+O per salvare e ctrl+X per uscire

sotituire 192.168.x.x con l'IP della EZL70

diamo ora i permessi necessari al file EZL.sh

chmod +x EZL.sh

modifichiamo il file rc.local per avviare in automatico la comunicazione con la EZL70

sudo -s
cd /etc
nano rc.local

si apre il file rc-local e deve essere modificato in modo che sia come il seguente

file: rc.local

#!/bin/sh -e
#
# rc.local
#
# This script is executed at the end of each multiuser runlevel.
# Make sure that the script will “exit 0” on success or any other
# value on error.
#
# In order to enable or disable this script just change the execution
# bits.
#
# By default this script does nothing.


# Print the IP address
_IP=$(hostname -I) || true
if [ “$_IP” ]; then
printf “My IP address is %s\n” “$_IP”
fi
sudo /var/www/MyScripts/EZL.sh # avvia il device EZL
sudo /usr/bin/curl http://localhost/123solar/scripts/boot123s.php# avvia 123solar al riavvio
exit 0

ctrl+O per salvare e ctrl+X per uscire

riavviare il sistema

shutdown -r now

al riavvio del sistema verifichiamo che il servizio funzioni

sudo -s
cd /dev
ls

se tutto funziona dovrebbe apparire un device ttyEZL0

impostare la porta di comunicazione su 123solar

Aprite un browser su un pc della stessa rete e digitate

http://192.168.x.xx/123solar/admin/

verrà chiesto il login a cui risponderete con admin e password (la stessa scelta in precedenza) e si aprirà il menù di configurazione di 123solar, selezionare “Configure your inverter(s)” .

Sulla sezione protocol, come porta di comunicazione modificare da “/dev/ttyUSB0” a “/dev/ttyEZL0”

1.5.3 Impostare un IP fisso sul raspberry

Per chi non avesse la possibilità di far fare al router questo servizio o per altre necessità, per impostare un IP fisso si deve modificare il file “interfaces”

sudo -s
cd /etc/network
nano interfaces

editare il file modificando e/o aggiungendo le righe nel seguente modo:

file: interfaces

iface eth0 inet static
address 192.168.xx.xx #(mettere i dati della propria rete)
netmask 255.255.255.0 #(mettere i dati della propria rete)
gateway 192.168.xx.xx #(mettere i dati della propria rete)

ctrl+O per salvare e ctrl+X per uscire

1.5.4. Clonazione della SD card

Una cosa molto utile, una volta che il sistema è stabile, è fare una copia della SD per poi poterla ricaricare in caso di malfunzionamento o danneggiamento di quella in uso.

Si utilizza sempre Win32diskimager (ver. 0.4) che si è utilizzato per caricare l'immagine iniziale procedendo come segue:

  1. Utilizzare solamente un'altra SD “uguale” o piu' capiente di quella da clonare.
  2. Inserire la scheda SD da clonare nel lettore di schede e avviare il programma
  3. Nella finestra principale nella prima riga “Image File” scegliere l'icona con la cartella per selezionare il percorso dove salvare l'immagine (non la lettera sotto a “Device” ma quella subito prima)
  4. Si apre una nuova finestra, quì si seleziona la posizione dove salvare il file e in basso sul label “Nome file” si inserisce nome file che identifichi il backup (esempio bak_RPi_15-15-12)
  5. Cliccare su “Salva” e si ritorna sulla finestra principale
  6. Spuntare il check box “MD5 Hash” serve per la verifica che il file sia letto e/o scritto correttamente
  7. Premere il tasto con la scritta “Read”, verrà creata l'immagine della SD da clonare con il nome .img che si e' scelto. Al termine della copia un messaggio avvertirà della avvenuta creazione.
  8. Inserire la SD vuota nel lettore e premere solamente il tasto “Write”. La barra di progressione darà la percentuale del lavoro di scrittura e al termine, un altro messaggio ci avvertirà dell'avvenuta scrittura. (NB: questo punto può essere fatto in un qualsiasi momento)

Per le versioni Ver. 0.7 e Ver. 0.8 la procedura è leggermente diversa (a mio parere è un baco)

  1. Utilizzare solamente un'altra SD “uguale” o piu' capiente di quella da clonare.
  2. Inserire la scheda SD da clonare nel lettore di schede e avviare il programma
  3. Nella finestra principale nella prima riga “Image File” digitare il nomefile con percorso completo ed estensione (tipo: C:\archivio\2013-07-12-wheezy-raspbian.img)

Continuare dal precedente punto 6.

1.5.5. Esecuzione di un backup giornaliero su uno spazio web ftp

Nelle guide precedenti veniva eseguito un backup giornaliero e memorizzato in sequenza sul server ftp, questo sistema spreca spazio sul server, è sufficente tenere il backup di qualche giorno. Ho pensato quindi fare un procedura che salvi x giorni e poi scarta il più vecchio con il principio “FIFO”

Installate, per prima cosa, il pacchetto lftp.

sudo -s
cd /..
apt-get install lftp

Create una directory dove posizionare gli script personali e creare uno script nome “ftpbackup”

sudo -s
cd /var/www
mkdir MyScripts
chmod -v 777 MyScripts
cd MyScripts
nano ftpbackup.sh

editare il seguente file:

ftpbackup.sh

#! /bin/sh
### BEGIN INIT INFO
# Short-Description: backup giornaliero
# Description: Questo file è usato per eseguire una copia giornaliera
# dei dati del datalogger 123solar di x giorni con metodo fifo
#
# posizionare il file in /var/www/MyScripts
#
# Author: Walter Borin
# ## END INIT INFO
# Do NOT "set -e"

TODAY=$(date +"%d-%b-%Y")   # Today's date like DD-MMM-YYYY
RMDATE=$(date +"%d-%b-%Y" -d '6 days ago') # TODAY minus X days ago - too old files
FTPUSER=<UserId>                          # User (inserire il vostro UserId)
FTPPW=<Password>                          # Password (inserire la password per l'ftp)
FTPSERVER= <IPserver>                     # IP server ftp (indirizzo IP del server)
LFTP=/usr/bin/lftp                         # Path to binary
DATADIR=/var/www/123solar/data             # Your data archives are here
TMPDIR=/var/www/MyScripts                  # Your temp backup file are here
FTPDIR=/<backupdir>                       # Your backup dir in ftp dir

tar -cpzf backupsolar_$TODAY.tar.gz $DATADIR

$LFTP <<EOF
open $FTPUSER:$FTPPW@$FTPSERVER
set ftp:ssl-allow no #Used for Altervista
put -O $FTPDIR backupsolar_$TODAY.tar.gz
wait
cd $FTPDIR
rm -rf backupsolar_$RMDATE.tar.gz
wait
close
exit
EOF

cd $TMPDIR
rm -rf backupsolar_$TODAY.tar.gz
#echo "Backup del: $TODAY salvato in FTP"
#

modificare la parte <UserId>, <Password> e <IPserver> con user, password e indirizzo IP del vostro sito ftp

ATTENZIONE: sul sito ftp dovete creare la directory <backupdir> sulla radice principale a vostro piacimento (es. “backupsolar”)

abilitare l'esecuzione dello script come programma

sudo -s
cd /var/www/MyScripts
chmod -v 755 ftpbackup.sh

a questo punto creiamo un crontab personalizzato per root e inseriamo l'esecuzione automatica all'ora desiderata

sudo -s
cd /..
crontab -u root -e

e modificare come segue:

file: root

SHELL=/bin/bash
PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin

# Edit this file to introduce tasks to be run by cron.
#
# Each task to run has to be defined through a single line
# indicating with different fields when the task will be run
# and what command to run for the task
#
# To define the time you can provide concrete values for
# minute (m), hour (h), day of month (dom), month (mon),
# and day of week (dow) or use '*' in these fields (for 'any').
# Notice that tasks will be started based on the cron's system
# daemon's notion of time and timezones.
#
# Output of the crontab jobs (including errors) is sent through
# email to the user the crontab file belongs to (unless redirected).
#
# For example, you can run a backup of all your user accounts
# at 5 a.m every week with:
# 0 5 * * 1 tar -zcf /var/backups/home.tgz /home/
# # For more information see the manual pages of crontab(5) and cron(8)
#
# m h dom mon dow command

15 21 * * * /var/www/MyScripts/ftpbackup.sh

ctrl+O per salvare e ctrl+X per uscire

  • 123solar_mono_powerone_wheezy.txt
  • Ultima modifica: 2018/05/22 16:04
  • da flane