# Device Operating State (opState)

Every manufacturer seems to like inventing and publishing their own list of error codes.  That's great for one off investigations or trouble shooting a specific device, but it's terrible if you are trying to manage a portfolio with thousands of different devices made by many different manufacturers.

The purpose of the opState property is to standardize and normalize the main state or error information coming from all of your different devices.  It makes it easy to get a high level understanding at a glance.

The most obvious place this manifests is in the tool tips shown on the devices in the Energy modules Dashboard view (see below, the opState for this device is "Normal" which is good!).

<figure><img src="/files/WqsduYMgvbXSwg6oe2k8" alt=""><figcaption></figcaption></figure>

The place where you can see the raw opState information and the associated manufacturer error codes or manufacturer specific operating state information (that opState is often derived from) will be the Power Dashboard.  An example is shown below (in this case, opState is derived from the device's sunsOpState information).

<div align="center"><figure><img src="/files/tSYyRuoPPhGODWuYnuJ4" alt=""><figcaption></figcaption></figure></div>

The [mapping](https://github.com/SolarNetwork/solarnetwork/wiki/SolarNet-API-global-objects#standard-device-operating-states) between these opState codes and the human readable meaning is as follows:

{% columns %}
{% column %}

<p align="center"><strong>Code</strong><br>0<br>1<br>2<br>3<br>4<br>5<br>6<br>7<br>8</p>
{% endcolumn %}

{% column %}

<p align="center"><strong>Meaning</strong><br>"Unknown"<br>"Normal"<br>"Starting"<br>"Standby"<br>"Shutdown"<br>"Fault"<br>"Disabled"<br>"Recovery"<br>"Override"</p>
{% endcolumn %}
{% endcolumns %}

*Please speak to your Ecosuite support team if you need more information on this topic or if you would like access to the Power Dashboard to see raw device specific errors and operating state information.*


---

# Agent Instructions: 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://docs.ecosuite.io/user-guide/modules/energy/device-operating-state-opstate.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.
