> For the complete documentation index, see [llms.txt](https://wiki.bitpool.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.bitpool.com/bitpool-edge/connectors/bitpool-edge-awair.md).

# Bitpool Edge Awair

## Getting Started

This is a standard Node.js module developed specifically to function within the Node-RED ecosystem.

## How to Use

Use the following procedure to install this module to your Node-RED instance, or download the pre-themed Bitpool-Edge Docker image that contains all our favourite nodes pre-installed.

### Bitpool-Edge Install

1. Log into your Bitpool-Edge instance and click the `Hamburger` icon, in the top-right corner.
2. Select `Manage Palette` from the drop down menu then click the `Pallete->Install` tabs to install.
3. Using the search bar type `@bitpoolos/edge-awair` and install the module once displayed.
4. Finally, use the left most navigation menu to scroll down to the heading `Bitpool Awair` to reveal available nodes.

### Docker Install :whale:

This Awair module and many other Bitpool developed nodes have been pre-installed for your convenience in a Bitpool themed Node-RED application.

Go here for how to install Bitpool-Edge.

### Awair Nodes

The Awair library contains a single node / functional block. 

<figure><img src="/files/6qQ8HQXT3XtLkLu2jLHp" alt=""><figcaption></figcaption></figure>

1. `Awair Device` - Allows for the connection to a device in the Awair Cloud and returns the latest available air data for that device.

### Basic Workflow

<figure><img src="/files/0wVt7TDWDdNhD2NwU5pD" alt=""><figcaption></figcaption></figure>

The image above is an example of a linked Awair Device node on a Flow tab. This is the basic flow of data.

1. The ‘Trigger’ node injects a simple timestamp into the `Awair Device` node.
2. The `Awair Device` node contains an API configuration along with a device selection which is used to retireve the latest air data for the device.
3. Finally, the `Output` node prints the payload to the debug tab for the user to see.

### Further Information

Now that your Bitpool-Edge is up and running, we have included simple example flows to demonstrate how to create a basic solution.

1. Log into your Bitpool-Edge instance and click the `Hamburger` icon, in the top-right corner.
2. Select `Manage Palette` from the drop down menu then click the `Import->Examples` tabs to see this node.
3. Navigate the ‘Examples flows’ tree and select `@bitpoolos/edge-awair` to reveal the preconfigured examples.
4. Click the example you would like to test then click the `Import` button.
5. Place the example nodes on a flow and review the configuration of each node. You will need to make suitable changes for your system.
6. Finally, click the `Save` to test.

> Additionally, there is basic helper documentation on each node. Just select a target node and click the `Help` tab found at the top right corner of Bitpool-Edge.
>
> **Hint** *- the icon looks like a book!*