Texas Instruments BIOSUSB User Manual Download Page 18

Page 18 of 21

BIOSUSB User Guide

6

Building and Running USB Application Example

This  chapter  discusses  how  to  configure  and  run  the  USB  host  or  device  example 

provided along with the package. 

Note : Before running any USB example, user should perform system reset 

or  reset  the  target  board  or  EVM  .  The  system  reset  can  be  performed 

through  code  composer  studio  IDE.  (From  CCS  IDE,  select  menu  item 

Debug->”Advanced  Resets”->”System  Reset”).  Note  that  CPU  Reset  from 

CCS does only the resetting the CPU, it does not reset the entire system

Setup  Procedure  for  CCS4  Environment (  Building  and  Loading  the 

executable)

1. Invoke  the  CCS4  and  perform  Target  configuration  to  configure 

C6747/OMAPL137 or C6748/OMAPL138 EVM platform and use the appropriate 

DSP  gel  file  and  Launch  the  target  by  selecting  Debug->  “TI  Launch 

Debugger”, then connect to the target.

2. Select  C/C++  perspective  window  (click  on  window->”open  perspective”-

>C/C++) and Open the USB example’s appropriate CCS4 project file. Select 

Project->”Import  existing  CCS/CCSE  eclipse  project”  and  provide  project 

directory  path  from  “<INSTALL_DIR>  \biosusb_xx_yy_zz\  packages\  ti\

biosusb\ examples\  <usbdevmsc,  usbdevhid,  usbhosthid  >\build\  <C6747/ 

C6748>\ ccs4”. This will load the selected project. Set Project configuration to 

Debug/Release mode.

3. Build  the  project  in  Release/Debug  mode.  Switch  to  Debug  window  by 

selecting  Debug  Perspective  window  (click  on  window->”open  perspective”-

>Debug) and load the executable.

4. Run the application program by pressing F8 key.

6.1

Building the USB MSC Device example for NAND OR MMC/SD OR SATA.

Below steps details how to build the USB device mass-storage application, where the 

target  platform  acts  as  USB  mass-storage  device  with  NAND  or  MMC/SD  or  SATA 

(only  on  C6748/OMAPL138  platform)  as  local  storage  media.  User  can  choose  the 

storage media to be either NAND or MMCSD or SATA with this application. Make sure 

all the dependent packages/components are installed and the environment variables 

are created and the values are initialized correctly. 
For CCS3 Environment

1. Setup  the  CCSV3  to  configure  C6747/OMAPL137  or  C6748/OMAPL138  EVM 

platform and use the appropriate DSP gel file and connect to the target.

2. Open  the  project  (PJT  file)  for  the  USB  device  sample  application  from 

“<INSTALL_DIR>\biosusb_xx_yy_zz\packages\ti\biosusb\examples\usbdevm

sc\build\<C6747/C6748>\ccs3\usb_dev_msc_sample.pjt”. 

Set 

Project 

configuration to Release mode.

3. User  can  chose  either  NAND  or  MMC/SD  or  SATA  (only  C6748  paltform) as 

storage  media.  Refer  to  block  media  user  guide from  BIOSPSP  package  for 

further details with respect to media selection to expose over USB.

Summary of Contents for BIOSUSB

Page 1: ...Template Version 1 4 User Guide BIOSUSB User Guide 01 10 01 ...

Page 2: ...Page 2 of 21 BIOSUSB Release Notes This page has been intentionally left blank ...

Page 3: ...warrant or represent that any license either express or implied is granted under any TI patent right copyright mask work right or other TI intellectual property right relating to any combination machine or process in which TI products or services are used Information published by TI regarding third party products or services does not constitute a license from TI to use such products or services or...

Page 4: ...Page 4 of 21 BIOSUSB User Guide This page has been intentionally left blank ...

Page 5: ...ss Storage Functionality 14 4 10 Use Case USB Host HID Functionality 14 5 USB Device Stack Architecture 15 5 1 Device Core Stack 15 5 2 Device MSC Function Driver 15 5 3 Device HID Function Driver 15 5 4 Device Generic Services 15 5 5 Platform Abstraction and Native OS Abstraction 16 5 6 Device Stack Component Libraries and Dependencies 16 5 7 Device Stack Component Build Options 16 5 8 Use Case U...

Page 6: ...Page 6 of 21 BIOSUSB User Guide ...

Page 7: ...rating system abstraction layer JOS USB general services module USB Device Platform capable of performing USB device functionality USB Host Platform capable of performing USB host functionality MSC Mass Storage Class USB Universal Serial Bus USBware Product name of Jungo s USB host and device stack 1 2 References Document Description 1 usb_device_stack pdf USBware device stack details 2 usb_host_s...

Page 8: ... Installation and configuration of dependent packages BIOS USB package is dependent on the following packages and as such expects these packages to be installed and configured correctly prior to its installation and usage I EDMA3 LLD Driver package II RTFS package Required for BIOS USB Host functionality RTFS package is needed for supporting MSC devices such as USB sticks USB HDD s etc III PSP_DRI...

