> For the complete documentation index, see [llms.txt](https://docs.buildings.ability.abb/collection/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.buildings.ability.abb/collection/english-v14/connectivity-as-a-service/connect-devices-with-abb-buildingpro/connect-devices-via-modbus/read-jobs.md).

# Read jobs

## Read Jobs

A *Job* in the Modbus context is a recurring task that is defined to read data from a Modbus device. This data can then be used for further processing, visualization, or control. A *Job* defines which data (registers) are read from a Modbus slave device and at what intervals the query should take place.

## Steps for creating a new job

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

1. Click in the [-> Modbus connection](/collection/english-v14/connectivity-as-a-service/connect-devices-with-abb-buildingpro/connect-devices-via-modbus/create-a-new-modbus-connection.md) on  <img src="/files/d79867caeee0fdf0e59fd7a510874af8885ed5a9" alt="" data-size="line">to create a new job.

   ▷ A configuration window for the new job opens.
2. **Job configuration**

   Fill in the following fields in the configuration window:

   * **Name**: Enter a name for the job that describes the task (e.g., "Read temperature").
   * **Function**: Select the Modbus function to be used for this job (e.g., "Read holding registers").
     * Typical functions include reading coil registers, input registers, or holding registers.
   * **Address**: Enter the start address of the registers you want to read. This is the memory address in the Modbus device.
   * **Length**: Enter the number of registers to be read.
   * **Interval**: Enter the interval (in seconds) at which the job should query the registers (e.g., every 10 seconds).
3. **Save job**
   * Click on **Save**, to create the job.
   * ▷ The new job appears in the list of defined jobs under *Read jobs*.

***

### Examples of typical Modbus jobs

* **Temperature monitoring**\
  A job that reads the temperature from a specific sensor every 30 seconds.
* **Collect power data**\
  A job that queries the power data of a generator via holding registers every hour.

***

{% hint style="danger" %}
Make sure that the address and length of the registers are specified correctly to ensure that the correct data is read. Incorrect information can lead to malfunctions or incorrect values.
{% endhint %}


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.buildings.ability.abb/collection/english-v14/connectivity-as-a-service/connect-devices-with-abb-buildingpro/connect-devices-via-modbus/read-jobs.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
