#include "conf_access.h"
#include "usb_drv.h"
#include "host_mem.h"
#include "scsi_decoder.h"
#include "usb_host_task.h"
#include "host_mass_storage_task.h"

Functions
uint8_t	host_get_lun (void)
	This function returns the number of LUNs of the connected mass-storage device. More...

Ctrl_status	host_ms_inquiry (void)
	This function sends an SCSI INQUIRY command (0x12) to the device. More...

uint8_t	host_ms_request_sense (void)
	This function sends an SCSI REQUEST SENSE command (0x03) to the device. More...

static void	host_ms_stall_management (uint8_t pipe)
	This function manages pipe STALLs. More...

Ctrl_status	host_read_10_extram (uint32_t addr, void *ram, uint8_t nb_sector)
	This function transfers 1 data sector from memory to RAM sector = 512 bytes. More...

Ctrl_status	host_read_10_ram (uint32_t addr, void *ram)
	This function transfers 1 data sector from memory to RAM sector = 512 bytes. More...

static Ctrl_status	host_read_10_ram_stop (void)
	This function terminates the transfer of a physical sector from memory to RAM. More...

Ctrl_status	host_read_capacity (uint8_t lun, uint32_t *u32_nb_sector)
	This function returns the address of the last valid sector in the lun. More...

uint8_t	host_read_sector_size (uint8_t lun)
	This function returns the physical sector size of the lun. More...

bool	host_removal (void)
	This function informs about the memory type. More...

Ctrl_status	host_test_unit_ready (uint8_t lun)
	This function tests memory state, and starts memory initialization. More...

bool	host_wr_protect (uint8_t lun)
	This function returns the write-protected mode Only used by memory removal with a HARDWARE-SPECIFIC write-protected detection. More...

Ctrl_status	host_write_10_extram (uint32_t addr, const void *ram, uint8_t nb_sector)
	This function transfers 1 data sector from RAM to memory sector = 512 bytes. More...

Ctrl_status	host_write_10_ram (uint32_t addr, const void *ram)
	This function transfers 1 data sector from RAM to memory sector = 512 bytes. More...

Variables
static uint8_t	buf_cmd [31]

uint8_t	g_b_read_run = false

uint8_t	g_pipe_ms_in

uint8_t	g_pipe_ms_out

uint16_t	g_u16_read_sector

uint32_t	g_u32_read_addr

uint8_t	g_u8_sector_size

uint8_t	host_selected_lun

uint8_t host_get_lun ( void )

This function returns the number of LUNs of the connected mass-storage device.

Returns: uint8_t: Number of logical units of the device

References data_stage, host_ms_get_max_lun, and Is_host_ms_configured.

Referenced by host_mass_storage_task().

Ctrl_status host_ms_inquiry ( void )

This function sends an SCSI INQUIRY command (0x12) to the device.

Returns: Ctrl_status It is ready -> CTRL_GOOD Memory unplug -> CTRL_NO_PRESENT Not initialized or changed -> CTRL_BUSY An error occurred -> CTRL_FAIL

References buf_cmd, COMMAND_PASSED, CTRL_FAIL, CTRL_GOOD, g_b_read_run, g_pipe_ms_in, g_pipe_ms_out, host_get_data(), host_read_10_ram_stop(), host_selected_lun, host_send_data(), Is_host_ms_configured, PIPE_GOOD, SBC_CMD_DIR_IN, SBC_CMD_INQUIRY, and status.

Referenced by host_mass_storage_task().

uint8_t host_ms_request_sense ( void )

This function sends an SCSI REQUEST SENSE command (0x03) to the device.

Returns: uint8_t: Sense Key

References buf_cmd, COMMAND_PASSED, CTRL_BUSY, CTRL_FAIL, CTRL_GOOD, CTRL_NO_PRESENT, g_b_read_run, g_pipe_ms_in, g_pipe_ms_out, host_get_data(), host_ms_stall_management(), host_read_10_ram_stop(), host_selected_lun, host_send_data(), Is_host_ms_configured, PIPE_GOOD, PIPE_STALL, SBC_ASC_MEDIUM_NOT_PRESENT, SBC_ASC_NOT_READY_TO_READY_CHANGE, SBC_CMD_DIR_IN, SBC_CMD_REQUEST_SENSE, SBC_SENSE_KEY_DATA_PROTECT, SBC_SENSE_KEY_HARDWARE_ERROR, SBC_SENSE_KEY_MEDIUM_ERROR, SBC_SENSE_KEY_NO_SENSE, SBC_SENSE_KEY_NOT_READY, SBC_SENSE_KEY_UNIT_ATTENTION, and status.

