AN1189. Implementing a Mass Storage Device Using the Microchip USB Device Firmware Framework INTRODUCTION BACKGROUND ON THE MASS STORAGE DEVICE CLASS



Similar documents
AN1142. USB Mass Storage Class on an Embedded Host INTRODUCTION. USB Mass Storage Class. Overview

TB3016. Using the PIC MCU CTMU for Temperature Measurement IMPLEMENTATION BASIC PRINCIPLE MEASUREMENT CIRCUIT

AN1286. Water-Resistant Capacitive Sensing INTRODUCTION THEORY OF OPERATION. Sensing Steps. Sensing Steps Description DESIGN

AN1303. Software Real-Time Clock and Calendar Using PIC16F1827 DATA INTERFACE INTRODUCTION IMPLEMENTATION INTERNAL REGISTER MAP

AN Wire Communication with PIC Microcontroller INTRODUCTION. OVERVIEW OF THE 1-Wire BUS. 1-Wire Protocol. Prerequisites

Installing and Licensing MPLAB XC C Compilers

Recommended Usage of Microchip 23X256/23X640 SPI Serial SRAM Devices RECOMMENDED CONNECTIONS FOR 23X256,23X640 SERIES DEVICES VCC 23X256/ HOLD.

AN687. Precision Temperature-Sensing With RTD Circuits RTD OVERVIEW INTRODUCTION EQUATION 1:

AN1325. mtouch Metal Over Cap Technology THEORY OF OPERATION INTRODUCTION CROSS SECTION OF METAL OVER CAPACITIVE (UNPRESSED)

AN1156. Battery Fuel Measurement Using Delta-Sigma ADC Devices INTRODUCTION REVIEW OF BATTERY CHARGING AND DISCHARGING CHARACTERISTICS

Uninstalling Incorrect USB Device Drivers

Universal Programming Module 2

TC1047/TC1047A. Precision Temperature-to-Voltage Converter. General Description. Applications. Block Diagram. Features.

AN1857. RGBW Color Mixing DALI Control Gear. COLOR MIXING USING RED, GREEN, BLUE AND WHITE LEDs INTRODUCTION HARDWARE

AN1212. Using USB Keyboard with an Embedded Host INTRODUCTION. USB Keyboard Overview. USB Keyboard with an Embedded Host USB KEYBOARD OUTPUT REPORT

AN1265. KEELOQ with AES Microcontroller-Based Code Hopping Encoder INTRODUCTION DUAL ENCODER OPERATION BACKGROUND FUNCTIONAL INPUTS AND

AN1470. Manchester Decoder Using the CLC and NCO ABSTRACT INTRODUCTION MANCHESTER ENCODED DATA (AS PER G.E. THOMAS)

AN1275. KEELOQ with Advanced Encryption Standard (AES) Receiver/Decoder KEY FEATURES OVERVIEW. Microchip Technology Inc.

Timers: Timer0 Tutorial (Part 1)

Designing A Li-Ion Battery Charger and Load Sharing System With Microchip s Stand-Alone Li-Ion Battery Charge Management Controller

AN956. Migrating Applications to USB from RS-232 UART with Minimal Impact on PC Software OVERVIEW INTRODUCTION. Microchip Technology Inc.

Features, Value and Benefits of Digital Control for Power Supplies

AN1543. Using MRF24W with PIC32 Internal Program Flash Memory For EZ_CONFIG_STORE ALTERNATIVE LOW-COST SOLUTIONS OVERVIEW SCOPE

AN1332. Current Sensing Circuit Concepts and Fundamentals CURRENT SENSING RESISTOR INTRODUCTION. Description. Microchip Technology Inc.

AN1492. Microchip Capacitive Proximity Design Guide INTRODUCTION CAPACITIVE SENSING BASICS SENSING

AN1066. Microchip MiWi Wireless Networking Protocol Stack INTRODUCTION CONSIDERATIONS TERMINOLOGY FEATURES

AN905. Brushed DC Motor Fundamentals INTRODUCTION PRINCIPLES OF OPERATION. Stator. Rotor SIMPLE TWO-POLE BRUSHED DC MOTOR. Microchip Technology Inc.

PIC32 Microcontroller Families

MCP73X23 Lithium Iron Phosphate (LiFePO 4 ) Battery Charger Evaluation Board User s Guide

AN1256. Microchip s Power MOSFET Driver Simulation Models INTRODUCTION MODEL DESCRIPTION. Using The Power MOSFET Simulation Models

TC7660. Charge Pump DC-to-DC Voltage Converter. Package Types. Features. General Description. Applications. Functional Block Diagram TC7660

WORKSHOP-IN-A-BOX 2: LOW POWER SOLUTIONS DEMONSTRATION BOARD

MCP2515 CAN Bus Monitor Demo Board User s Guide

TCP/IP Networking: Web-Based Status Monitoring

Section 15. Input Capture

