Atmel AT43DK370 User manual

AT43DK370 USB Host/Function
Development Kit
.......................................................................................................
User Guide for Revision 1.3

AT43DK370 USB Host/Function Dev. Kit User Guide i
3423C–USB–1/04
Table of Contents
Section 1
Introduction...........................................................................................1-1
1.1 Development Kit Features.........................................................................1-1
Section 2
Getting Started......................................................................................2-1
2.1 Electrostatic Warning................................................................................2-1
2.2 Unpacking the System..............................................................................2-1
2.3 System Requirements...............................................................................2-1
2.4 Connecting the Hardware .........................................................................2-2
2.5 Installing AT43DK370 and Starting Up the USB Clinic.............................2-2
2.6 Testing the Hardware................................................................................2-3
Section 3
Hardware Description ...........................................................................3-1
3.1 Jumper Settings........................................................................................3-2
Section 4
USB Clinic.............................................................................................4-1
4.1 Main Menu ................................................................................................4-1
4.2 Output Window .........................................................................................4-2
4.2.1 Command/Status Window..................................................................4-2
4.2.2 User Program Output Window............................................................4-2
4.3 Connection................................................................................................4-2
4.3.1 Test Connectivity................................................................................4-3
4.3.2 Check Device Enumerated.................................................................4-3
4.4 Download Code ........................................................................................4-3
4.5 Memory.....................................................................................................4-5
4.5.1 Fill Memory.........................................................................................4-5
4.5.2 Read Memory.....................................................................................4-5
4.6 Enumeration..............................................................................................4-5
4.6.1 Get Device Descriptor ........................................................................4-6
4.6.2 Get Configuration Descriptor..............................................................4-6
4.6.3 Get String Descriptor..........................................................................4-7
4.6.4 Set Configuration................................................................................4-7
4.6.5 Set Interface.......................................................................................4-7
4.7 Data Transfer............................................................................................4-8

Table of Contents
ii AT43DK370 USB Host/Function Dev. Kit User Guide
3423C–USB–1/04
4.7.1 Get ISO Data......................................................................................4-8
4.7.2 Send ISO Data ...................................................................................4-8
4.7.3 Get Data.............................................................................................4-8
4.7.4 Send Data...........................................................................................4-8
4.7.5 Control Transfer..................................................................................4-9
4.7.6 Custom Transfer.................................................................................4-9
4.8 Port Features ..........................................................................................4-10
4.8.1 Set Port Feature...............................................................................4-10
4.8.2 Clear Port Feature............................................................................4-10
4.9 Device State Control...............................................................................4-11
4.9.1 Reset Device....................................................................................4-11
4.9.2 Suspend Device ...............................................................................4-11
4.9.3 Resume Device................................................................................4-11
4.10 Miscellaneous Notes...............................................................................4-11
Section 5
Building Firmware for the AT43DK370 Development Kit......................5-1
5.1 Sample Directory and File Structure.........................................................5-1
5.1.1 USBP ARM Project Guide..................................................................5-2
5.1.2 “Make” Project....................................................................................5-4
5.2 ADS Settings.............................................................................................5-5
5.3 Modifying a Sample Application................................................................5-8
Section 6
Converting Between FLASH and ICE Mode.........................................6-1
6.1 Introduction ...............................................................................................6-1
6.2 Converting to Flash Mode from ICE Mode................................................6-1
6.3 Converting to Flash Mode from Download Mode......................................6-3
6.4 Converting to Download Mode from ICE Mode ........................................6-3
6.5 Converting to Download Mode from Flash Mode......................................6-4
6.6 Converting to ICE Mode from Flash Mode................................................6-4
6.7 Converting to ICE Mode from Download Mode ........................................6-4
6.8 Summary...................................................................................................6-4
Section 7
Generating Hex Files for Flash Mode in the AT43USB370 Development
Board with ADS ....................................................................................7-1
7.1 Introduction ...............................................................................................7-1
7.2 Procedure .................................................................................................7-1
Section 8
Technical Support.................................................................................8-1

Table of Contents
AT43DK370 USB Host/Function Dev. Kit User Guide iii
3423C–USB–1/04
Section 9
Appendices...........................................................................................9-1
9.1 AT43USB370 Bill of Materials (BOM).......................................................9-1
9.2 AT43DK370 Schematics...........................................................................9-3

