/pps/qnx/device/<device>

Directory of status objects for devices attached to the head unit

Publishers
Device publishers (mmcsdpub, usbpub, etc.)
Subscribers
Any app

Overview

When SD cards, USB sticks, or other devices are connected to the computer, PPS objects appear under the /pps/qnx/device/ directory to provide status information and control. In most cases, the status objects are named after the raw devices listed under the /dev directory (e.g., cd0, sda0). For USB devices, object names are of the form:

usb-bus_number.device_number

Note: Control objects have the form device_ctrl (e.g., usb_ctrl). For details see /pps/qnx/device/<device>_ctrl.

Sample CD object

@cd0
bus::CD
device_type::cdrom
media_type::dvd
prevent_media_removal::0
serial::FUJITSU TEN DVD-ROM DV-05FT2
slot_state::ready
slot_status::0/0/0
temperature_state::normal
temperature_value::21

Attributes for CD objects

Attribute Description
active_slot For media changers, the active slot number (if provided).
bus Bus type.
device_type Type of device:
  • cdrom (single disc player)
  • changer (multiple disc player)
media_type Type of media:
  • blank
  • audio
  • dvd
  • cd
prevent_media_removal Indicates whether media may be removed:
  • 0 (allow removal)
  • 1 (prevent removal)
serial Device-specific identifier reported by the driver.
slot_state Mechanical state of the active slot:
  • empty
  • loading
  • ready
  • ejecting
  • ejected
slot_status Key/ASC/ASCQ (often device-specific) codes reported by the drive. For example, on a Fujitsu DVD-ROM DV-05-30:
  • 2/62/0 (unreadable disk)
  • 2/4/1 (loading)
  • 0/0/0 (ready)
  • 2/4/2 (ejecting)
  • 2/4/0 (ejected)
  • 2/58/0 (empty)
  • 4/83/0 (failed to load or unload)
slots_avail For media changers, the number of slots available.
present_at_startup Indicates whether the media was present when the drive publisher started:
  • 0 (media was not present)
  • 1 (media was present)
mechanism_state For media changers, the state mechanism:
  • door_open
  • idle
  • audio
  • audio_scan
  • host
temperature_value Temperature (in degrees C) if the drive can report a temperature.
temperature_state Temperature state reported by the drive:
  • normal
  • overtemp
  • undertemp
  • unsupported
temperature_simulation A value of 1 means that simulation is on (no value means no simulation).

Sample SD card object

@sda0
bus::SD
card_type::SD
device_id::DS
locked::no
present_at_startup::no
product_name::SD08G
serial_number::AB00EN18A73
slotname::
speed::24000000
vendor_id::3
write_protection::on

Attributes for MMC/SD card objects

Attribute Description
bus Bus type.
card_type Type of card:
  • SD
  • MMC
device_id Manufacturer ID.
ecc_count Number of times the device driver has reported ECC errors.
locked Indicates whether (yes|no) the card is locked.
present_at_startup Indicates whether (yes|no) the card was present when the driver started.
product_name OEM product name.
serial_number Card serial number.
slotname Slot name passed to the driver.
speed Card speed (in Hz).
status Error status, if an error occurred.
write_protection Indicates status (on|off) of the write-protect switch.

Sample USB object

[n]@usb-1.4
bus::USB
busno::0x01
configuration::1
configurations::1
device_class::0x00
devno::0x04
max_packet_size0::64
product_id::0x1625
serial_number::0019E06B0852A951575A0813
upstream_device_address::1
upstream_host_controller::1
upstream_port::3
upstream_port_speed::High
vendor_id::0x0951

Attributes for USB objects

Attribute Description
bus Type of bus (USB).
busno Bus number (in hex).
configuration Selected configuration.
configurations Number of configurations.
device_class Device class ID (in hex).
device_protocol Device protocol (present only if device_class is not 0x00).
device_subclass Device subclass ID (present only if device_class is not 0x00).
devno Device number.
max_packet_size0 Maximum packet size.
product_id OEM product ID (in hex).
serial_number Product serial number.
upstream_device_address USB address where the device is connected. When connected to a host controller, this is 0; when connected to a USB hub, this is the hub's device address. .
upstream_host_controller Host controller number (usually 0). If you have multiple USB controllers, this is the number of the controller that detected the device.
upstream_port Port number (hub port number or 0 if connected to host controller).
upstream_port_speed Port speed:
  • Full
  • High
  • Low
vendor_id Manufacturer ID (in hex).