MCP2200 USB to RS-232 Demo Board User s Guide

AN1353. Op Amp Rectifiers, Peak Detectors and Clamps INTRODUCTION BASIC RECTIFIERS. Choosing the Components. Positive Half-Wave Rectifier.

dspic30f3012/3013 dspic30f3012/3013 Rev. B0 Silicon Errata dspic30f3012/3013 (Rev. B0) Silicon Errata Silicon Errata Summary

MCP1701A. 2 µa Low-Dropout Positive Voltage Regulator. Features. General Description. Applications. Package Types

Integrated Development Environment

AN1465. Digitally Addressable Lighting Interface (DALI) Communication TERMINOLOGY PHYSICAL LAYER DALI FREE-FORM LAYOUT. Topology FIGURE 1:

Integrated Development Environment

AN1140. USB Embedded Host Stack INTRODUCTION USB OVERVIEW. Host vs. Embedded Host. USB Hosts and Peripheral Devices

Resistive Temperature Detector (RTD) Reference Design

Section 5. Flash Programming

28-PIN DEMO BOARD USER S GUIDE

LIN Serial Analyzer User s Guide Rev2.0

MPLAB XC8 GETTING STARTED GUIDE. MPLAB XC8 Getting Started Guide

MPLAB Code Configurator User s Guide

How To Use Microchip.Com

TABLE 1: BUCK REGULATOR

MCP73811/2. Simple, Miniature Single-Cell, Fully Integrated Li-Ion / Li-Polymer Charge Management Controllers. Description. Features.

Touch Through Metal. mtouch Metal Over Capacitive Technology Part 1

AN1861. Bluetooth Smart Communication Using Microchip RN4020 Module and 16-bit PIC Microcontroller BLUETOOTH SMART COMMUNICATION INTRODUCTION

AN645. PIC16C57 Based Code Hopping Security System PINOUT OVERVIEW FEATURES BLOCK DIAGRAM RECOMMENDED READING

PIC10F200/202/204/206

ZENA Wireless Network Analyzer User s Guide

PIC18F26K20/46K20 Rev. B2/B3/B5/B6 Silicon Errata and Data Sheet Clarification

PICkit 3 Programmer/Debugger User s Guide

AN232. Low-Frequency Magnetic Transmitter Design ABOUT THIS APPLICATION NOTE INTRODUCTION LFMC LINK COMPONENTS

Serial EEPROM Powered for Automotive

AN1095. Emulating Data EEPROM for PIC18 and PIC24 Microcontrollers and dspic Digital Signal Controllers INTRODUCTION THEORY OF OPERATION

AN1307 FULL STEP MODE PHASE VOLTAGE AND PHASE CURRENT MICROSTEPPING WITH 1/4 STEP SIZE

Peripheral Brief: Programmable Switch Mode Controller (PSMC) 1, 2, 4, 8 PSMCXTMR CLR PSMCXPR = Period. Event PSMCXPRS. Rising.

AN709. System Level Design Considerations When Using I 2 C TM Serial EEPROM Devices INTRODUCTION INSURING BUS-FREE DURING POWER-UP

PICkit 2 Microcontroller Programmer USER S GUIDE

ZENA Wireless Network Analyzer User s Guide

AN1370. Smart Card Communication Using PIC MCUs INTRODUCTION SMART CARD COMMUNICATION USING PC APPLICATION

AVR287: USB Host HID and Mass Storage Demonstration. 8-bit Microcontrollers. Application Note. Features. 1 Introduction

Real-Time Data Monitor User s Guide

TB055. PS/2 to USB Mouse Translator IMPLEMENTATION OVERVIEW. Hardware FIGURE 1: PS/2 TO USB MOUSE TRANSLATOR HARDWARE DIAGRAM (1)

TCM809/TCM Pin Microcontroller Reset Monitors. General Description. Features. Applications. Pin Configurations. Typical Application Circuit

Bootloader for dspic30f/33f and PIC24F/24H Devices

AN990. Analog Sensor Conditioning Circuits An Overview INTRODUCTION SENSOR APPLICATIONS. Target Audience. Goals. Description.

TC4423A/TC4424A/TC4425A

AN1387. Using PIC32 MCUs to Develop Low-Cost Controllerless (LCC) Graphics Solutions INTRODUCTION. Basic Graphics Definitions

TB056. Demonstrating the Set_Report Request With a PS/2 to USB Keyboard Translator Example INTRODUCTION. The Set_Report Request.

AN1426. Design Tips for the MCP3911 INTRODUCTION. Addressable Devices on Single SPI Bus. Addressable SPI for Poly-phase Meter Designs.

MCP3004/ V 4-Channel/8-Channel 10-Bit A/D Converters with SPI Serial Interface. Features. Description. Applications.

AN1163. USB HID Class on an Embedded Device FEATURES INTRODUCTION LIMITATIONS ASSUMPTIONS SYSTEM HARDWARE. Microchip Technology Inc.

