forked from jappel/VersaMCU
Add UF2 bootloader for USB firmware flashing
Vendored and trimmed from microsoft/uf2-samdx1, adapted to the actual ATSAMD21G17D (128 KiB flash / 16 KiB RAM), fixing the flash/RAM-size mismatch that the previously commented-out SAM-BA bootloader target had (it assumed a 256 KiB SAMD21G18A). Builds as a standalone PlatformIO environment (bootloader/platformio.ini), no python2/make dependency. Compiles clean, fits in the 8 KiB bootloader region (7292/8192 bytes). Not yet flashed/verified on real hardware.
This commit is contained in:
cjjohn
parent
ce5db617a1
commit
de52b57041
143 changed files with 69119 additions and 0 deletions
165
bootloader/lib/usb_msc/sbc_protocol.h
Normal file
165
bootloader/lib/usb_msc/sbc_protocol.h
Normal file
|
|
@ -0,0 +1,165 @@
|
|||
/**
|
||||
* \file
|
||||
*
|
||||
* \brief SCSI Block Commands
|
||||
*
|
||||
* This file contains definitions of some of the commands found in the
|
||||
* SCSI SBC-2 standard.
|
||||
*
|
||||
* Note that the SBC specification depends on several commands defined
|
||||
* by the SCSI Primary Commands (SPC) standard. Each version of the SBC
|
||||
* standard is meant to be used in conjunction with a specific version
|
||||
* of the SPC standard, as follows:
|
||||
* - SBC depends on SPC
|
||||
* - SBC-2 depends on SPC-3
|
||||
* - SBC-3 depends on SPC-4
|
||||
*
|
||||
* Copyright (c) 2016 Atmel Corporation. All rights reserved.
|
||||
*
|
||||
* \asf_license_start
|
||||
*
|
||||
* \page License
|
||||
*
|
||||
* Redistribution and use in source and binary forms, with or without
|
||||
* modification, are permitted provided that the following conditions are met:
|
||||
*
|
||||
* 1. Redistributions of source code must retain the above copyright notice,
|
||||
* this list of conditions and the following disclaimer.
|
||||
*
|
||||
* 2. Redistributions in binary form must reproduce the above copyright notice,
|
||||
* this list of conditions and the following disclaimer in the documentation
|
||||
* and/or other materials provided with the distribution.
|
||||
*
|
||||
* 3. The name of Atmel may not be used to endorse or promote products derived
|
||||
* from this software without specific prior written permission.
|
||||
*
|
||||
* 4. This software may only be redistributed and used in connection with an
|
||||
* Atmel microcontroller product.
|
||||
*
|
||||
* THIS SOFTWARE IS PROVIDED BY ATMEL "AS IS" AND ANY EXPRESS OR IMPLIED
|
||||
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
|
||||
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT ARE
|
||||
* EXPRESSLY AND SPECIFICALLY DISCLAIMED. IN NO EVENT SHALL ATMEL BE LIABLE FOR
|
||||
* ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||||
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
||||
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
||||
* STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||||
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
||||
* POSSIBILITY OF SUCH DAMAGE.
|
||||
*
|
||||
* \asf_license_stop
|
||||
*
|
||||
*/
|
||||
#ifndef _SBC_PROTOCOL_H_
|
||||
#define _SBC_PROTOCOL_H_
|
||||
|
||||
#include "lib/usb_msc/usb_includes.h"
|
||||
|
||||
/**
|
||||
* \ingroup usb_msc_protocol
|
||||
* \defgroup usb_sbc_protocol SCSI Block Commands protocol definitions
|
||||
*
|
||||
* @{
|
||||
*/
|
||||
|
||||
/** \name SCSI commands defined by SBC-2 */
|
||||
#define SBC_FORMAT_UNIT 0x04
|
||||
#define SBC_READ6 0x08
|
||||
#define SBC_WRITE6 0x0A
|
||||
#define SBC_START_STOP_UNIT 0x1B
|
||||
#define SBC_READ_CAPACITY10 0x25
|
||||
#define SBC_READ10 0x28
|
||||
#define SBC_WRITE10 0x2A
|
||||
#define SBC_VERIFY10 0x2F
|
||||
|
||||
/** \name SBC-2 Mode page definitions */
|
||||
enum scsi_sbc_mode {
|
||||
SCSI_MS_MODE_RW_ERR_RECOV = 0x01, /**< Read-Write Error Recovery mode page */
|
||||
SCSI_MS_MODE_FORMAT_DEVICE = 0x03, /**< Format Device mode page */
|
||||
SCSI_MS_MODE_FLEXIBLE_DISK = 0x05, /**< Flexible Disk mode page */
|
||||
SCSI_MS_MODE_CACHING = 0x08
|
||||
};
|
||||
|
||||
/** \name SBC-2 Device-Specific Parameter */
|
||||
#define SCSI_MS_SBC_WP 0x80 /**< Write Protected */
|
||||
#define SCSI_MS_SBC_DPOFUA 0x10 /**< DPO and FUA supported */
|
||||
|
||||
/**
|
||||
* \brief SBC-2 Short LBA mode parameter block descriptor
|
||||
* \note Fields are MSB first (BE)
|
||||
*/
|
||||
struct sbc_slba_block_desc {
|
||||
be32_t nr_blocks; /**< Number of Blocks (BE32) */
|
||||
be32_t block_len; /**< Block Length (BE32) */
|
||||
#define SBC_SLBA_BLOCK_LEN_MASK 0x00FFFFFFU /**< Mask reserved bits */
|
||||
};
|
||||
|
||||
/**
|
||||
* \brief SBC-2 Caching mode page
|
||||
* \note Fields are MSB first (BE)
|
||||
*/
|
||||
struct sbc_caching_mode_page {
|
||||
uint8_t page_code;
|
||||
uint8_t page_length;
|
||||
uint8_t flags2;
|
||||
#define SBC_MP_CACHE_IC (1 << 7) /**< Initiator Control */
|
||||
#define SBC_MP_CACHE_ABPF (1 << 6) /**< Abort Pre-Fetch */
|
||||
#define SBC_MP_CACHE_CAP (1 << 5) /**< Catching Analysis Permitted */
|
||||
#define SBC_MP_CACHE_DISC (1 << 4) /**< Discontinuity */
|
||||
#define SBC_MP_CACHE_SIZE (1 << 3) /**< Size enable */
|
||||
#define SBC_MP_CACHE_WCE (1 << 2) /**< Write back Cache Enable */
|
||||
#define SBC_MP_CACHE_MF (1 << 1) /**< Multiplication Factor */
|
||||
#define SBC_MP_CACHE_RCD (1 << 0) /**< Read Cache Disable */
|
||||
uint8_t retention;
|
||||
be16_t dis_pf_transfer_len;
|
||||
be16_t min_prefetch;
|
||||
be16_t max_prefetch;
|
||||
be16_t max_prefetch_ceil;
|
||||
uint8_t flags12;
|
||||
#define SBC_MP_CACHE_FSW (1 << 7) /**< Force Sequential Write */
|
||||
#define SBC_MP_CACHE_LBCSS (1 << 6) /**< Logical Blk Cache Seg Sz */
|
||||
#define SBC_MP_CACHE_DRA (1 << 5) /**< Disable Read-Ahead */
|
||||
#define SBC_MP_CACHE_NV_DIS (1 << 0) /**< Non-Volatile Cache Disable */
|
||||
uint8_t nr_cache_segments;
|
||||
be16_t cache_segment_size;
|
||||
uint8_t reserved[4];
|
||||
};
|
||||
|
||||
/**
|
||||
* \brief SBC-2 Read-Write Error Recovery mode page
|
||||
* \note Fields are MSB first (BE)
|
||||
*/
|
||||
struct sbc_rdwr_error_recovery_mode_page {
|
||||
uint8_t page_code;
|
||||
uint8_t page_length;
|
||||
#define SPC_MP_RW_ERR_RECOV_PAGE_LENGTH 0x0A
|
||||
uint8_t flags1;
|
||||
#define SBC_MP_RW_ERR_RECOV_AWRE (1 << 7)
|
||||
#define SBC_MP_RW_ERR_RECOV_ARRE (1 << 6)
|
||||
#define SBC_MP_RW_ERR_RECOV_TB (1 << 5)
|
||||
#define SBC_MP_RW_ERR_RECOV_RC (1 << 4)
|
||||
#define SBC_MP_RW_ERR_RECOV_ERR (1 << 3)
|
||||
#define SBC_MP_RW_ERR_RECOV_PER (1 << 2)
|
||||
#define SBC_MP_RW_ERR_RECOV_DTE (1 << 1)
|
||||
#define SBC_MP_RW_ERR_RECOV_DCR (1 << 0)
|
||||
uint8_t read_retry_count;
|
||||
uint8_t correction_span;
|
||||
uint8_t head_offset_count;
|
||||
uint8_t data_strobe_offset_count;
|
||||
uint8_t flags2;
|
||||
uint8_t write_retry_count;
|
||||
uint8_t flags3;
|
||||
be16_t recovery_time_limit;
|
||||
};
|
||||
|
||||
/**
|
||||
* \brief SBC-2 READ CAPACITY (10) parameter data (8 bytes)
|
||||
* \note Fields are MSB first (BE)
|
||||
*/
|
||||
struct sbc_read_capacity10_data {
|
||||
be32_t max_lba; /**< LBA of last logical block (BE32) */
|
||||
be32_t block_len; /**< Number of bytes in the last logical block (BE32) */
|
||||
};
|
||||
|
||||
#endif /*_SBC_PROTOCOL_H_*/
|
||||
Loading…
Add table
Add a link
Reference in a new issue