Getting Started: Running the “USB
Host - Composite – MSD + CDC” demo
To run this project, you will need one of the
following sets of hardware:
Explorer
16 (DM240001)
USB
PICtail™ Plus Daughter Card (AC164131)
And one of the following PIMs
PIC24FJ256GB110 Plug-In-Module (PIM) (MA240014)
PIC32MX USB Plug-In-Module (PIM) (MA320002)
dsPIC33EP512MU810 USB Plug-In-Module (PIM)
PIC24EP512GU810 USB Plug-In-Module (PIM)
This
section describes how to set up the various configurations of hardware to run
this demo.
Configuration 1: PIC24FJ256GB110 PIM + Explorer 16
1)
Before attaching the PIC24FJ256GB110 PIM to the Explorer 16 board, insure that
the processor selector switch (S2) is in the “PIM” position as seen in the
image below.
2)
Short the J7 jumper to the “PIC24” setting
3)
Before connecting the PIC24FJ256GB110 PIM to the Explorer 16 board, remove all
attached cables from both boards.
Connect the PIC24FJ256GB110 PIM to the Explorer 16 board. Be careful when connecting the boards to
insure that no pins are bent or damaged during the process. Also insure that the PIM is not shifted in
any direction and that all of the headers are properly aligned.
4) On the USB PICTail Plus board, short jumpers
JP2 and JP3. Remove all other shorts on
the board.
5) Connect the USB PICTail Plus board to either
of the female PICTail Plus connectors or on the card edge connector (J9) at the
edge of the Explorer 16 board.
Note: When using the HID bootloader for PIC32, it is
important to modify the procdefs.ld file to relocate
the sections of code that will hold the bootloader and those sections that will
hold the user application. Example
modified procdefs.ld files have been provided with
each project. This file is currently
named “Procdefs.ld.boot”. When using the example project with the
bootloader it is required to remove the “.boot” section of the file. This will allow MPLAB to use this file
instead of the default linker file. Once
the linker file is renamed, however, the project will no longer work without
the bootloader. Please rename the file
in order to get the project working again with PIC32.
To
run this project, you will need to load the corresponding firmware into the
devices. There are two methods available
for loading the demos: Precompiled demos and source code projects.
Precompiled
Demos are available in the “<Install Directory>\USB – Precompiled Demos”
folders. Each demo should be prefaced
with the hardware platform it is compiled for.
Select the file that matches the hardware that you have and the demo
that you want to run. For more
information about how to load a precompiled project, please see the “Getting
Started – Loading a precompiled demo” guide.
The
source code for this demo is available in the “<Install Directory>\USB
Host - Composite - HID + MSD” directory.
In this directory you will find all of the user level source and header
files as well as project and workspace files for each of the hardware
platforms. Find the project (*.mcp) or workspace (*.mcw) file
that corresponds to the hardware platform you wish to test. Compile and program the demo code into the
hardware platform. For more help on how
to compile and program projects, please refer to the MPLAB® help available
through the help menu of MPLAB (Help->Topics…->MPLAB IDE).
This
demo supports a composite device with MSD and CDC interfaces only. Please refer
CDC host and MSD host documentation to understand the individual host
requirements. The device end can be programmed on any of the development boards
for which "USB Device - Composite - MSD + CDC" demo is implemented.
The composite host demo works in two steps.
Step 1
- The MSD interface opens a file "test.txt" with text "This is
from Composite Host." as the content of the file.
Step
2 - On pressing switch 'S6' on host i.e Explorer 16
board the demo send a character on the CDC interface. The same character is
echoed back by the device firmware. On reception the character is displayed on
the LCD display on the Explorer 16 demo board.
Note: when bootloading
this application using the HID bootloader, please make sure that the “Allow
Configuration Word Programming” box is checked.
This is required to be able to program the interrupt vectors on PIC24
products. As this demo requires
interrupts it will not work without this feature enabled.
Current version of the software supports the composite devices by Classes only and does not support devices by VID/PID. This Composite host demo is tested with "USB Device - Composite – MSD + CDC" that is part of the same stack. The transfer events macro USB_ENABLE_TRANSFER_EVENT must be commented in file usb_config.h, these are not supported for composite host demo in current release. USB configuration utility USBConfig.exe does not support composite host in current release.
The Microchip name and logo, the Microchip logo,
MPLAB, and PIC are registered trademarks of Microchip Technology Incorporated
in the
PICDEM is a trademark of
Microchip Technology Incorporated in the
Microsoft, Windows, and
Windows Vista are either registered trademarks or trademarks of Microsoft
Corporation in the