USB self-loop: HS host WRITE(10)s + reads back the onboard OSPI flash. More...

#include <stdint.h>
#include <string.h>
#include "ra8_board_ek_ra8d2.h"
#include "ra8_boot_entry.h"
#include "ra8_cgc.h"
#include "ra8_err.h"
#include "ra8_gpio_constants.h"
#include "ra8_isr.h"
#include "ra8_port_constants.h"
#include "ra8_port_utils.h"
#include "ra8_time.h"
#include "ra8_usb.h"
#include "ra8_usb_hmsc.h"
#include "ra8_xspi.h"
#include "usb_selftest_ospi_rw_steps.h"
#include "tx_api.h"
#include "ux_api.h"
#include "ux_dcd_ra8_usb.h"
#include "ux_device_class_storage.h"
#include "ux_device_stack.h"

Include dependency graph for main.c:

Enumerations
enum	ospirw_dev_step_t : uint32_t { k_ospirw_dev_step_stack = 1U , k_ospirw_dev_step_class = 2U , k_ospirw_dev_step_dcd = 3U , k_ospirw_dev_step_attach = 4U , k_ospirw_dev_step_parked = 5U }
	J-Link probe values marking device-worker bring-up progress. More...
enum	scsi_sense_code_t : uint8_t { k_scsi_sense_illegal_request = 0x05U , k_scsi_asc_lba_out_of_range = 0x21U , k_scsi_ascq_none = 0x00U , k_scsi_sense_data_protect = 0x07U , k_scsi_asc_write_protected = 0x27U }
	SCSI sense triple for an unsupported / out-of-range request. More...
enum	usb_langid_byte_t : uint8_t { k_usb_langid_en_us_lo = 0x09U , k_usb_langid_en_us_hi = 0x04U }

Functions
void	_tx_timer_interrupt (void)
void	SysTick_Handler (void)
	Service the SysTick exception selected by the linked application.
static UINT	ospirw_msc_read (VOID storage, ULONG lun, UCHAR data_pointer, ULONG number_blocks, ULONG lba, ULONG *media_status)
	Storage media-read callback: read the OSPI flash window back.
static UINT	ospirw_msc_write (VOID storage, ULONG lun, UCHAR data_pointer, ULONG number_blocks, ULONG lba, ULONG *media_status)
	Storage media-write callback: program host data into OSPI flash.
static UINT	ospirw_msc_status (VOID storage, ULONG lun, ULONG media_id, ULONG media_status)
	Storage media-status callback.
static UINT	ospirw_usbx_stack_up (void)
	Bring USBX system + device stack up with the MSC framework.
static void	ospirw_fill_lun (UX_SLAVE_CLASS_STORAGE_PARAMETER *p, uint32_t idx)
	Populate the writable LUN parameter slot with geometry + callbacks.
static UINT	ospirw_class_register (void)
	Register the Mass-Storage class with one writable LUN.
static VOID	ospirw_device_worker (ULONG arg)
	Device-side worker: bring OSPI + the writable device up, then park.
VOID	tx_application_define (VOID *first_unused_memory)
	ThreadX application-define hook.
static void	ospirw_panic_halt (void)
	Halt forever in WFI – panic stop on init failure.
static void	ospirw_route_usb_or_halt (void)
	Route both ports' pins: FS as device, HS as host.
static void	ospirw_setup_or_halt (void)
	Bring CGC + both USB clocks + SysTick + SCI8 + LEDs + pins up.
void	main (void)
	Application entry: bring the board up, then hand off to ThreadX.

Variables
static volatile bool	s_tx_kernel_up = false
	Set in tx_application_define; gates ThreadX tick delivery.
static const ra8_port_pin_t	k_ospirw_pin_fs_vbus = (ra8_port_pin_t)k_ra8_board_usbfs_pin_vbus
	USBFS VBUS sense pin (P4_07, PSEL = 0x13).
static const ra8_port_pin_t	k_ospirw_pin_fs_vbusen = (ra8_port_pin_t)k_ra8_board_usbfs_pin_vbusen
	USBFS VBUSEN (P5_00) – GPIO LOW for the device role.
