Enabling the USB Manager library's host/OTG functions

The functionality described in this document is for OTG-enabled Symbian phones only.

If you are using Symbian's USB host/OTG stack, then you need to build a particular executable into the ROM to make the USB Manager's host/OTG functions available to your USB control application. This document tells you how to do this.

Purpose

The Symbian USB Manager OS component is implemented according to Symbian's client-server architecture. If the device you are running it on includes the Symbian USB host/OTG stack, then you need to make sure the server-side of USB Manager's client-server pair is provided by the executable usbsvrotg.exe (instead of usbsvr.exe). The purpose of this executable is to provide the USB Manager functionality for controlling host/OTG services on a Symbian device. For more information about these two files, see The USB Manager Library overview.

Intended Audience

This document is for Symbian licensees who are implementing USB services, including host and On-The-Go services, on a Symbian device.

Required Background

To perform the instructions in this document you need to understand how to build a ROM image (see Tools: ROM building).

For details of, and links to, the USB and On-The-Go (OTG) specifications on the USB Implementers Forum website, see USB Manager library.

Setup and Configuration Requirements

The device you are designing needs to have had Symbian's low-level USB host/OTG stack ported to it.

Using the host/OTG version of the USB Manager server

Basic Procedure

The high-level steps for making sure the USB host/OTG version of USB Manager's server-side executable is included in the ROM are shown here:

  1. Run the buildrom command with a special parameter for including usbsvrotg.exe in the ROM.

  2. Copy the ROM image onto the target hardware

Putting the correct server-side executable into the ROM

Running the buildrom command with a special parameter

Copying the ROM image onto the target hardware

To copy the ROM image onto your target hardware:

  1. Check that the files included in the ROM image are correct (and particularly that the usbsvrotg.exe file has been included and that you are satisfied with their locations in the ROM image.

    To do this, inspect the .dir file which is amongst the five files that are output by the buildrom command. The .dir file lists all the files included in the ROM image and specifies both their source location (in the lefthand column) and their target location in the ROM image (in the righthand column).

  2. Rename the .IMG file to sys$rom.bin.

  3. Transfer the sys$rom.bin file on to your target hardware. (If you are using a hardware reference platform, copy it onto a memory card and insert the memory card into the correct slot on the board.)

Related information