Saving the ROSpec and Reader Configuration

When you're trying to debug LTK or Octane SDK software issues, it can be very helpful to view the reader's ROSpec and configuration in XML format. If you contact Impinj for support, we'll often ask you to pull this information and save it to a file. It's a great way to verify that your software has configured the reader as intended.

To do this, you'll need a telnet or ssh utility that can log its output to a file. Putty is a good choice on Windows. The screenshot below shows how to configure Putty for a reader connection.



Make sure you have the logging option set to "All session output". By default, Putty will save its output to a text file called putty.log.



Once you click the Open button, you will be prompted to login. The user name is impinj and the password is root. After logging in, you should see a command prompt (>).



To pull the ROSpec, issue this command and press enter:

show rfid llrp rospec 0

The reader will return the ROSpec as XML (partial listing show below for brevity).

<?xml version="1.0"?>
<GET_ROSPECS_RESPONSE
xmlns="http://www.llrp.org/ltk/schema/core/encoding/xml/1.0"
xmlns:Impinj="http://developer.impinj.com/ltk/schema/encoding/xml/1.8"
xmlns:IpjInt="http://internal.impinj.com/RFID/Engineering/LLRP/ltk/schema/encoding/xml/1.8"
MessageID="0">
<LLRPStatus>
<StatusCode>M_Success</StatusCode>
<ErrorDescription></ErrorDescription>
</LLRPStatus>
<ROSpec>
<ROSpecID>1234</ROSpecID>
<Priority>0</Priority>
<CurrentState>Disabled</CurrentState>
<ROBoundarySpec>
<ROSpecStartTrigger>
<ROSpecStartTriggerType>Immediate</ROSpecStartTriggerType>
</ROSpecStartTrigger>
<ROSpecStopTrigger>
<ROSpecStopTriggerType>Null</ROSpecStopTriggerType>
<DurationTriggerValue>0</DurationTriggerValue>
</ROSpecStopTrigger>
</ROBoundarySpec>
<AISpec>
<AntennaIDs>1 2 3 4</AntennaIDs>
<AISpecStopTrigger>
<AISpecStopTriggerType>Null</AISpecStopTriggerType>
<DurationTrigger>0</DurationTrigger>
</AISpecStopTrigger>

Next, you can view the reader configuration with this command:

show rfid llrp config

As with the ROSpec, the reader configuration is returned as XML.

<?xml version="1.0"?>
<GET_READER_CONFIG_RESPONSE
xmlns="http://www.llrp.org/ltk/schema/core/encoding/xml/1.0"
xmlns:Impinj="http://developer.impinj.com/ltk/schema/encoding/xml/1.8"
xmlns:IpjInt="http://internal.impinj.com/RFID/Engineering/LLRP/ltk/schema/encoding/xml/1.8"
MessageID="0">
<LLRPStatus>
<StatusCode>M_Success</StatusCode>
<ErrorDescription></ErrorDescription>
</LLRPStatus>
<Identification>
<IDType>MAC_Address</IDType>
<ReaderID>001625FFFF102532</ReaderID>
</Identification>
<AntennaProperties>
<AntennaConnected>true</AntennaConnected>
<AntennaID>1</AntennaID>
<AntennaGain>0</AntennaGain>
</AntennaProperties>
<AntennaProperties>
<AntennaConnected>false</AntennaConnected>
<AntennaID>2</AntennaID>
<AntennaGain>0</AntennaGain>
</AntennaProperties>
<AntennaProperties>
<AntennaConnected>false</AntennaConnected>
<AntennaID>3</AntennaID>
<AntennaGain>0</AntennaGain>
</AntennaProperties>
<AntennaProperties>
<AntennaConnected>false</AntennaConnected>
<AntennaID>4</AntennaID>
<AntennaGain>0</AntennaGain>
</AntennaProperties>
<AntennaConfiguration>
<AntennaID>1</AntennaID>
<RFReceiver>
<ReceiverSensitivity>1</ReceiverSensitivity>
</RFReceiver>
<RFTransmitter>
<HopTableID>1</HopTableID>
<ChannelIndex>0</ChannelIndex>
<TransmitPower>81</TransmitPower>
</RFTransmitter>

When you're done, use the exit command to end the session. The ROSpec and reader configuration are saved in the putty.log file. You can view the file in any text editor. This video covers this process in even more detail.