API referenceEmulation APIClasses

hololink::emulation::PyI2CPeripheral

View as Markdown

Inherits from: hololink::emulation::I2CPeripheral (public)

Methods

i2c_transaction

I2CStatus hololink::emulation::PyI2CPeripheral::i2c_transaction(
    uint16_t peripheral_address,
    const uint8_t *write_bytes,
    uint16_t write_size,
    uint8_t *read_bytes,
    uint16_t read_size
) override

python:

def i2c_transaction(self: hemu.I2CPeripheral, peripheral_address: int, write_bytes: List[int], read_bytes: List[int]) -> hemu.I2CStatus

perform an I2C transaction. This will be called by the I2CController when a transaction is requested.

read request size is the size of the read_bytes vector as initialized by the caller

Returns: I2CStatus The status of the transaction.

Parameters

peripheral_address
uint16_t

The peripheral address to communicate with.

write_bytes
const uint8_t *

The bytes to write to the peripheral.

write_size
uint16_t

The size of the write bytes

read_bytes
uint8_t *

The bytes to read from the peripheral. This shall be filled with 0s to the requested read size and replaced by peripheral. This is to ensure peripheral can get the read count from read_bytes.size() and enough valid data is returned for no-ops.

read_size
uint16_t

The size of the read bytes

start

void hololink::emulation::PyI2CPeripheral::start() override

start the peripheral.

This will be called when I2CController itself starts and should not be done by the client code

stop

void hololink::emulation::PyI2CPeripheral::stop() override

stop the peripheral.

This will be called when the I2CController is stopped and should not be done by the client code

Peripheral should release all resources in case a subsequent start() is called.

attach_to_i2c

void hololink::emulation::PyI2CPeripheral::attach_to_i2c(
    I2CController &i2c_controller,
    uint8_t i2c_bus_address
) override

python:

def attach_to_i2c(self: hemu.I2CPeripheral, i2c_controller: hemu.I2CController, bus_address: int)

attach the peripheral to the I2C controller. This should be called by client code before start() is called

Parameters

i2c_controller
I2CController &

The I2C controller to attach to. Retrieved from HSBEmulator with get_i2c(controller_address)

bus_address
uint8_t

The bus address of the peripheral.

I2CPeripheral

hololink::emulation::I2CPeripheral::I2CPeripheral()