static const ra8_port_pin_t	k_ospirw_pin_fs_dp = (ra8_port_pin_t)k_ra8_board_usbfs_pin_dp
	USBFS D+ (P8_14).
static const ra8_port_pin_t	k_ospirw_pin_fs_dm = (ra8_port_pin_t)k_ra8_board_usbfs_pin_dm
	USBFS D- (P8_15).
static const ra8_port_pin_t	k_ospirw_pin_hs_vbus = (ra8_port_pin_t)k_ra8_board_usbhs_pin_vbus
	USBHS_VBUS sense pin (P4_08, PSEL = 0x14).
static const ra8_port_pin_t	k_ospirw_pin_hs_pwr = (ra8_port_pin_t)k_ra8_board_usbhs_pin_pwr
	J7 host-power switch (PD07): HIGH = U18 supplies VBUS (UM 6.2).
static TX_THREAD	s_device_thread
	ThreadX TCB for the USBX device-side worker thread.
static UCHAR	s_device_stack [k_ospirw_thread_stack]
	Stack backing storage for s_device_thread.
static TX_THREAD	s_host_thread
	ThreadX TCB for the host-side worker thread.
static UCHAR	s_host_stack [k_ospirw_host_stack]
	Stack backing storage for s_host_thread.
static UCHAR	s_usbx_pool [k_ospirw_usbx_pool_bytes]
	USBX memory pool (USBX uses tx_byte_pool internally).
static UCHAR	s_msc_vendor_id [] = "RA8D2 "
static UCHAR	s_msc_product_id [] = "WRITABLE OSPI RW"
static UCHAR	s_msc_product_rev [] = "0001"
static volatile uint32_t	s_dbg_read_calls
	Device-side media_read invocations.
static volatile uint32_t	s_dbg_write_calls
	Device-side media_write invocations (WRITE(10) data received).
static volatile uint32_t	s_dbg_write_blocks
	Total 512-B blocks the device media_write callback stored.
static volatile uint32_t	s_dbg_dev_step
	Device worker progress: 1 stack, 2 class, 3 dcd, 4 attach, 5 parked.
static volatile uint32_t	s_dbg_dev_err
	Device worker first failing return code (0 = none).
static UCHAR	s_device_framework_fs []
static UCHAR	s_string_framework []
	USBX string descriptor table (vendor / product / serial).
static UCHAR	s_language_id_framework [] = {k_usb_langid_en_us_lo, k_usb_langid_en_us_hi}
	USBX language-id table – US English.

Detailed Description

USB self-loop: HS host WRITE(10)s + reads back the onboard OSPI flash.

Tag: [Ring 6 / APP] {World: S}

The WRITABLE OSPI MSC self-loop – it exercises the host->device bulk-OUT data path (SCSI WRITE(10)) landing on real non-volatile storage. The two USB ports are cabled to EACH OTHER and one firmware image runs both USB stacks:

USBFS (J11) = DEVICE: a ThreadX + USBX Mass-Storage class that exposes one WRITABLE logical unit (GET_MAX_LUN = 0) backed by a 64-sector (32 KiB) window of the onboard OSPI flash (IS25LX512M at xSPI CS1, offset 0x00200000). media_write programs host data into the flash window; media_read serves it back. IRQ-driven through the port/usbx/ux_dcd_ra8_usb bridge.
USBHS (J7) = HOST: the first-party polled host MSC stack (ra8_usb_hmsc). It enumerates the device, WRITE(10)s a deterministic per-LBA pattern across the whole window, then READ(10)s it back and byte-checks every sector – proving the device bulk-OUT WRITE data phase round-trips intact onto flash, end to end on chip.

No filesystem is involved (raw SCSI WRITE(10)/READ(10)); this is the non-volatile write-path counterpart to the read-only MSC self-loops, and the on-bench validation for the device bulk-OUT WRITE(10) driver fix against persistent storage. The window (0x00200000) is a scratch region clear of flash_journal (offset 0) and the read-only OSPI image (offset 0x00100000); it is erased then rewritten every run.

The link runs at 12 Mbps (FS device ceiling; HS host serves an FS downstream device).

Verdicts stream over SCI8 (J-Link OB CDC console, 115200) and are mirrored in J-Link-readable probes (s_dbg_*).

