Introduction
This introduction provides an overview of QNX Everywhere, how to get a QNX Software Development Platform license, and where to get support.
Self-Hosted Developer Desktop Guide
This guide provides instructions for building applications on QNX OS 8 using the self-hosted desktop, without the need for cross-compilation. It's built on the XFCE (XForms Common Environment) desktop environment, allowing QNX Everywhere users to start building QNX apps with minimal setup and friction.
Quick Start Target Image (QSTI)
This guide provides instructions on how to set up the Quick Start Target Image (QSTI) on a Raspberry Pi.
Custom Target Image (CTI)
This guide provides instructions on how to set up the Custom Target Image (CTI) on a Raspberry Pi.
Interfacing with your hardware
This chapter describes how to communicate with your given hardware.
The QNX Porting Guide
This guide provides comprehensive information on porting software from Linux to QNX.
Driver Development Kit (DDK) Developer's Guide
The Driver Development Kit (DDK) Developer's Guide is for developers who build device drivers for the QNX OS.
- Character I/O and UART (Universal Asynchronous Receiver Transmitter) DDK
  - Developing a char driver
  - Starting the char driver
  - Interfacing with the driver
  - io-char library reference
    - Macros
      - dev_lock()
        Lock a device
      - dev_unlock()
        Unlock a device
    - dev_cleanup()
      Clean up a device
    - drain_check()
      Check if a device has been drained
    - iochar_send_event()
      Send a pulse event into io-char's event handler
    - iochar_tick_cnt()
      Calculate tick count
    - kick()
      Kick the output driver into life
    - timer_queue()
      Add an entry to the io-char timer queue
    - timer_remove()
      Remove an entry from the io-char timer queue
    - ttc()
      Configure the terminal's settings
    - tti()
      Pass data, or error and control codes to io-char
    - tti2()
      Pass a data buffer, or error and control codes to io-char
    - tto()
      Give output buffer data to hardware
    - tto_checkclients()
      Check client lists for notify conditions
    - tto_getchar()
      Get the first character from the output buffer to process
    - tto_write_block()
      Store bytes in a buffer
    - tty_init_lock()
      Initialize the TTYCTRL locking mechanism
    - tty_lock()
      Lock the TTYCTRL structure to prevent modification by other threads
    - tty_unlock()
      Unlock the TTYCTRL structure to allow modifications by other threads
    - TTYBUF
      Implement a circular buffer for character I/O operations
    - TTYCTRL
      Tty control structure
    - TTYDEV
      Structure for a tty device
    - TTYINIT
      Structure used to initialize a tty device
    - TTYINITPTY
      Structure for initialization and configuration of pty devices
    - TTYWAIT
      Structure to track and manage clients that are waiting for I/O operations on terminal devices
    - tx_inject()
      Inject a character at the front of the output buffer
    - wait_add()
      Add a new wait entry to the client message buffer
    - wait_remove_rcvid()
      Remove the receive ID matching the wait entry
  - Stub io-char driver
  - Raspberry Pi 4 mini UART driver example
- Inter-integrated circuit (I2C) DDK
- Serial peripheral interface (SPI) DDK
- Human interface device (HID) DDK
- Touch DDK

dev_lock()

Lock a device

Synopsis:

#include <sys/io-char.h>

#define dev_lock(dev)

Arguments:

dev: The device to be locked.
Note:
This argument is ignored and locking is done on the TTYCTRL structure instead

Description:

Lock the device. Locks the TTYCTRL structure global variable ttyctrl. Requires that TTYCTRL structure is in scope, named as ttyctrl.

Page updated: January 08, 2026