# Canopy Overview

The cerillo canopy is a local wireless device capable of commanding and controlling the cerillo stratus and future cerillo devices. It creates a local wireless network that other cerillo devices can connect to. Devices connected to a canopy are also known as child devices of that canopy.

## LED Indicators
- Left LED: Status indicator
    - indicates the status of the canopy
- Right LED: Comm indicator
    - indicates messages are being transmitted or received

| LED    | Color                                          | Status                                              |
| ------ | ---------------------------------------------- | --------------------------------------------------- |
| Status | <span style="color:gray">White</span>          | Booting                                             |
| Status | <span style="color:green">Green</span>         | Active/Connected and local network created          |
| Status | <span style="color:purple">Purple Pulse</span> | Scanning for cerillo Devices                        |
| Status | <span style="color:red">Red</span>             | canopy software crashed and device must be rebooted |
| Comms  | <span style="color:blue">Blue</span>           | XBee message transmitted or received (Rx/Tx)        |
| Comms  | <span style="color:purple">Purple</span>       | Serial Message Transmitted or received (Rx/Tx)      |
| Comms  | <span style="color:red">Red</span>             | Error transmitting or receiving a message           |

## Initial Setup
1. Confirm receipt of all components and device.
2. Using your software license card, register the user account for your organization’s labrador premium subscription (the device software) with the [license registration directions](../register.md).
3. Cerillo devices must be running the most up-to-date firmware to access wireless capabilities. To verify your device has the correct firmware, follow these steps:
   1. Plug your stratus into a computer using the provided USB cable.
   2. Using your computer, open the cerillo labrador premium software.
   3. Labrador will walk you through your device firmware update to ensure canopy compatibility.
   4. For additional instructions, scan the QR code to the right.
4. Using the provided USB cable, connect the canopy to a computer running cerillo labrador premium for power and functionality.
5. Reboot your stratus to begin using wireless capabilities.

:::{note} Since cerillo devices can be communicated with through USB or through a canopy, USB communication is prioritized over canopy communication. That means if a device is connected via USB as well as connected to a canopy, device communication between Labrador and the device will take place over USB and not over the canopy's network.
:::


![canopy Home Page](../../_images/canopy-main.png)

| Number | Element                    | Description                              p                                                                                                   |
| ------ | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| 1      | **Device Info Panel**      | Contains device identifying information and status information.                                                                              |
| 2      | **Device Settings Button** | Brings up device settings in the **Device Control Panel** area of the application                                                            |
| 3      | **Canopy Network Info**    | Displays [Canopy Networking Info](canopy-network.md)                                                                                         |
| 4      | **Refresh Child Devices**  | Click to scan for devices connected to this canopy - typically referred to as "child" devices                                                |
| 3      | **Child Device List**      | Will display all devices connected to this canopy's network - also known as "Child Devices". Click on a device to navigate to its home page. |