Table of Contents
iv AT43DK370 USB Host/Function Dev. Kit User Guide
3423C–USB–1/04

AT43DK370 USB Host/Function Dev. Kit User Guide 1-1
3423C–USB–1/04
Section 1
Introduction
Congratulations on your purchase of the AT43DK370 Development Kit. The
AT43DK370 is a complete starter kit and development system for the AT43USB370
Host/Function Processor. It is designed to allow real-time firmware development and
evaluation of the AT43USB370 USB Host/Function Processor.
1.1 Development Kit
Features The AT43DK370 development kit consists of the following features:
n AT43USB370 USB Host/Function Processor Reference Design Board featuring
– ARM System Processor
– 1 MBytes Flash ROM
– 2 MBytes Static RAM
– USB Type A/B Ports
– RS-232 Serial Port
– MII Expansion Connector
– Generic 8-bit Expansion Connector
– 20-pin JTAG interface connector
– Reset Button
– Power Indicator LEDs
– In-system Firmware Programming Capability
n USB Firmware Library including USB Host Stack, User Class Device Drivers and
High Level APIs in C
n USB Clinic In-circuit Emulation Tool
The latest version of the USB Clinic can be found in the USB section of the Atmel web
site at http://www.atmel.com/ad/plugplayhost. Please refer to the same section for up-
to-date information on new USB software, documentation releases and tool upgrades.

Introduction
1-2 AT43DK370 USB Host/Function Dev. Kit User Guide
3423C–USB–1/04

AT43DK370 USB Host/Function Dev. Kit User Guide 2-1
3423C–USB–1/04
Section 2
Getting Started
2.1 Electrostatic
Warning The AT43DK370 Development Board is shipped in protective anti-static packaging. The
board must not be subjected to high electrostatic potentials. A grounding strap or similar
protective device should be worn when handling the board. Avoid touching the compo-
nent pins or any other metallic elements.
2.2 Unpacking the
System The development kit is supplied with the following:
n AT43DK370 Reference Design Board
n Female-Female DB9 Null-modem Cable
n 2m Fully Rated USB Cable
n 5V Regulated Power Supply
n Atmel USB CD-ROM with Software and Documentation
n Atmel Products CD-ROM
Please contact your local Atmel distribution or E-mail [e-mail] if any of the
aforementioned items is missing from the package.
2.3 System
Requirements The minimum hardware and software requirements are:
n 486 Processor (Pentium®is recommended)
n 128 MB RAM
n 10 MB Free Hard Disk Space
n Windows®98/2000/ME/XP
n RS-232 Port (COM port)

Getting Started
2-2 AT43DK370 USB Host/Function Dev. Kit User Guide
3423C–USB–1/04
2.4 Connecting the
Hardware Atmel has taken great care in creating a reliable demonstration kit for its customers. In
order to ensure proper operation, the supplied components in the kit must be used in the
setup as shown in Figure 2-1. Atmel does NOT recommend substitution of these
components.
Figure 2-1. Connection to the AT43DK370
Connect the AT43DK370 evaluation board as follows:
1. Connect the serial cable from J5 on the evaluation board to a COM port on the
PC.
2. Connect the AC input connector of the power supply to an AC wall outlet
(110 VAC).
3. Connect the DC output connector of the power supply to J1 on the evaluation
board.
2.5 Installing
AT43DK370 and
Starting Up the
USB Clinic
To install the AT43DK370:
1. Insert the “Atmel AT43DK370” CD into the CD-ROM drive of the PC or notebook
and follow the instructions.
2. After installation, the AT43USB370 documents, firmware, and software should
be installed on the C:\Program Files\ATMEL USB\AT43DK370 , if the default
installation directory is used. One of the software programs installed is USB
Clinic. It is an integrated diagnostic and debugging tool that provides communi-
cation between the AT43DK370 and the PC. Please refer to Section 4 of this
User's Guide for detailed description of this tool.
3. To invoke the USB Clinic program from desktop go to Start >Programs > Atmel
USB Clinic >Atmel USB Clinic. The screen in Figure 2-2 will appear.
J1
J5
Power Supply
(5VDC)
110VAC
Outlet
AT43USB370DK Evaluation Board
RS232
Cable

