Construa uma Ponte IR Habilitada para SmartThings com Arduino UNO e ThingShield
Componentes e Materiais
| Arduino UNO | 1 |
| SmartThings Shield para Arduino (ThingShield) | 1 |
| LED Emissor IR | 1 |
| Diodo Receptor IR | 1 |
| Resistor 100 Ohm (opcional) | 1 |
Sobre o Projeto
Introdução
Um simples controle remoto de TV é capaz de muito mais do que trocar canais quando conectado à nuvem SmartThings. Com uma contagem pequena de peças e retorno imediato, o projeto é uma boa forma de explorar a plataforma.
Contexto sobre Arduino e o ThingShield
O SmartThings ThingShield facilita a criação de protótipos SmartThings usando Arduino. O shield conecta-se diretamente ao UNO, ligando ao hub SmartThings via protocolo Zigbee. Uma chave no shield permite escolher entre usar pinos 0,1 ou 2,3 para comunicar com o Arduino. O ThingShield já reserva o uso do pino 6.
Para mais informações sobre como começar com Arduino: Guia Arduino
Passo 1: Você vai precisar
- (x1) SmartThings Arduino ThingShield
- (x1) Arduino Uno
- (x1) Receptor IR
- (x1) LED Emissor IR
- (x1) Resistor 100 Ohm (opcional)
Passo 2: Baixe a Biblioteca IR
O projeto depende de uma excelente biblioteca Arduino desenvolvida por Ken Shirriff: Arduino-IRremote
Instale a biblioteca Arduino da maneira usual: Guia de Bibliotecas
Uma vez instalada, precisamos modificar o IRRemoteInt.h para usar o timer no pino 9. Neste exemplo, usamos o pino 3 para comunicação com o ThingShield.
Passo 3: Sketch do Arduino
Faça upload do sketch para sua placa Arduino (veja seção de código).
Passo 4: A Montagem
A montagem é simples e direta. Primeiro conecte o ThingShield sobre o Arduino. Embora apenas o Arduino seja mostrado no diagrama abaixo, a disposição dos pinos é a mesma com o shield acoplado.
Para o Receptor IR, conecte os pinos correspondentes ao GND e 5V. Depois conecte o pino de dados ao pino 11 do Arduino. Conecte o LED emissor IR ao pino 9 e GND. O resistor de 100 ohm é opcional neste design, pois o LED provavelmente aguenta a corrente máxima do Arduino já que pisca rapidamente para enviar sinais. Se ficado ligado continuamente, a mesma corrente provavelmente queimaria o LED.
Passo 5: Criando um Device Type Personalizado no SmartThings
No IDE do SmartThings, criamos um novo device type para nosso ThingShield.
Vá à seção "My Device Types", clique em "New SmartDevice" à direita.
Criar um novo SmartDevice requer dois passos. Primeiro, dê um nome ao novo device type no topo: "Ir Bridge". Note que referenciaríamos o nome do nosso SmartDevice no código do SmartApp depois.
Precisamos definir os Atributos (variáveis) e Comandos (funções) do dispositivo. Para este tutorial, criaremos atributos e comandos para dois botões programáveis e um botão de gravação. Adicione cada um dos atributos e comandos mostrados. Selecione "Create" para continuar para a codificação do device.
Em seguida, copie a definição do device para a janela de código no IDE (veja seção de código). Clique no botão "Save" no topo e depois em "Publish" para tornar o device disponível para você.
Passo 6: Atualizando o ThingShield para seu Novo Device Type
Certifique-se de adicionar seu ThingShield ao hub SmartThings se ainda não estiver configurado. Para parear o dispositivo, acople o ThingShield ao seu Arduino e alimente-o. Segure o botão "Switch" no shield por 6 segundos. Com o app SmartThings no smartphone, selecione o botão Add. Pressione o botão físico "switch" mais uma vez e você deve ver o hub identificar o ThingShield.
De volta ao IDE, navegue até seu Arduino ThingShield clicando em "devices" na tela inicial. Selecione seu dispositivo na lista e clique no botão "Edit" no final da página. No menu dropdown "Type", escolha o novo tipo SmartDevice que você criou. É útil dar nomes significativos aos dispositivos quando precisar selecioná-los depois. Clique em update para definir o dispositivo para seu novo device type.
Nota: ao publicar atualizações nos seus device types personalizados no futuro, você vai querer voltar para confirmar que seus dispositivos físicos permaneceram associados ao device type correto após uma atualização publicada.
Passo 7: Escrevendo o SmartApp
Temos mais um pedaço de código no projeto – o próprio SmartApp. Navegue até "My SmartApps" e inicie um "New SmartApp" clicando no botão à direita. Dê um nome, descrição e categoria ("My apps"). Clique em "Create" para continuar codificando o app.
Copie o código do smartApp (veja seção de código). Selecione "Save" e depois clique em "Publish" para tornar o SmartApp disponível no seu app SmartThings iOS ou Android.
Note que referenciamos o tipo SmartDevice pelo nome como "IrBridge" sem o espaço original que usamos no nome "Ir Bridge":
input "irDevice", "device.IrBridge"
A linha nos permite mostrar apenas dispositivos do tipo "Ir Bridge" como opções para selecionar no SmartApp. O camelCasing usado é muito específico: ao referenciar device types em smart apps, espaços são removidos do nome. O primeiro caractere e caracteres originalmente seguintes a um espaço são capitalizados. Todos os outros são minúsculos, independentemente da capitalização original.
Passo 8: Habilitando o SmartApp
Dentro do app SmartThings no smartphone, associe o novo SmartApp com nosso novo dispositivo IR e selecione os switches que deseja controlar. Depois clique em "install".
Para programar cada um dos botões no app, vá aos detalhes do tile clicando na engrenagem no canto do tile. Selecione o grande botão de gravação – ele ficará vermelho para mostrar que está em modo de gravação. Então clique no tile (Play/Pause ou B) que deseja controlar – ficará amarelo. Aponte seu controle remoto para o ThingShield e pressione o botão que quer aprender. O ThingShield enviará aquele código para a nuvem SmartThings e o associará ao botão que escolheu no SmartApp. O botão recém-programado ficará verde e o botão de gravação voltará a branco.
Da próxima vez que você pressionar aquele botão no seu controle remoto, você alternará o switch que associou ao botão no SmartApp.
Código
Sketch Arduino
//*****************************************************************************
/// @file
/// @brief
/// Arduino SmartThings IR Shield
//*****************************************************************************
#include <SoftwareSerial.h>
#include <SmartThings.h>
#include <IRremote.h>
//*****************************************************************************
// Definições de Pinos
//*****************************************************************************
#define PIN_LED 13
#define PIN_RECV 11
#define PIN_THING_RX 3
#define PIN_THING_TX 2
//*****************************************************************************
// Variáveis Globais
//*****************************************************************************
SmartThingsCallout_t messageCallout;
SmartThings smartthing(PIN_THING_RX, PIN_THING_TX, messageCallout);
bool isDebugEnabled;
int stateLED;
IRrecv irrecv(PIN_RECV);
IRsend irsend;
decode_results results;
//*****************************************************************************
// Funções API
//*****************************************************************************
void setup() {
isDebugEnabled = true;
stateLED = 0;
pinMode(PIN_LED, OUTPUT);
digitalWrite(PIN_LED, LOW);
if (isDebugEnabled) {
Serial.begin(9600);
Serial.println("setup..");
}
irrecv.enableIRIn();
}
void loop() {
smartthing.run();
if (irrecv.decode(&results)) {
blue();
irrecv.resume();
Serial.println(results.value, HEX);
String irCmd;
if (results.decode_type == NEC) {
irCmd = String(results.value, HEX) + "," + "NEC" + String(results.bits, DEC) + ":" + String(results.value, HEX);
} else if (results.decode_type == SONY) {
irCmd = String(results.value, HEX) + "," + "SNY" + String(results.bits, DEC) + ":" + String(results.value, HEX);
} else if (results.decode_type == RC5) {
irCmd = String(results.value, HEX) + "," + "RC5" + String(results.bits, DEC) + ":" + String(results.value, HEX);
} else if (results.decode_type == RC6) {
irCmd = String(results.value, HEX) + "," + "RC6" + String(results.bits, DEC) + ":" + String(results.value, HEX);
} else {
irCmd = String(results.value, HEX) + "," + "RAW" + String(results.bits, DEC) + ":";
}
Serial.println(irCmd);
smartthing.send(irCmd);
irCmd = "";
}
}
void messageCallout(String message) {
smartthing.shieldSetLED(0, 0, 0);
if (isDebugEnabled) {
Serial.print("Rx: '");
Serial.print(message);
Serial.println("' ");
}
String type = message.substring(0,3);
int startCode = message.indexOf(':');
String lenStr = message.substring(3,startCode);
String codeStr = message.substring(startCode + 1);
unsigned long code;
if(type != "RAW") code = stringToNum(codeStr,16);
int len = stringToNum(lenStr,10);
if(type == "NEC") {
Serial.println("NEC-SEND");
Serial.println(len);
Serial.println(code,HEX);
irsend.sendNEC(code,len);
irrecv.enableIRIn();
} else if(type == "SNY") {
irsend.sendSony(code,len);
irrecv.enableIRIn();
} else if(type == "RC5") {
irsend.sendRC5(code,len);
irrecv.enableIRIn();
} else if(type == "RC6") {
irsend.sendRC6(code,len);
irrecv.enableIRIn();
}
}
unsigned long stringToNum(String s, int base) {
unsigned long i = 0;
unsigned long value = 0;
unsigned long place = s.length();
char c;
unsigned long sign = 1;
for(i; i < s.length(); i++) {
place--;
c = s[i];
if(c == '-') { sign = -1; }
else if (c >= '0' && c <= '9') { value += (c - '0') * exponent(base,place); }
else if (c >= 'A' && ((c - 'A' + 10) < base)) { value += ((c - 'A') + 10) * exponent(base,place); }
else if (c >= 'a' && (c - 'a' + 10) < base) { value += ((c - 'a') + 10) * exponent(base,place); }
}
value *= sign;
return value;
}
unsigned long exponent(int num, int power) {
unsigned long total = num;
unsigned long i = 1;
for(power; i < power; i++) { total *= num; }
return (power == 0) ? 1 : total;
}
void green() { smartthing.shieldSetLED(0, 1, 0); }
void blue() { smartthing.shieldSetLED(0, 0, 1); }
void red() { smartthing.shieldSetLED(1, 0, 0); }
void off() { delay(100); smartthing.shieldSetLED(0, 0, 0); }
Definição do Device (Groovy)
/** * Smart Ir * Author: danny@smartthings.com * Date: 2013-03-06 */
metadata {
simulator {}
tiles {
standardTile("recStatus", "device.recStatus", width: 2, height: 2, canChangeIcon: true, canChangeBackground: true) {
state "off", label: 'record', action: "record", backgroundColor: "#ffffff"
state "on", label: 'record', action: "record", backgroundColor: "#ff0000"
}
standardTile("buttonA", "device.buttonAStatus", width: 1, height: 1, canChangeIcon: true, canChangeBackground: true) {
state "unset", label: '', action: "buttonA", icon: "st.custom.buttons.play-pause", backgroundColor: "#cccccc"
state "prog", label: '', action: "buttonA", icon: "st.custom.buttons.play-pause", backgroundColor: "#FDE910"
state "set", label: '', action: "buttonA", icon: "st.custom.buttons.play-pause", backgroundColor: "#79b821"
}
standardTile("buttonB", "device.buttonBStatus", width: 1, height: 1, canChangeIcon: true, canChangeBackground: true) {
state "unset", label: '', action: "buttonB", icon: "st.custom.buttons.b", backgroundColor: "#cccccc"
state "prog", label: '', action: "buttonB", icon: "st.custom.buttons.b", backgroundColor: "#FDE910"
state "set", label: '', action: "buttonB", icon: "st.custom.buttons.b", backgroundColor: "#79b821"
}
main (["buttonA","buttonB"])
details (["recStatus","buttonA","buttonB"])
}
}
def parse(String description) {
def value = zigbee.parse(description)?.text
def codeParts = value.split(/,/)
if(device.currentValue("recStatus") == "on") {
if(device.currentValue("lastButton") != "") {
def buttonStatus = "${device.currentValue("lastButton")}Status"
def buttonHex = "${device.currentValue("lastButton")}Hex"
def buttonCode = "${device.currentValue("lastButton")}Code"
def result = [
createEvent(name:buttonStatus, value:"set", isStateChange:true),
createEvent(name:buttonHex, value:codeParts[0], isStateChange:true),
createEvent(name:buttonCode, value:codeParts[1], isStateChange:true),
createEvent(name:"recStatus", value:"off", isStateChange:true),
createEvent(name:"lastButton", value:"", isStateChange:true)
]
return result
}
} else {
if(codeParts[0] == device.currentValue("buttonAHex")) {
def result = createEvent(name: "button", value: "A", isStateChange:true)
return result
} else if(codeParts[0] == device.currentValue("buttonBHex")) {
def result = createEvent(name: "button", value: "B", isStateChange:true)
return result
}
}
return createEvent(name: null, value: "")
}
def record() {
clearLast()
if(device.currentValue("recStatus") == "on") {
sendEvent(name:"recStatus", value:"off", isStateChange:true)
} else {
sendEvent(name:"recStatus", value:"on", isStateChange:true)
}
}
def buttonA() {
if(device.currentValue("recStatus") == "on") {
clearLast()
sendEvent(name:"buttonAStatus", value:"prog", isStateChange:true)
sendEvent(name:"lastButton", value:"buttonA", isStateChange:true)
} else if(device.currentValue("buttonAStatus") == "set") {
zigbee.smartShield(text: "${device.currentValue("buttonACode")}").format()
}
}
def buttonB() {
clearLast()
if(device.currentValue("recStatus") == "on") {
sendEvent(name:"buttonBStatus", value:"prog", isStateChange:true)
sendEvent(name:"lastButton", value:"buttonB", isStateChange:true)
} else if(device.currentValue("buttonBStatus") == "set") {
zigbee.smartShield(text: "${device.currentValue("buttonBCode")}").format()
}
}
def clearLast() {
if(device.currentValue("lastButton") != "") {
sendEvent(name:"${device.currentValue("lastButton")}", value:"unset", isStateChange:true)
sendEvent(name:"lastButton", value:"", isStateChange:true)
}
}
Código do SmartApp (Groovy)
/** * IR Receiver * Author: danny@smartthings.com * Date: 2013-03-31 */
preferences {
section("Pick an IR device...") {
input "irDevice", "device.IrBridge"
}
section("Button A turns on or off..."){
input "switch1", "capability.switch", title: "This light", required: false
}
section("Button B turns on or off..."){
input "switch2", "capability.switch", title: "This light", required: false
}
}
def installed() {
subscribe(irDevice, "button.B", handleB)
subscribe(irDevice, "button.A", handleA)
}
def updated() {
unsubscribe()
subscribe(irDevice, "button.B", handleB)
subscribe(irDevice, "button.A", handleA)
}
def handleA(evt) {
if (switch1.currentValue("switch") == "on") { switch1.off() } else { switch1.on() }
}
def handleB(evt) {
if (switch2.currentValue("switch") == "on") { switch2.off() } else { switch2.on() }
}
Processo de manufatura
- Construa um Robô com Raspberry Pi e Python: Guia Completo
- Construa um Segway Auto-Equilibrado com Raspberry Pi
- Aproveitando Dados na Internet da Confiabilidade: Estratégias para Gestão Eficaz
- Capture Gotas d'Água em Ação com Arduino Nano – Fotografia de Alta Velocidade DIY
- Sensor K30 CO₂: Monitoramento de Qualidade do Ar Interno em Tempo Real
- Facilitando Comunicação Surdo-Cego com 1Sheeld e Arduino
- Mealheiro Inteligente: Controlar Aceitador de Moedas com Arduino Nano
- Controlar um LED via Bluetooth com Arduino – Guia DIY Simples
- Monitore a Temperatura da Sua Casa de Qualquer Lugar com Integração Arduino Cloud
- Construindo a Força de Trabalho do Amanhã: Como a Automação Inteligente Melhora a Experiência do Funcionário