Aprender

Um ADXL345 em um Arduino: X, Y, Z e um nível de bolha

Intermediário

Ou veja todas as aulas.

  • 526componentes na bancada
  • 46placas rodando agora
  • 1.00xtempo real, em todas as placas
Arduino Uno: um ADXL345 como nível de bolhaao vivo0.000 s 0.00x
Clique para abrir no editor
Um ADXL345 em A4 e A5, lido com a biblioteca Adafruit, imprimindo X, Y e Z três vezes por segundo em um ATmega328P simulado.

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 pinoVai paraNota
ADXL345 VCC5 VO GY-291 aceita 3,3 V ou 5 V
ADXL345 GNDGND
ADXL345 SDAA4O pino de dados I2C do Uno
ADXL345 SCLA5O pino de clock I2C do Uno
CS, SDO, INT1, INT2NadaA 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.

O sketch do nível de inclinação
#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 circuito

Perguntas

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.

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.