#Biblioteca para comando do Kit Wearable da Telefônica
Mais informações: http://iot.telefonicabeta.com/kit-iot-wearable/
##0) Observações importantes
- Esta biblioteca foi desenvolvida para uso com a Intel Galileo Gen 2 rodando o Intel IoT Developer Kit 1.0. Saiba mais em https://software.intel.com/en-us/iot/downloads
##1) Requisitos
- Intel Galileo Gen 2 (não testado na Gen 1, mas não há nada que impeça o uso)
- Sistema Intel IoT Developer Kit 1.0 devidamente instalado
- Dispositivo Bluetooth devidamente instalado e configurado na Intel Galileo
- Acesso ao terminal do Linux na Intel Galileo (via Ethernet, Wifi, Serial ou PoorMansTelnet)
- Dispositivo wearable da Telefônica com firmware devidamente instalado
##2) Dependências
- Esta biblioteca inclui na pasta deps os módulos Python necessários para execução dos scripts:
- pexpect
- ptyprocess
- pybluez
- No IoT Developer Kit 1.0 não há nenhuma outra dependência pendente
##3) Instalação
- Copie para o cartão SD de seu sistema Yocto em uma pasta conveniente (ex. /home/root/wearablePython) todos os arquivos desta biblioteca
- Pela linha de comando do Yocto, execute a instalação de cada um dos módulos Python incluídos na pasta deps:
- Abra a pasta correspondente
- Execute o comando: $ python setup.py install
##4) Utilizando a biblioteca
- Antes de utilizar a biblioteca escreva o endereço MAC Low Energy de seu kit wearable (disponível na etiqueta atrás da bateria) no arquivo bltAddrWearable com o seguinte formato de exemplo: 00:0E:0B:00:39:AA (você pode utilizar um editor de texto comum caso esteja em um computador convencional ou o comando vi no Yocto - altamente não recomendado).
- Cada um dos scripts disponíveis controla uma função do kit wearable: acelerômetro, sensor de luminosidade, sensor de temperatura, buzzer, LED RGB e botões.
- IMPORTANTE: Antes de executar qualquer script é preciso habilitar o dispositivo Bluetooth na Intel Galileo! Utilize a seguinte sequência de comandos no terminal, supondo que seu dispositivo Bluetooth esteja endereçado no Linux como hci0:
- $ rfkill unblock all
- $ hciconfig hci0 up
- Os scripts são executados pelo comando:
- $ python nome_do_script.py [ARGUMENTOS]
- Todos os scripts aceitam o argumento --h para exibir um resumo de sua função e um exemplo de utilização
##5) Referência rápida
- getAcel.py
- Imprime a aceleração no eixo enviado como argumento
- Argumentos: X, Y ou Z
- Uso: python getAcel.py X
- getLumi.py
- Imprime a luminosidade lida pelo LDR da placa
- Argumentos: NENHUM
- Uso: python getLumi.py
- getTemp.py
- Imprime a temperatura, em celsius, lida pelo sensor da placa
- Argumentos: NENHUM
- Uso: python getTemp.py
- sendCommand.py
- Envia a cadeia de caracteres passada como argumento para o dispositivo wearable. Obs: O programa adiciona automaticamente o caractere # antes do comando e a cadeia \r\n depois do comando. Veja uma lista de comandos aqui: https://github.com/telefonicadigital/kit-iot-wearable-node/wiki/Comandos-padr%C3%B5es-do-Wearable
- Argumentos: Uma cadeia de caracteres, sem espaço
- Uso: python sendCommand.py cadeiaDeCaracteres
- setBuzzer.py
- Aciona o buzzer da placa com a frequência desejada (use 0 para desligar)
- Argumentos: Frequência, um número inteiro entre 0 e 2000
- Uso: python setBuzzer.py 1000
- setLed.py
- Configura a intensidade luminosa de cada uma das cores do LED RGB disponível na placa.
- Argumentos: 3 números inteiros entre 0 e 255, representando a intensidade de cada cor do LED na sequência R (vermelho) G (verde) e B (azul).
- Uso: python setLed.py 255 255 0
- waitButton.py
- Aguarda o pressionamento de um botão no kit wearable e imprime o número do botão pressionado (1 ou 2). Após um timeout (não configurável) se nenhum botão for pressionado o script imprime 0.
- Argumentos: NENHUM
- Uso: python waitButton.py