in16(), inbe16(), inle16()

Read a 16-bit value from a port

Synopsis:

#include <hw/inout.h>

uint16_t in16( uintptr_t port );

#define inbe16 ( port ) ...

#define inle16 ( port ) ...

Arguments:

port
The port you want to read the value from.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The in16() function reads a 16-bit value from the specified port in native-endian format (there's no conversion required).

The inbe16() and inle16() macros read a 16-bit value that's in big-endian or little-endian format, respectively, from the specified port, and returns the value as native-endian.


Caution: The inbe16() and inle16() macros access the specified port more than once if endian conversion is necessary. This could be a problem on some hardware.

Returns:

A 16-bit value in native-endian.

Classification:

QNX Neutrino

Safety:
Cancellation point No
Interrupt handler Yes
Signal handler Yes
Thread Yes

Caveats:

The calling thread must have I/O privileges; see ThreadCtl()'s _NTO_TCTL_IO command for details.

The calling process must also use mmap_device_io() to access the device's I/O registers.

Both inbe16() and inle16() are implemented as macros.

See also:

in8(), in8s(), in16s(), in32(), in32s(), mmap_device_io(), out8(), out8s(), out16(), out16s(), out32(), out32s()