Requests configuration parameters from a device. A configuration is split into three separate sources:

Sending a <query_setting> without children returns all configuration information for a device, and the complete device configuration is returned. You can use a full <query_setting> reply as a backup of the full configuration of a device.

The settings returned by <query_setting> are arranged in a set of groups called setting groups which logically group associated configuration settings.  The children of <query_setting> are setting groups.

The children of settings groups are field value pairs which make up the actual configuration.  Values are typed and are declared in the RCI descriptor.  See About RCI descriptors for a list of available types.

Optionally, field value pairs can be grouped together when appropriate.  These groupings are called a list.  Alternatively, if an element X inside a setting group has child elements, then element X is a list.  Lists should not be nested more than one deep.


The following attributes are optional but recommended in device implementations.  If a device does not support an attribute, it must behave as if the attribute is ignored and not return an error solely because of an unknown attribute.

Supported attributes must be declared in the RCI descriptor. Devices can also add other attributes specific to their device.  All attributes must be declared in the RCI descriptor.


The source attribute lets a user request the settings from a particular source.  Supported source values:

The default is “current.”


The compare_to attribute works with the source attribute to return only the differences from the compare_to settings and the settings source specified in source. For example, to return only the settings that are different from defaults, issue this request:

<rci_request version=”1.1”>
  <query_setting source=”current” compare_to=”defaults”/>

Supported compare_to values include:


<rci_request version=”1.1”>

<rci_reply version=”1.1”
  <serial index=”1”> <!—setting group “serial”, serial port# 1-->
   <baud>300</baud>   <!—field, value pair (baud, 300) -->
   <serial index=”2”>
  <routing>    <!—setting group “routing”, index # 1 implied -->
   <acl index=”1”>    <!—ACL is a list, array position #1 -->
    <allowed>tom, john</allowed>
   <acl index=”2”>


© 2017 Digi International Inc. All rights reserved.
<query_setting> updated on 01 Aug 2017 11:27 AM