AN884. Driving Capacitive Loads With Op Amps INTRODUCTION LINEAR RESPONSE. Simplified Op Amp AC Model. Overview. Purpose OP AMP MODEL EQUATION 1:

MCP3204/ V 4-Channel/8-Channel 12-Bit A/D Converters with SPI Serial Interface. Features. Description. Applications.

dspic Digital Signal Controllers

MPLAB ICD 3 In-Circuit Debugger User s Guide For MPLAB X IDE

AN3354 Application note

AN1305. Sensorless 3-Phase Brushless Motor Control with the PIC16FXXX TYPICAL MOTOR CONNECTION OVERVIEW DRIVE AND CONTROL CIRCUITRY

TC4421/TC4422. Functional Block Diagram. TC4421 Inverting. TC4422 Non-Inverting V DD. 300 mv Output. Input 4.7V. GND Effective. Input.

MCP3021. Low Power 10-Bit A/D Converter With I 2 C Interface. Description. Features. Applications. Functional Block Diagram.

AN1106. Power Factor Correction in Power Conversion Applications Using the dspic DSC INTRODUCTION

MCRF khz Passive RFID Device with Sensor Input. Not recommended for new designs. Package Type. Features. Description. Applications PDIP/SOIC

Introduction to the dspic DSC SMPS (Part 1)

PICkit TM 2 Microcontroller Programmer USER S GUIDE

AN1164. USB CDC Class on an Embedded Device INTRODUCTION ASSUMPTIONS FEATURES LIMITATIONS

PICmicro DC Motor Control Tips n Tricks

How To Improve Electromagnetic Compatibility

AN688. Layout Tips for 12-Bit A/D Converter Application GETTING A GOOD START INTRODUCTION. Microchip Technology Inc. / 2 MCP602

Determining USB Peripheral Device Class

Analog-to-Digital Converters

Transcription:

Implementing a Mass Storage Device Using the Microchip USB Device Firmware Framework Author: INTRODUCTION David Flowers Microchip Technology Inc. USB devices are now part a daily life for many people throughout the world. Removable USB hard drives, USB memory sticks ( thumb drives ), multi-card readers and many digital cameras appear as a new disk drive when they are plugged into the USB port of a computer. These devices all use the Mass Storage Device (MSD) class to communicate with the computer. This application note will cover how to modify the Microchip USB Device Firmware Framework to create a Mass Storage Device. It is assumed that the user already has some working knowledge of the USB protocol. BACKGROUND ON THE MASS STORAGE DEVICE CLASS Disk drive manufacturers have been creating compatible disks for over two decades now. The Small Computer System Interface (SCSI) protocol was developed during this time, allowing drive manufacturers and system developers to share a common protocol for device control and communication. SCSI provides the means for reading, writing and checking the status of the drives, as well as other available commands. The USB Implementers Forum (USB-IF) re-used the existing SCSI protocols to create a new physical interface for mass storage applications. The USB Mass Storage Device class is the result of that effort. The MSD class specification uses the already existing protocols and provides a wrapper around them in order to transport them over the USB. For external hard drives or thumb drives, this is the SCSI protocol. By using the same protocols as other drives, this enables MSD devices to appear on the host as a new disk drive. The MSD protocol has two types of command packets: the Command Block Wrapper (CBW) at the beginning of a data transaction, and the Command Status Wrapper (CSW) at the conclusion. If data is exchanged between a host and device, it occurs between these after the Command Block Wrapper and before the Command Status Wrapper. The CBW is transmitted on the USB as the first packet of a new transaction. It defines what command is being transmitted, what the length is, which logical device is being talked to and a tag to help tie the command to a status stage. After the CBW is received by the device, there may or may not be a data transmission phase. This depends on what the command was and if it required a data stage. For example, if the command was a SCSI READ(10) command, then the device should read and return the requested addresses during the data transmission phase. After all of the data has been sent, the USB host closes out the entire transaction by sending a CSW packet. This packet has a tag that matches the corresponding CBW. The CSW also contains a residue field that informs the host about any requested data that may have not been sent during that transaction. Finally, there are status bits that are sent back to indicate if there were any errors while performing the requested function. More information about each field of the CBW and CSW packets is available in the MSD specification, available at the USB-IF web site (www.usb.org). MASS STORAGE DEVICE FIRMWARE The Microchip USB Device Firmware Framework provides an MSD class driver that can be used to easily create MSD devices. Several example projects are provided as a reference starting point. Please refer to the help file provided in the USB Device Firmware Framework distribution for more details about these example projects. The following section provides details in how to take the base USB Device Firmware Framework and create a working MSD example with the provided class driver. Directory Structure The MSD class driver is included in the USB Device Firmware Framework installation; the directory structure is shown in Figure 1. The USB files required for an MSD application (shown in bold) must be included in the project. The entire MSD class driver is contained in the files, usb_function_msd.c and usb_function_msd.h. 2008 Microchip Technology Inc. DS01189A-page 1

FIGURE 1: PROJECT DIRECTORY STRUCTURE FOR MSD PROJECTS - - - - <Application> <Application>.c/.h USBDescriptor.c usb_config.h HardwareProfile.h Microchip USB USBDevice.c - MSD Device Driver usb_function_msd.c - Include Compiler.h GenericTypDefs.h USB usb_device.h usb.h usb_core.h usb_function_msd.h Physical Layer The MSD class driver was written to use the physical layers provided in the Microchip Application Note AN1045, Implementing File I/O Functions Using Microchip s Memory Disk Drive File System Library. Once the physical layer is installed, the MSD code needs to know where to find the physical interface functions. For this purpose, there are several application-specific definitions that must be defined by the application: LUNMediaInitialize() LUNReadCapacity() LUNReadSectorSize() LUNMediaDetect() LUNSectorWrite(bLBA,pDest,Write0) LUNWriteProtectState() LUNSectorRead(bLBA,pSrc) An example definition would look like: #define LUNMediaInitialize() MediaInitialize(). Within the source code for the Memory Disk Drive File System, only the physical layer files need to be added (e.g., sd_card.c and sd_card.h); system files (e.g., FSIO.c) are not required. Please see the examples accompanying the file system code for more details. DS01189A-page 2 2008 Microchip Technology Inc.

Functions There are three additional function calls that are required by the MSD class driver. The first is the initialization function, USBMSDInit(). This function should be called when the device is plugged into the USB port. This can be added into USBCBInitEP, as shown in Example 1. If an application requires that both the USB host and the embedded device be able to modify the media content, then the system files are required. The second function is MSDTasks(). This is the main task handler for the MSD device driver. This function should be called frequently while the device is connected to the USB, but only after the USB is in a configured state. The frequency at which this function is called helps to determine the device throughput. Example 2 shows a typical usage. Note: When using the MSD class, please insure that the data contents are not being modified while the host is attempting to read/write the data. Use a semaphore or some other mechanism to manage both sets of code accessing the same memory. EXAMPLE 1: TYPICAL USAGE OF USBMSDInit() void USBCBInitEP(void) { USBEnableEndpoint(MSD_DATA_IN_EP, USB_IN_ENABLED USB_OUT_ENABLED USB_HANDSHAKE_ENABLED USB_DISALLOW_SETUP); USBMSDInit(); } EXAMPLE 2: TYPICAL USE OF MSDTasks() void ProcessIO(void) { if((usbdevicestate < CONFIGURED_STATE) (USBSuspendControl==1)) return; MSDTasks(); }//end ProcessIO 2008 Microchip Technology Inc. DS01189A-page 3

The final function that needs to be called is USBCheckMSDRequest(). This function checks transactions on Endpoint 0 to see if they apply to the MSD class driver. This function can be called from the function, USBCBCheckOtherReq(), as shown in Example 3. EXAMPLE 3: TYPICAL USE OF USBCheckMSDRequest() void USBCBCheckOtherReq(void) { USBCheckMSDRequest(); } //end Definitions and Constants The physical layer section of this document already covered some definitions that are required to tie a physical interface to the MSD class driver. There are a few other definitions and constants that need to be added or changed in order to get the MSD class driver to work with the USB firmware framework. DESCRIPTORS When any USB device is attached to the bus, it is required to send a set of descriptors that tell the computer host what type of device it is. For most device classes, this is typically done through the bdeviceclass, bdevicesubclass and bdeviceprotocol fields of the device descriptor (see Table 9-8 of the USB specification for more details). The MSD class driver, however, requires that MSD devices declare their class in the interface descriptor and leave these fields in the device descriptor as unspecified (0x00), as shown in Example 4. Inside the interface descriptor, there are three fields that must be updated to use the MSD class driver. The binterfaceclass, binterfacesubclass and binterfaceprotocol need to be updated to the correct values. The binterfaceclass field needs to reflect that this device is an MSD device (MSD_INTF). The binterfacesubclass needs to reflect which of the subclasses defined in the MSD specification that the application is using. The options available can also be found in the file, usb_function_msd.h. All of the demo applications have MSD_INTF_SUBCLASS defined as SCSI_TRANSPARENT so that the host uses the SCSI command set to talk to the device. The binterfaceprotocol must reflect which MSD protocol method is being used for data transfer. All new applications are required to use the Bulk Only Transport (BOT) protocol. This protocol uses one bulk endpoint for data from the host, one bulk endpoint for data going to the host and the control endpoint for other control related transfers. For this purpose, the MSD_PROTOCOL should be set to BOT (0x50). In addition to the updated interface fields, the endpoint descriptors, located at the end of the configuration descriptor, are updated, such that there is one bulk IN endpoint and one bulk OUT endpoint. A typical MSD configuration descriptor with all the required changes is shown in Example 5. EXAMPLE 4: DEVICE DESCRIPTOR FOR MASS STORAGE DEVICE (CLASS, SUBCLASS AND PROTOCOL UNSPECIFIED) /* Device Descriptor */ ROM USB_DEVICE_DESCRIPTOR device_dsc= { 0x12, // Size of this descriptor in bytes USB_DESCRIPTOR_DEVICE, // DEVICE descriptor type 0x0110, // USB Spec Release Number in BCD format 0x00, // Class Code 0x00, // Subclass code 0x00, // Protocol code EP0_BUFF_SIZE, // Max packet size for EP0, see usbcfg.h 0x04D8, // Vendor ID 0x0009, // Product ID: mass storage device demo 0x0001, // Device release number in BCD format 0x01, // Manufacturer string index 0x02, // Product string index 0x00, // Device serial number string index 0x01 // Number of possible configurations }; DS01189A-page 4 2008 Microchip Technology Inc.

