usb_host_file_ops_steps.h

Go to the documentation of this file.

 
#pragma once
 
#include <stdint.h>
 
#include "ra8_err.h"
#include "ra8_fs.h"
#include "ra8_usb.h"
#include "ra8_usb_hmsc.h"
 
/* =============================================================================
 * Compile-time configuration (shared between main.c and the steps TU)
 * =============================================================================
 */

typedef enum : uint32_t {
  k_fileops_baud       = 115200U, 
  k_fileops_idle_ms    = 50U,     
  k_fileops_retry_ms   = 5000U,   
  k_fileops_target_lun = 0U,      
  k_fileops_print_cap  = 160U,    
} usb_fileops_config_t;

typedef enum : uint16_t {
  k_fileops_sector_bytes = 512U, 
  k_fileops_name_cap     = 64U,  
} usb_fileops_size_t;

typedef enum : uint8_t {
  k_fileops_hex_chars_u16   = 4U,  
  k_fileops_hex_chars_u32   = 8U,  
  k_fileops_dec_chars_u64   = 20U, 
  k_fileops_nibble_bits     = 4U,  
  k_fileops_hex_digit_split = 10U, 
} usb_fileops_hex_t;

typedef enum : uint32_t {
  k_fileops_nibble_mask = 0xFU, 
  k_fileops_dec_radix   = 10U,  
} usb_fileops_mask_t;

typedef enum : uint32_t {
  k_fileops_probe_tbl_off  = 432U, 
  k_fileops_probe_tbl_len  = 80U,  
  k_fileops_probe_head_len = 64U,  
  k_fileops_probe_row      = 16U,  
  k_fileops_probe_lba_max  = 3U,   
} usb_fileops_probe_t;
 
/* =============================================================================
 * Console helpers
 * =============================================================================
 */

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

[[nodiscard]] ra8_err_t fileops_print_dec(uint64_t value);

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

[[nodiscard]] ra8_err_t fileops_print_fail(const char* what, ra8_err_t err);
 
/* =============================================================================
 * Mount + suite + probe
 * =============================================================================
 */

[[nodiscard]] ra8_err_t fileops_mount_volume(ra8_fs_mount_t** out_mount);

[[nodiscard]] ra8_err_t fileops_suite_create(ra8_fs_mount_t* mount);

[[nodiscard]] ra8_err_t fileops_suite_mutate(ra8_fs_mount_t* mount);

void fileops_probe_layout(void);