Um ADXL345 em um Arduino: X, Y, Z e um nível de bolha
Intermediário
- 526componentes na bancada
- 46placas rodando agora
- 1.00xtempo real, em todas as placas
O ADXL345 é um pequeno acelerômetro de três eixos da Analog Devices. Ele vem no módulo GY-291 em muitos kits de sensores, conversa com um Arduino por I2C e, em repouso, mede muito bem uma coisa: para onde é para baixo. Isso faz dele o chip por trás de alarmes de inclinação, níveis de bolha e do truque de "para que lado está o meu telefone virado".
O circuito acima é um Uno lendo um ADXL345 com a biblioteca unificada de sensores da Adafruit. Três vezes por segundo ele imprime os três eixos em metros por segundo ao quadrado, a contagem bruta em X e um conselho: nivelado, levante a ponta, abaixe a ponta ou role para nivelar. Aperte Rodar e arraste a placa no canvas para incliná-la e veja os números mudarem.
O que você precisa
- Um Arduino Uno
- Um módulo ADXL345 (GY-291)
- Quatro fios jumper
- Uma protoboard (opcional)
Ligação
| Componente e pino | Vai para | Nota |
|---|---|---|
| ADXL345 VCC | 5 V | O GY-291 aceita 3,3 V ou 5 V |
| ADXL345 GND | GND | |
| ADXL345 SDA | A4 | O pino de dados I2C do Uno |
| ADXL345 SCL | A5 | O pino de clock I2C do Uno |
| CS, SDO, INT1, INT2 | Nada | A placa puxa CS para alto para I2C e SDO para baixo para o endereço 0x53 |
O que um acelerômetro lê em repouso
Um acelerômetro mede aceleração, e a gravidade conta. Deitado plano sobre uma mesa, o ADXL345 sente 1 g puxando reto para baixo pelo eixo Z e nada em X ou Y. Incline-o, e parte daquele 1 g passa para X ou Y. Quanto passa mostra o quanto ele está inclinado: a 30 graus, metade está no eixo inclinado, porque o seno de 30 graus é um meio.
O chip transforma cada eixo em um número. Na resolução máxima, cada unidade vale 3,9 milésimos de g, então 1 g é cerca de 256 unidades. Ele fica no endereço I2C 0x53 com o pino SDO em nível baixo, que é como o GY-291 vem de fábrica, e em 0x1D com o SDO em nível alto.
Um detalhe atrapalha quem escreve o próprio código: o chip liga em standby e não mede nada até receber a ordem. Até lá, todo eixo lê zero. O begin() da biblioteca faz isso por você.
A biblioteca Adafruit ADXL345
A maioria dos tutoriais do ADXL345 usa Adafruit_ADXL345_U.h, que precisa de Adafruit_Sensor.h junto. No Arduino IDE você instala "Adafruit ADXL345" pelo Gerenciador de Bibliotecas e ele traz a biblioteca Unified Sensor. No Mokxi as duas já vêm incluídas, então os includes funcionam sem acrescentar nada.
begin() verifica se o chip responde com o ID dele e o acorda. Se nada responde, o sketch imprime "No ADXL345 detected" e para. setRange() escolhe a faixa de 2, 4, 8 ou 16 g; para inclinação qualquer uma serve, e o sketch usa 16 g na resolução máxima.
getEvent() lê os três eixos de uma vez e devolve os valores em metros por segundo ao quadrado. getX(), getY() e getZ() dão as unidades brutas, que é o que o sketch compara para decidir para onde inclinar.
#include <Wire.h>
#include <Adafruit_Sensor.h>
#include <Adafruit_ADXL345_U.h>
Adafruit_ADXL345_Unified accel = Adafruit_ADXL345_Unified(12345);
void setup() {
Serial.begin(9600);
if (!accel.begin()) {
Serial.println("No ADXL345 detected");
while (1) delay(10);
}
accel.setRange(ADXL345_RANGE_16_G);
Serial.println("Tilt level: ADXL345 ready");
}
void loop() {
sensors_event_t event;
accel.getEvent(&event);
int16_t rawX = accel.getX();
Serial.print("X: ");
Serial.print(event.acceleration.x);
Serial.print(" Y: ");
Serial.print(event.acceleration.y);
Serial.print(" Z: ");
Serial.print(event.acceleration.z);
Serial.print(" m/s^2 raw X ");
Serial.print(rawX);
// Half a m/s^2 is 13 counts at 3.9 mg a count.
int16_t rawY = accel.getY();
if (rawX > 13) {
Serial.println(" tip it nose up");
} else if (rawX < -13) {
Serial.println(" tip it nose down");
} else if (rawY > 13 || rawY < -13) {
Serial.println(" roll it level");
} else {
Serial.println(" level");
}
delay(300);
}Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.
O que ele imprime, e por que plano lê 10.04
Aperte Rodar e a primeira linha depois de "Tilt level: ADXL345 ready" é toda de zeros: "X: 0.00 Y: 0.00 Z: 0.00 m/s^2 raw X 0 level". O sketch perguntou antes de o chip terminar a primeira amostra. Um terço de segundo depois ele lê "X: 0.00 Y: 0.00 Z: 10.04 m/s^2 raw X 0 level".
Por que 10.04 e não 9.81? A biblioteca converte cada unidade em 4 milésimos de g, um número redondo próximo dos 3,9 reais do chip. Assim, as 256 unidades de 1 g saem como 1.024 g, ou 10.04 m/s^2. Placas reais mostram a mesma coisa, além de um pouco de ruído e desvio próprios. Para inclinação isso não importa, porque o que conta é a fração em cada eixo.
Drag the board 30 degrees nose up and the line becomes "X: -5.02 Y: 0.00 Z: 8.71 m/s^2 raw X -128 tip it nose down": half of 256 counts, with a minus sign, and the sketch says how to fix it. Tip it 30 degrees the other way and you get "raw X 128 tip it nose up". Roll it 20 degrees sideways and Y takes 3.45 m/s^2, with "roll it level". At 2 degrees of roll Y reads 0.35, under the 13 count limit, and the sketch calls it level.
I2C ou SPI
O ADXL345 também pode falar SPI: mantenha CS em nível baixo e ele ignora I2C e escuta em SDA, SDO e SCL como um barramento SPI de quatro fios. Alguns tutoriais usam isso para leituras mais rápidas. Para um sensor de inclinação ou um contador de passos o I2C basta, e ele precisa de apenas dois fios que outros sensores podem compartilhar.
O Mokxi simula apenas o lado I2C. Com CS em nível baixo, o chip simulado fica calado no I2C, como um real, mas não responde SPI. Se o seu projeto precisa de SPI, teste essa ligação numa placa real.
Também há um segundo projeto pronto que dispensa a biblioteca e lê os registradores do chip com Wire, byte por byte. Vale a pena dar uma olhada se você quer ver o que begin() e getEvent() realmente enviam.
Erros comuns
Reading zeros on every axis. A hand-written driver that never writes 0x08 to the POWER_CTL register leaves the chip in standby. Use begin(), or write that byte yourself.
O endereço errado. Com SDO ligado a 5 V o chip muda para 0x1D, e um sketch que olha 0x53 não encontra nada. Ligue SDO em nível alto aqui e o sketch imprime "No ADXL345 detected", a mesma linha que aparece com o SDA removido.
Esperar 9.81 deitado plano. Com esta biblioteca a leitura plana dá cerca de 10.04, e uma placa real também tem um pequeno desvio em cada eixo. Calibre com a sua própria leitura plana se precisar de números exatos.
Confundir os eixos. As setas impressas no GY-291 mostram X e Y. Incline a placa e veja qual número muda antes de escrever o código que reage a ele.
Abra este circuito no editor. Arduino Uno: um ADXL345 como nível de bolha, ligado como aparece no topo desta página. Troque um componente ou um valor e rode de novo.
Abrir o circuitoPerguntas
Qual biblioteca preciso para o ADXL345 no Arduino?
Adafruit ADXL345 (Adafruit_ADXL345_U.h) e Adafruit Unified Sensor (Adafruit_Sensor.h), ambas pelo Gerenciador de Bibliotecas. No Mokxi elas já vêm incluídas.
Qual é o endereço I2C do ADXL345?
0x53 com SDO em nível baixo ou solto, que é como o GY-291 vem de fábrica, e 0x1D com SDO em nível alto.
Como ligar um ADXL345 num Arduino Uno?
VCC ao 5 V, GND ao GND, SDA ao A4 e SCL ao A5. Deixe CS, SDO e os dois pinos de interrupção como a placa os puxa.
Por que meu ADXL345 lê 10 em vez de 9.8 m/s^2?
The Adafruit library scales each count as 4 thousandths of a g, slightly more than the chip’s 3.9, so 1 g reads about 10.04. Real boards add their own small offsets on top.
Posso usar o ADXL345 por SPI?
O chip suporta com CS em nível baixo. O Mokxi simula apenas o lado I2C, então teste a ligação SPI em hardware real.
Continuar
De onde vêm as informações desta página
Monte isto de verdade
Abra o editor, mude um valor e veja o número mudar junto. Nada para instalar, e não precisa de conta.