Pinout

FS device: P4_07 VBUS sense, P5_00 VBUSEN GPIO LOW (device role), P8_14 D+, P8_15 D- (PSEL usb_fs). HS host: SW4-8 to Host via the U15 expander, PD07 HIGH (U18 supplies J7 VBUS), P4_08 USBHS_VBUS (PSEL usb_hs). Console: PD_02/PD_03 SCI8 (PSEL sci_async).

Author: Brighton Sikarskie

Date: 2026-06-13

Copyright: Copyright (c) 2026 Brighton Sikarskie SPDX-License-Identifier: MIT

Since: 0.1.0

Definition in file main.c.

Enumeration Type Documentation

◆ ospirw_dev_step_t

enum ospirw_dev_step_t : uint32_t

J-Link probe values marking device-worker bring-up progress.

Enumerator
k_ospirw_dev_step_stack	USBX system + device stack up.
k_ospirw_dev_step_class	MSC class registered.
k_ospirw_dev_step_dcd	DCD bridge initialized.
k_ospirw_dev_step_attach	Device attached (DPRPU).
k_ospirw_dev_step_parked	Bring-up done; worker parked.

Definition at line 140 of file main.c.

◆ scsi_sense_code_t

enum scsi_sense_code_t : uint8_t

SCSI sense triple for an unsupported / out-of-range request.

Enumerator
k_scsi_sense_illegal_request	Sense key: ILLEGAL REQUEST.
k_scsi_asc_lba_out_of_range	ASC: LBA out of range.
k_scsi_ascq_none	ASCQ: none.
k_scsi_sense_data_protect	Sense key: DATA PROTECT.
k_scsi_asc_write_protected	ASC: WRITE PROTECTED.

Definition at line 149 of file main.c.

◆ usb_langid_byte_t

enum usb_langid_byte_t : uint8_t

Enumerator
k_usb_langid_en_us_lo	LANGID 0x0409 low byte.
k_usb_langid_en_us_hi	LANGID 0x0409 high byte.

Definition at line 359 of file main.c.

Function Documentation

◆ _tx_timer_interrupt()

void _tx_timer_interrupt ( void )

extern

◆ main()

void main ( void )

Application entry: bring the board up, then hand off to ThreadX.

The application entry point Reset_Handler hands control to.

Both USB controllers' clocks and pins come up before the kernel so the workers only deal with stack bring-up.

Precondition: Reset_Handler copied .data and zeroed .bss.; SystemInit set VTOR, FPU, priority grouping.

Postcondition: On clean entry the CPU stays in tx_kernel_enter forever.; On any HAL init failure the function halts in WFI.

Note: Single entry point; not re-entrant.

Since: 0.1.0

Definition at line 871 of file main.c.

References ospirw_panic_halt(), ospirw_setup_or_halt(), and ra8_isr_globals_enable().

◆ ospirw_class_register()

UINT ospirw_class_register ( void )

static

Register the Mass-Storage class with one writable LUN.

Sets number_lun = 1 and fills the LUN slot via ospirw_fill_lun, so the host's GET_MAX_LUN returns 0. One is the single writable unit this self-loop exercises.

Returns: UINT UX_SUCCESS on success.

Return values

UX_SUCCESS Class registered.

Precondition: ospirw_usbx_stack_up has succeeded.; Media callbacks are defined.

Postcondition: MSC class bound to configuration 1, interface 0, with 1 LUN.; GET_MAX_LUN will report 0.

Note: Not re-entrant.

Since: 0.1.0

Definition at line 619 of file main.c.

References k_ospirw_count, memset(), ospirw_fill_lun(), s_msc_product_id, s_msc_product_rev, and s_msc_vendor_id.

Referenced by ospirw_device_worker().

◆ ospirw_device_worker()

VOID ospirw_device_worker ( ULONG arg )

static

Device-side worker: bring OSPI + the writable device up, then park.

Provisions the OSPI write window (ospirw_ospi_provision), then USBX system + device stack + writable MSC class + DCD bridge on the USBFS controller, then DPRPU attach. USBX runs the SCSI/BBB state machine on its own class threads after this.

Parameters

