iochar_regdrv_power()

Register as a power-managed device driver

Synopsis:

#include <sys/io-char.h>

int iochar_regdrv_power(TTYDEV *dev, 
                        TTYINITPOWER *init,
                        unsigned flags);

Arguments:

dev

A pointer to the structure that represents the specific device that data has been received on.

init

A pointer to the structure that represents the power-managed device registration info.

flags

Common power-management flags. One of:

• PWR_INIT_DRVREG — register as a power-managed device.
• PWR_INIT_DRVPSTORE — driver wants its own persistent storage object .
• PWR_INIT_DRVSAVE — driver wants to store data for HWVOL or NORAM
• PWR_INIT_DRVOVERRIDE — driver will assume all setpower functionality.
• PWR_INIT_DRVNOFLOWCTL — driver should delay before powering down for flow control.
• PWR_INIT_NOPMM —indicates that there is no power manager running on initializing.
• PWR_WAITING_DRAIN — a power change is waiting for device to drain.
• PWR_FLOW_PAGED — device is HW or SW paged due to power.
• PWR_EVENT_DEVCTL — check devctl blocking queue.
• PWR_EVENT_DEVWAKEUP — device wants to wake up due to an external event such as a device wakeup event (this is NOT a CPU wakeup) .
• PM_MODE_HW_NONE — power mode does not support any hardware access .
• PM_MODE_HW_TX — power mode allows transmit.
• PM_MODE_HW_RX — power mode allows receive.
• PM_MODE_HW_CTRL — power mode allows control over RTS/DTR lines.
• PM_MODE_HW_REGREAD — power mode allows registers to be read .
• PM_MODE_HW_REGWRITE — power mode allows registers to be written.
• PM_MODE_HW_ALL — power mode allows full device access .
• PM_MODE_HW_RXTX — power mode allows transmit and receive.
• PM_MODE_HW_REG — power mode allows registers to be read and written.
• PM_MODE_HW_DRAIN — power mode allows registers to be read and be transmitted.
• PM_MODE_HW_OFF —OFF modes should not allow any HW access.
• PM_MODE_HW_ACTIVE — ACTIVE modes should allow full HW access.

Description:

This function registers with io-char as a power-managed driver. If you're writing a power-managed device driver, call iochar_regdrv_power() before calling ttc(TTC_INIT_POWER, ...).

Returns:

0

Success.

-1

An error occurred.

Classification:

QNX Neutrino

See also:

TTYDEV, ttc(), tti(), tto()