# Power Meter

## Introduction

In this project you will be directed to create a power meter usecase. You need a power meter device that has been integrated with Antares. You are asked to group devices based on the application name and device name into the power meter usecase group. This process is called **Integrate Device** in the Antares Insight Hub service.

## Prerequisites

Before starting the project, make sure you have followed the mandatory prerequisites. Here is the prerequisite page that needs to be prepared.

{% content-ref url="power-meter/power-meter-usecase-prerequisites" %}
[power-meter-usecase-prerequisites](https://docs.antares.id/en/antares-insight-hub/usecase/power-meter/power-meter-usecase-prerequisites)
{% endcontent-ref %}

## Usecase Power Meter Creation Steps

## 1. Integrate Device

### 1.1. Open Usecase Power Meter Menu

On the left navigation bar, select ‘Usecase’. Then on the Usecase menu select ‘Power Meter’.

<figure><img src="https://3873791589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7cujmJ5QHdJaAjH815aZ%2Fuploads%2FPGEWmYqidZD8TQxAG3Qh%2Fimage.png?alt=media&#x26;token=b21f6dce-c6fc-411d-b4cd-32ddfb92ca06" alt=""><figcaption></figcaption></figure>

### 1.2.Do Device Integration

On the Power Meter Usecase Page, Click ‘Integrate’ then a pop up form will appear.

<figure><img src="https://3873791589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7cujmJ5QHdJaAjH815aZ%2Fuploads%2FGdpSw7VmHYbiy4HWOXD6%2Fimage.png?alt=media&#x26;token=4debecb8-54be-48b3-ad29-28678e99c7a2" alt=""><figcaption></figcaption></figure>

Next, fill in the Integrate Device form by filling in the **‘Application Name’**, select **‘Device Name’** then fill in other data such as **Decoder Type, Device Label, Serial Number, Address** and **Map Location**.

{% hint style="info" %}
Make sure the **Decoder Type** matches the type of Device you are using.
{% endhint %}

<figure><img src="https://3873791589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7cujmJ5QHdJaAjH815aZ%2Fuploads%2F8IUMDAozVlbBwjNqREut%2Fimage.png?alt=media&#x26;token=99e9ea9e-956e-4507-911f-1ff70bb6b120" alt=""><figcaption></figcaption></figure>

The following is an explanation of the Integrate Device form parameters

<table><thead><tr><th width="92">No.</th><th>Data Type</th><th>Description</th></tr></thead><tbody><tr><td>1.</td><td>Usecase</td><td>Select the usecase according to your needs. There are 3 (three) usecase options, namely Power Meter, Water Meter, and Water Level.</td></tr><tr><td>2.</td><td>Application</td><td>After creating an application, you can use the application in a usecase</td></tr><tr><td>3.</td><td>Device</td><td>After adding the device to the application, select the device for the usecase you will be using.</td></tr><tr><td>4.</td><td>Device Label</td><td>Create labels for the devices you will use</td></tr><tr><td>5.</td><td>Decoder Type</td><td>A decoder option is provided by Antares. The decoder serves to ensure that the payload used by the user matches the format used by Antares.</td></tr><tr><td>6.</td><td>Serial Number</td><td>Enter the serial number for the device you will be using</td></tr><tr><td>7.</td><td>Address</td><td>Provide the address that will be used for your usecase</td></tr><tr><td>8.</td><td>Map Location</td><td>Select the coordinates on the map according to the address you have listed</td></tr></tbody></table>

Make sure the data filled in the form is correct. After filling in the data on the Integrate Device form, then click ‘Integrate’.

<figure><img src="https://3873791589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7cujmJ5QHdJaAjH815aZ%2Fuploads%2FcXIRxlFNLgBsGG82qc4z%2Fimage.png?alt=media&#x26;token=f36d031a-f652-4109-b86f-81e2306515f2" alt=""><figcaption></figcaption></figure>

Once you have successfully integrated the device, the display will change as shown below.

<figure><img src="https://3873791589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7cujmJ5QHdJaAjH815aZ%2Fuploads%2F9gm7LfLE8A4Zj1neJBed%2Fimage.png?alt=media&#x26;token=8179fa39-dabe-4122-9ead-6f8d420ea5ac" alt=""><figcaption></figcaption></figure>

### 1.3. View Detail Device

On the usecase page, you can view data from particular devices that have been successfully integrated. To view data from a particular device, click the device that you have integrated to see more data information.

<figure><img src="https://3873791589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7cujmJ5QHdJaAjH815aZ%2Fuploads%2Fl1irJ0NGoak6dZaokUWP%2Fimage.png?alt=media&#x26;token=f1ce3a96-ce38-4085-8dc8-dc1af9a3b8bf" alt=""><figcaption></figcaption></figure>

The following is a detailed view of the device that has been opened.

<figure><img src="https://3873791589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7cujmJ5QHdJaAjH815aZ%2Fuploads%2FgYN5iQTxGkgwaBBtGto9%2Fimage.png?alt=media&#x26;token=9f1f0852-9aa8-4fca-93c1-d19f7c7a3e0e" alt=""><figcaption></figcaption></figure>

## 2. Testing Payload

To ensure the Antares Insight service is working properly, make sure the payload sent by the user's device matches the format that has been determined in Antares Insight. You can then follow the steps below to use the Payload Decoder feature.

### 2.1. Choose Payload Decoder

On the left navigation bar, click the ‘Usecase’ menu then select ‘Power Meter’. After opening the Power Meter Usecase page, click ‘Payload Decoder’.

<figure><img src="https://3873791589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7cujmJ5QHdJaAjH815aZ%2Fuploads%2FCGY1p67ymjz77nk3K24p%2Fimage.png?alt=media&#x26;token=9ef6d21e-a054-498a-9427-4f2ab80ff08e" alt=""><figcaption></figcaption></figure>

A popup will appear as shown below, select the decoder you want to use.

{% hint style="info" %}
There are several decoders provided by Antares. You can customise the decoder selection according to your device type.
{% endhint %}

<figure><img src="https://3873791589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7cujmJ5QHdJaAjH815aZ%2Fuploads%2FzAB2kpnZkcYy4Egw7kY8%2Fimage.png?alt=media&#x26;token=dcd8e1b8-e177-47a6-8896-0b01cf5c0c2f" alt=""><figcaption></figcaption></figure>

### 2.2. Input Data Payload

You can see an example payload based on the device recommendation on the following page.

{% content-ref url="power-meter/payload-example-power-meter" %}
[payload-example-power-meter](https://docs.antares.id/en/antares-insight-hub/usecase/power-meter/payload-example-power-meter)
{% endcontent-ref %}

Enter the payload for your device in the ‘Input Decoder’ field. After entering the payload, click the ‘Submit’ button.

{% hint style="info" %}
Payloads that have been customised to the format used in Antares will automatically appear in the ‘Decoder Results’ column.
{% endhint %}

## 3. Setup Device Threshold

In this section you can set the threshold for **alert notification**. You can enter a **maximum of 3 data parameters** that you want to be used as **alert notifications**. You can also limit it to a **maximum of 3 threshold points**. For more details you can see it on the following page.

{% content-ref url="power-meter/setup-device-threshold-power-meter" %}
[setup-device-threshold-power-meter](https://docs.antares.id/en/antares-insight-hub/usecase/power-meter/setup-device-threshold-power-meter)
{% endcontent-ref %}

## 4. Setting Estimation Cost

In this section you can set the price of electricity usage. On the Power Meter Usecase page, click **‘Set Estimation Cost’** then a popup form will appear that you need to fill in.

<figure><img src="https://3873791589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7cujmJ5QHdJaAjH815aZ%2Fuploads%2FpoECwaZgl0y554yF2iba%2Fimage.png?alt=media&#x26;token=653cd6db-f074-4071-9e65-3b38a525222b" alt=""><figcaption></figcaption></figure>

Next you need to fill in the **‘Currency’** and **‘Price per kWh’** data on the Estimation Cost form.

<figure><img src="https://3873791589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7cujmJ5QHdJaAjH815aZ%2Fuploads%2FB5ddHP55UNH6gfCd7fGv%2Fimage.png?alt=media&#x26;token=bec061a7-da51-4d0d-8faa-f8ca29700d49" alt=""><figcaption></figcaption></figure>

Next, click ‘Apply to Power Meter Device’ to apply the cost estimation settings to the power meter usecase. If the process is successful, the results will be as shown below.

<figure><img src="https://3873791589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7cujmJ5QHdJaAjH815aZ%2Fuploads%2Fe3QWRafvx2Kubwa4SRCw%2Fimage.png?alt=media&#x26;token=eb599bf4-063b-456b-9503-456b5287771b" alt=""><figcaption></figcaption></figure>

## Manage Usecase

## 1. Edit Device Usecase

In this section you can edit usecase data details such as ‘**Application Name’, ‘Device Name’, Decoder Type, Device Label, Serial Number, Address and Map Location** that you previously filled in when filling out the integrate device form. On the Power Meter Usecase page, select the device you want to edit as shown below.

<figure><img src="https://3873791589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7cujmJ5QHdJaAjH815aZ%2Fuploads%2FRocfcwm5AK8VL9PJh4fF%2Fimage.png?alt=media&#x26;token=dfcfc93f-bb96-4e4d-9cd9-b802394505b4" alt=""><figcaption></figcaption></figure>

On the selected device page click ‘Edit Details’, then the Edit Integrate device popup form will appear.

<figure><img src="https://3873791589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7cujmJ5QHdJaAjH815aZ%2Fuploads%2Ff2Jm9kDS3MVpDLffkhik%2Fimage.png?alt=media&#x26;token=a5e1a2a9-0aef-47a5-b99c-fc839b0aa990" alt=""><figcaption></figcaption></figure>

You can rearrange the device usecase data as needed.

<figure><img src="https://3873791589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7cujmJ5QHdJaAjH815aZ%2Fuploads%2FpFVo6P9gkey1fuBzrxCu%2Fimage.png?alt=media&#x26;token=b88a7624-4e93-41b0-841c-e08a83fe14f6" alt=""><figcaption></figcaption></figure>

## 2. Edit Device Power Meter

In this section, you can edit the device in the application antares. You can change the subscription package, set LoRa, and view other data. On the Power Meter Usecase page, select the device you want to edit as shown below.

<figure><img src="https://3873791589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7cujmJ5QHdJaAjH815aZ%2Fuploads%2FRiuEX5tg56pu7uL4mPOr%2Fimage.png?alt=media&#x26;token=cb885083-bf92-4a39-9789-a4a4763d0ab3" alt=""><figcaption></figcaption></figure>

On the selected device page click ‘Config’, then you will be directed to the device page that you want to configure.

<figure><img src="https://3873791589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7cujmJ5QHdJaAjH815aZ%2Fuploads%2FcnHdKcSQ6j74W153jLch%2Fimage.png?alt=media&#x26;token=203f0ece-d532-425f-a089-ad228f0acb12" alt=""><figcaption></figcaption></figure>

You can configure devices such as **‘Set LoRa’,** **‘Webhhok’, ‘Subscription’**, and view other data details.

<figure><img src="https://3873791589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7cujmJ5QHdJaAjH815aZ%2Fuploads%2F1ApFhqtFtD6igt4tjaW8%2Fimage.png?alt=media&#x26;token=801d2412-1a50-4fbe-9f27-bd5cfb0feede" alt=""><figcaption></figcaption></figure>


---

# 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.antares.id/en/antares-insight-hub/usecase/power-meter.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.