Page 9: ...n the sample application project for referring to libraries of PSP components like block media PSC platforms MMC SD NAND I2C etc Please ensure that this environment variable is pointing to the install directory of PSP component intended to be used along with this package eg If BIOSPSP package is installed into c pspdrivers_1_30_00_06 the environment variable is set to PSP_DRIVERS_INSTALL_DIR c psp...

Page 10: ... 21 BIOSUSB User Guide 3 Folder Structure Figure 1 illustrates the folder structure and placement of the BIOS USB package Figure 1 BIOSUSB directory structure The folder biosusb contains the following components ...

Page 11: ...xtension C apps This folder contains the USB application for device host a devmscglue This folder contains the USB device MSC glue application source documentation and binary Debug and Release modes MSC glue application supports storage device exposition over USB Platform acting as MSC device to a USB host D example This folder contains the example for USB device or host for C6747 C6748 platforms ...

Page 12: ...omponent also implements the hub driver and the host controller driver functionality for both USB1 1 Host Controller OHCI and USB2 0 controller MUSB 4 2 Host Class MSC Driver The host mass storage class driver component ti biosusb host mass a674 provides the capability to communicate with external USB mass storage devices such as thumb drives It supports the SCSI command protocol for communication...

Page 13: ...liverable Note The host stack component libraries are located at biosusb host Host Stack Component Library Name Depends On Host Core Stack ti biosusb host core a674 ti biosusb host jos a674 Host MSC Class Driver ti biosusb host mass a674 ti biosusb host core a674 ti biosusb host jos a674 Host HID Class Driver ti biosusb host hid a674 ti biosusb host core a674 ti biosusb host jos a674 Host Generic ...

Page 14: ... Storage Functionality The following libraries are required to build a USB host mass storage functionality These libraries are available in Release mode in the directory biosusb host Release A ti biosusb host core a674 B ti biosusb host mass a674 C ti biosusb host jos a674 D ti biosusb host portcom a674 E ti biosusb host port a674 4 10 Use Case USB Host HID Functionality The following libraries ar...

Page 15: ...he device mass storage function driver component provides the capability to expose mass storage device functionality to the USB host It supports the SCSI command protocol for communication with the USB host 5 3 Device HID Function Driver The HID function driver component provides the capability to expose HID device interface functionality to the USB host 5 4 Device Generic Services The USB device ...

Page 16: ...B device stack components Table 4 lists the build options that have been used to build the device stack components that are available in the BIOS USB product Configuration Option Configuration Value 1 CONFIG_PORT Dsp_bios 2 CONFIG_MEMPOOL 1 3 CONFIG_MEMPOOL_SIZE 500000 4 CONFIG_MEMPOOL_DMABLE 1 5 CONFIG_MUSBHSFC 1 6 CONFIG_ JSLAVE 1 7 CONFIG_BYTE_ORDER CPU_LITTLE_ENDIAN 8 CONFIG_ALIGN_CRITICAL 1 9...

Page 17: ...osusb device Release A ti biosusb device core a674 B ti biosusb device fd a674 C ti biosusb device jos a674 D ti biosusb device port a674 E ti biosusb device portcom a674 5 9 Use Case USB Device HID Functionality The following libraries are required to build USB device HID function driver These libraries are available in Release mode in the directory biosusb device Release A ti biosusb device core...

Page 18: ...ted project Set Project configuration to Debug Release mode 3 Build the project in Release Debug mode Switch to Debug window by selecting Debug Perspective window click on window open perspective Debug and load the executable 4 Run the application program by pressing F8 key 6 1 Building the USB MSC Device example for NAND OR MMC SD OR SATA Below steps details how to build the USB device mass stora...

Page 19: ...le application from INSTALL_DIR biosusb_xx_yy_zz packages ti biosusb examples usbdevhid b uild C6747 C6748 ccs3 usb_dev_hid_sample pjt Set Project configuration to Release mode 3 Build the project in Release mode the executable file will be created in the INSTALL_DIR biosusb_xx_yy_zz packages ti biosusb examples usbdevhid b uild C6747 C6748 bin Release folder 4 Load the devhid_sample out file from...

Page 20: ...48 ccs3 usb_host_hid_sample pjt Set Project configuration to Release mode 3 Build the project in Release mode the executable file will be created in the INSTALL_DIR biosusb_xx_yy_zz packages ti biosusb examples usbho sthid build C6747 C6748 bin Release folder 4 Connect the USB mouse keyboard to USB port USB0 or USB1 directly or through HUB 5 Load the hosthid_sample out file from the Release folder...

Page 21: ...21 of 21 BIOSUSB User Guide 7 Technical Support BIOSUSB To submit questions about issues with this BIOSUSB drivers release please go to the external forums at http community ti com or to http support ti com ...

Reviews: