User guide

Speedway Reader IPJ-R1000 for Gen 2 UHF RFID

6.5. Image Management Command

6.5.1. Invoking an Upgrade

An upgrade can be triggered in any one of the following scenarios:

• The user can invoke the Rshell command config image upgrade to instruct the reader to enter push mode and directly

download the upgrade image file from the specified URI and perform an upgrade with the image downloaded. See

section 7.4.2.5 for details.

• The user can invoke the Rshell command config image metafile to instruct the reader to enter pull mode, download a

metafile from the specified URI, and perform an upgrade based on the metafile Regardless of the upgrade status, the

reader remembers the URI for future use. See section 7.4.2.3 for details.

• The user can invoke the Rshell command config image retrievemode to manually set the retrieve mode of the reader.

If the retrieve mode is set to pull via this command and the reader has a valid metafile URI, the reader will

immediately attempt to retrieve the metafile via the URI. If metafile retrieval fails, the reader will retry periodically

based on the retrieve period specified in the command. See section 7.4.2.4 for details.

6.5.2. Factory Default Restoration

The following command can be used to restore the Speedway reader's factory default configuration settings associated with the

currently running image:

• The user can use the Rshell command config image factory to return the reader to a factory default configuration.

The command retains the current primary SOP, but defaults the reader’s configuration and erases the reader’s

application. See section 7.4.2.1 for details.

6.5.3. Fallback to Previous Image

The following command can be used to fallback or restore the reader’s previous image in case something was ill affected by

the upgrade procedure:

• The user can invoke the Rshell command config image fallback to restore the reader to its previous image. See

section 7.4.2.2 for details.

6.5.4. Query the Upgrade Status

The following command is used to query the status of upgrades including factory default and fallback:

• The user can invoke the Rshell command show image summary

to view the details of the current primary and

secondary images. This command also shows the status of pending and completed upgrades as well as error codes

indicating the reasons for upgrade failures. See section 7.5.2.1 for details.

• The user can invoke the Rshell command show image metafile

to view the details of the current retrieve mode and

metafile data. See section 7.5.2.1 for details.

6.5.5. Background Execution of Image Management Commands

Some image management commands are executed in the background and are not finished right away. If a previous image

management command is still being processed, a subsequent image management command will be rejected with a command

response code of “Previous-Command-In-Progress”. The following image management commands have this

behavior:

config image metafile

config image upgrade

config image factory

During the execution of these image management commands, the reboot command will also be rejected with the “Previous-

Command-In-Progress” error unless the force option is applied. All other config image and show image commands are