> For the complete documentation index, see [llms.txt](https://www.opal-rt.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.opal-rt.com/docs/rt-lab/configure-ios/communication-protocol-ios/pickering-driver/pxi-pickering-example.md).

# PXI Pickering Example

## Description <a href="#description" id="description"></a>

The **PXI Pickering** example can be created by starting a new RT‑LAB project. From the menu bar, select **File > New > RT‑LAB Project**. Enter a name and location for your project, then click **Next**. From the available templates list, navigate to **IO > Pickering > PXI** and select **Pickering**, then click **Finish**.

This example demonstrates how to use the **Pickering interface** to program and control a **Pickering PXI programmable resistor card 40‑295‑121‑10/16**.

The Pickering 40‑295‑121‑10/16 card is a programmable resistor module featuring **10 independent subunits**, each providing **16‑bit resolution**. The card allows programming of **10 resistance values**, each within a **0–4 kΩ range**, making it well suited for sensor emulation, automated testing, and hardware‑in‑the‑loop (HIL) applications.

<figure><img src="https://96827845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRdpSk8kjn20gXAexnt6%2Fuploads%2Fgit-blob-e9d62b0b8ac0872995a60b7203dd4de11d0cfe2e%2FDR-rtlab-pickering-ex-pxi.png?alt=media" alt="" width="383"><figcaption></figcaption></figure>

## Requirements <a href="#requirements" id="requirements"></a>

The simulator must be connected to a Pickering **PXI chassis** through a **PCI‑Express (PCIe)** interface, equipped with a Pickering **40‑295‑121‑10/16 programmable resistor card**.

[Verify that an active RT-LAB license](https://www.opal-rt.com/docs/rt-lab/licensing-reference/simulator-license.md) with the following feature is installed on the simulator:

| Feature Name | Required Status | Description                 |
| ------------ | --------------- | --------------------------- |
| PICKERING    | Enabled         | Pickering resistive modules |

## Detailed explanation <a href="#detailedexplanation" id="detailedexplanation"></a>

This example illustrates how to drive a Pickering PXI programmable resistor card directly from a real‑time simulation model. The Pickering driver operates within RT‑LAB and communicates with the PXI hardware over a PCIe link, providing low‑latency and deterministic interaction.

Each subunit of the 40‑295‑121 card is treated as an independent programmable resistor. During execution, resistance values are set by the model and applied to the hardware channels in real time, while channel status information is monitored to confirm correct operation.

### Model preparation and configuration <a href="#modelpreparationandconfiguration" id="modelpreparationandconfiguration"></a>

To prepare and run the example:

1. Review and adjust the Pickering interface parameters as desired. The parameter **Serial number** must be set to match the serial number printed on the front panel of your Pickering card.
2. Build the Pickering model.
3. Load the model and verify that all interface connections have been properly created.
4. Execute the model.
5. Use the console subsystem to interact with the simulation.

## Simulation and results <a href="#simulationandresults" id="simulationandresults"></a>

Once the Pickering interface is properly configured and the model is running on the simulator, resistance values generated by the model are transmitted to the Pickering PXI programmable resistor card through the PCIe interface. These values are applied to the corresponding hardware channels in real time.

Users can modify resistance values through the Console subsystem and verify that the programmed resistances are applied on the physical card. The card pins can be probed using external measurement equipment, such as a multimeter or an oscilloscope, to validate the programmed resistances and confirm correct hardware behavior.

During execution, deterministic communication between the real‑time model and the PXI hardware ensures precise and repeatable resistance control. When the simulation is stopped or reset, the card channels return to their configured default states, leaving the hardware in a known and controlled condition.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://www.opal-rt.com/docs/rt-lab/configure-ios/communication-protocol-ios/pickering-driver/pxi-pickering-example.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
