ra8_board_ek_ra8d2_touch.c

Go to the documentation of this file.

 
#include "ra8_board_ek_ra8d2_touch.h"
 
#include <stdint.h>
 
#include "ra8_board_ek_ra8d2.h"
#include "ra8_cgc.h"
#include "ra8_check.h"
#include "ra8_err.h"
#include "ra8_i2c_bus_ops.h"
#include "ra8_i3c.h"
#include "ra8_io_i2c_bus.h"
#include "ra8_io_i2c_bus_i3c_compat.h"
#include "ra8_touch.h"

static const char* const s_tag = "ra8_board.touch";

static ra8_io_i2c_bus_t s_touch_bus = {};
 
ra8_err_t ra8_board_touch_open(const ra8_board_touch_cfg_t* cfg)
{
  RA8_CHECK_NULL_PTR(cfg, s_tag, "cfg must not be nullptr");
  if (cfg->max_points > (uint8_t)k_ra8_touch_max_points) {
    return k_ra8_err_invalid_arg;
  }
 
  /* The bit-rate divider is solved against the LIVE PCLKA, not a constant.
   * Eight copies of this block fed it 60 MHz while the project's CGC tree
   * publishes 125 MHz, so none of them ran at the 400 kHz they asked for. */
  uint32_t        pclka_hz = 0U;
  const ra8_err_t clk_err  = ra8_cgc_get_clock_hz(k_ra8_clock_id_pclka, &pclka_hz);
  if (clk_err != k_ra8_ok) { /* GCOVR_EXCL_BR_LINE -- const channel/handle cannot fail post-bind */
    /* ra8_cgc_get_clock_hz with a valid clock-id and non-null out always
     * returns k_ra8_ok; kept so a future id change cannot pass silently. */
    return clk_err; /* GCOVR_EXCL_LINE -- const channel/handle cannot fail post-bind */
  }
 
  const ra8_i3c_cfg_t bus_cfg = {
    .mode     = k_ra8_i3c_mode_i2c,
    .bus_hz   = (uint32_t)k_ra8_board_touch_bus_hz,
    .pclka_hz = pclka_hz,
  };
  const ra8_err_t bus_err = ra8_i3c_init((uint8_t)k_ra8_board_touch_i3c_channel, &bus_cfg);
  if (bus_err != k_ra8_ok) {
    return bus_err;
  }
 
  const ra8_err_t bind_err =
    ra8_io_i2c_bus_bind_i3c_compat(&s_touch_bus, (uint8_t)k_ra8_board_touch_i3c_channel);
  if (bind_err != k_ra8_ok) { /* GCOVR_EXCL_BR_LINE -- const channel/handle cannot fail post-bind */
    /* Rejects only a null handle or an out-of-range channel, and both are
     * compile-time constants here. */
    return bind_err; /* GCOVR_EXCL_LINE -- const channel/handle cannot fail post-bind */
  }
 
  ra8_i2c_bus_ops_t bus_ops = {};
  const ra8_err_t   ops_err = ra8_io_i2c_bus_as_ops(&s_touch_bus, &bus_ops);
  if (ops_err != k_ra8_ok) { /* GCOVR_EXCL_BR_LINE -- const channel/handle cannot fail post-bind */
    /* Rejects only an unbound or null handle; the bind above just succeeded. */
    return ops_err; /* GCOVR_EXCL_LINE -- const channel/handle cannot fail post-bind */
  }
 
  const ra8_touch_cfg_t touch_cfg = {
    .bus        = bus_ops,
    .target_7b  = (uint8_t)k_ra8_board_touch_target_7b,
    .irq_pin    = cfg->irq_pin,
    .max_points = (cfg->max_points == 0U) ? (uint8_t)k_ra8_touch_max_points : cfg->max_points,
  };
  return ra8_touch_open(&touch_cfg);
}