Getting Started: Running the “USB
Host - Composite - HID + MSD” 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 HID and MSD interfaces only. Please refer
HID 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 - HID + MSD" 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 - The HID interface gets POT value from the device and displays it on the LCD
mounted on the Explorer 16 board. On press of switch 'S6' on Explorer 16 board
HID interface sends a command to toggle the LED's on the device 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 - HID + MSD" 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