ra8_io_i2c_bus.c

Go to the documentation of this file.

 
#include "ra8_io_i2c_bus.h"
 
#include <stdint.h>
 
#include "ra8_attributes.h"
#include "ra8_check.h"
#include "ra8_err.h"
#include "ra8_i2c_bus_ops.h"
#include "ra8_io_i2c_bus_internal.h"

static const char* const s_tag = "ra8_io_i2c_bus";
 
/* =============================================================================
 * Internal helpers
 * =============================================================================
 */

RA8_INTERNAL
static ra8_err_t internal_validate(const ra8_io_i2c_bus_t* bus)
{
  if (bus == nullptr) {
    return k_ra8_err_null_ptr;
  }
  if (bus->iface == nullptr) {
    return k_ra8_err_not_initialized;
  }
  return k_ra8_ok;
}
 
/* =============================================================================
 * Public API -- dispatch through the bound backend
 * =============================================================================
 */
 
ra8_err_t ra8_io_i2c_bus_write(const ra8_io_i2c_bus_t* bus,
                               uint8_t                 addr,
                               const uint8_t*          data,
                               uint32_t                len,
                               bool                    send_stop)
{
  const ra8_err_t v = internal_validate(bus);
  if (v != k_ra8_ok) {
    return v;
  }
  RA8_CHECK_NULL_PTR(bus->iface->write, s_tag, "backend write op missing");
  return bus->iface->write(bus->ctx, addr, data, len, send_stop);
}
 
ra8_err_t
ra8_io_i2c_bus_read(const ra8_io_i2c_bus_t* bus, uint8_t addr, uint8_t* data, uint32_t len)
{
  const ra8_err_t v = internal_validate(bus);
  if (v != k_ra8_ok) {
    return v;
  }
  RA8_CHECK_NULL_PTR(bus->iface->read, s_tag, "backend read op missing");
  return bus->iface->read(bus->ctx, addr, data, len);
}
 
ra8_err_t ra8_io_i2c_bus_transfer(const ra8_io_i2c_bus_t* bus,
                                  uint8_t                 addr,
                                  const uint8_t*          wr,
                                  uint32_t                wr_len,
                                  uint8_t*                rd,
                                  uint32_t                rd_len)
{
  const ra8_err_t v = internal_validate(bus);
  if (v != k_ra8_ok) {
    return v;
  }
  RA8_CHECK_NULL_PTR(bus->iface->transfer, s_tag, "backend transfer op missing");
  return bus->iface->transfer(bus->ctx, addr, wr, wr_len, rd, rd_len);
}
 
/* =============================================================================
 * ra8_i2c_bus_ops_t bridge (Ring-3 seam)
 * =============================================================================
 */

RA8_INTERNAL
static ra8_err_t
internal_ops_write(void* ctx, uint8_t addr, const uint8_t* data, uint32_t len, bool send_stop)
{
  RA8_CHECK_NULL_PTR(ctx, s_tag, "ctx (i2c bus) must not be nullptr");
  return ra8_io_i2c_bus_write((const ra8_io_i2c_bus_t*)ctx, addr, data, len, send_stop);
}

RA8_INTERNAL
static ra8_err_t internal_ops_read(void* ctx, uint8_t addr, uint8_t* data, uint32_t len)
{
  RA8_CHECK_NULL_PTR(ctx, s_tag, "ctx (i2c bus) must not be nullptr");
  return ra8_io_i2c_bus_read((const ra8_io_i2c_bus_t*)ctx, addr, data, len);
}

RA8_INTERNAL
static ra8_err_t internal_ops_transfer(void*          ctx,
                                       uint8_t        addr,
                                       const uint8_t* wr,
                                       uint32_t       wr_len,
                                       uint8_t*       rd,
                                       uint32_t       rd_len)
{
  RA8_CHECK_NULL_PTR(ctx, s_tag, "ctx (i2c bus) must not be nullptr");
  return ra8_io_i2c_bus_transfer((const ra8_io_i2c_bus_t*)ctx, addr, wr, wr_len, rd, rd_len);
}
 
ra8_err_t ra8_io_i2c_bus_as_ops(const ra8_io_i2c_bus_t* bus, ra8_i2c_bus_ops_t* out)
{
  const ra8_err_t v = internal_validate(bus);
  if (v != k_ra8_ok) {
    return v;
  }
  RA8_CHECK_NULL_PTR(out, s_tag, "out must not be nullptr");
  out->write    = internal_ops_write;
  out->read     = internal_ops_read;
  out->transfer = internal_ops_transfer;
  out->ctx      = (void*)(uintptr_t)bus;
  return k_ra8_ok;
}