i2cdevice python

i2cDevice

O i2CDevice é uma estrutura Python destinada a lidar com padrões de interação comuns de dispositivo SMBUS/I2C.

Este projeto tem como objetivo tornar as implementações em grupo das bibliotecas Python para dispositivos I2C mais fáceis, mais simples e inerentemente autocumentos.

Faz isso separando uma descrição detalhada dos registros de hardware e como eles devem ser manipulados em um idioma de definição estruturado.

Este projeto não pretende ajudá-lo a criar uma API pública para dispositivos Python- que deve ser construído sobre os fundamentos apresentados aqui.

Usando esta biblioteca

Geralmente, você deve buscar uma representação 1: 1 dos registros de hardware no dispositivo que você está implementando, mesmo que não planeje usar toda a funcionalidade. Ter o conjunto de registros completo implementado permite a fácil adição de novos recursos no futuro.

Confira as bibliotecas listadas abaixo para exemplos do mundo real.

Características

• Classes para descrever dispositivos, registros e campos de bits individuais dentro de registros de uma maneira que mapeia em estreita colaboração com a folha de dados
• Tradução de valor de números do mundo real (como 512ms ) para registrar valores (como 0b111 ) e de volta
• Leia os registros em um nome nomeado de campos usando get
• Escreva vários campos de registro em uma transação usando set com argumentos de palavras -chave
• Suporte ao tratamento de múltiplos bytes como um único valor ou um único registro com vários valores

Construído com i2cdevice

• BME280 - https://github.com/pimoroni/bme280-python
• BMP280 - https://github.com/pimoroni/bmp280-python
• BH1745 - https://github.com/pimoroni/bh1745-python
• AS7262 - https://github.com/pimoroni/as7262-python
• LSM303D - https://github.com/pimoroni/lsm303d-python
• LTR559 - https://github.com/pimoroni/ltr559-python
• ADS1015 - https://github.com/pimoroni/ads1015-python

Exemplos

O exemplo abaixo define o registro ALS_CONTROL em um LTR559, com endereço de registro 0x80 .

Tem 3 campos; Ganho - que é mapeado para valores do mundo real - e sw_reset/modo que são sinalizadores de bits únicos.

 ALS_CONTROL = Register ( 'ALS_CONTROL' , 0x80 , fields = (
    BitField ( 'gain' , 0b00011100 , values_map = { 1 : 0b000 , 2 : 0b001 , 4 : 0b011 , 8 : 0b011 , 48 : 0b110 , 96 : 0b111 }),
    BitField ( 'sw_reset' , 0b00000010 ),
    BitField ( 'mode' , 0b00000001 )
))

Uma tabela de pesquisa não é necessária para valores, no entanto, uma função pode ser usada para traduzir valores e para um formato que o dispositivo entende.

O exemplo abaixo usa i2cdevice._byte_swap para alterar a endianidade de dois valores de 16 bits antes de serem armazenados/recuperados.

 # This will address 0x88, 0x89, 0x8A and 0x8B as a continuous 32bit register
ALS_DATA = Register ( 'ALS_DATA' , 0x88 , fields = (
    BitField ( 'ch1' , 0xFFFF0000 , bitwidth = 16 , values_in = _byte_swap , values_out = _byte_swap ),
    BitField ( 'ch0' , 0x0000FFFF , bitwidth = 16 , values_in = _byte_swap , values_out = _byte_swap )
), read_only = True , bitwidth = 32 )

Um "registro" e seu "campo de bits" definem um conjunto de regras e lógica para detalhes com o registro de hardware, que é interpretado pela classe de dispositivo. Os registros são declarados em um dispositivo usando o argumento registers=() da palavra -chave:

 I2C_ADDR = 0x23
ltr559 = Device ( I2C_ADDR , bit_width = 8 , registers = (
	ALS_CONTROL ,
	ALS_DATA
))

Registros de leitura

Um configurou os campos de um registro pode ser lido em um nome nomeado usando o método get :

 register_values = ltr559 . get ( 'ALS_CONTROL' )
gain = register_values . gain
sw_reset = register_values . sw_reset
mode = register_values . mode 

REGISTROS DE ESCRITÓRIO

O nome do nome retornado do get é imutável e não tenta mapear os valores de volta ao hardware, a fim de escrever um ou mais campos em um registro, você deve usar set com um argumento de palavra -chave para cada campo:

 ltr559 . set ( 'ALS_CONTROL' ,
           gain = 4 ,
           sw_reset = 1 )

Isso lerá o estado do registro do dispositivo, atualizará os Bitfields de acordo e escreverá o resultado de volta.