Skip to main content

How to modify device configuration by SMS (setcfg and setioparam SMS commands)

Learn how to change a device's configuration remotely using the setcfg and setioparam SMS commands in Advanced Configurator.

Introduction

This article explains how to change a device's configuration remotely by sending SMS commands. You use the setcfg command to update general configuration settings, and the setioparam command to update input/output (IO) parameters.


1 Before You Begin

Complete the checks below before you send any SMS command to a device.

1.1 Required Tools

Application

Download

Advanced Configurator

1.2 Device Requirement

⚠️ Warning: The target device must have Enable configuration over SMS turned on. If this setting is disabled, the device ignores the setcfg command and the change fails silently.

Enable configuration over SMS setting in Advanced Configurator

1.3 Configuration Limitations

Some configuration settings cannot be changed by SMS. The image below shows which parameters are unavailable with this method.

Configuration settings that cannot be changed by SMS


2 Changing the Configuration with setcfg

Follow these steps to generate a setcfg command in Advanced Configurator and send it to the device:

  1. Open Advanced Configurator.

  2. Go to File → Open CFG and load the configuration file from the target device. If you do not have it, open any configuration file for the same device type that uses different settings.

    Opening a configuration file via File, Open CFG

  3. Change the parameters you want to update. In this example, Time with engine is set to 30 s.

    Setting Time with engine to 30 seconds

  4. Go to File → Generate SMS.

    Generating the SMS command via File, Generate SMS

  5. Enter the SMS password if the target device has one.

    Entering the SMS password

  6. Copy the generated message and send it to the target device.

⚠️ Warning: Only the parameters you change are included in the setcfg command. Settings you leave unchanged are not sent to the device.


3 Confirming the Change

If the configuration is updated successfully, the device replies with the following message:

Configuration parameter(s) was set!


4 Configuring IO Parameters with setioparam

You can also configure input/output (IO) parameters remotely using the setioparam SMS command.

For the full command syntax and parameter list, see the setioparam command reference.


5 Related Documentation

For more detail, see the following resources:

Did this answer your question?