> For the complete documentation index, see [llms.txt](https://wecon.gitbook.io/pistudio-manual/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wecon.gitbook.io/pistudio-manual/6.-object/6.1-buttons-switchs/6.1.4-word-lamp.md).

# 6.1.4 Word lamp

**Introduction**

\[Word lamp] could display value of specified PLC or HMI word address, the display state of the component changes as the value of the read address changes.

**Description**

![](/files/-Luq6Dv5cF_3jlGvdxHE)

**1) Address**

**Read address:** read the value from specified address.

**2) States settings**

**States count:** The default Word state displays the number of States 1, which could be selected by the drop-down list to display the state of object, range: 1-128.

**State value:** Users could set different values to correspond to different states, the setting window as below figure shows.

**For example**

By default, when value of read address is 0, object displays state 0.

If change settings as below figure shows

When value of read address is 11, object displays state 1.

![](/files/-Luq6Dv69Mmi0Spg5pM4)

**State of value out of range:** When the value of read address exceeds the maximum state number, there is no corresponding state to be displayed. So there are two modes of processing for it: "Hide" and "Show state"

**Hide:** When the value of the read address exceeds the set range value, the word state display object will be blank.

**Show state:** When the value of the read address exceeds the set range value, the object will display the "Specified state". For example, set the maximum is state 7 (value is 6), when the read address of the value is greater than 6, it will display state 2 text and pictures.

**3) Transform state**

**Quick Read:** Directly read the value of the connected device without going through the HMI cache

**Auto transforms:** Object switch states automatically

![](/files/-Luq6Dv7VC6152JtPuLn)

**Trigger:** Control bit to enable switch automatically

**Auto return:** return to the initial state after reaching the final state;

**Time of transform:** it is used for setting the frequency in automatic switching state. Unit: 100ms.

**Dynamic interval:** set the frequency of automatic switching state and read it from the address. Unit: 100ms. If the value in address is 10, then the frequency of automatic switching state is 10\*100ms = 1s.

**Manual**

![](/files/-Luq6Dv8XeVn5T7vtCVN)

**Set state:** Set a constant value for the word address.

**State increase:** Increase state for each time the switch is triggered.

**State decrease:** Decrease state for each time the switch is triggered.

**Last state:** The state will not increase/decrease when reaches limits.

##


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wecon.gitbook.io/pistudio-manual/6.-object/6.1-buttons-switchs/6.1.4-word-lamp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.