Getting Started
AT43DK370 USB Host/Function Dev. Kit User Guide 2-3
3423C–USB–1/04
Figure 2-2. USB Clinic - Main Menu
2.6 Testing the
Hardware From the USB Clinic Main Menu click Connection (Figure 2-3 and Figure 2-4 will
appear). The Connection button allows testing of the RS-232 serial port and the
AT43DK370 development board connection. Prior to going to the Connection menu,
please make sure that the AT43DK370 is physically connected to the PC with the sup-
plied serial cable or any standard serial cable.
Figure 2-3. USB Clinic - Connection

Getting Started
2-4 AT43DK370 USB Host/Function Dev. Kit User Guide
3423C–USB–1/04
Figure 2-4. COM Port Availability
The USB Clinic automatically detects and displays the availability of COM ports from
COM1 to COM4 in the Connection window. Users can use any available COM port by
simply selecting the desired COM port and then clicking on the Connect to Target but-
ton to open the selected COM port. To verify connectivity between the selected COM
port and the AT43DK370 development board, click on Test Connectivity with Target
and look for
Connection verified in the Output Window (see Figure 2-5). The Test
Connectivity with Target also checks the AT43DK370 firmware revision to see if it sup-
ports the current USB Clinic version.
Figure 2-5. Connection Verified Output Window
Once the connection is established, USB Clinic is ready for use. Please refer to Section
4 for more details.

AT43DK370 USB Host/Function Dev. Kit User Guide 3-1
3423C–USB–1/04
Section 3
Hardware Description
The AT43DK370 development board comes pre-configured as a USB Host in StandAl-
one (Flash) mode. Alternative settings are available through jumper configurations.
Complete descriptions of the jumper settings are explained in Section 3.1.
Figure 3-1. AT43USB370 Development Board Components Layout
The AT43DK370 Development Board consists of an ARM®processor with 32-bit exter-
nal bus, the AT43USB370 Host/Function Processor, 2 Mbytes of flash ROM, 2 Mbytes
of SRAM, USB type A/B ports and RS-232 serial port. The AT43USB370 connects to
the ARM processor through its 32-bit generic host interface. The RS-232 port provides
access to the ARM processor and the AT43USB370, and the in-system programming to
SRAM.
Section 8 of this User's Guide contains complete AT43DK370 BOM and schematics.
2
9
1
0
= Pin 1
JP1
JP2
JP7
JP5
JP4
JP3
JP13
JP12
J1
ICE (J4) RS-232 (J5)
J3
J2
SW1
ROM3
ROM2
ROM1
ROM0
RAM0 RAM1
Voltage
Regulator System
Processor
(ARM)
Atmel
AT43USB370
RAM2 RAM3
Power
Connector
(5 VDC)
Reset
Switch
USB-B
Connector
USB-A
Connector
JP9, JP8, JP11, JP10

Hardware Description
3-2 AT43DK370 USB Host/Function Dev. Kit User Guide
3423C–USB–1/04
3.1 Jumper Settings The AT43DK370 Development Board supports two modes of operation, the default
Standalone (or Flash) Mode and the ICE (In-Circuit Emulator) mode. In Standalone
Mode, the AT43DK370 Development Board executes code from its on board flash
ROM. While in ICE Mode, an In-Circuit Emulator for the ARM processor can be con-
nected through J4 to further facilitate code development. The corresponding jumper
settings for the different modes are shown in Table 3-1.
The AT43USB370 is a dual role processor that can be configured either as a full/low
speed host or a full speed device. Its exact personality is defined by the jumper settings
shown in Table 3-2. Please be aware that the AT43SUB370 can operate either in the
host mode or in the device mode, but not simultaneously.
Table 3-3 contains the jumper settings for the clock source. In normal operations, a
6 MHz crystal clock source is used. For debugging purposes, an external 48 MHz oscil-
lator can be used as the clock source to the AT43USB370 by bypassing its internal PLL.
JP3 was used in DK 1.0 for Revision A of the AT43USB370's minor erratum relating to
DMA acknowledgement. This erratum is resolved with minor re-works of the
AT43DK370 Development Board and leaving the JP3 jumper open. Both the re-works
and the JP3 setting are done at the factory.
DK 1.1, or Revision B of the AT43USB370 requires no such workaround. However, to
simplify user usage, JP3 can still be left open, the way it is from the factory setting.
JP12 and JP13 are currently unused and are reserved for future expansion.
Table 3-1. Development Board Environment
Standalone Mode (Default) ICE Mode
JP4 (nRCS<4> is 1) Close: 3-5, 7-9, 2-4 Close: 1-3, 5-7, 2-4
JP7 Close: 1-2 Close: 2-3
Table 3-2. Development Board Configuration
USB Host (Default) USB Function FS
JP5 Close: 2-3 Close: 1-2
JP8 Open Open
JP9 Close Open
JP10 Open Close
JP11 Close Open
Table 3-3. AT43USB370 Clock Source
Internal PLL with 6 MHz Crystal (Default) External 48 MHz Oscillator
JP1 Close: 1-2 Close: 2-3
JP2 Close: 1-2 Close: 2-3

