DCMD_F3S_STATSSR

QNX SDP8.0Devctl and Ioctl CommandsDeveloper

Get the lock status of a secure silicon region

Synopsis:

#include <sys/dcmd_f3s.h>

#define DCMD_F3S_STATSSR    __DIOTF(_DCMD_F3S, F3S_STATSSR, uint32_t)

Arguments to devctl():

Argument Value
filedes A file descriptor that you obtained by opening the device.
dcmd DCMD_F3S_STATSSR
dev_data_ptr An array of type uint32_t
n_bytes The number of entries in the array
dev_info_ptr NULL

Description:

This command gets the lock status of a secure silicon region.

Input:

  • For most flash parts, the OTP area can be locked entirely. So you may pass a 1-byte data buffer to get the lock status of the entire OTP area. A value of 1 means locked, and 0 means unlocked. For example:
    devctl(fd, DCMD_F3S_STATSSR, &stat, 1, NULL);
      
  • For some flash parts, the OTP area is divided into multiple small regions (for example 32), and each region can be locked separately. You may pass a 4-byte data buffer to get the lock stat of all 32 regions. Each bit represents the lock status of each region. For example:
    devctl(fd, DCMD_F3S_STATSSR, &stat, 4, NULL) ;
      

Output:

The lock status.

See also:

DCMD_F3S_LOCKSSR, DCMD_F3S_READSSR, DCMD_F3S_WRITESSR

devctl() in the QNX OS C Library Reference

Page updated: