102 lines
3.1 KiB
Python
102 lines
3.1 KiB
Python
# SPDX-FileCopyrightText: 2021 Melissa LeBlanc-Williams for Adafruit Industries
|
|
#
|
|
# SPDX-License-Identifier: MIT
|
|
"""Generic Linux I2C class using PureIO's smbus class"""
|
|
|
|
import warnings
|
|
from Adafruit_PureIO import smbus
|
|
|
|
|
|
class I2C:
|
|
"""
|
|
I2C class
|
|
|
|
Baudrate has no effect on Linux systems. The argument is only there for compatibility.
|
|
"""
|
|
|
|
MASTER = 0
|
|
SLAVE = 1
|
|
_baudrate = None
|
|
_mode = None
|
|
_i2c_bus = None
|
|
|
|
# pylint: disable=unused-argument
|
|
def __init__(self, bus_num, mode=MASTER, baudrate=None):
|
|
if mode != self.MASTER:
|
|
raise NotImplementedError("Only I2C Master supported!")
|
|
_mode = self.MASTER
|
|
|
|
if baudrate is not None:
|
|
warnings.warn(
|
|
"I2C frequency is not settable in python, ignoring!", RuntimeWarning
|
|
)
|
|
|
|
try:
|
|
self._i2c_bus = smbus.SMBus(bus_num)
|
|
except FileNotFoundError:
|
|
raise RuntimeError(
|
|
"I2C Bus #%d not found, check if enabled in config!" % bus_num
|
|
) from RuntimeError
|
|
|
|
# pylint: enable=unused-argument
|
|
|
|
def scan(self):
|
|
"""Try to read a byte from each address, if you get an OSError
|
|
it means the device isnt there"""
|
|
found = []
|
|
for addr in range(0, 0x80):
|
|
try:
|
|
self._i2c_bus.read_byte(addr)
|
|
except OSError:
|
|
continue
|
|
found.append(addr)
|
|
return found
|
|
|
|
# pylint: disable=unused-argument
|
|
def writeto(self, address, buffer, *, start=0, end=None, stop=True):
|
|
"""Write data from the buffer to an address"""
|
|
if end is None:
|
|
end = len(buffer)
|
|
self._i2c_bus.write_bytes(address, buffer[start:end])
|
|
|
|
def readfrom_into(self, address, buffer, *, start=0, end=None, stop=True):
|
|
"""Read data from an address and into the buffer"""
|
|
if end is None:
|
|
end = len(buffer)
|
|
|
|
readin = self._i2c_bus.read_bytes(address, end - start)
|
|
for i in range(end - start):
|
|
buffer[i + start] = readin[i]
|
|
|
|
# pylint: enable=unused-argument
|
|
|
|
def writeto_then_readfrom(
|
|
self,
|
|
address,
|
|
buffer_out,
|
|
buffer_in,
|
|
*,
|
|
out_start=0,
|
|
out_end=None,
|
|
in_start=0,
|
|
in_end=None,
|
|
stop=False,
|
|
):
|
|
"""Write data from buffer_out to an address and then
|
|
read data from an address and into buffer_in
|
|
"""
|
|
if out_end is None:
|
|
out_end = len(buffer_out)
|
|
if in_end is None:
|
|
in_end = len(buffer_in)
|
|
if stop:
|
|
# To generate a stop in linux, do in two transactions
|
|
self.writeto(address, buffer_out, start=out_start, end=out_end, stop=True)
|
|
self.readfrom_into(address, buffer_in, start=in_start, end=in_end)
|
|
else:
|
|
# To generate without a stop, do in one block transaction
|
|
readin = self._i2c_bus.read_i2c_block_data(
|
|
address, buffer_out[out_start:out_end], in_end - in_start
|
|
)
|
|
for i in range(in_end - in_start):
|
|
buffer_in[i + in_start] = readin[i]
|