[in] arg ThreadX entry argument (unused).

Precondition: tx_application_define created this thread.; USB-FS pins + 48 MHz clock are up (main did both).

Postcondition: OSPI window erased, FS device attached + serviceable on its LUN.; On any bring-up failure the thread exits.

Note: Runs once; loops forever on success.

Since: 0.1.0

Definition at line 661 of file main.c.

References k_ospirw_dev_step_attach, k_ospirw_dev_step_class, k_ospirw_dev_step_dcd, k_ospirw_dev_step_parked, k_ospirw_dev_step_stack, k_ospirw_idle_ticks, k_ra8_ok, k_ra8_usb_speed_fs, ospirw_class_register(), ospirw_ospi_provision(), ospirw_usbx_stack_up(), ra8_usb_device_attach(), s_dbg_dev_err, s_dbg_dev_step, tx_thread_sleep, and ux_dcd_ra8_usb_initialize().

Referenced by tx_application_define().

◆ ospirw_fill_lun()

void ospirw_fill_lun	(	UX_SLAVE_CLASS_STORAGE_PARAMETER *	p,
		uint32_t	idx )

static

Populate the writable LUN parameter slot with geometry + callbacks.

The LUN is a writable FAT-disk-typed, removable, 64-sector OSPI-backed volume whose media callbacks program and read the OSPI flash window.

Parameters

[in,out]	p	The class parameter block.
[in]	idx	LUN slot index (0..1).

Precondition: p is zeroed and being filled before class register.; idx is below k_ospirw_count.

Postcondition: Slot idx carries the geometry + media callbacks.; No other slot is touched.

Note: Helper to keep the register function within the size cap.

Since: 0.1.0

Definition at line 582 of file main.c.

References k_ospirw_block_size, k_ospirw_sectors, ospirw_msc_read(), ospirw_msc_status(), and ospirw_msc_write().

Referenced by ospirw_class_register().

◆ ospirw_msc_read()

UINT ospirw_msc_read	(	VOID *	storage,
		ULONG	lun,
		UCHAR *	data_pointer,
		ULONG	number_blocks,
		ULONG	lba,
		ULONG *	media_status )

static

Storage media-read callback: read the OSPI flash window back.

Bound-checks the request against the LUN geometry, then reads number_blocks sectors from the OSPI window at k_ospirw_offset with ra8_xspi_flash_read into the USBX buffer. One callback serves the single LUN. LED1 toggles per call so loop traffic is visible.

Parameters

[in,out]	storage	USBX storage class instance (unused).
[in]	lun	Logical unit number (0..1).
[out]	data_pointer	USBX-owned destination buffer.
[in]	number_blocks	Number of 512-byte blocks to produce.
[in]	lba	Starting LBA.
[out]	media_status	Filled with sense status word.

Returns: UX_SUCCESS if the request fits the LUN; else UX_ERROR.

Return values

UX_SUCCESS	Read completed.
UX_ERROR	Out-of-range LBA / count.

Precondition: data_pointer / media_status are non-NULL (USBX guarantee).; lun is below k_ospirw_count.

Postcondition: Either the blocks were synthesized or media_status is non-zero.; s_dbg_read_calls advanced.

Note: Called from the USBX storage class thread.

Since: 0.1.0

Definition at line 402 of file main.c.

References k_ospirw_block_size, k_ospirw_instance, k_ospirw_offset, k_ospirw_sectors, k_ra8_board_led1, k_ra8_ok, k_scsi_asc_lba_out_of_range, k_scsi_ascq_none, k_scsi_sense_illegal_request, ra8_board_led_toggle(), ra8_xspi_flash_read(), and s_dbg_read_calls.

Referenced by ospirw_fill_lun().

◆ ospirw_msc_status()

UINT ospirw_msc_status	(	VOID *	storage,
		ULONG	lun,
		ULONG	media_id,
		ULONG *	media_status )

static

Storage media-status callback.

Always reports media-present.

Synthesized LUNs never go absent; status is constant 0.

Parameters

[in,out]	storage	USBX storage class instance (unused).
[in]	lun	Logical unit number (unused).
[in]	media_id	Media id (unused).
[out]	media_status	Filled with 0 (no fault).

