---
title: Modify Device(s) in DeviceHub for One Litmus Edge
slug: solutions/modify-devices-in-devicehub-for-one-litmus-edge
docTags: 
createdAt: 2025-08-13T12:21:16.394Z
---

To modify Device(s) with Litmus Excel Add-ins, you should be familiar with how Devices work in [DeviceHub](docId:55lxgtILWfsyGkxzrdFoD) on Litmus Edge.

# Before You Begin

- You have installed the Litmus Excel Add-ins extension. See [Install Litmus Excel Add-ins](docId\:GZDhBJ1xZZNDDThYOCuuu) for details.
- You have prepared a [Tool file.](docId\:cLsF07WLI-66k4Rs-xuiH) 
- Devices have been [added](docId\:ot0c1ugAyykjZmqiYbh8j) to DeviceHub.

# Initial Preparation

Open a new Device Management Tool File in Excel.

If prompted, *Enable Content *to allow the code to run.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/jzotppmZSPdRS7VZpFPvg_image.png" size="80" width="600" height="150" position="center" showCaption="false"}

Make sure the the tool is set to *One LE* for the **Connect To** option.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/QetYSKLGQHfvmjN-sRrIX_image.png" size="70" width="402" height="199" position="center" showCaption="false"}

# Modify Device(s)

## Import Devices

Import the Device Settings for devices defined on Litmus Edge using the [Import Device(s) Wizard](docId\:l0Cy8AmrA80RNY4X_PT3k).

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/gQSGCLWorGt5gGjUDkH06_image.png" size="70" width="560" height="218" position="center" showCaption="false"}

Users can set a filter to reduce the number of devices shown as selection to the user.

- **Search Option**: Select what type of filter is to be used
- **Device Name Mask**: Set the filter to be applied. Will be ignored if **Search Option** is set to *ALL*
- The wizard will show what filter will be applied.

::Image[]{src="https://images.archbee.com/SSUUxKZUk9bFTEPNn_6Zo/AhrQFAJN5UvNzs_PWyhJo_image.png?format=webp" size="80" width="886" height="802" position="center" showCaption="false"}

- Press the **Search** button to pull the filtered List of devices from Litmus Edge.

::Image[]{src="https://images.archbee.com/SSUUxKZUk9bFTEPNn_6Zo/D7wkR0ArLRUb71k7ttNIs_image.png?format=webp" size="80" width="886" height="802" position="center" showCaption="false"}

- The user will be shown the filtered List of devices matching their filter.

::Image[]{src="https://images.archbee.com/SSUUxKZUk9bFTEPNn_6Zo/UoDLYqrre0Q4UdjdQvkAL_image.png?format=webp" size="80" width="896" height="797" position="center" showCaption="false"}

- Select the Devices to import and press the **Import** button. 

::Image[]{src="https://images.archbee.com/SSUUxKZUk9bFTEPNn_6Zo/6hFdp6gBHD20lR56BWGch_image.png?format=webp" size="80" width="891" height="799" position="center" showCaption="false"}

:::hint{type="info"}
**Notes**:

Users can choose between:

- Press** New Search** to set another filter and search again if the list doesn't show the devices the user wanted to import
- Select **All **Devices using the Checkbox in the Header Row.
- Select a **Group** of Devices by selecting their respective Check Box
- Select one **Device **by selecting the respective Check Box
- Select **No **Device and close the Wizard pressing the **Close** button instead.
:::

- The selected device(s) with their settings are imported into the sheet. 
  Once finished, the user can either.
  - perform another search using the **New Search** button
  - finish the import using the **Close** button

::Image[]{src="https://images.archbee.com/SSUUxKZUk9bFTEPNn_6Zo/HYEXll4J8Yt__6Ntp44p0_image.png?format=webp" size="80" width="1599" height="811" position="center" showCaption="false"}

- The **Action** for each imported device is set to **M** for modify.

