How to Configure Region of Operation for Impinj R700

To support the needs of the global RAIN RFID community, Impinj R700 provides a choice of regulatory region settings to facilitate user compliance based on their region. For example, the Thailand regulatory region setting only allows RF transmission in the 920-925 MHz band, in accordance with the regulations of the Thailand’s Nation Broadcasting and Telecommunications Commission.[1]

This support article will show you how to update the regulatory region on the Impinj R700 RAIN RFID reader using three methods: the Reader Management web UI, the reader's RShell, and the reader configuration REST API. Take your time and read each instruction carefully. In this example, we will be using the global reader model. New Impinj R700 readers require that users set their regulatory region before operation is allowed. 

NOTE: The RF settings must match the country/region of operation to comply with local laws and regulations. The user is responsible for ensuring that the RF settings are correctly set. The user is solely responsible for any fines or other damages resulting from incorrect or non-compliant country/region settings on the reader. For some regions and transmit powers the user may be required to apply for and obtain a license from the local regulatory agency. Review local regulatory requirements before use. By proceeding the user acknowledges these responsibilities.

Prior to Configuration

Step 1: Connect the Impinj R700 Reader

Make sure the Impinj R700 reader is connected to your network, and that you can access it through a web browser. Consult the Impinj R700 Installation & Operations Guide if you need detailed instructions.

Step 2: Upgrade the Firmware

Impinj R700 reader firmware version 7.4 or greater is required to change the regulatory region. If you haven't already done so, upgrade Impinj R700 to the latest firmware.  Consult the Impinj R700 Installation & Operations Guide if you need detailed instructions.

Configuration Using Reader Management Web UI

Step 1: Navigate to the Reader Management web page. 

Open a web browser and type in either the reader’s hostname or IP address into the URL as follows: http://<Hostname or Static IP>.

Use the ‘root’ user credentials (default password 'impinj') to log in to the Impinj R700 Reader Management web UI.

mceclip0.png

Step 2: Check the Regulatory Region Setting (Optional)

Once you are logged in, you’ll be able to see the Reader Management interface. You can check the current regulatory region setting in the “Details” section. In this example, the regulatory region setting is “None – RFID Disabled,” which is the default for new Impinj R700 readers with Impinj R700 firmware version 7.4 or greater.

mceclip1.png

Step 3: Select the New Regulatory Region

An Impinj R700 reader with the latest firmware will have a dedicated “Change Regulatory Region” section on the right. (If this section is not visible, the Impinj R700 firmware might not be up to date.)

Expand the “Available Regions” dropdown menu and select the regulatory region for your reader. In this example, we select “FCC Part 15.247” for the North America region.

mceclip2.png

mceclip3.png

Step 4: Press Update Region

Once you have selected the new regulatory region, press the “Change Region” button immediately below.

mceclip4.png

This will prompt you to acknowledge sole responsibility for complying with local laws and regulations and for paying any fines or damages resulting from non-compliance when changing this setting.

mceclip0.png

Step 5: Reboot Reader

Now that you have selected a new regulatory region, you must reboot the reader to complete the update, as indicated by a red text message in the “Change Regulatory Region” section.

mceclip6.png

In the “Reader Reboot” section, click the “Reboot” button to initiate a reader reboot.

mceclip7.png

A “RefreshTimer” will show how many seconds are left before the reader reboot is complete.

mceclip8.png

Step 6: Verify New Regulatory Region

After the reader has rebooted, check the “Reader Details” section to verify that the regulatory region changed to the setting you selected.

mceclip9.png

You have now successfully updated the regulatory region on an Impinj R700 reader!

Configuration Through RShell Using PuTTY

Users can access the reader's RShell through any reliable secure shell (SSH) and serial client. In this example, we will be using PuTTY.

Step 1: Confirm PuTTY is Installed

Confirm that you have the latest version of PuTTY. PuTTY version 0.60 or later contains support for serial connections.

Step 2: Connect to Reader RShell through PuTTY

Open PuTTY and type in the Impinj R700 hostname/IP address in the "Host Name" textbox. Click "Open" to bring up the RShell. Make sure "SSH" is selected in the "Connection Type" list and the "Port" is set to 22.

mceclip1.png

Use the ‘root’ user credentials (default password 'impinj') to log in to the reader's RShell.

mceclip7.png

mceclip8.png

Step 3: Show System Region

Use the following RShell command to review the system's current regulatory region setting, the full list of selectable region settings, and the numerical code to select a region.

> show system region

In our example, the Impinj R700 global reader will output the following options:

mceclip9.png

The "OperatingRegion" shows the numerical code for the current regulatory region setting. The region numerical code appears in the string associated with each selectable region, adjacent to the textual description of that region. For example, the Brazil Regulatory region (902-907 and 915-928 MHz) is listed as SelectableRegion2, and the region numerical code is 13. The current "OperatingRegion" number is '255', which means the current regulatory region setting is "None - RFID Disabled." 

Step 4: Select a New Region

