# Rainforest Automation (v1.0.0b)

**URL:** <https://community.homey.app/t/rainforest-automation-v1-0-0b/1153>\
**Category:** Apps\
**Tags:** app, zigbee\
**Created:** [September 5, 2018, 5:38am UTC](https://community.homey.app/t/rainforest-automation-v1-0-0b/1153 "2018-09-05T05:38:43Z")\
**Posts on this page:** 11\
**Page:** 1

<div class="post-metadata">

**Author:** ![Jamie](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jamie/32/5274_2.png) [@Jamie](https://community.homey.app/u/Jamie)\
**Post date:** [September 5, 2018, 5:38am UTC](https://community.homey.app/t/rainforest-automation-v1-0-0b/1153/1 "2018-09-05T05:38:43Z")

</div>

# Rainforest Automation

[![](https://us1.discourse-cdn.com/flex025/uploads/athom/original/1X/04294250faa70b03d2c074c14d78da9302b548de.png)](https://apps.athom.com/app/com.rainforestautomation)

Have Homey report on your entire home’s power usage, simply by pluging in a gateway into a standard power point. Note that it requires that your energy provider is using a smart energy meter.

* * *

## Supports

Currently supports the latest gateway from Rainforest, the eagle-200.

![](https://cdn.rawgit.com/hive/com.rainforestautomation/master/drivers/eagle200/assets/icon.svg)

* * *

## Pairing

In order to pair a new device, you will need your gateway details (found on the bottom of your gateway) and preferably your gateway should be statically assigned an IP address using your router.

 ![](https://us1.discourse-cdn.com/flex025/uploads/athom/original/1X/eb9d640e5c1d9dedce3b83ffd644780a9a5736ba.png)

* * *

## Details

**Tested**

Hypothetically this will work with any device connected to the gateway. Practically it has been tested with Smart Power Meters, specifically a “Generic Zigbee Smart Power Meter”.

**Features**

```
Power Metering 
Power Measuring

```

**Settings**

```
Power Meter Polling Frequency
Power Measure Polling Frequency
Gateway IP Address

```

**Languages**

```
English (Australian)

```

* * *

## Change Log

- 1.0.0

* * *

## Road Map

- 1.1.0

- 1.2.0

- \> 2.0.0

* * *

## Requests

Given that smart power meters are generally only installed in Australia, Canada, US and the Homey community is largely based in Europe. With such a small foot print of users, new features/versions will be added upon request/demand if there is any.

---

<div class="post-metadata">

**Author:** ![Jamie](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jamie/32/5274_2.png) [@Jamie](https://community.homey.app/u/Jamie)\
**Post date:** [September 5, 2018, 5:39am UTC](https://community.homey.app/t/rainforest-automation-v1-0-0b/1153/2 "2018-09-05T05:39:03Z")

</div>

- Reserved

---

<div class="post-metadata">

**Author:** ![Tony\_Burn](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/tony_burn/32/2030_2.png) [@Tony\_Burn](https://community.homey.app/u/Tony_Burn)\
**Post date:** [September 5, 2018, 11:35pm UTC](https://community.homey.app/t/rainforest-automation-v1-0-0b/1153/3 "2018-09-05T23:35:26Z")

</div>

Hi,

Just tried this, put in all the details and it just sits there spinning gear icon, and gets no further ?

Any way to debug this ?

just noticed however that my model number is different, RFA-Z109-PC-002

---

<div class="post-metadata">

**Author:** ![Jamie](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jamie/32/5274_2.png) [@Jamie](https://community.homey.app/u/Jamie)\
**Post date:** [September 6, 2018, 1:37am UTC](https://community.homey.app/t/rainforest-automation-v1-0-0b/1153/4 "2018-09-06T01:37:25Z")

</div>

> [@Tony\_Burn](#):
>
> RFA-Z109-PC-002

Hey Tony, your using the original Eagle, I have the Eagle 200. I am happy to add support for the original Eagle but ill need some help to make sure it actually works as it is a completely different structure/authorisation.

---

<div class="post-metadata">

**Author:** ![Tony\_Burn](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/tony_burn/32/2030_2.png) [@Tony\_Burn](https://community.homey.app/u/Tony_Burn)\
**Post date:** [September 6, 2018, 1:51am UTC](https://community.homey.app/t/rainforest-automation-v1-0-0b/1153/5 "2018-09-06T01:51:20Z")

</div>

Sure, what do you need me to do ?

I am a software dev myself, and have already done other integrations with my eagle, so should be pretty easy.

---

<div class="post-metadata">

**Author:** ![Tony\_Burn](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/tony_burn/32/2030_2.png) [@Tony\_Burn](https://community.homey.app/u/Tony_Burn)\
**Post date:** [September 6, 2018, 1:53am UTC](https://community.homey.app/t/rainforest-automation-v1-0-0b/1153/6 "2018-09-06T01:53:59Z")

</div>

All I have done with mine is a HTTP post (with authorisation username = cloud id, password = install code)

http:{ipaddress}/cgi-bin/cgi\_manager

with the content

\<LocalCommand\>\n\r\<Name\>get\_usage\_data\</Name\>\n\r\<MacId\>0xd8d5b90000005dbc\</MacId\>\n\r\<Format\>JSON\</Format\>\n\r\</LocalCommand\>

which returns back the json structure

{“meter\_status”:“Connected”,  
“demand”:“0.5700”,  
“demand\_units”:“kW”,  
“demand\_timestamp”:“1536235984”,  
“summation\_received”:“0.000”,  
“summation\_delivered”:“42351.001”,  
“summation\_units”:“kWh”,  
“price”:“0.1759”,  
“price\_units”:“840”,  
“price\_label”:“Set by User”,  
“message\_timestamp”:“946684800”,  
“message\_confirmed”:“N”,  
“message\_confirm\_required”:“N”,  
“message\_id”:“0”,  
“message\_queue”:“active”,  
“message\_read”:“Y”,  
“threshold\_upper\_demand”:“11.548000”,  
“threshold\_lower\_demand”:"-2.000000",  
“fast\_poll\_frequency”:“0x00”,  
“fast\_poll\_endtime”:“0x00000000”}

---

<div class="post-metadata">

**Author:** ![Jamie](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jamie/32/5274_2.png) [@Jamie](https://community.homey.app/u/Jamie)\
**Post date:** [September 6, 2018, 2:35am UTC](https://community.homey.app/t/rainforest-automation-v1-0-0b/1153/7 "2018-09-06T02:35:45Z")

</div>

Thanks for sending through the command, made things a lot clearer. It looks like that command is for the [Uploader API](https://rainforestautomation.com/wp-content/uploads/2014/07/EAGLE-Uploader-API_06.pdf). [Push] I was looking at the [REST API](https://rainforestautomation.com/wp-content/uploads/2015/07/EAGLE_REST_API-1.1.pdf) [Pull] - Pretty glad we figured that out early.

Honestly Ive only had a quick glance at both documents, looks like the REST API is accessing their cloud server? I have to look into it in more detail.

All I would need from you would be each CURL commands we would send and the response,so I can build a ‘dummy’ device. And then to test ideally dev branch (or alpha) with me to make sure its connecting / getting back the same results as your CURL command. In my experience most APIs have a couple of small idiosyncrasies that need to be worked out.

---

<div class="post-metadata">

**Author:** ![Jamie](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jamie/32/5274_2.png) [@Jamie](https://community.homey.app/u/Jamie)\
**Post date:** [September 6, 2018, 3:11am UTC](https://community.homey.app/t/rainforest-automation-v1-0-0b/1153/8 "2018-09-06T03:11:33Z")

</div>

> [@Tony\_Burn](#):
>
> get\_usage\_data

Doesn’t seem like either of the documents I sent through have the command you are using, nor its response. Which document did you use to find that command?

---

<div class="post-metadata">

**Author:** ![Tony\_Burn](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/tony_burn/32/2030_2.png) [@Tony\_Burn](https://community.homey.app/u/Tony_Burn)\
**Post date:** [September 6, 2018, 3:24am UTC](https://community.homey.app/t/rainforest-automation-v1-0-0b/1153/9 "2018-09-06T03:24:37Z")

</div>

I can’t attach a PDF here, but its the same as their Cloud REST API, you just use the local address instead of the cloud one (took me ages to find that one)

But you are right, get\_usage\_data does not exist in the documents, I can’t remember where I found that, was over a year ago.

If you want, I can open up my FW to port forward thru to this device - perhaps best to take this out of public forums, send me a PM with your IP address and we can go from there

---

<div class="post-metadata">

**Author:** ![Jamie](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jamie/32/5274_2.png) [@Jamie](https://community.homey.app/u/Jamie)\
**Post date:** [September 8, 2018, 5:05pm UTC](https://community.homey.app/t/rainforest-automation-v1-0-0b/1153/10 "2018-09-08T17:05:45Z")

</div>

@Tony_Burn I’ve created a new branch with support for the original eagle device.

> **[hive/com.rainforestautomation](https://github.com/hive/com.rainforestautomation/tree/alpha)**
>
> Athom Homey app for the rainforest automation power meters - hive/com.rainforestautomation

However, It was built based of the spec doc, with out any testing upon a device. Using the undocumented ‘localCommand’ syntax upon the documented commands. Soooo YMMV.

In **theory** (ha) it should work but this is as far as I can take it personally with out a device to test upon or with out someone with a device testing it for me.

I’ve got one more release I would like to do before I move onto another project, so hopefully it gets tested and merged back in time.

Thanks

---

<div class="post-metadata">

**Author:** ![Tony\_Burn](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/tony_burn/32/2030_2.png) [@Tony\_Burn](https://community.homey.app/u/Tony_Burn)\
**Post date:** [September 8, 2018, 10:11pm UTC](https://community.homey.app/t/rainforest-automation-v1-0-0b/1153/11 "2018-09-08T22:11:47Z")

</div>

Hi @Jamie what do I need to do to test this for you ?