Referenced by host_mass_storage_task(), host_ms_stall_management(), and host_test_unit_ready().

static void host_ms_stall_management ( uint8_t pipe )

static

This function manages pipe STALLs.

Parameters

pipe	Pipe for the CLEAR ENDPOINT FEATURE request

References buf_cmd, g_pipe_ms_in, Host_ack_stall, host_clear_endpoint_feature, host_get_data(), Host_get_pipe_endpoint_number, host_ms_request_sense(), Host_reset_data_toggle, and MSK_EP_DIR.

Referenced by host_ms_request_sense(), host_read_10_extram(), host_read_10_ram(), host_read_10_ram_stop(), host_read_capacity(), host_test_unit_ready(), host_wr_protect(), and host_write_10_extram().

Ctrl_status host_read_10_extram	(	uint32_t	addr,
		void *	ram,
		uint8_t	nb_sector
	)

This function transfers 1 data sector from memory to RAM sector = 512 bytes.

Parameters

addr	Sector address to start read
ram	Address of RAM buffer
nb_sector	number of sector

Returns: Ctrl_status It is ready -> CTRL_GOOD Memory unplug -> CTRL_NO_PRESENT Not initialized or changed -> CTRL_BUSY An error occurred -> CTRL_FAIL

References buf_cmd, COMMAND_PASSED, CTRL_FAIL, CTRL_GOOD, g_b_read_run, g_pipe_ms_in, g_pipe_ms_out, g_u32_read_addr, g_u8_sector_size, host_get_data(), host_ms_stall_management(), host_read_10_ram(), host_read_10_ram_stop(), HOST_SECTOR_SIZE, host_selected_lun, host_send_data(), Is_host_ms_configured, LSB0W, LSB1W, LSB2W, LSB3W, MSB0W, MSB1W, MSB2W, MSB3W, PIPE_STALL, SBC_CMD_DIR_IN, SBC_CMD_READ_10, and status.

Referenced by ushell_cmd_perform_extaccess().

Ctrl_status host_read_10_ram	(	uint32_t	addr,
		void *	ram
	)

This function transfers 1 data sector from memory to RAM sector = 512 bytes.

Parameters

addr	Sector address to start read
ram	Address of RAM buffer

Returns: Ctrl_status It is ready -> CTRL_GOOD Memory unplug -> CTRL_NO_PRESENT Not initialized or changed -> CTRL_BUSY An error occurred -> CTRL_FAIL

References buf_cmd, CTRL_FAIL, CTRL_GOOD, g_b_read_run, g_pipe_ms_in, g_pipe_ms_out, g_u16_read_sector, g_u32_read_addr, g_u8_sector_size, host_get_data(), host_ms_stall_management(), host_read_10_ram_stop(), host_read_capacity(), HOST_SECTOR_SIZE, host_selected_lun, host_send_data(), Is_host_ms_configured, LSB0W, LSB1W, LSB2W, LSB3W, MSB0W, MSB1W, MSB2W, MSB3W, NULL, PIPE_STALL, SBC_CMD_DIR_IN, SBC_CMD_READ_10, and status.

Referenced by host_read_10_extram().

Ctrl_status host_read_10_ram_stop ( void )

static

This function terminates the transfer of a physical sector from memory to RAM.

Returns: Ctrl_status It is ready -> CTRL_GOOD Memory unplug -> CTRL_NO_PRESENT Not initialized or changed -> CTRL_BUSY An error occurred -> CTRL_FAIL

References buf_cmd, COMMAND_PASSED, CTRL_FAIL, CTRL_GOOD, g_b_read_run, g_pipe_ms_in, g_u16_read_sector, host_get_data(), host_ms_stall_management(), HOST_SECTOR_SIZE, NULL, and PIPE_STALL.

Referenced by host_ms_inquiry(), host_ms_request_sense(), host_read_10_extram(), host_read_10_ram(), host_read_capacity(), host_test_unit_ready(), host_wr_protect(), and host_write_10_extram().

Ctrl_status host_read_capacity	(	uint8_t	lun,
		uint32_t *	u32_nb_sector
	)

This function returns the address of the last valid sector in the lun.

Parameters

lun	Logical Unit Number
u32_nb_sector	Pointer to number of sectors (sector = 512 bytes)

Returns: Ctrl_status It is ready -> CTRL_GOOD Memory unplug -> CTRL_NO_PRESENT Not initialized or changed -> CTRL_BUSY An error occurred -> CTRL_FAIL