![](https://images.archbee.com/SSUUxKZUk9bFTEPNn_6Zo/gh0Et8bbNh4LetqfIw6OL_image.png?format=webp)

## Mandatory Device settings

Users can modify these mandatory settings for a device

**Device Name:** The Name of an existing Device can be changed.

:::hint{type="warning"}
**Important: **This will change the topic for all Tags and will cause other services like Analytics, Integrations or Flows not be able to read the data
:::

**Device Properties: **are a mandatory set of Device Settings, which are populated initially with a set of default values. 
To connect to your PLC, you will have to provide your specific device properties settings instead.
Which you can provide through one of two options.

- **Option 1**: You can provide your specific **Device Properties **directly through the Formula Bar or through the cell. 
  You will need to be careful to not remove any of the Key-Value pairs as well as keeping the JSON formatting accurate.

::Image[]{src="https://images.archbee.com/SSUUxKZUk9bFTEPNn_6Zo/sPZ4DAVj7RjGT2bALcoHd_image.png?format=webp" size="80" width="883" height="434" position="center" showCaption="false"}

- **Option 2**: You can use the [Device Properties Wizard](docId\:QN07nz6dLFdz1MDPqkijc).

::Image[]{src="https://images.archbee.com/SSUUxKZUk9bFTEPNn_6Zo/o0wEIX1Bj8qZ201eFTEik_image.png?format=webp" size="80" width="880" height="493" position="center" showCaption="false"}

This allows you to edit the Device Properties without the risk of potentially invalidating the JSON Object.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/2soucxr1v7QVbWpHkbXXh_image.png" size="80" width="1007" height="617" position="center" showCaption="false"}

Modify any of the [not mandatory settings](docId:8KuCG2IUuno0H68fUBqL0) as needed.

:::hint{type="info"}
**Notes**:

You can repeat modifying [mandatory](docId:8KuCG2IUuno0H68fUBqL0) and [not mandatory](docId:8KuCG2IUuno0H68fUBqL0) for every device you need to modify before [executing any Action](docId:8KuCG2IUuno0H68fUBqL0).
:::

## Executing Actions

When all [mandatory](docId:8KuCG2IUuno0H68fUBqL0) and [not mandatory](docId:8KuCG2IUuno0H68fUBqL0) settings for all device(s) are set, they are ready to be modified.

It is **Recommended** but not mandatory to verify the configuration first without executing the Action by pressing the **Verify Only** button.

::Image[]{src="https://images.archbee.com/SSUUxKZUk9bFTEPNn_6Zo/NoZnE9s3b-TULIhExGKXD_image.png?format=webp" size="60" width="421" height="196" darkWidth="800" darkHeight="372" position="center" showCaption="false"}

This will check that all required Device Settings are provided and logically correct. And provide any finding to the user.
Example: Below the user did select to have Meta Data but did not provide any.

::Image[]{src="https://images.archbee.com/SSUUxKZUk9bFTEPNn_6Zo/IbkluRSCyQqbWtQ36BDJr_image.png?format=webp" size="80" width="689" height="556" darkWidth="800" darkHeight="645" position="center" showCaption="false"}

:::hint{type="warning"}
**Important: **The tool can not verify if all provided device settings are factually correct. For example it can not verify that the network address  provided for the PLC is the correct IP address.
:::

The Device(s) can be modified on Litmus Edge by pressing the **Verify + Execute** button.

::Image[]{src="https://images.archbee.com/SSUUxKZUk9bFTEPNn_6Zo/5UXZJMKPU69JV2UFYFUI__image.png?format=webp" size="60" width="394" height="215" position="center" showCaption="false"}

This will check that all required Device Settings are provided and logically correct. And provide any finding to the user.
If no issues have been identified, the tool will verify that the user wants to execute **ALL** the actions from the **Action** Column:

1. **A**: Add Device(s)
2. **M**: Modify Device(s)
3. **D**: Delete Device(s)
4. **I**: Ignore Device(s) -> do nothing

To perform all actions, press the **Yes** button.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/SaeUZnW6hlpNP3uExkEGr_image.png" size="80" width="726" height="389" position="center" showCaption="false"}

The Tool will perform ALL Actions row by row. When finished, a result Summary is shown. Close the Result Summary by pressing the **X** close button.

![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/6JCkBehMHzZbjpw2aRAqd_image.png)

The tool will ask if the user wants to re-compare the Device(s) against Litmus Edge.
To re-compare, press the **Yes **button.
To not re-compare, press the **No** button.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/VQRPOvyUKCOX_soNIGsej_image.png" size="72" width="409" height="163" position="center" showCaption="false"}

If the User selected to press the **Yes **button from aboves messagebox, the tool will pull all the device settings from Litmus Edge again including the DeviceID and also change the Action to **M **for each Device with a DeviceID. 

![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/S05oQNJHyijeRmJq041mU_image.png)

## Not Mandatory Device Settings

Each Device has a number of not mandatory Settings which can be used to meet specific needs.

- **Device Description:** A short description of the device.
- **Enable Meta Data**: Select if you want to add Meta Data to the device. 
- [Meta Data](docId\:pal6ABPZbrimdU9LvGJ30): Provide a JSON Object which holds all the Meta Data you want to add to the Device. See [Organize Device and Tag Data by Using Metadata](docId\:MU-6j6Zhi0CvCHDad0w8n) to learn more. 
  It is recommended to use the [Meta Data Wizard](docId\:tECprcmT6i2KyOPTH9DFZ).

::Image[]{src="https://images.archbee.com/SSUUxKZUk9bFTEPNn_6Zo/T5Q2r1SUhIqKVOC5HjhuS_image.png?format=webp" size="60" width="514" height="485" position="center" showCaption="false"}

- **Enable Status Register**: Select if you want to add a Status Register which is used to monitor if the Device is reachable instead of the Default status check mechanism. 
- [Status Register](docId\:pal6ABPZbrimdU9LvGJ30): Provide the Register definition as a JSON Object.
  It is recommended to use the [Status Register Wizard](docId\:hH2cpcEvKHuMoFTZYQFpm).

::Image[]{src="https://images.archbee.com/SSUUxKZUk9bFTEPNn_6Zo/BhpBU4XCAmr8CKlkVpTkH_image.png?format=webp" size="60" width="503" height="505" position="center" showCaption="false"}

- [Enable Alias Topics](docId\:pal6ABPZbrimdU9LvGJ30): Select if you want to substitute long, unreadable device and tag IDs with human-readable device and tag names in topic names
- [Enable Logging](docId\:pal6ABPZbrimdU9LvGJ30): Select if you want to enable the Logging option for Gen 2 drivers.
  *Note: For Gen 1 Drivers this option is unavailable.*
- [Enable Data Store](docId\:pal6ABPZbrimdU9LvGJ30): Select if you want to store the collected data locally.
- **Data Store Retention Period**: Provide the number of hours the data are to be stored. 

::Image[]{src="https://images.archbee.com/SSUUxKZUk9bFTEPNn_6Zo/NimI72GiQZv44IMVruhSf_image.png?format=webp" size="30" width="238" height="264" position="center" showCaption="false"}

- **Optional Settings:** This provides a JSON Object which allows users to set settings like:
  - [Publish on Polling Interval](docId\:pal6ABPZbrimdU9LvGJ30): Select if for Gen 2 drivers the driver will always publish messages according to the polling interval configuration.
  - [Watchdog](docId\:pal6ABPZbrimdU9LvGJ30): Select if the driver will be monitored based on the Watchdog period.
  - [Publish Additional Attributes](docId\:pal6ABPZbrimdU9LvGJ30): Select if for some Gen 2 drivers (OPC UA, BACnet, DNP3, Modbus) additional information such as Source Timestamp, Server Timestamp and Status Code

    It is recommended to use the [Optional Settings Wizard](docId:2evk5VHPFjZHD9FMsO95q).

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/jsHhvnYfVS6aiXS_A9cGG_image.png" size="42" width="251" height="448" position="center" showCaption="false"}

# Troubleshooting

The Tool will perform several checks throughout the proces of defining the device settings.  If they do not pass successfully, the user will be notified. 
The checks include:

- Device Name uniqueness. 
  - The tool checks if a **Device Name **already exist in the Tool.

::Image[]{src="https://images.archbee.com/SSUUxKZUk9bFTEPNn_6Zo/5rBSAGbp6LNrMCZ6gcP_4_image.png?format=webp" size="80" width="814" height="546" position="center" showCaption="false"}

- [Allowed and not allowed Ascii Characters](docId\:FNwHcidRnnPizCZkUWiYz) for Device Names and Descriptions
  - The user is shown a message box as notification.

::Image[]{src="https://images.archbee.com/SSUUxKZUk9bFTEPNn_6Zo/4Si7sE4GQy8R695YtN0fb_image.png?format=webp" size="80" width="518" height="382" position="center" showCaption="false"}

- The character(s) are highlighted in red and also shown in a note.

::Image[]{src="https://images.archbee.com/SSUUxKZUk9bFTEPNn_6Zo/9OzSe1GiihbbSWcMBArjm_image.png?format=webp" size="80" width="413" height="205" position="center" showCaption="false"}

- See [Allowed and not allowed Ascii Characters for Names and Descriptions](docId\:FNwHcidRnnPizCZkUWiYz) for a full list for both Names and Descriptions.
- Correct JSON formating for **Device Properties**, **Meta Data**, **Status Register **and **Optional Settings**.
  - Example for an invalid JSON formatting of the Device Properties

::Image[]{src="https://images.archbee.com/SSUUxKZUk9bFTEPNn_6Zo/dGddL0nuF0Znfk5Ka804s_image.png?format=webp" size="80" width="480" height="455" position="center" showCaption="false"}

- Valid entry for **Data Store Retention Period** to be a number and withhin allowed range
  - Example for an invalid entry for the Retention period

::Image[]{src="https://images.archbee.com/SSUUxKZUk9bFTEPNn_6Zo/RYZo53e2BzHUNlMKWtRi1_image.png?format=webp" size="60" width="524" height="485" position="center" showCaption="false"}

- Do exist JSON Key-Value pairs in columns **Device Properties**, **Optional Settings** or **Status Registers** with a value being:
  - empty
  - **null**
  - empty array "**\[]**"
  - empty JSON Object "**\{}**"
- Are the columns **Device Properties**, **Optional Settings** or **Status Registers **empty. 
  If they are, the default JSON Object will be automaticlly added.