7.2. QNX Neutrino

7.2.1. Thread priority

QNX supports a total of 256 scheduling priority levels. A non-root thread can set its priority to a level from 1 to 63 (the highest priority).

Using priorities higher than 63 is only possible if the allowed priority range is changed for non-root processes:

procnto -P priority

For more information’s about changing the priority range refer to the QNX documentation.

Attention

Don’t changing the priority range leads to bad timing performance!

7.2.2. Unbind Ethernet Driver instance

The network interface must be unloaded if it is used by an operating system driver. Depending on the QNX version, a corresponding command must be executed in the QNX Shell or the QNX Build Script.

QNX >= 6.5
ifconfig en1 destroy
QNX >= 7.1
umount /dev/io-sock/devs-em.so/em1

7.2.3. IOMMU/SMMU support

For systems that have to use an IOMMU/SMMU for security reasons, it is possible to create predefined typed memory region that is used by the Real-time Ethernet Driver. The definition has to be done in the QNX BSP build file and the name must match following pattern:

smm_ LinkLayerName - InstanceNumber(32Bit Hex)

Example: Real-time Ethernet Driver emllIntelGbe with instance number 1
smm_emllIntelGbe-0x00000001

A separate typed memory region must be defined for each Real-time Ethernet Driver instance. The typed memory is automatically used by the Real-time Ethernet Driver if it matches the pattern, otherwise the default memory is used.

7.2.4. Setting up and running EcMonitorDemo

  1. QNX Neutrino OS configuration

    In order to get real-time priority (e.g. 250), see Thread priority and also set JOBS_PRIORITY. The applications needs root privileges to increase the priority above 63.

  2. Unbind Ethernet Driver instance, e.g.

    ifconfig en1 destroy
    
  3. Copy files from EC-Monitor package /bin and eni.xml to directory, e.g. /tmp.

  4. Adjust LD_LIBRARY_PATH search locations for Real-time Ethernet Driver if necessary, e.g.

    export LD_LIBRARY_PATH=/tmp:$LD_LIBRARY_PATH
    
  5. Run EcMonitorDemo

    cd /tmp
    ./EcMonitorDemo -intelgbe 1 1 -f eni.xml
    

7.2.5. OS Compiler settings

Besides the general settings from Compiling the EcMonitorDemo the following settings are necessary to build the example application for QNX Neutrino.

Extra include paths
<InstallPath>/SDK/INC/QNX
<InstallPath>/Examples/Common/QNX
Extra source paths
<InstallPath>/Examples/Common/QNX
<InstallPath>/Sources/OsLayer/QNX
Extra library paths to the main EtherCAT® components
<InstallPath>/SDK/LIB/QNX/<Arch>
Extra libraries
socket