Returns: Always UX_SUCCESS.

Return values

UX_SUCCESS Media is present and ready.

Precondition: media_status is non-NULL (USBX guarantee).; The class instance is live.

Postcondition: *media_status is 0.; No other state changes.

Note: Synthesized volumes; never report media-not-present.

Since: 0.1.0

Definition at line 519 of file main.c.

Referenced by ospirw_fill_lun().

◆ ospirw_msc_write()

UINT ospirw_msc_write	(	VOID *	storage,
		ULONG	lun,
		UCHAR *	data_pointer,
		ULONG	number_blocks,
		ULONG	lba,
		ULONG *	media_status )

static

Storage media-write callback: program host data into OSPI flash.

The LUN is writable; the host's WRITE(10) data-OUT phase lands here. Programs number_blocks sectors from the USBX buffer into the OSPI window at k_ospirw_offset with ra8_xspi_flash_program. The window is ERASED once at boot, so this is a fast program-only path (no per-write 4 KiB erase, which would exceed the host's BOT timeout). Bumps s_dbg_write_calls / s_dbg_write_blocks.

Parameters

[in,out]	storage	USBX storage class instance (unused).
[in]	lun	Logical unit number (unused; single LUN).
[in]	data_pointer	USBX-owned source buffer (received OUT data).
[in]	number_blocks	Number of 512-byte blocks the host wrote.
[in]	lba	Starting LBA.
[out]	media_status	Filled with the sense status word.

Returns: UX_SUCCESS if the request fits the window; else UX_ERROR.

Return values

UX_SUCCESS	Blocks programmed into the OSPI window.
UX_ERROR	Out-of-range LBA / count.

Precondition: data_pointer / media_status are non-NULL (USBX guarantee).; The OUT data phase delivered number_blocks * 512 bytes.

Postcondition: The OSPI window holds the written sectors; counters advanced.; *media_status is 0 on success.

Note: Called from the USBX storage class thread.

Since: 0.1.0

Definition at line 464 of file main.c.

References k_ospirw_block_size, k_ospirw_instance, k_ospirw_offset, k_ospirw_sectors, k_ra8_board_led2, k_ra8_ok, k_scsi_asc_lba_out_of_range, k_scsi_ascq_none, k_scsi_sense_illegal_request, ra8_board_led_toggle(), ra8_xspi_flash_program(), s_dbg_write_blocks, and s_dbg_write_calls.

Referenced by ospirw_fill_lun().

◆ ospirw_panic_halt()

void ospirw_panic_halt ( void )

static

Halt forever in WFI – panic stop on init failure.

Last-resort stop; only a debugger or reset recovers.

Precondition: Called only after a fatal boot error.; Interrupts may be in any state.

Postcondition: CPU is parked.; No further code runs.

Note: Not reachable post-boot.

Since: 0.1.0

Definition at line 763 of file main.c.

Referenced by main(), ospirw_route_usb_or_halt(), and ospirw_setup_or_halt().

◆ ospirw_route_usb_or_halt()

void ospirw_route_usb_or_halt ( void )

static

Route both ports' pins: FS as device, HS as host.

FS device: P4_07 VBUS sense, P5_00 VBUSEN GPIO LOW (else peripheral routing forces host VBUSEN and blocks device enum), P8_14/P8_15 data. HS host: SW4-8 to Host via the U15 expander, PD07 HIGH (U18 supplies J7), P4_08 VBUS sense.

Precondition: IOPORT and the U15 expander are reachable.; Called once from ospirw_setup_or_halt.

Postcondition: FS pins carry the device role, HS pins the host role.; PD07 is HIGH (J7 powered).

Note: Panic-halts on any routing failure.

Since: 0.1.0

Definition at line 786 of file main.c.

References k_ospirw_pin_fs_dm, k_ospirw_pin_fs_dp, k_ospirw_pin_fs_vbus, k_ospirw_pin_fs_vbusen, k_ospirw_pin_hs_pwr, k_ospirw_pin_hs_vbus, k_ra8_level_high, k_ra8_level_low, k_ra8_ok, k_ra8_psel_usb_fs, k_ra8_psel_usb_hs, ospirw_panic_halt(), ra8_board_io_expander_set_usbhs_host_mode(), ra8_gpio_output_init(), and ra8_pfs_route_peripheral().

