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
If your Impinj R700 runs the firmware version 8.x, click here.
If your Impinj R700 runs the firmware version 7.x, click here.
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, as shown below.
Step 2: Check the Regulatory Region Setting (Optional)
Once you are logged in, you can check the current regulatory region setting. In the example below, the regulatory region is set to "FCC Part 15.247."
Step 3: Select the New Regulatory Region
To select the regulatory region, click "Change Region" button, as shown below. "Change Operating Region" popup window appears.
In "Change Operating Region" popup window, click "Available Regions" dropdown menu and select the regulatory region for your reader, and click "Change Region" button on the right.
Step 4: Click Change Region Button
Once you have selected the new regulatory region, click the “Change Region” button on the right, as shown below.
"Operating Region updated to xxxxxx" message briefly appears at the bottom right corner of the web UI, confirming that the regulatory region setting is successfully changed.
Step 5: Reboot Reader
Now that you have selected a new regulatory region, you must reboot the reader to complete the update, as shown below.
Click Reboot Button.
Click "Reboot" again when asked to confirm.
Step 6: Verify New Regulatory Region
After the reader has rebooted, verify that the regulatory region changed to the setting you selected. In this example, we changed the regulatory region from "FCC Part 15.247" to "Australia 920-926 MHz."
You have now successfully updated the regulatory region on an Impinj R700 reader!
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 IP address>.
Use the ‘root’ user credentials (default password 'impinj') to log in to the Impinj R700 Reader Management web UI.
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.
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.
Step 4: Press Update Region
Once you have selected the new regulatory region, press the “Change Region” button immediately below.
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.
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.
In the “Reader Reboot” section, click the “Reboot” button to initiate a reader reboot.
A “RefreshTimer” will show how many seconds are left before the reader reboot is complete.
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.
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.
Use the ‘root’ user credentials (default password 'impinj') to log in to the reader's RShell.
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:
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.
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.
(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.)
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.
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.
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.
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."
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.
You have now successfully updated the regulatory region on an Impinj R700 reader!
Comments
Article is closed for comments.