Lecciones y el juego de aprendizaje

Escribe un controlador con una hoja de datos

Escribe un driver para un INA219 y un BMP280 con nada m谩s que Wire y las hojas de datos, desde el id del chip hasta una clase de driver que sobrevive a un chip ausente.

El banco de trabajo

Every lesson opens the same circuit on an Uno. A BMP280 sits on A4 and A5 with its supply through a slide switch, so flipping the switch unplugs it while the sketch runs. An INA219 sits on the header's SDA and SCL with 5 V going into VIN+, through its 0.1 ohm shunt, and out of VIN- into a 100 ohm load. On an Uno those are the same two I2C wires, so both chips share one bus: the INA219 at 0x40 and the BMP280 at 0x76.

Toma el curso en Write a driver from a datasheet en /learn.

Qu茅 hace cada sketch

Ninguno incluye una biblioteca de sensores. Cada byte es una transacci贸n de Wire.

  • drvscan escanea de 0x08 a 0x77 cada dos segundos, lee el id del chip del BMP280 (0x58 del registro 0xD0) y dos valores de encendido.
  • drvina lee los registros de 16 bits big-endian del INA219: la configuraci贸n 0x399F, el shunt (499 cuentas de 10 uV) y el bus (4996 mV), luego escribe la calibraci贸n 4096 y la lee de vuelta, tras lo cual el registro de corriente lee 49.9 mA.
  • drvinit ejecuta la secuencia de inicializaci贸n del BMP280: verificaci贸n de id, reinicio por software, la copia de la NVM en im_update, config, una medici贸n forzada cronometrada con measuring, y una lectura de vuelta de ctrl_meas.
  • drvburst reads the 24 calibration bytes and the 6 data bytes in one burst each, assembles little-endian words and 20-bit counts, and times a burst against six single reads.
  • drvcalib aplica las f贸rmulas de compensaci贸n en enteros de Bosch: 22.00 C y 101326 Pa con los deslizadores predeterminados.
  • drverr devuelve un estado de cada transferencia, detecta el chip equivocado por su id, agota el tiempo de cada espera, y reinicializa un sensor que fue desconectado y volvi贸. Tambi茅n puede probar una segunda direcci贸n.
  • drvboss es una clase Bmp280 y una clase Ina219 volando un globo meteorol贸gico: modo normal a 16x de presi贸n, altitud relativa, corriente de carga y una alarma de techo.

Lo que hacen los chips simulados

El BMP280 es exacto a nivel de registros: el mapa de memoria, los valores de reinicio, im_update durante 2 ms tras un reinicio, los tiempos de medici贸n de la hoja de datos para cada sobremuestreo, los modos forzado y normal, y de 16 a 20 bits de resultado. Su calibraci贸n es el propio ejemplo resuelto de Bosch (dig_T1 27504, dig_T2 26435, dig_T3 -1000, etc茅tera), y sus registros de datos guardan las cuentas en bruto que las f贸rmulas de la hoja de datos convierten de vuelta en la temperatura y presi贸n de sus deslizadores. Si te equivocas en un corrimiento, un signo o un orden de bytes, lee tonter铆as, como uno real.

El INA219 es una resistencia real de 0.1 ohm en el circuito, as铆 que lee la propia corriente del circuito. Sus registros de corriente y potencia leen cero hasta que se escribe la calibraci贸n, como dice la hoja de datos.

L铆mites honestos

  • Sin ruido. Un BMP280 real var铆a en algunos pascales, que es para lo que sirven el sobremuestreo y el filtro IIR; aqu铆 solo cambian el tiempo de medici贸n y la cantidad de bits.
  • Los sketches usan la f贸rmula de presi贸n de 32 bits de la hoja de datos, que da uno o dos pascales de diferencia respecto a la de 64 bits (101326 Pa para un deslizador en 101325). El AVR no tiene multiplicaci贸n r谩pida de 64 bits, as铆 que esto tambi茅n es lo que hace un controlador en un Uno real.
  • El I2C del Uno aqu铆 est谩 implementado por software y corre cerca de 30 kHz, as铆 que una lectura de registro tarda unos 1.4 ms y cada espera activa se mide en esos pasos.
  • La altitud del globo usa la pendiente en l铆nea recta de la f贸rmula barom茅trica, 8.33 cm por pascal, con una exactitud de unos pocos por ciento en unos cientos de metros.

Habla con los chips para lo b谩sico de I2C, SPI y UART, y Hojas de datos y esquem谩ticos para leer los documentos de donde salen estos controladores.