Aprender

Un ADXL345 en un Arduino: X, Y, Z y un nivel de burbuja

Intermedio

O mira todas las lecciones.

  • 526componentes en el banco de trabajo
  • 46placas funcionando ahora
  • 1.00xtiempo real, en todas las placas
Arduino Uno: un ADXL345 como nivel de burbujaen vivo0.000 s 0.00x
Haz clic para abrirlo en el editor
Un ADXL345 en A4 y A5, leído con la biblioteca de Adafruit, imprimiendo X, Y y Z tres veces por segundo en un ATmega328P simulado.

El ADXL345 es un acelerómetro de tres ejes pequeño de Analog Devices. Va montado en el módulo GY-291 de muchos kits de sensores, se comunica con un Arduino por I2C y, en reposo, mide muy bien una cosa: hacia dónde está abajo. Eso lo convierte en el chip detrás de las alarmas de inclinación, los niveles de burbuja y el truco de "hacia qué lado está mi celular".

El circuito de arriba es un Uno leyendo un ADXL345 con la biblioteca unificada de sensores de Adafruit. Tres veces por segundo imprime los tres ejes en metros por segundo al cuadrado, el conteo crudo en X, y un consejo: nivel, inclínalo hacia arriba, inclínalo hacia abajo, o ponlo en horizontal a los lados. Presiona Ejecutar, luego arrastra la placa en el lienzo para inclinarla y observa cómo se mueven los números.

Lo que necesitas

  • Un Arduino Uno
  • Un módulo ADXL345 (GY-291)
  • Cuatro cables de conexión
  • Una protoboard (opcional)

Cableado

Componente y pinVa aNota
ADXL345 VCC5 VEl GY-291 acepta 3.3 V o 5 V
ADXL345 GNDGND
ADXL345 SDAA4El pin de datos I2C del Uno
ADXL345 SCLA5El pin de reloj I2C del Uno
CS, SDO, INT1, INT2NadaLa placa pone CS en alto para I2C y SDO en bajo para la dirección 0x53

Qué lee un acelerómetro en reposo

Un acelerómetro mide aceleración, y la gravedad cuenta. Acostado plano sobre un escritorio, el ADXL345 siente 1 g jalando recto hacia abajo por su eje Z y nada en X ni en Y. Inclínalo, y parte de ese 1 g pasa a X o Y. Cuánto se mueve te dice qué tan inclinado está: a 30 grados, la mitad está en el eje inclinado, porque el seno de 30 grados es un medio.

El chip convierte cada eje en un número. A resolución completa, un conteo son 3.9 milésimas de g, así que 1 g son unas 256 cuentas. Está en la dirección I2C 0x53 con su pin SDO en bajo, que es como viene el GY-291, y en 0x1D con SDO en alto.

Un detalle hace tropezar a quienes escriben su propio código: el chip enciende en modo de espera y no mide nada hasta que se le indica. Hasta entonces, cada eje lee cero. El begin() de la biblioteca lo hace por ti.

La biblioteca Adafruit ADXL345

La mayoría de los tutoriales del ADXL345 usan Adafruit_ADXL345_U.h, que necesita Adafruit_Sensor.h junto a él. En el IDE de Arduino instalas "Adafruit ADXL345" desde el Gestor de bibliotecas y este trae la biblioteca Unified Sensor. En Mokxi ambas vienen integradas, así que los includes funcionan sin agregar nada.

begin() verifica que el chip responda con su ID y lo despierta. Si nada responde, este sketch imprime "No ADXL345 detected" y se detiene. setRange() elige el rango de 2, 4, 8 o 16 g; para inclinación sirve cualquiera, y el sketch usa 16 g a resolución completa.

getEvent() lee los tres ejes de una sola vez y los devuelve en metros por segundo al cuadrado. getX(), getY() y getZ() dan las cuentas crudas en su lugar, que es lo que el sketch compara para decidir hacia dónde inclinar.

El sketch del nivel de inclinación
#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 en el editorSolo el código: el editor coloca la placa y los componentes que puede leer del sketch.

Qué imprime, y por qué en horizontal lee 10.04

Presiona Ejecutar y la primera línea tras "Tilt level: ADXL345 ready" es todo ceros: "X: 0.00 Y: 0.00 Z: 0.00 m/s^2 raw X 0 level". El sketch preguntó antes de que el chip terminara su primera muestra. Un tercio de segundo después lee "X: 0.00 Y: 0.00 Z: 10.04 m/s^2 raw X 0 level".

¿Por qué 10.04 y no 9.81? La biblioteca convierte cada cuenta en 4 milésimas de g, un número redondo cercano a las 3.9 reales del chip. Así, las 256 cuentas de 1 g dan 1.024 g, o 10.04 m/s^2. Las placas reales muestran lo mismo, más un poco de ruido y de offset propios. Para detectar inclinación no importa, porque lo que cuenta es la proporción en cada eje.

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 o SPI

El ADXL345 también puede comunicarse por SPI: mantén CS en bajo e ignora el I2C y escucha en SDA, SDO y SCL como un bus SPI de cuatro cables. Algunos tutoriales usan eso para lecturas más rápidas. Para un sensor de inclinación o un contador de pasos el I2C es más que suficiente, y solo necesita dos cables que otros sensores pueden compartir.

Mokxi solo simula el lado I2C. Con CS en bajo el chip simulado se queda callado en el I2C, igual que uno real, pero no responde por SPI. Si tu proyecto necesita SPI, prueba ese cableado en una placa real.

También hay un segundo sketch integrado que se salta la biblioteca y lee los registros del chip con Wire, byte por byte. Vale la pena verlo si quieres saber qué es lo que en realidad envían begin() y getEvent().

Errores comunes

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.

La dirección equivocada. Con SDO conectado a 5 V el chip pasa a 0x1D, y un sketch que busca en 0x53 no encuentra nada. Aquí, conecta SDO en alto y el sketch imprime "No ADXL345 detected", la misma línea que aparece si desconectas SDA.

Esperar 9.81 estando plano. Con esta biblioteca, en plano se lee alrededor de 10.04, y una placa real también tiene un pequeño offset en cada eje. Calibra con tu propia lectura en plano si necesitas números exactos.

Confundir los ejes. Las flechas impresas en la GY-291 muestran X y Y. Inclina la placa y observa qué número cambia antes de escribir el código que reacciona a él.

Abre este circuito en el editor. Arduino Uno: un ADXL345 como nivel de burbuja, cableado tal como corre al inicio de esta página. Cambia un componente o un valor y ejecútalo de nuevo.

Abrir el circuito

Preguntas

¿Qué biblioteca necesito para el ADXL345 en Arduino?

Adafruit ADXL345 (Adafruit_ADXL345_U.h) y Adafruit Unified Sensor (Adafruit_Sensor.h), ambas desde el Gestor de bibliotecas. En Mokxi ya vienen integradas.

¿Cuál es la dirección I2C del ADXL345?

0x53 con SDO en bajo o sin conectar, que es como viene la GY-291, y 0x1D con SDO en alto.

¿Cómo conecto un ADXL345 a un Arduino Uno?

VCC a 5 V, GND a GND, SDA a A4 y SCL a A5. Deja CS, SDO y los dos pines de interrupción tal como los pone la placa.

¿Por qué mi ADXL345 marca 10 en lugar 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.

¿Puedo usar el ADXL345 por SPI?

El chip lo admite con CS en bajo. Mokxi solo simula el lado I2C, así que prueba el cableado SPI en hardware real.

Ármalo en la vida real

Abre el editor, cambia un valor y mira cómo cambia el número con él. Nada que instalar y sin necesidad de cuenta.