Home
QNX Software Development Platform
QNX SDP is a cross-compiling and debugging environment, including an IDE and command-line tools, for building binary images and programs for target boards running the QNX OS 8.0.
OS Components & Operations
Customizing a BSP
While QNX provides Board Support Packages (BSPs) for many common platforms and their individual variants, in some cases, you need a BSP for a board that QNX does not provide. If this is the case, you can modify a QNX BSP or develop your own.
I2C
Application interfaces
Resource manager interface
DCMD_I2C_STATUS

QNX Momentics IDE User's Guide
This User's Guide describes version 8.0 of the Integrated Development Environment (IDE) that's part of the QNX Tool Suite.
QNX Software Development Platform
QNX SDP is a cross-compiling and debugging environment, including an IDE and command-line tools, for building binary images and programs for target boards running the QNX OS 8.0.
- Quickstart Guide
- System Architecture
  The System Architecture guide accompanies the QNX OS and is intended for both application developers and end-users.
- OS Components & Operations
  - Boot Optimization Guide
    The Boot Optimization Guide describes techniques you can use to reduce the time from your board's initial power on until you have a fully functional QNX system running on the board.
  - Building Embedded Systems
    The Building Embedded Systems guide is intended for developers who are developing or building BSPs for QNX OS embedded systems.
  - Customizing a BSP
    While QNX provides Board Support Packages (BSPs) for many common platforms and their individual variants, in some cases, you need a BSP for a board that QNX does not provide. If this is the case, you can modify a QNX BSP or develop your own.
    - Prerequisites
    - The development process
      BSP development begins with a reference BSP from QNX.
    - OS Image Buildfiles
    - Startup
    - Graphics
    - I2C
    - USB
    - Networking
    - Serial port
    - SPI
    - DIM
  - Device Publishers Developer's Guide
  - High Availability Framework Developer's Guide
  - High-Performance Networking Stack (io-sock) User's Guide
    This guide contains instructions for implementing and using the QNX OS High-Performance Networking Stack and its manager, io-sock.
  - PCI Server User's Guide
  - Performance Tuning User's Guide
  - QNX Filesystem for Safety User's Guide
  - SMMUMAN User's Guide
  - System Analysis Toolkit (SAT) User's Guide
  - Technotes
  - User's Guide
    The QNX OS User's Guide is intended for all users of a QNX OS system, from system administrators to end users.
- Graphics
- Programming
- System Security Guide
  The QNX System Security Guide is intended for both system integrators who are responsible for the security of a QNX OS system and developers who want to create a QNX OS resource manager free from vulnerabilities.
- Utilities & Libraries
- Migrating to QNX OS 8.0
QNX Software in the Cloud
QNX Software in the Cloud enables developers to use the QNX OS in the Amazon cloud environment.
QNX Toolkit for Visual Studio Code
This User's Guide describes the QNX^® Toolkit for Visual Studio Code. The guide introduces you to the QNX Toolkit by explaining the QNX development environment and how to build, run, and debug your QNX^® Operating System (OS) applications and systems.
QNX Hypervisor User's Guide
This User's Guide explains the QNX hypervisor architecture and provides instructions for installing and running a QNX Hypervisor system, changing system components and configuration, and using hypervisor features such as virtual devices (vdevs).
Typographical Conventions, Support, and Licensing
This section describes the typographical conventions used throughout the documentation, explains how to obtain technical support, and provides some information about licensing.

DCMD_I2C_STATUS

QNX SDP8.0Customizing a BSPConfigurationDeveloper

#include <hw/i2c.h>

#define DCMD_I2C_STATUS             (__DIOF (_DCMD_I2C, 9, i2c_status_t))

The arguments to devctl() are:


Argument	Value
`filedes`	A file descriptor that you obtained by opening the device.
`dcmd`	DCMD_I2C_STATUS
`dev_data_ptr`	A pointer to an i2c_status_t
`n_bytes`	sizeof(i2c_status_t)
`dev_info_ptr`	NULL

The DCMD_I2C_STATUS command gets the status of the device.

Input

None.

Output

The status; one of:

I2C_STATUS_DONE: The transaction completed (with or without an error).
I2C_STATUS_ERROR: An unknown error occurred.
I2C_STATUS_NACK: Slave no-acknowledgement.
I2C_STATUS_ARBL: Lost arbitration.
I2C_STATUS_BUSY: The transaction timed out.
I2C_STATUS_ABORT: The transaction was aborted.

Page updated: August 11, 2025