References buf_cmd, COMMAND_PASSED, CTRL_FAIL, CTRL_GOOD, g_b_read_run, g_pipe_ms_in, g_pipe_ms_out, g_u8_sector_size, host_get_data(), host_ms_stall_management(), host_read_10_ram_stop(), host_selected_lun, host_send_data(), Host_set_device_ready, Is_host_ms_configured, PIPE_GOOD, PIPE_STALL, SBC_CMD_DIR_IN, SBC_CMD_READ_CAPACITY_10, sbc_format_scsi_to_mcu_data, and status.

Referenced by host_mass_storage_task(), and host_read_10_ram().

uint8_t host_read_sector_size ( uint8_t lun )

This function returns the physical sector size of the lun.

Parameters

lun	Logical Unit Number

Returns: uint8_t: Number of 512-byte blocks per sector

References g_u8_sector_size.

bool host_removal ( void )

This function informs about the memory type.

Returns: true if the memory is removable

References Is_host_ms_configured.

Ctrl_status host_test_unit_ready ( uint8_t lun )

This function tests memory state, and starts memory initialization.

Parameters

lun	Logical Unit Number

Returns: Ctrl_status It is ready -> CTRL_GOOD Memory unplug -> CTRL_NO_PRESENT Not initialized or changed -> CTRL_BUSY An error occurred -> CTRL_FAIL

References buf_cmd, COMMAND_PASSED, CTRL_BUSY, CTRL_FAIL, CTRL_GOOD, g_b_read_run, g_pipe_ms_in, g_pipe_ms_out, host_get_data(), host_ms_request_sense(), host_ms_stall_management(), host_read_10_ram_stop(), host_selected_lun, host_send_data(), Host_set_device_ready, Is_host_ms_configured, PIPE_GOOD, PIPE_STALL, SBC_CMD_DIR_OUT, SBC_CMD_TEST_UNIT_READY, and status.

Referenced by host_mass_storage_task().

bool host_wr_protect ( uint8_t lun )

This function returns the write-protected mode Only used by memory removal with a HARDWARE-SPECIFIC write-protected detection.

Warning: The customer must unplug the memory to change this write-protected mode.

Parameters

lun	Logical Unit Number

Returns: true if the memory is protected

References buf_cmd, COMMAND_PASSED, CTRL_FAIL, CTRL_GOOD, g_b_read_run, g_pipe_ms_in, g_pipe_ms_out, g_u8_sector_size, host_get_data(), host_ms_stall_management(), host_read_10_ram_stop(), host_selected_lun, host_send_data(), Is_host_ms_configured, PIPE_GOOD, PIPE_STALL, SBC_CMD_DIR_IN, SBC_CMD_MODE_SENSE_6, and status.

Ctrl_status host_write_10_extram	(	uint32_t	addr,
		const void *	ram,
		uint8_t	nb_sector
	)

This function transfers 1 data sector from RAM to memory sector = 512 bytes.

Parameters

addr	Sector address to start write
ram	Address of RAM buffer
nb_sector	Number of sector

Returns: Ctrl_status It is ready -> CTRL_GOOD Memory unplug -> CTRL_NO_PRESENT Not initialized or changed -> CTRL_BUSY An error occurred -> CTRL_FAIL

References buf_cmd, COMMAND_PASSED, CTRL_FAIL, CTRL_GOOD, g_b_read_run, g_pipe_ms_in, g_pipe_ms_out, g_u8_sector_size, host_get_data(), host_ms_stall_management(), host_read_10_ram_stop(), HOST_SECTOR_SIZE, host_selected_lun, host_send_data(), Is_host_ms_configured, LSB0W, LSB1W, LSB2W, LSB3W, MSB0W, MSB1W, MSB2W, MSB3W, PIPE_STALL, SBC_CMD_DIR_OUT, SBC_CMD_WRITE_10, and status.

Referenced by host_write_10_ram(), and ushell_cmd_perform_extaccess().

Ctrl_status host_write_10_ram	(	uint32_t	addr,
		const void *	ram
	)

This function transfers 1 data sector from RAM to memory sector = 512 bytes.

Parameters

addr	Sector address to start write
ram	Address of RAM buffer

Returns: Ctrl_status It is ready -> CTRL_GOOD Memory unplug -> CTRL_NO_PRESENT Not initialized or changed -> CTRL_BUSY An error occurred -> CTRL_FAIL

References host_write_10_extram().

uint8_t buf_cmd[31]

static

Referenced by host_ms_inquiry(), host_ms_request_sense(), host_ms_stall_management(), host_read_10_extram(), host_read_10_ram(), host_read_10_ram_stop(), host_read_capacity(), host_test_unit_ready(), host_wr_protect(), and host_write_10_extram().