Teledyne LeCroy Protocol PCI Express Script Automation Test Tool User Manual

Page 19

Advertising
background image

Teledyne LeCroy

PCI Express Script Automation Test Tool User Manual

15

2.5.2.2.2 Module Installation

You must have root privileges to install the module. Preferably, use the sudo command to install the module with
root privileges. During installation, you can pass optional commands to control the module.

$ sudo insmod pcide.ko <option=0|1>


The available options are:
poll=1

poll=1 is for module to poll Device Emulator commands.
poll=0 is for module to use an interrupt.
If you omit this parameter, default is 0.
Important: Use the poll=1 polling mode when testing with the Summit Z2 Trainer traffic
generator. Use the poll=0 interrupt mode for all other cases.

msi=1

msi=1 is for MSI mode interrupts.
msi=0 is for legacy interrupts. Legacy interrupts are ignored if you use the poll=1 option.
If you omit this parameter, default is 0.
Note: This setting is currently not in use.

debug=1

debug=1 prints verbose debug messages to the system or kernel logging file.
debug=0 prints normal messages.
If you omit this parameter, default is 0.

mcfg=<ADDRESS>

Use decimal or hexadecimal (prefixed with “0x”) for the root port configuration space
address. The system uses this address only if the module does not find the value.

aer=<ADDRESS>

Use decimal or hexadecimal (prefixed with “0x”) for the root port advanced error reporting
space address. The system uses this address only if the module does not find the value.


An example of module installation with options is:

$ sudo insmod pcide.ko debug=1 poll=1

2.5.2.2.3 Module Removal

To remove the module, type:

$ sudo rmmod pcide


Using the above methods, the module does not stay loaded in memory. You must install the module after each
reboot. To

To install the module so that it stays loaded in memory, you can:

o

Call the sudo insmod … command from a script run at boot time with root privileges.

o

Copy the pcide.ko file into the path /lib/modules/$(uname –r) where it will load automatically.
$(uname –r) will resolve into the particular kernel version number that is currently running.













Advertising