ra8_pcntr.h

Go to the documentation of this file.

 
#pragma once
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include <stdint.h>
 
#include "ra8_err.h"
#include "ra8_port_constants.h"
#include "ra8_port_regs.h"

[[nodiscard]] static inline ra8_err_t
ra8_pcntr_set_output(ra8_port_t port, ra8_pin_t pin, ra8_level_t level)
{
  if ((uint8_t)port > (uint8_t)k_ra8_port_max) {
    return k_ra8_err_gpio_invalid_port;
  }
  if ((uint8_t)pin > (uint8_t)k_ra8_pin_max) {
    return k_ra8_err_gpio_invalid_pin;
  }
 
  volatile r_port_regs_t* port_regs = ra8_port(port);
  if (port_regs == nullptr) {
    return k_ra8_err_hw_unmapped;
  }
 
  const uint32_t pdr_mask  = (uint32_t)(1UL << (uint32_t)pin);
  const uint32_t podr_mask = pdr_mask << (uint32_t)k_ra8_pcntr_high_half_shift;
 
  /* HUM Ch 20.2 "PCNTR1/PODR/PDR : Port Control Register 1" p 840 -- read {PODR, PDR}
   * so the sibling pins on this port are preserved across the update. */
  uint32_t pcntr1 = port_regs->PCNTR1;
  pcntr1 |= pdr_mask; /* PDR[pin] = 1 -> this pin is an output. */
  if (level == k_ra8_level_high) {
    pcntr1 |= podr_mask; /* PODR[pin] = 1 -> drive high. */
  } else {
    pcntr1 &= ~podr_mask; /* PODR[pin] = 0 -> drive low. */
  }
  /* HUM Ch 20.2 "PCNTR1/PODR/PDR : Port Control Register 1" p 840 -- write {PODR, PDR}:
   * commit the pin as an output at the requested level. */
  port_regs->PCNTR1 = pcntr1;
  return k_ra8_ok;
}

[[nodiscard]] static inline ra8_err_t
ra8_pcntr_read(ra8_port_t port, ra8_pin_t pin, ra8_level_t* out_level)
{
  if (out_level == nullptr) {
    return k_ra8_err_null_ptr;
  }
  if ((uint8_t)port > (uint8_t)k_ra8_port_max) {
    return k_ra8_err_gpio_invalid_port;
  }
  if ((uint8_t)pin > (uint8_t)k_ra8_pin_max) {
    return k_ra8_err_gpio_invalid_pin;
  }
 
  volatile r_port_regs_t* port_regs = ra8_port(port);
  if (port_regs == nullptr) {
    return k_ra8_err_hw_unmapped;
  }
 
  /* HUM Ch 20.2 "PCNTR2/EIDR/PIDR : Port Control Register 2" p 841 -- read PIDR: the live
   * pin state in the low half of the register. */
  const uint32_t pidr     = port_regs->PCNTR2;
  const uint32_t pin_mask = (uint32_t)(1UL << (uint32_t)pin);
  *out_level              = ((pidr & pin_mask) != 0U) ? k_ra8_level_high : k_ra8_level_low;
  return k_ra8_ok;
}
 
#ifdef __cplusplus
}
#endif