ra8-firmware 0.1.0
Bare-metal firmware for the Renesas RA8 family (RA8D2 / RA8P1)
Loading...
Searching...
No Matches
ra8_bscan.h
Go to the documentation of this file.
1
74
75#pragma once
76
77#ifdef __cplusplus
78extern "C" {
79#endif
80
81#include <stdint.h>
82
83#include "ra8_bscan_regs.h"
84#include "ra8_err.h"
85
100
101/* =============================================================================
102 * Lifecycle
103 * =============================================================================
104 */
105
130[[nodiscard]] ra8_err_t ra8_bscan_init(void);
131
152[[nodiscard]] ra8_err_t ra8_bscan_deinit(void);
153
154/* =============================================================================
155 * Read-out API
156 * =============================================================================
157 */
158
185[[nodiscard]] ra8_err_t ra8_bscan_get_idcode(uint32_t* out);
186
213
242[[nodiscard]] ra8_err_t ra8_bscan_clear_status(uint32_t mask);
243
244/* =============================================================================
245 * Bookkeeping API
246 * =============================================================================
247 */
248
283
284#ifdef __cplusplus
285}
286#endif
ra8_err_t ra8_bscan_get_status(ra8_bscan_status_t *out)
Get a snapshot of the driver's TAP bookkeeping state.
Definition ra8_bscan.c:147
ra8_err_t ra8_bscan_clear_status(uint32_t mask)
Clear the recorded last-instruction state (no hardware effect).
Definition ra8_bscan.c:159
ra8_err_t ra8_bscan_deinit(void)
Tear down the bookkeeping object.
Definition ra8_bscan.c:122
ra8_err_t ra8_bscan_set_instruction(ra8_bscan_instr_t instr)
Record the JTIR opcode the external fixture is currently driving.
Definition ra8_bscan.c:174
ra8_err_t ra8_bscan_init(void)
Initialise the firmware-side TAP bookkeeping object.
Definition ra8_bscan.c:110
ra8_err_t ra8_bscan_get_idcode(uint32_t *out)
Get the chip's hardwired JTIDR device ID code.
Definition ra8_bscan.c:134
JTAG / IEEE-1149.1 Boundary Scan TAP constants for the RA8D2.
ra8_bscan_instr_t
JTIR Test Bit Set (TS[3:0]) command codes.
Error Code Definitions for ra8-firmware.
ra8_err_codes_t ra8_err_t
Canonical error-return type used by every ra8-firmware API.
Definition ra8_err.h:546
Snapshot of the firmware-side TAP bookkeeping object.
Definition ra8_bscan.h:95
uint32_t expected_idcode
JTIDR value the fixture should observe.
Definition ra8_bscan.h:98
ra8_bscan_instr_t last_instruction
Last JTIR opcode reported by the fixture.
Definition ra8_bscan.h:97
bool initialized
True once ra8_bscan_init ran.
Definition ra8_bscan.h:96