AT43DK370 USB Host/Function Dev. Kit User Guide 4-1
3423C–USB–1/04
Section 4
USB Clinic
USB Clinic is a Graphical User Interface (GUI) based diagnostic and debugging tool that
provides basic control of the AT43USB370 USB Host/Function Processor via the
RS-232 serial port. Its main feature set includes user firmware download/execution,
direct read/write access of the AT43USB370 internal memory, manipulation of USB
device enumeration, data transfer through various endpoints, hub feature selection, and
USB device state control. All of the AT43USB370 Library APIs can be called through
USB Clinic. This section explains the capability and the usage of USB Clinic in detail.
Please note since the function calls used in USB Clinic allows the flexibility of user
inputs, it is the user's responsibility to ensure the inputs are bound to the USB Specifica-
tion 2.0 in order to obtain the correct response from the USB Clinic and the
AT43USB370 Library.
Atmel will continue to extend the capability of the USB Clinic. The following section is
intended for USB Clinic Rev. 1.2. For software upgrades, please refer to the USB sec-
tion of the Atmel web site at http://www.atmel.com/ad/plugplayhost.
4.1 Main Menu Once properly installed, USB Clinic can be invoked by double-clicking on the USB
Clinic icon, or if default installation options are used, from the Windows' Startup menu
by selecting Start > Programs > USB Clinic.
The Main Menu will appear on screen (see Figure )
Table 4-1. USB Clinic - Main Menu

USB Clinic
4-2 AT43DK370 USB Host/Function Dev. Kit User Guide
3423C–USB–1/04
Each button in the Main Menu represents a category of functions. USB Clinic Rev. 1.2
currently supports seven categories of functions: Connection, Download Code, Fill/Read
Memory, Enumeration, Data Transfer, Hub Port Feature, and Device State Control. The
the last four categories, functions are tied with the AT43USB370 Library APIs directly.
For detailed usage regarding those function calls, please refer to the “AT43USB370
Software Development Guide for Host Mode”.
4.2 Output Window Executing any function button will bring up the Output Window. There are two sections
in the Output Window: the Command/Status Window and the User Program Output
Window.
4.2.1 Command/Status
Window The Command/Status Window displays all messages and outputs resulting from the execution of USB Clinic commands. Click the Clear button to clear the content of the
window see Figure 4-2).
4.2.2 User Program
Output Window The User Program Output Window displays text messages and outputs from the user developed firmware. In the user firmware source code, users will need to insert
\n at the
end of every message printing statement to ensure that messages are properly dis-
played in the User Program Output Window. Clicking the Clear button clears the
content of the window (see Figure 4-2).
4.3 Connection From the Main Menu, the Connection button allows testing of the RS-232 serial port
and the AT43DK370 Development Board connection. Prior to go to the Connection
menu, please make sure that the AT43DK370 is physically connected to the PC with the
supplied serial cable.
Click on the Connection button and the windows in Figure 4-1 and Figure 4-2 appear.
Figure 4-1. USB Clinic - Connection Window