Use the RShell command 'config system region [#]' to select a new regulatory region, where [#] is the region numerical code as shown in the selectable region list above. In this example, we select “FCC Part 15.247” for the North America region, which has a region numerical code of 0.

> config system region 0

If the command is successful, RShell will output a "reboot required" success status.

mceclip10.png

Step 5: Reboot Reader

As the success status indicated, the Impinj R700 reader requires a reboot to complete the new regulatory region configuration. Use the following RShell command to reboot the reader:

> reboot

If the command is successful, RShell will issue a success status.

mceclip11.png

(Note: Your Impinj R700 reader will disconnect from PuTTY while rebooting. When this happens, RShell will issue an error message saying the network connection unexpectedly closed.)

mceclip12.png

Step 6: Verify System Region Setting

To verify that you set the regulatory region correctly, you can use the "show system region" command again. When your reader disconnected from PuTTY while rebooting, you can use PuTTY to reconnect to your reader's RShell. 

mceclip13.png

The "OperatingRegion" now shows a numerical code 0, which means the current regulatory region setting is now FCC.

You have now successfully updated the regulatory region on an Impinj R700 reader!

Configuring Using the Curl Tool on REST API Endpoints

Impinj R700 firmware version 7.4 and greater has new /system endpoints that can be used to configure device parameters through the reader configuration REST API (formerly known as RESTful Interface). These include GET and PUT methods for the region of operation, and a POST method to reboot the reader. 

There are several ways to send REST API requests. In this example we will be using curl, a command-line tool for transferring data through various protocols using HTTP/HTTPS and which is available through the Microsoft Windows command prompt (cmd.exe).

Step 1: Ensure HTTPS is Enabled

Impinj R700 firmware version 7.4.1 requires that HTTPS is enabled before accessing the /system endpoints. If your reader is set to HTTP and not HTTPS, the request will return with the error message: "The request is only allowed via HTTPS. Please make sure the HTTPS service is enabled on the reader."

For more information on how to disable HTTP and enable HTTPS, consult the following support article: How to configure HTTP and HTTPS on the Impinj R700 Reader

Step 2: Use Curl to Check Regulatory Region (Optional)

Open the Windows command prompt. To check your reader's regulatory region using curl, issue the following command, where impinj-xx-xx-xx is the reader hostname and root:impinj are the login credentials. 

curl -k https://root:impinj@impinj-xx-xx-xx/api/v1/system/region

Note that the "-k" argument is necessary to access the endpoint. Otherwise curl will not trust the root and will issue a security error: "InitializeSecurityContext failed: SEC_E_UNTRUSTED_ROOT (0x80090325) - The certificate chain was issued by an authority that is not trusted." 

(The reader uses a self-signed certificate which curl will flag as not trusted. The "-k" argument informs curl to skip certificate validation. Curl will still utilize TLS encryption when accessing the endpoint.)

If the curl command is successful, curl will perform a GET method on the /system/region endpoint and output the reader's current operating region as well as a full array list of the selectable regions in JSON format.

OperatingRegionList.png

In the above example, the current regulatory region is "None- RFID Disabled", and the selectable regions of the Impinj R700 FGX reader are shown.

Step 3: Use Curl to Input New Regulatory Region

To change the regulatory region through the REST API, the user must use a PUT method to pass a new operating region value in JSON format to the /system/region endpoint.

mceclip0.png

To do so using curl, you need to specify the PUT method using a -X argument, the JSON content type using a -H argument, and the new operation region value in JSON format using a -d argument. 

Below is a curl code example that will change the reader to the FCC region for North America, where impinj-xx-xx-xx is the reader hostname and root:impinj are the reader credentials. Use this code example as a reference for formatting your curl method.

curl -X PUT -H "Content-Type: application/json" -d "{\"operatingRegion\":\"FCC Part 15.247\"}" -k https://root:impinj@impinj-xx-xx-xx/api/v1/system/region

If the curl command is successful, the reader will reply with the message: "System reboot is required for the new configuration to take effect."SystemReboot.png

Step 4: Use Curl to Reboot Reader

To restart the reader through the API, the user must use a POST method to call the /system/reboot endpoint. Issue the following command, where impinj-xx-xx-xx is the reader hostname and root:impinj are the reader credentials.

curl -X POST -k https://root:impinj@impinj-xx-xx-xx/api/v1/system/reboot

If the curl command is successful, the reader will give a null reply ("{}"), indicating that it has begun to reboot. Wait for one minute before issuing new commands to the reader, because the reader will be unresponsive during its reboot.

Step 5: Use Curl to Verify Regulatory Region

To verify that the regulatory region was inputted correctly, you can use curl after the reboot. Issue the following command, where impinj-xx-xx-xx is the reader hostname and root:impinj are the reader credentials.

curl -k https://root:impinj@impinj-xx-xx-xx/api/v1/system/region

Once again, the curl command will output the current operating region and a list of the selectable regions. In our example, the operating region is successfully changed to FCC.

mceclip1.png

You have now successfully updated the regulatory region on an Impinj R700 reader!

[1] https://www.gs1.org/docs/epc/uhf_regulations.pdf

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Article is closed for comments.