Hardware Resource Manager Overview

This section gives a brief overview of Hardware Resource Manager (HWRM) component.

Hardware Resource Manager (HWRM) is a client-server solution, which utilizes ECom plug-ins to achieve device independency. ECom plug-ins convert the client requests into the hardware control commands.

Purpose

HWRM performs the following functions:

  • Provide client APIs to control lights, vibra.

  • Retrieve battery information of the device.

  • Publish certain power-state related Publish and Subscribe properties.

  • Enable clients to retrieve status information on the hardware elements such as light, vibration, power.

Required background

Knowledge of the client-server architecture, asynchronous processing, and active objects feature of the Symbian system model architecture.

HWRM architecture

HWRM provides client APIs that can control various hardware elements. It also provides callback pointers, so that the client applications can register to receive notification on the hardware status changes. Refer to the tutorials for information on how to use client APIs. Client APIs are useful for both application developers and the handset manufacturers.

APIs

The HWRM provides the following client APIs and plug-in APIs:

Class Description

CHWRMLight

Abstract class defining Lights client API.

CHWRMVibra

Abstract class defining Vibra client API.

CHWRMPower

Class defining Power client API.

Typical use cases

HWRM is used for the following:

  • Used to configure a plug-in.

  • Start/stop device vibra.

  • Release the reserved lights

  • Retrieve the supported light targets of the device, current light status, vibra settings and status.

  • Reserve light targets, device vibra.

  • Switch ON/OFF the lights.

  • Request for tactile vibration pulse.