# Get started tutorial (Gen 2)

This tutorial guides you through the basic steps of planning a Site, preparing to deploy Silvanet devices and then deploying each Silvanet device type in a forest.

{% embed url="<https://youtu.be/_HSeM5HV4GI>" %}
Dryad Silvanet Suite Tutorial - Gen 2 devices
{% endembed %}

{% file src="<https://2403147378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqvtUjx9C2FEFg7nicAx%2Fuploads%2FWYhF6M5Dvpgc2qsve4pF%2FDryad%20Gen%202%20Get%20Started%20Tutorial.pdf?alt=media&token=40d27140-1da0-412f-b1a0-50af55d973b4>" %}
Open a PDF version of the Gen 2 Get Started tutorial
{% endfile %}

## Goal

After completing this tutorial, you should know how to:

* Use the [Silvanet Site Management app](https://docs.dryad.app/dryad-documentation/silvanet-suite/silvanet-sma) to estimate the required Gateways and Sensor to cover a Site
* Use the [Silvanet Deployment app](https://docs.dryad.app/dryad-documentation/silvanet-suite/deployment-app) to deploy Silvanet devices in a Site
* View the status of deployed Silvanet devices in the [Site view](https://docs.dryad.app/dryad-documentation/silvanet-suite/silvanet-sma/site-overview) of the Site Management app

## Prerequisites

You need the following before beginning this tutorial:

* Login credentials to the Site Management app
* At least one Site provided in the Site Management app
* The Silvanet Deployment app installed on a smartphone

## 1. Plan the Site

The Planning tool is part of the Site Management app. It is used to estimate the amount and location of Border Gateways, Mesh Gateways and Wildfire Sensors to cover a Site.

### **Login to dryad.app**

Your user credentials (Username and Password) give you access to the Dryad Site Management app (dryad.app) and the Dryad Deployment app.

{% hint style="info" %}
Only users with Admin rights or Resellers can grant access to the Silvanet web and mobile apps. For more information, see [Add new users](https://docs.dryad.app/dryad-documentation/silvanet-suite/silvanet-sma/user-management#add-new-users).
{% endhint %}

1. Go to [dryad.app](https://dryad.app/). Dryad recommends using Chrome.

<figure><img src="https://2403147378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqvtUjx9C2FEFg7nicAx%2Fuploads%2FFNzCQQsoLaPEMUxkK2Mf%2Fsm-login-page.jpg?alt=media&#x26;token=8f64afaa-c6e2-4218-8ea0-08ccb2fc3e1b" alt="" width="563"><figcaption><p>Dryad.app login page</p></figcaption></figure>

2. Select **Login** and then in the **Sign In** form, enter your username and password.

### **Select or create a Site**

1. In the Site Management app, select the **Sites view.** The Site is where you prepare the deployment plan.

<figure><img src="https://2403147378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqvtUjx9C2FEFg7nicAx%2Fuploads%2FIcrA8gdiJJgfxfvR1s3l%2Fsm-create-site.png?alt=media&#x26;token=01d222ec-6db3-42de-80a6-3af7e3c7dc6d" alt="" width="563"><figcaption><p>Sites view</p></figcaption></figure>

2. If no Site appears, select **Create Site**.
3. Give the Site a name, select a region, then select **Create Site**.

{% hint style="info" %}
**See Also**

For more information, see [Sites view](https://docs.dryad.app/dryad-documentation/silvanet-suite/silvanet-sma/site-overview).
{% endhint %}

### **Plan coverage estimation**

Use the **Planning tool** to estimate coverage requirements for your site. It is accessed within the [**Sites view**](https://docs.dryad.app/dryad-documentation/silvanet-suite/silvanet-sma/site-overview) page.

Draw **paths** (hiking, roads, power lines of higher Sensor density), **areas** (wide areas of lighter Sensor density) and **connectivity zones** (mesh network of gateways).

The result is a total number of Gateways and Sensors needed to cover the Site.

<figure><img src="https://2403147378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqvtUjx9C2FEFg7nicAx%2Fuploads%2FJR9RKNTn8RgS4IEHYAjH%2Fpt-access-planning-tool.png?alt=media&#x26;token=9b2fc6a3-fb07-419b-93cb-d306bcb1456d" alt="" width="563"><figcaption><p>Access the Planning tool</p></figcaption></figure>

1. Run the Planning tool:\
   From the ellipse menu (top-right), select **Planning tool**.
2. Find a deployment location:\
   Search for a suitable location using the **Search** form. You can find any location as this is only an example plan.
3. Draw some paths and areas:\
   Look at the map and experiment with the drawing tools.
   1. If you see a hiking trail, railroad or other linear area, use the **Draw Path** tool to draw a path along the route. Notice the dots along the path. These are estimated Sensor locations. Give the path a name and then try some of the settings.
   2. For larger forested areas, use the **Draw Area** tool to follow the perimeter of the area to be protected by Sensors. Notice the dots inside the area. These are estimated Sensor locations. Give the area a name and move the slider to increase or decrease Sensor density.
4. Build up the mesh network using the **Connectivity Mesh**:\
   This adds Border Gateways and Mesh Gateways. First, add a Border Gateway. Afterwards, select in the blue zone of the Border Gateway and then add a Mesh Gateway. Continue adding Mesh Gateways until the Site is covered. Make sure you select in a blue zone before adding another Mesh Gateway.
5. Optionally, add a few comments:\
   Use the **Comment tool** to add a comment or two.
6. You can always delete a route or area and add new ones. Just try the tools and get comfortable using the Planning tool.

{% hint style="info" %}
Notice the white and yellow dots. You can use these dots to modify the route or area. Try enlarging an area by selecting a white dot and moving it outward.
{% endhint %}

{% hint style="info" %}
As you add paths, areas and connectivity zone, the device counters increment. This gives you an estimate of the number of Silvanet devices needed to provide coverage.
{% endhint %}

<figure><img src="https://2403147378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqvtUjx9C2FEFg7nicAx%2Fuploads%2FnlPdWwWPDjtmLAq1JPgk%2Fpt-network-coverage.png?alt=media&#x26;token=9b1d4f96-4c4e-4a06-af0c-4eb27c94afc7" alt="" width="563"><figcaption><p>Example completed coverage estimate</p></figcaption></figure>

7. Save your plan using the menu on the upper left of the tool to select **Save**.

{% hint style="info" %}
**Planning tool tutorial**

For a detailed example of preparing a coverage estimation, see [Planning Tool tutorial](https://github.com/dryad-networks/dryad-web-docs/blob/main/docs/planning-tool-tutorial.md).
{% endhint %}

### **Completed plan**

With the coverage estimation completed, it is ready to be exported.

1. Print a Summary document.
   1. Select **Export Summary** to save the estimation as a printable document (.docx).
   2. After downloading the document, it can be saved as PDF for later printing to be used by forestry workers to deploy the devices.
2. Release the deployment plan to the Dryad Deployment app.
   1. Select **Release Deployment Plan** to send the deployment plan to the Deployment app.
   2. Before releasing the plan, the Planning tool checks if there are any issues that need to be resolved. If found, use the provided troubleshooting information to fix the issues. For example, if a sensor is outside a connectivity zone, fix this by selecting the Sensor icon and moving it inside a blue zone.
   3. After all issues have been resolved, **release** the Deployment plan.
   4. The plan appears in the Deployment app as a new Site.

## 2. Prepare to deploy

{% hint style="danger" %}
Pre-charge the Border and Mesh Gateways for 24 hours before bringing the devices to the deployment locations.
{% endhint %}

### Required deployment tools

Bring the appropriate [deployment tools](https://docs.dryad.app/dryad-documentation/silvanet-deployment/guidelines/tools):

* Toolbox to carry all the necessary tools
* Hammer for treenails, chisel to shave off tree bark and shears for trimming branches and for cutting lengths of garden wire
* Binoculars to ensure line of sight between devices
* 10 mm wood drill bit, 6 mm wood drill bit, cordless drill and extra fully-charged battery
* Chainsaw for quickly cutting large branches (optional)
* 17 mm wrench used for U-Clamps
* Garden wire for temporary installations
* 16 foot (5 meter) foldable ladder
* Handheld radio (Walkie-talkie) or other alternative means of communication for locations with no cell connectivity

{% hint style="info" %}
**See Also**

For more information, see [Preparation guidelines](https://docs.dryad.app/dryad-documentation/silvanet-deployment/guidelines).
{% endhint %}

### **Deployment app installed**

Ensure the Deployment app is installed on a fully charged Smartphone.

{% hint style="info" %}
Before heading into the deployment area, find a location with good mobile connectivity and launch the Deployment app on the Smartphone. Then select the Site.
{% endhint %}

## 3. Deploy Border Gateway

Deploy the Border Gateway to make a connection with the Silvanet Cloud Platform.

### **Select Border Gateway**

1. In the [Deployment app](https://docs.dryad.app/dryad-documentation/silvanet-suite/deployment-app#map-view), tap the Site generated by the Planning tool.
2. From the list of devices, tap a Border Gateway.
3. The **Register Device** screen appears. Your location is indicated by a blue dot on the map.

<figure><img src="https://2403147378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqvtUjx9C2FEFg7nicAx%2Fuploads%2FS7pLFNUgvr5I3vzNKKKW%2Fbg-select-device.png?alt=media&#x26;token=a9a816c0-70bf-400e-b7c5-62258091fb5b" alt="" width="188"><figcaption><p>Register Border Gateway</p></figcaption></figure>

### **Register Border Gateway**

1. Using the Deployment app, move towards the deployment location for the Border Gateway.
2. Once at the location, tap **Register Device** to open the Scanning screen.
3. Scan the device's QR Code to [register the Border Gateway](https://docs.dryad.app/dryad-documentation/silvanet-deployment/deploy-bg/register-bg).
4.

```
<figure><img src="../.gitbook/assets/bg-scan-qr-code (1).png" alt="" width="188"><figcaption><p>Scan QR Code</p></figcaption></figure>
```

5. The **Registration successful** screen appears.

<figure><img src="https://2403147378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqvtUjx9C2FEFg7nicAx%2Fuploads%2Fc4WYLxKCd5GGpwe5T5EC%2Fbg-registration-successful.png?alt=media&#x26;token=07cdda05-252f-4f64-822f-e8a2f195323d" alt="" width="188"><figcaption><p>Registration successful</p></figcaption></figure>

### **Mount Border Gateway**

1. Use treenails (for trees) or U-Clamps (for poles) to mount the Border Gateway 3 m above ground level.
2. Use garden wire to vertically mount the solar panel above the Border Gateway and face it towards the sun (at 12:00 noon).
3. Connect the solar panel to the Border Gateway using the provided cable and connector.

<figure><img src="https://2403147378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqvtUjx9C2FEFg7nicAx%2Fuploads%2FDiTlXhfuo7niSZOtXfeI%2Fbg-mount-border-gateway.png?alt=media&#x26;token=64bacf78-230d-46e5-a12c-aa6a8edda2dc" alt="" width="188"><figcaption><p>Mount Border Gateway</p></figcaption></figure>

{% hint style="warning" %}
Do not mount the solar panel behind the Border Gateway.
{% endhint %}

4. If available, use a mains power supply and router, with the PoE Injector. as described in [Border Gateway scenarios](https://docs.dryad.app/dryad-documentation/silvanet-deployment/guidelines/border-gateway-deployment-scenarios#wired-mains-and-router).

### **Run Connectivity test**

Run the connectivity test to ensure the Border Gateway has connectivity to the Silvanet Cloud.

1. Tap **Confirm & Start Connectivity Test** to begin.

<figure><img src="https://2403147378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqvtUjx9C2FEFg7nicAx%2Fuploads%2FdiaLJVj3Ii3m25B9YuE5%2Fbg-waiting-for-connectivity.png?alt=media&#x26;token=3f3640d8-489a-4df8-a3f1-06ce11046fd6" alt="" width="188"><figcaption><p>Run Connectivity Test</p></figcaption></figure>

2. If unsuccessful, follow the troubleshooting information provided in the app, then restart the Connectivity Test.
3. If successful, tap **Close** or **Show Device Details**.

<figure><img src="https://2403147378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqvtUjx9C2FEFg7nicAx%2Fuploads%2F8NYZtHfgXsFHXfPA3O5J%2Fbg-connectivity-test-successful.png?alt=media&#x26;token=9d33bc8a-14dd-45e8-96bc-82d9e9b92f48" alt="" width="188"><figcaption><p>Successful connectivity test</p></figcaption></figure>

{% hint style="info" %}
**See Also**

For more information, see [Deploy Border Gateways](https://docs.dryad.app/dryad-documentation/silvanet-deployment/deploy-bg).
{% endhint %}

## 4. Deploy Mesh Gateways

With the Border Gateway connected to the Silvanet Cloud, you can begin deploying the Mesh Gateways to build up a Silvanet Mesh Network.

### **Select Mesh Gateway**

1. Tap a Mesh Gateway from the list of devices.
2. The **Register Device** screen appears. Your location is indicated by a blue dot on the map.

<figure><img src="https://2403147378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqvtUjx9C2FEFg7nicAx%2Fuploads%2FspZbFyd889wwjH3emQry%2Fmg-gen2-register-device.png?alt=media&#x26;token=8f9a4f12-704c-4942-98db-7b1fca26c7b6" alt="" width="188"><figcaption><p>Find deployment location</p></figcaption></figure>

3. Using the Deployment app, move towards the deployment location.

### **Register Mesh Gateway**

1. Once at the location, tap **Register Device** to open the Scanning screen.
2. Scan the device's QR Code to register the Mesh Gateway.

<figure><img src="https://2403147378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqvtUjx9C2FEFg7nicAx%2Fuploads%2FAGFCGajyWhYTuFiPY0ct%2Fmg-gen2-scan-qr-code.png?alt=media&#x26;token=2f944232-bbef-4b69-a91b-40929a0abc38" alt="" width="188"><figcaption><p>Scan QR Code</p></figcaption></figure>

### **Mount Mesh Gateway**

1. Find the location on the tree or pole that is at a minimum of 3 m above ground level and is oriented towards the sun (at 12:00 noon).
2. Using tree nails (for trees) or U-Clamps (for poles), mount the Mesh Gateway at least 3 m above ground level.

<figure><img src="https://2403147378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqvtUjx9C2FEFg7nicAx%2Fuploads%2FF7bZFm4sOv7bobz3Kk8h%2Fmg-gen2-mount-mesh-gateway.png?alt=media&#x26;token=cf525786-c3fe-4d2e-ae6c-1cfbc074a249" alt="" width="188"><figcaption><p>Mount Mesh Gateway</p></figcaption></figure>

### **Run Connectivity test**

1. Ensure the Mesh Gateway is securely mounted.
2. Tap **Confirm & Start Connectivity Test** to run a Connectivity test. This test ensures the device has connectivity to the Border Gateway and/or Mesh Network.
3. If the Border Gateway cannot be reached, follow the information provided in the app and restart the test.
4. If the Mesh Gateway can communicate with neighboring Gateways but the signal is too weak, follow the information provided in the app and restart the test.
5. If successful, tap Close or Show Device Details, then go ahead and deploy the next Mesh Gateway.

### **Deploy next Mesh Gateway**

Use the same procedures to deploy the remaining Mesh Gateways.

{% hint style="info" %}
**See Also**

For more information, see [Deploy Mesh Gateways](https://docs.dryad.app/dryad-documentation/silvanet-deployment/deploy-mg).
{% endhint %}

## 5. Deploy Wildfire Sensors

### **Select Wildfire Sensor**

1. Tap a Wildfire Sensor from the list of devices.
2. The **Register Device** screen appears. Your location is indicated by a blue dot on the map.

<figure><img src="https://2403147378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqvtUjx9C2FEFg7nicAx%2Fuploads%2F9Z0sISBQYMRusS8eK9V8%2Fsensor-gen2-register-device.png?alt=media&#x26;token=1d9d5a5e-a39c-4806-8601-f9d14474699e" alt="" width="168"><figcaption><p>Register Device</p></figcaption></figure>

3. Move towards the Sensor deployment location.
4. Once at the location, find a stable tree that is healthy and unlikely to be cut down.
5. Tap **Register Device** to open the Scanning screen.

### **Register Wildfire Sensor**

1. Before mounting the Sensor, use the Deployment app to scan the QR Code on the Sensor. This app then registers the Wildfire Sensor.
2. After connecting with the Silvanet Cloud via the Silvanet Mesh Network, the **Registration successful** screen appears.

<figure><img src="https://2403147378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqvtUjx9C2FEFg7nicAx%2Fuploads%2FTYXMPFaOexviLMK1iPgv%2Fsensor-gen2-registration-successful.png?alt=media&#x26;token=293e270e-32f4-44cb-b6cc-db97a19e81ce" alt="" width="168"><figcaption><p>Registration successful</p></figcaption></figure>

### **Mount Wildfire Sensor**

1. Find the location on the tree that is at a minimum of 3 m above ground level. Use a chisel or axe to remove any protruding bark at the location. Do not overly damage the bark.
2. Use a tree nail and spacer to mount the Wildfire Sensor.

<figure><img src="https://2403147378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqvtUjx9C2FEFg7nicAx%2Fuploads%2FKMfQlXejclCwWjTJhPBb%2Fsensor-gen2-mount-sensor.png?alt=media&#x26;token=91b558f3-fc6e-4cc7-b3d4-6238c3f43b31" alt="" width="168"><figcaption><p>Mount the Sensor</p></figcaption></figure>

{% hint style="info" %}
For temporary mounting, use garden wire to secure the Sensor to a tree.
{% endhint %}

3. Ensure the Sensor is securely attached to the tree.
4. Tap **Confirm** to complete the deployment.
5. The **Installation successful** screen appears.

<figure><img src="https://2403147378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqvtUjx9C2FEFg7nicAx%2Fuploads%2FDwx5bem1DEGLxZ7RnDXc%2Fsensor-gen2-installation-successful.png?alt=media&#x26;token=f2071655-48c6-4253-965d-03d0e5e390a6" alt="" width="168"><figcaption><p>Successful installation</p></figcaption></figure>

3. Tap **Close** or **Show Device Details**.

<figure><img src="https://2403147378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqvtUjx9C2FEFg7nicAx%2Fuploads%2FaLlS7ToycADXicyMav3C%2Fsensor-installed.jpg?alt=media&#x26;token=5fb7562b-ddfb-4abd-9932-17d740e32028" alt="" width="375"><figcaption><p>Mounted Wildfire Sensor</p></figcaption></figure>

### **Allow Wildfire Sensor to calibrate**

Allow 14 days for the Wildfire Sensors to [calibrate](https://docs.dryad.app/dryad-documentation/silvanet-deployment/deploy-sensors/sensor-calibration).

{% hint style="info" %}
**See Also**

For more information, see [Deploy Wildfire Sensors](https://docs.dryad.app/dryad-documentation/silvanet-deployment/deploy-sensors).
{% endhint %}

## Next steps

After calibration, the Silvanet Suite of Gateways and Sensors are now ready for fire detection.

Review the [**Site details**](https://docs.dryad.app/dryad-documentation/silvanet-suite/silvanet-sma/site-view) section of a Site in the Site Management app to ensure all Sensors are sending data.

{% hint style="info" %}
**See Also**

For more information, see [Site details](https://docs.dryad.app/dryad-documentation/silvanet-suite/silvanet-sma/site-view).
{% endhint %}