EXAMPLE 5: CONFIGURATION DESCRIPTOR FOR MASS STORAGE DEVICE /* Configuration 1 Descriptor */ ROM BYTE configdescriptor1[]= { /* Configuration Descriptor */ 9, // Size of this descriptor in bytes USB_DESCRIPTOR_CONFIGURATION, // CONFIGURATION descriptor type 0x20,0x00, // Total length of data for this cfg 1, // Number of interfaces in this cfg 1, // Index value of this configuration 0, // Configuration string index _DEFAULT _SELF, // Attributes, see usbdefs_std_dsc.h 50, // Max power consumption (2X ma) }; /* Interface Descriptor */ 9, // Size of this descriptor in bytes USB_DESCRIPTOR_INTERFACE, // INTERFACE descriptor type 0, // Interface Number 0, // Alternate Setting Number 2, // Number of endpoints in this intf MSD_INTF, // Class code MSD_INTF_SUBCLASS, // Subclass code MSD_PROTOCOL, // Protocol code 0, // Interface string index /* Endpoint Descriptor */ 7, USB_DESCRIPTOR_ENDPOINT, _EP01_IN,_BULK, MSD_IN_EP_SIZE,0x00, 0x00, 7, USB_DESCRIPTOR_ENDPOINT, _EP01_OUT, _BULK, MSD_OUT_EP_SIZE,0x00, 0x00 INQUIRY RESPONSE STRING One of the SCSI commands sent to the MSD device is INQUIRY. This asks the device for information, such as if the device is removable, which SCSI command sets does this device support and various strings that are used to label the drive in the operating system. The MSD class driver looks for a reference inside the code defined as const ROM InquiryResponse inq_resp[] that should hold this data. This string should be defined inside the user code. An example for a Mass Storage Device is shown in Example 6. There are three fields that need to be modified in this structure. The first is the T10-assigned Vendor ID, provided by the INCITS Technical Committee that oversees the standards for SCSI storage devices. Each vendor of a SCSI storage product should have a unique T10 Vendor ID, in addition to the Vendor ID assigned by the USB-IF. Users can obtain more information about the T10 Vendor ID (available without cost at the time of this writing) at the committee s web site (www.t10.org). The product ID and revision information files can be modified as desired by the vendor. They are fixed length strings, so any unused locations need to contain spaces. Figure 2 shows the Device Manager window for a host connected to a device with the inquiry response string shown in Example 6 (upper red box). Note how the string in the disk drive section reflects the names returned in the response. The name provided in the USB section of the Device Manager (second red box) is a generic string that is provided for all USB MSD devices. 2008 Microchip Technology Inc. DS01189A-page 5

EXAMPLE 6: MSD INQUIRY RESPONSE STRING /* Standard Response to INQUIRY command stored in ROM */ const ROM InquiryResponse inq_resp = { 0x00, // peripheral device is connected, direct access block device 0x80, // removable 0x04, //, 4=> SPC-2 0x02, // response is in format specified by SPC-2 0x20, // n-4 = 36-4=32= 0x20 0x00, // sccs etc. 0x00, // bque=1 and cmdque=0,indicates simple queueing 0x00, // 00 obsolete, 0x80 for basic task queueing {'M','i','c','r','o','c','h','p'}, // T10-assigned Vendor ID {'M','a','s','s',' ','S','t','o','r','a','g','e',' ',' ',' ',' '}, //product ID {'0','0','0','1'} //revision information }; FIGURE 2: MASS STORAGE DEVICE AS IT APPEARS IN DEVICE MANAGER DS01189A-page 6 2008 Microchip Technology Inc.

usb_config.h Settings There are several additional settings that must be defined in order for the MSD class firmware to run correctly. These settings (Example 7) should be added to the usb_config.h file located in the application directory of the user s program. First, the MSD class library needs to be enabled. This is done by defining USB_USE_MSD. In addition, the MSD class firmware must know which endpoints have been selected in the descriptors to use as the MSD endpoints. In this example, Endpoint 1 was used for the in and out data. The firmware must also know the size of the endpoints used for the MSD data transfer. Finally, the MSD class firmware needs to know how many Logical Unit Numbers (LUNs) the device supports. The number of logical units is the number of drives that the application wishes to show up for this USB device. This value is 0 through 15 inclusive, indicating the maximum Logical Unit Number (LUN) of the system. If the system has only one logical unit, then 0 must be used. Up to 16 LUNs can be defined. Memory Organization and Linker File Modifications for PIC18 Devices The MSD class library transfers an entire sector of data (typically, 512 bytes) at a time. For this reason, a sector size array is required in the MSD class firmware. In PIC18 devices, the maximum data size that is allowed in a single bank of RAM is 256 bytes. Data variables that are larger than this require modifications to the device s linker script. This data must reside in RAM that is also accessible by the USB module. The newly formed 512-byte section must be named mymsd. Example 8 shows a typical PIC18F4550 linker script with the required modifications. Note that the usb6 and usb7 data memory sections are commented out and the new mymsd data bank spans the memory that was in both of these banks. EXAMPLE 7: MSD DEFINITIONS ADDED TO usb_config.h #define USB_USE_MSD // enable MSD Class library #define MSD_DATA_IN_EP1 // use EP1 for input data #define MSD_DATA_OUT_EP1 // and output data #define MSD_IN_EP_SIZE 64 // endpoint sizes in bytes #define MSD_OUT_EP_SIZE 64 // #define MAX_LUN 0 // only one LUN will be supported EXAMPLE 8: TYPICAL PIC18 LINKER SCRIPT FOR USE WITH MSD ACCESSBANK NAME=accessram START=0x0 END=0x5F DATABANK NAME=gpr0 START=0x60 END=0xFF DATABANK NAME=gpr1 START=0x100 END=0x1FF DATABANK NAME=gpr2 START=0x200 END=0x2FF DATABANK NAME=gpr3 START=0x300 END=0x3FF DATABANK NAME=usb4 START=0x400 END=0x4FF PROTECTED DATABANK NAME=usb5 START=0x500 END=0x5FF PROTECTED //DATABANK NAME=usb6 START=0x600 END=0x6FF PROTECTED //DATABANK NAME=usb7 START=0x700 END=0x7FF PROTECTED DATABANK NAME=myMSD START=0x600 END=0x7FF PROTECTED ACCESSBANK NAME=accesssfr START=0xF60 END=0xFFF PROTECTED 2008 Microchip Technology Inc. DS01189A-page 7

FREQUENTLY ASKED QUESTIONS ABOUT THE MSD FIRMWARE Q: I am missing the physical interface files (SD-SPI.c, SD-SPI.h, etc.). Where can I find them? A: These files are located in the installation for Microchip Application Note AN1045, Implementing File I/O Functions Using Microchip s Memory Disk Drive File System Library. Install the files from AN1045 into the same base directory as the USB device firmware framework. Q: How do I get a MSD device working in conjunction with the Microchip MDD library in AN1045? A: In addition to the physical layer and configuration files, the file system files (FSIO.c, FSIO.h, etc.) are required. These files are only required when both the USB host and the firmware want to read and/or modify the contents of the memory on the drive. If only the USB host reads and/or writes the memory, then these files are not required. Also, depending on the system implementation, it may be required to create a semaphore system to prevent the USB code and the MDD code from accessing the physical media simultaneously, as corruption of the disk may result if the host and embedded device try to write to the media at the same time. Please see the provided demo for an example project. Q: What is T10 and why does my device need a T10 Vendor ID? A: T10 is shorthand for Technical Committee 10 of the International Committee on Information Technology Standards (INCITS). INCITS is an ANSI accredited body that develops voluntary standards for information technology; T10 is the specific group that maintains the Small Computer System Interface (SCSI) storage standards. The T10 Vendor ID is used during device enumeration to help users correctly identify a particular device in the host operating system. Unlike a USB-IF Vendor ID, the T10 Vendor ID is not required for a device to be offered for sale. Manufacturers also do not have to belong to T10 to obtain a Vendor ID. As of the time of this document s publication, there is no cost to register a T10 ID. Additional information on T10 and the Vendor ID registration process is available at the committee s web site, www.t10.org. Q: Why does the device name show up as Microchp in the Windows Device Manager? Is this a typographical error? A: This is not a typo, but the best answer to a technical limitation. Since the Vendor ID field sent in response to the INQUIRY command can only be 8 bytes long, Microchp is used as a shortened version of Microchip (which would be 9 bytes). Q: Why doesn t MSD work with Microsoft Windows 98? A: The MSD demonstration uses the native Windows driver, usbstor.sys. The Windows 98 operating system does not provide native support for the driver. Please refer to the Microsoft web site for details: http://www.microsoft.com/whdc/device/storage/ usbfaq.mspx Q: Why does MSD implement the SCSI command set and not the RBC? A: Currently, Windows 2000 and Windows XP do not provide support to handle devices that implement Reduced Block Commands (RBC, subclass 0x01) protocol. Please refer to the Microsoft web site for further details: http://www.microsoft.com/whdc/device/storage/ usbfaq.mspx DS01189A-page 8 2008 Microchip Technology Inc.

SUMMARY Developing a USB Mass Storage Device application is no different, and no more complicated, than developing any other USB device application. Using the Microchip USB Device Firmware Framework and accompanying MSD firmware, users can design a solution without having to worry about the underlying SCSI protocols. This application note covers the basic concepts of creating and configuring an MSD application. Additional examples and demos are included with the Microchip USB Device Firmware Framework for various MSD solutions. REFERENCES For more information on components of the Microchip USB Peripheral Device Support Package, the following documents are available at the Microchip web site (www.microchip.com/usb): Microchip Application Note AN1045, Implementing File I/O Functions Using Microchip s Memory Disk Drive File System Library (DS01045) Microchip USB Device Firmware Framework User s Guide (DS51679) For more information on USB in general: USB Implementers Forum, Universal Serial Bus Revision 2.0 Specification, http://www.usb.org/developers/docs/ 2008 Microchip Technology Inc. DS01189A-page 9

NOTES: DS01189A-page 10 2008 Microchip Technology Inc.

Note the following details of the code protection feature on Microchip devices: Microchip products meet the specification contained in their particular Microchip Data Sheet. Microchip believes that its family of products is one of the most secure families of its kind on the market today, when used in the intended manner and under normal conditions. There are dishonest and possibly illegal methods used to breach the code protection feature. All of these methods, to our knowledge, require using the Microchip products in a manner outside the operating specifications contained in Microchip s Data Sheets. Most likely, the person doing so is engaged in theft of intellectual property. Microchip is willing to work with the customer who is concerned about the integrity of their code. Neither Microchip nor any other semiconductor manufacturer can guarantee the security of their code. Code protection does not mean that we are guaranteeing the product as unbreakable. Code protection is constantly evolving. We at Microchip are committed to continuously improving the code protection features of our products. Attempts to break Microchip s code protection feature may be a violation of the Digital Millennium Copyright Act. If such acts allow unauthorized access to your software or other copyrighted work, you may have a right to sue for relief under that Act. Information contained in this publication regarding device applications and the like is provided only for your convenience and may be superseded by updates. It is your responsibility to ensure that your application meets with your specifications. MICROCHIP MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED, WRITTEN OR ORAL, STATUTORY OR OTHERWISE, RELATED TO THE INFORMATION, INCLUDING BUT NOT LIMITED TO ITS CONDITION, QUALITY, PERFORMANCE, MERCHANTABILITY OR FITNESS FOR PURPOSE. Microchip disclaims all liability arising from this information and its use. Use of Microchip devices in life support and/or safety applications is entirely at the buyer s risk, and the buyer agrees to defend, indemnify and hold harmless Microchip from any and all damages, claims, suits, or expenses resulting from such use. No licenses are conveyed, implicitly or otherwise, under any Microchip intellectual property rights. Trademarks The Microchip name and logo, the Microchip logo, Accuron, dspic, KEELOQ, KEELOQ logo, MPLAB, PIC, PICmicro, PICSTART, rfpic and SmartShunt are registered trademarks of Microchip Technology Incorporated in the U.S.A. and other countries. FilterLab, Linear Active Thermistor, MXDEV, MXLAB, SEEVAL, SmartSensor and The Embedded Control Solutions Company are registered trademarks of Microchip Technology Incorporated in the U.S.A. Analog-for-the-Digital Age, Application Maestro, CodeGuard, dspicdem, dspicdem.net, dspicworks, dsspeak, ECAN, ECONOMONITOR, FanSense, In-Circuit Serial Programming, ICSP, ICEPIC, Mindi, MiWi, MPASM, MPLAB Certified logo, MPLIB, MPLINK, mtouch, PICkit, PICDEM, PICDEM.net, PICtail, PIC 32 logo, PowerCal, PowerInfo, PowerMate, PowerTool, REAL ICE, rflab, Select Mode, Total Endurance, UNI/O, WiperLock and ZENA are trademarks of Microchip Technology Incorporated in the U.S.A. and other countries. SQTP is a service mark of Microchip Technology Incorporated in the U.S.A. All other trademarks mentioned herein are property of their respective companies. 2008, Microchip Technology Incorporated, Printed in the U.S.A., All Rights Reserved. Printed on recycled paper. Microchip received ISO/TS-16949:2002 certification for its worldwide headquarters, design and wafer fabrication facilities in Chandler and Tempe, Arizona; Gresham, Oregon and design centers in California and India. The Company s quality system processes and procedures are for its PIC MCUs and dspic DSCs, KEELOQ code hopping devices, Serial EEPROMs, microperipherals, nonvolatile memory and analog products. In addition, Microchip s quality system for the design and manufacture of development systems is ISO 9001:2000 certified. 2008 Microchip Technology Inc. DS01189A-page 11

WORLDWIDE SALES AND SERVICE AMERICAS Corporate Office 2355 West Chandler Blvd. Chandler, AZ 85224-6199 Tel: 480-792-7200 Fax: 480-792-7277 Technical Support: http://support.microchip.com Web Address: www.microchip.com Atlanta Duluth, GA Tel: 678-957-9614 Fax: 678-957-1455 Boston Westborough, MA Tel: 774-760-0087 Fax: 774-760-0088 Chicago Itasca, IL Tel: 630-285-0071 Fax: 630-285-0075 Dallas Addison, TX Tel: 972-818-7423 Fax: 972-818-2924 Detroit Farmington Hills, MI Tel: 248-538-2250 Fax: 248-538-2260 Kokomo Kokomo, IN Tel: 765-864-8360 Fax: 765-864-8387 Los Angeles Mission Viejo, CA Tel: 949-462-9523 Fax: 949-462-9608 Santa Clara Santa Clara, CA Tel: 408-961-6444 Fax: 408-961-6445 Toronto Mississauga, Ontario, Canada Tel: 905-673-0699 Fax: 905-673-6509 ASIA/PACIFIC Asia Pacific Office Suites 3707-14, 37th Floor Tower 6, The Gateway Harbour City, Kowloon Hong Kong Tel: 852-2401-1200 Fax: 852-2401-3431 Australia - Sydney Tel: 61-2-9868-6733 Fax: 61-2-9868-6755 China - Beijing Tel: 86-10-8528-2100 Fax: 86-10-8528-2104 China - Chengdu Tel: 86-28-8665-5511 Fax: 86-28-8665-7889 China - Hong Kong SAR Tel: 852-2401-1200 Fax: 852-2401-3431 China - Nanjing Tel: 86-25-8473-2460 Fax: 86-25-8473-2470 China - Qingdao Tel: 86-532-8502-7355 Fax: 86-532-8502-7205 China - Shanghai Tel: 86-21-5407-5533 Fax: 86-21-5407-5066 China - Shenyang Tel: 86-24-2334-2829 Fax: 86-24-2334-2393 China - Shenzhen Tel: 86-755-8203-2660 Fax: 86-755-8203-1760 China - Wuhan Tel: 86-27-5980-5300 Fax: 86-27-5980-5118 China - Xiamen Tel: 86-592-2388138 Fax: 86-592-2388130 China - Xian Tel: 86-29-8833-7252 Fax: 86-29-8833-7256 China - Zhuhai Tel: 86-756-3210040 Fax: 86-756-3210049 ASIA/PACIFIC India - Bangalore Tel: 91-80-4182-8400 Fax: 91-80-4182-8422 India - New Delhi Tel: 91-11-4160-8631 Fax: 91-11-4160-8632 India - Pune Tel: 91-20-2566-1512 Fax: 91-20-2566-1513 Japan - Yokohama Tel: 81-45-471-6166 Fax: 81-45-471-6122 Korea - Daegu Tel: 82-53-744-4301 Fax: 82-53-744-4302 Korea - Seoul Tel: 82-2-554-7200 Fax: 82-2-558-5932 or 82-2-558-5934 Malaysia - Kuala Lumpur Tel: 60-3-6201-9857 Fax: 60-3-6201-9859 Malaysia - Penang Tel: 60-4-227-8870 Fax: 60-4-227-4068 Philippines - Manila Tel: 63-2-634-9065 Fax: 63-2-634-9069 Singapore Tel: 65-6334-8870 Fax: 65-6334-8850 Taiwan - Hsin Chu Tel: 886-3-572-9526 Fax: 886-3-572-6459 Taiwan - Kaohsiung Tel: 886-7-536-4818 Fax: 886-7-536-4803 Taiwan - Taipei Tel: 886-2-2500-6610 Fax: 886-2-2508-0102 Thailand - Bangkok Tel: 66-2-694-1351 Fax: 66-2-694-1350 EUROPE Austria - Wels Tel: 43-7242-2244-39 Fax: 43-7242-2244-393 Denmark - Copenhagen Tel: 45-4450-2828 Fax: 45-4485-2829 France - Paris Tel: 33-1-69-53-63-20 Fax: 33-1-69-30-90-79 Germany - Munich Tel: 49-89-627-144-0 Fax: 49-89-627-144-44 Italy - Milan Tel: 39-0331-742611 Fax: 39-0331-466781 Netherlands - Drunen Tel: 31-416-690399 Fax: 31-416-690340 Spain - Madrid Tel: 34-91-708-08-90 Fax: 34-91-708-08-91 UK - Wokingham Tel: 44-118-921-5869 Fax: 44-118-921-5820 01/02/08 DS01189A-page 12 2008 Microchip Technology Inc.