Essa diferença vale uma tarde, e o mesmo vale para a diferença entre um barramento e um mapa de registradores.
I2C é o barramento que um iniciante conhece em segundo lugar, depois de "um pino está em nível alto ou baixo". São dois fios para qualquer número de dispositivos, cada um com um endereço, e é o que quase todo módulo interessante de um kit usa. O que segue é o que os três módulos desta bancada realmente fazem com ele, e as quatro ou cinco coisas que dão errado.
O formato de uma transferência
As duas linhas ficam em nível alto em repouso, seguradas por resistores de pull-up, e toda placa pronta da caixa de componentes carrega seu próprio par, por isso um OLED, um relógio ou um IMU funciona ligado direto em dois pinos sem mais nada na protoboard.
Um mestre fala puxando-as para baixo:
START SDA falls while SCL is high
address seven bits and a read/write bit, most significant first
ACK the addressed device pulls SDA down for the ninth clock
bytes eight bits and an acknowledge, over and over
STOP SDA rises while SCL is high
Esse é todo o protocolo. Tudo que está acima dele (registradores, ponteiros, a ordem dos bytes) é assunto do chip, não do barramento.
Wire.h
As chamadas de Wire de um tutorial funcionam como estão. Wire.begin() inicia o barramento nos pinos I2C da própria placa (A4 e A5 no Uno, os outros no artigo de ajuda de cada placa), Wire.begin(sda, scl) em quaisquer dois, e uma leitura de registrador são as quatro linhas de sempre:
#include <Wire.h>
void setup() {
Serial.begin(9600);
Wire.begin();
Wire.beginTransmission(0x68);
Wire.write(0x75); // WHO_AM_I
Wire.endTransmission(false); // no STOP: a repeated START follows
Wire.requestFrom(0x68, 1);
Serial.println(Wire.read(), HEX); // 68
}
void loop() {}
Wire.h é um header próprio do Mokxi sobre mokxi_i2c.h, então é um mestre por bit-bang como todo o resto aqui, com os buffers de 32 bytes da biblioteca original e seus códigos de endTransmission: 0 para sucesso, 2 para um endereço sem resposta, 3 para um byte de dados recusado. Um scanner I2C encontra todos os módulos no barramento. O que ele não faz é ser escravo: Wire.begin(address) interrompe a compilação com uma mensagem, porque nada no Mokxi pode ser o mestre de uma placa.
Lendo um arquivo de registradores
Os dois componentes I2C aqui são arquivos de registradores, e são lidos da mesma forma:
S addr+W A reg A Sr addr+R A data A data A ... data N P
Escreva o ponteiro, depois um START repetido (um segundo START sem um STOP no meio, o que mantém o barramento ocupado e impede que outro mestre se meta), então leia. O ponteiro avança a cada byte, então um bloco inteiro sai em uma transferência. firmware/lib/mokxi_i2c.h tem isso como readRegisters().
Isso não é um luxo. Leia os sete registradores de hora de um relógio um por vez e ele pode avançar entre os minutos e os segundos, e 10:00:59 sai como 10:01:59, uma vez por hora, para sempre.
O MPU6050, e as duas coisas que todo mundo encara
Um acelerômetro de três eixos e um giroscópio de três eixos em um chip, na pequena placa roxa GY-521. A parte do barramento é fácil; o mapa de registradores é o trabalho.
Ele liga dormindo. PWR_MGMT_1 (0x6B) lê 0x40 depois do reset (o bit SLEEP), e até ele ser limpo todo registrador de medição lê zero. Sem erro, sem reclamação: um nada perfeitamente estável, o que é pior que uma travada. O begin() de todo driver escreve 0 ali primeiro.
WHO_AM_I é 0x68 qualquer que seja o endereço. O registrador guarda os bits 6:1 do endereço, e AD0 é o bit 0. Então uma placa configurada para 0x69 ainda se identifica como 0x68, e um driver que compara WHO_AM_I com o endereço que está usando falha exatamente na placa que alguém teve que configurar.
Depois disso é aritmética. Os bits 4:3 de ACCEL_CONFIG e os bits 4:3 de GYRO_CONFIG escolhem as faixas, e as contagens por unidade estão no datasheet:
| bits | acelerômetro | contagens por g | bits | giroscópio | contagens por grau/s | |
|---|---|---|---|---|---|---|
| 0 | +/-2 g | 16384 | 0 | +/-250 graus/s | 131 | |
| 1 | +/-4 g | 8192 | 1 | +/-500 graus/s | 65.5 | |
| 2 | +/-8 g | 4096 | 2 | +/-1000 graus/s | 32.8 | |
| 3 | +/-16 g | 2048 | 3 | +/-2000 graus/s | 16.4 |
Cada leitura é um número de 16 bits com sinal, byte alto primeiro, e satura no fim da escala em vez de dar a volta, o que é todo o argumento para as faixas mais largas.
Leia-os em uma rajada, como todo driver faz. O chip copia suas leituras para os registradores que você lê somente enquanto o barramento está em repouso, então os quatorze bytes de ACCEL_XOUT_H a GYRO_ZOUT_L em uma transferência são uma amostra, e o modelo tira sua captura instantânea quando uma transferência de leitura é endereçada. Leia um registrador por transferência e os bytes alto e baixo podem vir de duas amostras.
A gravidade é o truque
Um acelerômetro em repouso mede a reação à gravidade e nada mais. Deitado na bancada isso é (0, 0, +1 g); incline-o e a gravidade passa para os outros dois eixos, e a inclinação é o arco tangente de dois dos três. É por isso que um componente que mede aceleração é o que diz para que lado algo está virado enquanto ele está perfeitamente parado.
Arraste a placa no canvas e ela inclina; as leituras acompanham. O giroscópio é a outra metade e se comporta bem diferente: ele lê o quão rápido a placa está girando, então fica em zero até você arrastar e volta a zero no momento em que você para. As propriedades pitch e roll definem a inclinação em graus, e temperature a temperatura do chip, 25 C por padrão.
O que este modelo não faz
Sem DMP e sem FIFO: o firmware do processador de movimento não é modelado, então uma biblioteca que o usa não recebe nada, em vez de algo errado. O mestre I2C auxiliar em XDA e XCL são dois pinos que não fazem nada. GYRO_ZOUT é sempre zero, porque não há nada no canvas que giraria a placa em torno do eixo apontando para você. E este chip está perfeitamente calibrado, enquanto um real precisa de seus offsets de repouso medidos e subtraídos antes de prestar para alguma coisa, então um sketch escrito aqui precisa desse trabalho adicionado antes de encontrar hardware de verdade.
O DS3231, e o BCD
Um oscilador de cristal compensado por temperatura, e é por isso que é o relógio que todo mundo acaba comprando: um DS1307 atrasa minutos por mês e este atrasa isso por ano. Endereço 0x68, fixo. Não há pino de endereço.
Tudo nele é decimal codificado em binário. Cada byte guarda dois dígitos decimais, um por nibble, então vinte e cinco segundos é 0x25 e não 25:
value = (byte >> 4) * 10 + (byte & 0x0f)
Esqueça disso e 37 minutos passados aparecem como 55. É a única coisa em que todo mundo erra uma vez.
The other trap is the hours register. Bit 6 is the 12-hour flag, and with it set
bits 4:0 are 1 to 12 and bit 5 is PM, so 3 pm is 0x63, and a driver that
masks with 0x3f instead of 0x1f reads it as 23.
O componente mantém um calendário real com anos bissextos, os dois alarmes com toda a tabela de máscaras do datasheet, e SQW tanto como saída do alarmo quanto como onda quadrada a 1 Hz, 1.024 kHz, 4.096 kHz ou 8.192 kHz. O OSF (bit 7 do registrador de status) vem ativo e significa "este horário não é confiável", o que numa bancada de verdade é como você descobre que a bateria de moeda de alguém acabou. A propriedade start é o horário inicial (2026-01-01 12:00:00 por padrão) e temperature é o que o registrador de temperatura lê.
Duas coisas não são modeladas e estão ditas aqui com clareza: a saída de 32 kHz, porque gerá-la seriam 65.536 bordas por segundo simulado para algo que nenhum componente da caixa de componentes consegue usar; e a bateria, então um componente que perde VCC perde o horário, onde um módulo real o mantém.
Ambos são 0x68
O MPU6050 e o DS3231 respondem ao mesmo endereço. Dois deles num único barramento é um dos poucos conflitos de endereço reais que um kit pode produzir, e a solução é o pino AD0: ligue-o em nível alto e o IMU vai para 0x69. Vale a pena fazer isso de propósito uma vez.
O TM1637, que não é I2C
O display de quatro dígitos parece exatamente um dispositivo I2C (o mesmo START, o mesmo STOP, um acknowledge num nono clock), mas não é, em dois pontos que quebram toda tentativa de controlá-lo com uma biblioteca Wire:
- Não há endereço. O primeiro byte após um START é um comando, então o chip responde a tudo que estiver no barramento. Dois deles compartilham um par de pinos e mostram a mesma coisa.
- Os bytes vão com o bit menos significativo primeiro. No I2C, o mais significativo vem primeiro. Se inverter, o display acende um conjunto de segmentos errados com cara de certos, um bug difícil de perceber.
As três transferências que um driver envia são 0x40 (gravar dados no display, com auto-incremento), 0xC0 seguido de quatro bytes de segmento, e 0x80 | 0x08 | brightness. Um byte por dígito, o bit 0 é o segmento A até o bit 6 para o G, e o bit 7 é os dois pontos, apenas no segundo dígito, o que é uma ligação do módulo e não do chip, e é por isso que toda biblioteca tem um caso especial para isso.
Os oito níveis de brilho são larguras de pulso em dezesseis: 1, 2, 4, 10, 11, 12, 13, 14. Não são espaçados de forma uniforme, e é por isso que o nível 3 dá um salto tão grande.
Circuitos para abrir
- Medidor de inclinação: um MPU6050 e três lâmpadas. Arraste a placa e veja os registradores acompanharem a gravidade.
- MPU6050 servo stabilizer: um filtro complementar move dois servos contra a inclinação para manter uma plataforma nivelada.
- Relógio de mesa: um DS3231 e um TM1637 lado a lado, que é todo o sentido do par: dois dispositivos de dois fios em dois barramentos de dois fios diferentes.
- Termômetro num LCD I2C: o terceiro tipo de dispositivo I2C, um expansor de portas sem registradores nenhum.
O que não é modelado no próprio barramento
Clock stretching, which none of these three chips does anyway. Arbitration between two masters. Ten-bit addressing. And the rate: the parts decode the bus from its edges and impose no timing of their own, so a driver that is too fast works here where a real device would not answer.
Arduino I2C LCD not working usa um scanner e Wire.endTransmission() para distinguir um erro de ligação de um endereço errado.
The tutorial Arduino TM1637 walks through Pomodoro timer: TM1637Display, the colon, leading zeros and a countdown timed with millis().
Related
- A página do componente MPU6050, com seu pinout
- A página do componente DS3231, com seu pinout
- A página do componente TM1637, com seu pinout