USB Clinic
AT43DK370 USB Host/Function Dev. Kit User Guide 4-3
3423C–USB–1/04
Figure 4-2. USB Clinic - Output Window
4.3.1 Test Connectivity The USB Clinic automatically detects and displays the availability of COM ports from
COM1 to COM4 in the Connection window. Users can use any available COM port by
simply selecting the desire COM port and then clicking on the Connect to Target button
to open the selected COM port. To verify connectivity between the selected COM port
and the AT43DK370 Development Board, click on Test Connectivity with Target and
look for Connection verified in the Output Window. The Test Connectivity with Tar-
get also checks the AT43DK370 firmware revision and its USB Clinic application code
revision.
4.3.2 Check Device
Enumerated The Check Device Enumerated command allows the user to see if the connected tar- get USB devices are enumerated or not. It is done by checking if the device addresses
have been assigned to the target USB devices. AT43USB370 can host up to 7 USB
devices, so the device address ranges from 1 to 7, and is assigned by the enumeration
timing order in which a device is connected to the AT43USB370 Host.
4.4 Download Code The Download Code button allows downloading user developed firmware onto the sys-
tem processor's program memory space for debug and testing. Please be aware that
this button is NOT for downloading AT43DK370 firmware. The AT43DK370 boots off
from the system processor and its firmware is stored in an external flash attached to the
system processor.

USB Clinic
4-4 AT43DK370 USB Host/Function Dev. Kit User Guide
3423C–USB–1/04
Figure 4-3. USB Clinic - Download/Execute Code
The ARM code requires 32-bit Intel Hex File Format with the entry point at address
0x108000. Select the appropriate ARM firmware in the file selection window first and
then double-click on the file or click on the Download Now!! to start the downloading
process. The progress bar and the associated messages indicate the code download
status. A sample download Hex file is included in the CD at the C:\Program
Files\Atmel USB\AT43DK370\Firmware directory.
Once code download is complete, the user has the option of downloading the firmware
again without executing the code or executing the downloaded firmware by clicking on
Execute Now. Resetting the AT43DK370 Development Board will not erase the firm-
ware from the ARM's memory space.
The Download Now!! command executes the downloaded firmware. The user should
only click on Download Now!! after code download is complete. During execution, the
only way to return control back to USB Clinic is to press the reset button on the
AT43USB370 Development Board or to power-cycle the board. The User Program
Output Window displays the test output of the user developed firmware during execu-
tion as shown in Figure 4-4.
Figure 4-4. USB Clinic - User Program Output Window

USB Clinic
AT43DK370 USB Host/Function Dev. Kit User Guide 4-5
3423C–USB–1/04
4.5 Memory There are two types of memory commands are available, Fill Memory and Read
Memory.
4.5.1 Fill Memory The Fill Memory command allows the user to write to the memory location of the target
device with the desired data size in Little Endian format. The user will need to select the
desired data size (8 bits, 16 bits, or 32 bits), then enter the number of data size to fill
(4 digits decimal value), starting address (Hex value), and the pattern (Hex value) to be
written to the target address.
4.5.2 Read Memory The Read Memory command allows the user to read to the desired memory location of
the target device in the Little Endian format. The user will need to select the data size to
be read (8 bits, 16 bits, or 32 bits), and then enter the starting address (Hex value) to
read from the target. The output displays a maximum of 8 address values (for 8 bytes or
4 words or 2 long words) of Hex value per line, and it displays from lower address to
higher address (left to right, and top to bottom). Please note that the available memory
address in the AT43DK370 Development Board ranges up to 0x3FFFFFFF. The user
will not be able to read or write to memory addresses beyond this limit.
Figure 4-5. USB Clinic - Read Memory
4.6 Enumeration The Enumeration functions allow for retrieving and potentially altering the USB device
interface setting upon successful device connection and enumeration. There are five
Enumeration functions, as shown in Figure 4-6, they are the Get Device Descriptor,
Get Configuration Descriptor, Get String Descriptor, Set Configuration, and Set
Interface.

USB Clinic
4-6 AT43DK370 USB Host/Function Dev. Kit User Guide
3423C–USB–1/04
Figure 4-6. USB Clinic Enumeration
4.6.1 Get Device
Descriptor The Get Device Descriptor command allows the user to get the device descriptor of a target USB device. A target USB device is defined as one of the USB devices connected
to the AT43DK370 development board. To retrieve the target device's descriptor, the
user needs to assign its device address as input. The device address ranges from 1 to
7, and is assigned by the enumeration timing order in which a device is connected to the
AT43DK370 Host.
Figure 4-7. USB Clinic - Get Device Descriptor
4.6.2 Get Configuration
Descriptor The Get Configuration Descriptor command allows the user to get the configuration descriptor of the first configuration from the target device. The current FW does not sup-
port multiple configurations. To get the configuration descriptor, the user will need to
assign the right device address and the configuration index as input. Configuration
Descriptor Index (CDIndex) zero always retrieves the first configuration descriptor,