ra8_io_spi_bus.c

Go to the documentation of this file.

 
#include "ra8_io_spi_bus.h"
 
#include <stdint.h>
 
#include "ra8_attributes.h"
#include "ra8_check.h"
#include "ra8_err.h"
#include "ra8_io_spi_bus_internal.h"
#include "ra8_spi.h"
#include "ra8_spi_bus_ops.h"

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

RA8_INTERNAL
static ra8_err_t internal_validate(const ra8_io_spi_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_spi_bus_xfer8(const ra8_io_spi_bus_t* bus, uint8_t tx, uint8_t* rx)
{
  const ra8_err_t v = internal_validate(bus);
  if (v != k_ra8_ok) {
    return v;
  }
  RA8_CHECK_NULL_PTR(bus->iface->xfer8, s_tag, "backend xfer8 op missing");
  return bus->iface->xfer8(bus->ctx, tx, rx);
}
 
ra8_err_t ra8_io_spi_bus_write_read(const ra8_io_spi_bus_t* bus,
                                    const void*             tx,
                                    void*                   rx,
                                    uint32_t                len,
                                    ra8_spi_bit_width_t     width)
{
  const ra8_err_t v = internal_validate(bus);
  if (v != k_ra8_ok) {
    return v;
  }
  RA8_CHECK_NULL_PTR(bus->iface->write_read, s_tag, "backend write_read op missing");
  return bus->iface->write_read(bus->ctx, tx, rx, len, width);
}
 
ra8_err_t ra8_io_spi_bus_set_clock(const ra8_io_spi_bus_t* bus, uint32_t baud_hz, uint32_t pclk_hz)
{
  const ra8_err_t v = internal_validate(bus);
  if (v != k_ra8_ok) {
    return v;
  }
  RA8_CHECK_NULL_PTR(bus->iface->set_clock, s_tag, "backend set_clock op missing");
  return bus->iface->set_clock(bus->ctx, baud_hz, pclk_hz);
}
 
/* =============================================================================
 * ra8_spi_bus_ops_t bridge (Ring-3 seam)
 * =============================================================================
 */

RA8_INTERNAL
static ra8_err_t internal_ops_xfer8(void* ctx, uint8_t tx, uint8_t* rx)
{
  RA8_CHECK_NULL_PTR(ctx, s_tag, "ctx (spi bus) must not be nullptr");
  return ra8_io_spi_bus_xfer8((const ra8_io_spi_bus_t*)ctx, tx, rx);
}
 
ra8_err_t ra8_io_spi_bus_as_ops(const ra8_io_spi_bus_t* bus, ra8_spi_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->xfer8 = internal_ops_xfer8;
  out->ctx   = (void*)(uintptr_t)bus;
  return k_ra8_ok;
}