Referenced by ospirw_setup_or_halt().

◆ ospirw_setup_or_halt()

void ospirw_setup_or_halt ( void )

static

Bring CGC + both USB clocks + SysTick + SCI8 + LEDs + pins up.

USBFS needs the 48 MHz PLL2 reference; USBHS needs its UTMI PLL. SCI8 is the J-Link OB CDC console at 115200.

Precondition: Reset_Handler finished C runtime init.; SystemInit has run.

Postcondition: Console works; both USB ports' pins and clocks are live.; LED1/LED2 are initialized.

Note: Panic-halts on any failure; called once from main.

Since: 0.1.0

Definition at line 827 of file main.c.

References k_ospirw_baud, k_ra8_board_led1, k_ra8_board_led2, k_ra8_clock_id_cpuclk0, k_ra8_ok, ospirw_panic_halt(), ospirw_route_usb_or_halt(), ra8_board_led_init(), ra8_board_uart_console_init(), ra8_cgc_get_clock_hz(), ra8_cgc_init(), ra8_cgc_usbfs_clock_enable(), ra8_cgc_usbhs_pll_enable(), and ra8_time_init().

Referenced by main().

◆ ospirw_usbx_stack_up()

UINT ospirw_usbx_stack_up ( void )

static

Bring USBX system + device stack up with the MSC framework.

One-shot USBX pool + device-stack init (FS-only framework).

Returns: UINT UX_SUCCESS on success.

Return values

UX_SUCCESS Stack ready.

Precondition: File-scope pool reserved.; Thread context.

Postcondition: Device stack accepts class registrations.; On failure USBX state is undefined.

Note: Single-call; not idempotent.

Since: 0.1.0

Definition at line 548 of file main.c.

References k_ospirw_usbx_pool_bytes, s_device_framework_fs, s_language_id_framework, s_string_framework, and s_usbx_pool.

Referenced by ospirw_device_worker().

◆ SysTick_Handler()

void SysTick_Handler ( void )

Service the SysTick exception selected by the linked application.

Service one SysTick event for the core timebase.

Resolves to the weak core timebase handler unless a strong RTOS or application handler overrides it. The vector table references the selected implementation without owning its subsystem policy.

Precondition: Entered for a SysTick exception with a valid exception frame.; The selected handler's timebase or scheduler state is initialised.

Postcondition: The selected implementation has processed one SysTick event.; The vector table itself remains unchanged.

Note: Runs in handler mode; thread-safety follows the selected implementation.

Since: 0.1.0

The weak firmware implementation advances the millisecond counter, then services linked ThreadX and USB hooks when their weak symbols and readiness state permit. The host-test implementation advances only the counter. An application may replace either weak definition with a strong handler.

Precondition: The handler is entered for one SysTick event or a host-test equivalent.; On target, ra8_time_init() configured the SysTick period.

Postcondition: s_tick_ms has advanced by exactly one.; Optional subsystem hooks run only when linked and ready.

Note: IRQ-safe; the weak symbol may be overridden by an application handler.

Since: 0.1.0

Service the SysTick exception selected by the linked application.

The weak firmware implementation advances the millisecond counter, then services linked ThreadX and USB hooks when their weak symbols and readiness state permit. The host-test implementation advances only the counter. An application may replace either weak definition with a strong handler.

Precondition: The handler is entered for one SysTick event or a host-test equivalent.; On target, ra8_time_init() configured the SysTick period.

Postcondition: s_tick_ms has advanced by exactly one.; Optional subsystem hooks run only when linked and ready.

Note: IRQ-safe; the weak symbol may be overridden by an application handler.

Since: 0.1.0

Service the SysTick exception selected by the linked application.

Precondition: Called from exception context (IPSR == 15).; _tx_initialize_low_level has programmed SysTick.

Postcondition: One ThreadX tick elapsed; PendSV may be pending.

Definition at line 95 of file main.c.

References _tx_timer_interrupt(), ra8_time_on_tick(), s_tx_kernel_up, and ux_dcd_ra8_usb_irq_reenable().

