usb_selftest_dfu_steps.h

Go to the documentation of this file.

 
#pragma once
 
#include <stdint.h>
 
#include "ra8_err.h"

typedef enum : uint32_t {
  k_dfu_thread_stack    = 4096U,   
  k_dfu_host_stack      = 8192U,   
  k_dfu_usbx_pool_bytes = 32768U,  
  k_dfu_idle_ticks      = 50U,     
  k_dfu_boot_wait_ticks = 500U,    
  k_dfu_retry_ticks     = 3000U,   
  k_dfu_baud            = 115200U, 
  k_dfu_print_cap       = 160U,    
  k_dfu_dev_priority    = 8U,      
  k_dfu_host_priority   = 24U,     
} dfu_config_t;

typedef enum : uint8_t {
  k_dfu_hex_chars_u16   = 4U,  
  k_dfu_hex_chars_u32   = 8U,  
  k_dfu_dec_chars_u32   = 10U, 
  k_dfu_nibble_bits     = 4U,  
  k_dfu_hex_digit_split = 10U, 
} dfu_hex_t;

typedef enum : uint32_t {
  k_dfu_nibble_mask = 0xFU, 
  k_dfu_dec_radix   = 10U,  
} dfu_mask_t;

typedef enum : uint32_t {
  k_dfu_xfer_size   = 64U,         
  k_dfu_blocks      = 8U,          
  k_dfu_image_bytes = 512U,        
  k_dfu_no_mismatch = 0xFFFFFFFFU, 
  k_dfu_pat_blk_mul = 131U,        
  k_dfu_pat_idx_mul = 7U,          
  k_dfu_pat_bias    = 0xA5U,       
  k_dfu_byte_mask   = 0xFFU,       
  k_dfu_dev_addr    = 1U,          
  k_dfu_intf        = 0U,          
  k_dfu_config_val  = 1U,          
} dfu_geom_t;

typedef enum : uint32_t {
  k_dfu_phase_boot     = 0U, 
  k_dfu_phase_init     = 1U, 
  k_dfu_phase_enum     = 2U, 
  k_dfu_phase_download = 3U, 
  k_dfu_phase_upload   = 4U, 
  k_dfu_phase_pass     = 5U, 
} dfu_phase_t;

typedef enum : uint16_t {
  k_dfu_bm_std_dev_in     = 0x80U, 
  k_dfu_bm_std_dev_out    = 0x00U, 
  k_dfu_bm_class_if_out   = 0x21U, 
  k_dfu_bm_class_if_in    = 0xA1U, 
  k_dfu_breq_get_desc     = 0x06U, 
  k_dfu_breq_set_addr     = 0x05U, 
  k_dfu_breq_set_config   = 0x09U, 
  k_dfu_breq_dnload       = 0x01U, 
  k_dfu_breq_upload       = 0x02U, 
  k_dfu_breq_getstatus    = 0x03U, 
  k_dfu_breq_abort        = 0x06U, 
  k_dfu_desc_device       = 0x01U, 
  k_dfu_dev_desc_len      = 18U,   
  k_dfu_off_dev_pid       = 10U,   
  k_dfu_byte_bits         = 8U,    
  k_dfu_getstatus_len     = 6U,    
  k_dfu_off_status_state  = 4U,    
  k_dfu_state_dnload_idle = 5U,    
  k_dfu_state_idle        = 2U,    
} dfu_req_t;

typedef enum : uint32_t {
  k_dfu_vbus_settle_ms = 200U,      
  k_dfu_attach_to_ms   = 2000U,     
  k_dfu_debounce_ms    = 500U,      
  k_dfu_reset_hold_ms  = 50U,       
  k_dfu_recovery_ms    = 20U,       
  k_dfu_addr_settle_ms = 5U,        
  k_dfu_status_poll_ms = 2U,        
  k_dfu_status_tries   = 50U,       
  k_dfu_enum_tries     = 8U,        
  k_dfu_attach_spin    = 50000000U, 
} dfu_enum_tune_t;
 
#ifndef RA8_OFF_TARGET

[[nodiscard]] ra8_err_t dfu_host_pass(void);
 
#endif /* !RA8_OFF_TARGET */