usb_selftest_wlun_steps.h

Go to the documentation of this file.

 
#pragma once
 
#include <stdint.h>
 
#include "ra8_err.h"
#include "ra8_usb_hmsc.h"
 
#ifndef RA8_OFF_TARGET
#include "ux_api.h"
#endif
 
/* -------------------------------------------------------------------------- */
/* Tunables */
/* -------------------------------------------------------------------------- */

typedef enum : uint32_t {
  k_wlun_thread_stack    = 4096U,   
  k_wlun_host_stack      = 8192U,   
  k_wlun_usbx_pool_bytes = 32768U,  
  k_wlun_idle_ticks      = 50U,     
  k_wlun_boot_wait_ticks = 500U,    
  k_wlun_retry_ticks     = 3000U,   
  k_wlun_baud            = 115200U, 
  k_wlun_print_cap       = 160U,    
  k_wlun_dev_priority    = 8U,      
  k_wlun_host_priority   = 24U,     
} wlun_config_t;

typedef enum : uint8_t {
  k_wlun_hex_chars_u16   = 4U,  
  k_wlun_hex_chars_u32   = 8U,  
  k_wlun_dec_chars_u32   = 10U, 
  k_wlun_nibble_bits     = 4U,  
  k_wlun_hex_digit_split = 10U, 
} wlun_hex_t;

typedef enum : uint32_t {
  k_wlun_nibble_mask = 0xFU, 
  k_wlun_dec_radix   = 10U,  
} wlun_mask_t;

typedef enum : uint32_t {
  k_wlun_count              = 1U,          
  k_wlun_sectors            = 64U,         
  k_wlun_block_size         = 512U,        
  k_wlun_burst_blocks       = 8U,          
  k_wlun_burst_bytes        = 4096U,       
  k_wlun_target_lun0        = 0U,          
  k_wlun_no_mismatch        = 0xFFFFFFFFU, 
  k_wlun_pat_lun_mul        = 97U,         
  k_wlun_pat_lba_mul        = 7U,          
  k_wlun_pat_bias           = 0x5AU,       
  k_wlun_byte_mask          = 0xFFU,       
  k_wlun_mismatch_lun_shift = 24U,         
} wlun_geom_t;

typedef enum : uint32_t {
  k_wlun_phase_boot   = 0U, 
  k_wlun_phase_init   = 1U, 
  k_wlun_phase_enum   = 2U, 
  k_wlun_phase_verify = 3U, 
  k_wlun_phase_pass   = 4U, 
} wlun_phase_t;
 
#ifndef RA8_OFF_TARGET
 
/* -------------------------------------------------------------------------- */
/* Shared per-(LUN,LBA) pattern */
/* -------------------------------------------------------------------------- */

void wlun_pattern_fill(uint32_t lun, uint32_t lba, UCHAR* out);
 
/* -------------------------------------------------------------------------- */
/* Console helpers (SCI8 -> J-Link OB CDC) */
/* -------------------------------------------------------------------------- */

uint8_t wlun_nibble_to_hex(uint32_t nibble);

uint32_t wlun_str_len(const char* text);

[[nodiscard]] ra8_err_t wlun_sci_write(const uint8_t* data, uint32_t len);

[[nodiscard]] ra8_err_t wlun_print(const char* text);

[[nodiscard]] ra8_err_t wlun_print_dec(uint32_t value);

[[nodiscard]] ra8_err_t wlun_print_hex(uint32_t value, uint8_t digits);

[[nodiscard]] ra8_err_t wlun_print_fail(const char* what, ra8_err_t err);
 
/* -------------------------------------------------------------------------- */
/* Host side: ra8_usb_hmsc enumerate + WRITE(10) then read-verify */
/* -------------------------------------------------------------------------- */

VOID wlun_host_worker(ULONG arg);
 
#endif /* !RA8_OFF_TARGET */