◆ tx_application_define()

VOID tx_application_define ( VOID * first_unused_memory )

ThreadX application-define hook.

Spawns both workers.

Device worker at priority 8, host worker at 24 (below the USBX class threads). Sets s_tx_kernel_up so SysTick may feed ThreadX from here on.

Parameters

[in] first_unused_memory Sentinel (unused; static stacks).

Precondition: Called from tx_kernel_enter after scheduler init.; Static stacks are reserved at file scope.

Postcondition: Two auto-start worker threads are queued.; s_tx_kernel_up is true.

Note: Called once at boot; not thread-safe.

Since: 0.1.0

Definition at line 716 of file main.c.

References k_ospirw_dev_priority, k_ospirw_host_priority, k_ospirw_host_stack, k_ospirw_thread_stack, ospirw_device_worker(), ospirw_host_worker(), s_device_stack, s_device_thread, s_device_thread_name, s_host_stack, s_host_thread, s_host_thread_name, s_tx_kernel_up, TX_AUTO_START, TX_NO_TIME_SLICE, and tx_thread_create.

Variable Documentation

◆ k_ospirw_pin_fs_dm

const ra8_port_pin_t k_ospirw_pin_fs_dm = (ra8_port_pin_t)k_ra8_board_usbfs_pin_dm

static

USBFS D- (P8_15).

Definition at line 119 of file main.c.

Referenced by ospirw_route_usb_or_halt().

◆ k_ospirw_pin_fs_dp

const ra8_port_pin_t k_ospirw_pin_fs_dp = (ra8_port_pin_t)k_ra8_board_usbfs_pin_dp

static

USBFS D+ (P8_14).

Definition at line 116 of file main.c.

Referenced by ospirw_route_usb_or_halt().

◆ k_ospirw_pin_fs_vbus

const ra8_port_pin_t k_ospirw_pin_fs_vbus = (ra8_port_pin_t)k_ra8_board_usbfs_pin_vbus

static

USBFS VBUS sense pin (P4_07, PSEL = 0x13).

Definition at line 110 of file main.c.

Referenced by ospirw_route_usb_or_halt().

◆ k_ospirw_pin_fs_vbusen

const ra8_port_pin_t k_ospirw_pin_fs_vbusen = (ra8_port_pin_t)k_ra8_board_usbfs_pin_vbusen

static

USBFS VBUSEN (P5_00) – GPIO LOW for the device role.

Definition at line 113 of file main.c.

Referenced by ospirw_route_usb_or_halt().

◆ k_ospirw_pin_hs_pwr

const ra8_port_pin_t k_ospirw_pin_hs_pwr = (ra8_port_pin_t)k_ra8_board_usbhs_pin_pwr

static

J7 host-power switch (PD07): HIGH = U18 supplies VBUS (UM 6.2).

Definition at line 125 of file main.c.

Referenced by ospirw_route_usb_or_halt().

◆ k_ospirw_pin_hs_vbus

const ra8_port_pin_t k_ospirw_pin_hs_vbus = (ra8_port_pin_t)k_ra8_board_usbhs_pin_vbus

static

USBHS_VBUS sense pin (P4_08, PSEL = 0x14).

Definition at line 122 of file main.c.

Referenced by ospirw_route_usb_or_halt().

◆ s_dbg_dev_err

volatile uint32_t s_dbg_dev_err

static

Device worker first failing return code (0 = none).

Definition at line 222 of file main.c.

◆ s_dbg_dev_step

volatile uint32_t s_dbg_dev_step

static

Device worker progress: 1 stack, 2 class, 3 dcd, 4 attach, 5 parked.

Definition at line 220 of file main.c.

◆ s_dbg_read_calls

volatile uint32_t s_dbg_read_calls

static

Device-side media_read invocations.

Definition at line 214 of file main.c.

◆ s_dbg_write_blocks

volatile uint32_t s_dbg_write_blocks

static

Total 512-B blocks the device media_write callback stored.

Definition at line 218 of file main.c.

◆ s_dbg_write_calls

volatile uint32_t s_dbg_write_calls

static

Device-side media_write invocations (WRITE(10) data received).

Definition at line 216 of file main.c.

