... | ... | @@ -99,13 +99,13 @@ O software desse repositório inclue: |
|
|
|
|
|
* Clone esse repositório (requer a ferramenta git):
|
|
|
```
|
|
|
$ git clone https://git.cta.if.ufrgs.br/meteorolog/logger.git
|
|
|
git clone https://git.cta.if.ufrgs.br/meteorolog/logger.git
|
|
|
```
|
|
|
> Alternativamente, você pode [baixar o ZIP](https://git.cta.if.ufrgs.br/meteorolog/logger/repository/archive.zip).
|
|
|
|
|
|
* Acesse a pasta raiz, que contém o arquivo `Makefile`:
|
|
|
```
|
|
|
$ cd logger
|
|
|
cd logger
|
|
|
```
|
|
|
**ATENÇÃO**: Daqui em diante será assumido que você está dentro desta pasta ao executar os comandos `make`.
|
|
|
|
... | ... | @@ -122,7 +122,7 @@ $ cd logger |
|
|
|
|
|
Usuários do Debian (e derivados) podem utilizar o gerenciador de pacotes `apt-get` para instalar as dependências como segue:
|
|
|
```
|
|
|
$ make dep
|
|
|
make install-deps
|
|
|
```
|
|
|
|
|
|
> OBS: Pode ser necessário reiniciar o terminal ou até mesmo a seção de usuário.
|
... | ... | @@ -132,7 +132,7 @@ Usuários de outras distribuições deverão verificar a disponibilidade dessas |
|
|
#### 2.2 Dependências locais (não requer senha de administrador)
|
|
|
|
|
|
```
|
|
|
$ make setup
|
|
|
make setup
|
|
|
```
|
|
|
|
|
|
O logger foi programado na linguagem Python e utiliza diversas [bibliotecas de terceiros](https://git.cta.if.ufrgs.br/meteorolog/arduino-meteorolog/blob/master/logger/requirements.pip). O comando acima criará um ambiente virtual (na pasta `.venv`) contendo uma instalação isolada de Python e que possui as bibliotecas necessárias ao logger.
|
... | ... | @@ -151,13 +151,13 @@ Dentro da pasta [firmware/meteorolog](https://git.cta.if.ufrgs.br/meteorolog/log |
|
|
|
|
|
* 2ª Opção) Via linha de comando (executado na pasta raiz, que contém o `Makefile`):
|
|
|
```
|
|
|
$ make firmware
|
|
|
make firmware
|
|
|
```
|
|
|
> ATENÇÃO: Certifique-se de que a única placa conectada na USB é aquela em que você deseja instalar o firmware!
|
|
|
>
|
|
|
> OBS: Requer que a IDE do Arduino esteja instalada (idealmente, versão 1.0.x), assim como [python-pip](https://packages.debian.org/jessie/python/python-pip):
|
|
|
```
|
|
|
$ sudo apt-get install python-pip
|
|
|
sudo apt-get install python-pip
|
|
|
```
|
|
|
|
|
|
#### 3.1 Teste o firmware
|
... | ... | @@ -174,8 +174,7 @@ Revise pelo menos os seguintes intens: |
|
|
|
|
|
| Valor | Descrição breve |
|
|
|
| --------------------- | -------------------------------------------------------------- |
|
|
|
| `server/BOARD_ID` | ID da sua placa conforme cadastrada em [dados.cta.if.ufrgs.br/emm](http://dados.cta.if.ufrgs.br/emm) |
|
|
|
| `server/USER_HASH` | Código de autenticação de usuário (conforme seus dados em [dados.cta.if.ufrgs.br/emm/auth/userdata](http://dados.cta.if.ufrgs.br/emm/auth/userdata) |
|
|
|
| `server/BOARD_HASH` | Código de autenticação de usuário (conforme seus dados em [dados.cta.if.ufrgs.br/emm/auth/userdata](http://dados.cta.if.ufrgs.br/emm/auth/userdata) |
|
|
|
| `reading/SENSORS` | Sensores cuja leitura será solicitada. |
|
|
|
| `reading/SLEEP_MINUTES` | Tempo que logger aguardará para fazer outra leitura. |
|
|
|
|
... | ... | @@ -184,13 +183,13 @@ Revise pelo menos os seguintes intens: |
|
|
Objetivando verificar se a configuração atual é válida, execute o logger em primeiro plano com:
|
|
|
|
|
|
```
|
|
|
$ make run
|
|
|
make run
|
|
|
```
|
|
|
|
|
|
### 5. Instale o logger
|
|
|
|
|
|
```
|
|
|
$ make deploy
|
|
|
make deploy
|
|
|
```
|
|
|
|
|
|
> ATENÇÃO: A instalação pode levar alguns minutos. Alguns programas serão instalados no sistema (requer senha de administrador). Confira os detalhes na wiki [prepare-venv](prepare-venv).
|
... | ... | @@ -205,7 +204,7 @@ O que significa que o logger está rodando, com sucesso, em background. Assim, v |
|
|
|
|
|
Monitore a execução com:
|
|
|
```
|
|
|
$ make tail-log
|
|
|
make tail-log
|
|
|
```
|
|
|
|
|
|
* Os dados coletados são validados e armazenados na pasta `data/` (presente na raiz do projeto).
|
... | ... | @@ -215,27 +214,27 @@ $ make tail-log |
|
|
|
|
|
Por fim, o logger pode ser desativado com:
|
|
|
```
|
|
|
$ make undeploy
|
|
|
make undeploy
|
|
|
```
|
|
|
|
|
|
### 6. Monitore os dados
|
|
|
|
|
|
* Monitore a execução do logger em background com:
|
|
|
```
|
|
|
$ make tail-log
|
|
|
make tail-log
|
|
|
```
|
|
|
* Toda vez que o daemon reinicia (por exemplo, ao reiniciar a máquina), um novo log de execução é criado na pasta `logger/logs`, contendo a time stamp do início da execução;
|
|
|
* O comando acima monitora apenas o `.log` mais recente;
|
|
|
|
|
|
* Monitore a coleta de dados (salvos na pasta `arduino-meteorolog/data/`) com:
|
|
|
```
|
|
|
$ make tail-data
|
|
|
make tail-data
|
|
|
```
|
|
|
* Toda vez que o daemon reinicia (por exemplo, ao reiniciar a máquina), um novo arquivo `datalog`, contendo as leituras em formato CSV (ver `settings.yaml`), é criado;
|
|
|
* O comando acima monitora apenas o `datalog` mais recente;
|
|
|
|
|
|
* Monitore o progresso do `datalog` mais recente em um gráfico (requer `Gnuplot`) com:
|
|
|
```
|
|
|
$ make plot-data col=<C>
|
|
|
make plot-data col=<C>
|
|
|
```
|
|
|
onde `<C>` deve ser o número da coluna que será plotada no eixo y. |