◆ s_device_framework_fs

UCHAR s_device_framework_fs[]

static

Definition at line 235 of file main.c.

◆ s_device_stack

UCHAR s_device_stack[k_ospirw_thread_stack]

static

Stack backing storage for s_device_thread.

Since: 0.1.0

Definition at line 176 of file main.c.

◆ s_device_thread

TX_THREAD s_device_thread

static

ThreadX TCB for the USBX device-side worker thread.

Note: Single-writer (worker only).

Since: 0.1.0

Definition at line 169 of file main.c.

◆ s_host_stack

UCHAR s_host_stack[k_ospirw_host_stack]

static

Stack backing storage for s_host_thread.

Since: 0.1.0

Definition at line 191 of file main.c.

◆ s_host_thread

TX_THREAD s_host_thread

static

ThreadX TCB for the host-side worker thread.

Note: Single-writer (worker only).

Since: 0.1.0

Definition at line 184 of file main.c.

◆ s_language_id_framework

UCHAR s_language_id_framework[] = {k_usb_langid_en_us_lo, k_usb_langid_en_us_hi}

static

USBX language-id table – US English.

Since: 0.1.0

Definition at line 369 of file main.c.

◆ s_msc_product_id

UCHAR s_msc_product_id[] = "WRITABLE OSPI RW"

static

Definition at line 202 of file main.c.

◆ s_msc_product_rev

UCHAR s_msc_product_rev[] = "0001"

static

Definition at line 203 of file main.c.

◆ s_msc_vendor_id

UCHAR s_msc_vendor_id[] = "RA8D2 "

static

Definition at line 201 of file main.c.

◆ s_string_framework

UCHAR s_string_framework[]

static

USBX string descriptor table (vendor / product / serial).

Each entry: 2 bytes lang-id, 1 byte string index, 1 byte length, then ASCII bytes.

Since: 0.1.0

Definition at line 300 of file main.c.

◆ s_tx_kernel_up

volatile bool s_tx_kernel_up = false

static

Set in tx_application_define; gates ThreadX tick delivery.

main() starts SysTick before tx_kernel_enter and the setup window is long (U15 expander I2C blocks for ms), so the tick fires pre-kernel; feeding _tx_timer_interrupt into ThreadX's zeroed timer state bus-faults. Gate it until the kernel runs.

Since: 0.1.0

Definition at line 92 of file main.c.

◆ s_usbx_pool

UCHAR s_usbx_pool[k_ospirw_usbx_pool_bytes]

static

USBX memory pool (USBX uses tx_byte_pool internally).

Since: 0.1.0

Definition at line 198 of file main.c.

Enumerations

Functions

Variables

Detailed Description

Pinout

Enumeration Type Documentation

◆ ospirw_dev_step_t

◆ scsi_sense_code_t

◆ usb_langid_byte_t

Function Documentation

◆ _tx_timer_interrupt()

◆ main()

◆ ospirw_class_register()

◆ ospirw_device_worker()

◆ ospirw_fill_lun()

◆ ospirw_msc_read()

◆ ospirw_msc_status()

◆ ospirw_msc_write()

◆ ospirw_panic_halt()

◆ ospirw_route_usb_or_halt()

◆ ospirw_setup_or_halt()

◆ ospirw_usbx_stack_up()

◆ SysTick_Handler()

◆ tx_application_define()

Variable Documentation

◆ k_ospirw_pin_fs_dm

◆ k_ospirw_pin_fs_dp

◆ k_ospirw_pin_fs_vbus

◆ k_ospirw_pin_fs_vbusen

◆ k_ospirw_pin_hs_pwr

◆ k_ospirw_pin_hs_vbus

◆ s_dbg_dev_err

◆ s_dbg_dev_step

◆ s_dbg_read_calls

◆ s_dbg_write_blocks

◆ s_dbg_write_calls

◆ s_device_framework_fs

◆ s_device_stack

◆ s_device_thread

◆ s_host_stack

◆ s_host_thread

◆ s_language_id_framework

◆ s_msc_product_id

◆ s_msc_product_rev

◆ s_msc_vendor_id

◆ s_string_framework

◆ s_tx_kernel_up

◆ s_usbx_pool