# Manhole Cover Monitoring

## Introduction

**Supported in:** [SimplePack 2.0](https://gitlab.com/simplehw/ask/-/blob/asksync/working-with-devices/devices/simplepack/simplepack-3-0-and-4-0-plus.md), [SimplePack 3.0/4.0 Plus](https://gitlab.com/simplehw/ask/-/blob/asksync/working-with-devices/devices/simplepack/simplepack-3-0-and-4-0-plus.md), [SimpleIndustry](https://gitlab.com/simplehw/ask/-/blob/asksync/working-with-devices/devices/simpleindustry-simplemeter/simpleindustry-introduction.md)

**Intended for:** End users and integrators & platform providers to understand device behavior before direct implementation and fine-tuning (for those who want to integrate the device into their own platform, the firmware documentation is here: [API 6](https://simplehw.atlassian.net/wiki/spaces/DOC/overview) and [API 5](https://docs.google.com/spreadsheets/d/1616krkTZz6iCMI5YTxwOo10u3eYOwVr7-IzNzN86Kkw/))

**Use case description:** We will use the SimplePack mode **Put me back** - the device, installed on a manhole cover, will behave like this: First, when the device detects the cover being opened, you will receive a movement detection message. When the interaction is over and no movement is detected anymore, a time countdown will start and when it reaches zero, the device will send you a second message that will contain data from the accelerometer, which you can then use to determine what happened to the manhole cover - if it was returned to the original position or remained opened.

## Prerequisites

Before-you-start checklist (you should have everything on the list if you went through the [first message guide](/kb/simple-api-6-generation/i-am-iot-platform-provider/first-message.md)):

✅ Hardware/devices\
✅ Sigfox connectivity\
✅ Sigfox coverage where you need it\
✅ IO Frog platform account and access\
✅ Correctly set-up callbacks in the Sigfox backend (if you're using your own connectivity)\
✅ [You're receiving messages from your devices](/kb/simple-api-6-generation/i-am-iot-platform-provider/first-message.md)\
✅ *Everything is fine!*

## Step-by-step setup guide

1\. Go to the IO Frog platform and **login** with your account.

![image](/files/tpHvEhk4OHBOdHfeRkSd)

2\. After you login, head over to your profile in the top right and make sure your Experience level is **Expert**, otherwise you will not be able to change device downlink - if necessary, increase your level and hit Update to save the changes.

![image](/files/LaFPOS8ad3ibEY8NOiqj)

3\. Go to the All devices tab and click on device **Setup**.

![image](/files/o2pp44Hf2uFnnfo8wgVE)

4\. In the downlink tab, set the mode to **Put me back** (0...0106 in the top bar), hit Update.

![image](/files/mxQa6HWRpBbB29MjDZTl)

5\. Press the button of your device for 10+ (SP 2.0) or 6+ (SP 3.0 Plus) seconds, this will trigger downlink with the new settings - the **LED** will keep blinking for about a minute.

```
 If you're working with the **SimpleIndustry** or the **SimpleMeter**, you need to either wait for the heartbeat that will request downlink (older prototypes) or you will use a **magnet** on the reed switch instead of pressing the button. The time of operation is the same (6s+ of magnet presence to trigger downlink, 2-4s to disarm device, 1s to arm).
```

| SimplePack 2.0                                 | SimplePack 3.0/4.0 Plus                                 |
| ---------------------------------------------- | ------------------------------------------------------- |
| ![SimplePack 2.0](/files/8Wldhlom6ucgPlA1DxLQ) | ![SimplePack 3.0/4.0 Plus](/files/LHBrdQTMdegLeiSNbgee) |

6\. Once the LED stops blinking, you can place the device where you need it: use a heavy-duty double-sided tape or maybe magnets to stick it to the manhole cover. Please note that if the manhole is made of metal as most are, it's preferable to use a 2-3 cm plastic spacer (read more in our [article about device placement](/kb/simple-api-6-generation/device/correct-device-placement.md)).

7\. Once placed, activate the device by pressing the button and try opening and closing the cover to see if you get the messages right. *There, all done!*

Please note that Sigfox has a **90% delivery success rate**. It's possible that the downlink will not be received by the device, the best way forward in this case is simply **repeating the whole process from Step 4 onwards**.

## Suggestions

* If you're getting **false or limited reports** of usage, try playing around with **accelerometer sensitivity settings** (the higher the number, the less sensitive the sensor).
* If you're **losing a lot of messages**, set up **3x alert repetition**. This will better the performance of your device and you should lose less messages.
* **Public data sharing:** IO Frog also supports public channels, where you can add multiple devices and display data from all of them at the same time, including their position on a world map. It's very cool and we highly suggest you take a look! Here's our [coffee project](https://www.iofrog.com/public/iofrog/en/?channel=S2LZHUMFVQDNWFUM) and here's [how to set a public channel up](/kb/simple-api-6-generation/i-am-iot-platform-provider/public-channel-setup.md).

![image](/files/apnyfPvACRk5KeIBXf2P)


---

# 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://ask.simplehw.eu/kb/simple-api-6-generation/i-am-iot-platform-provider/manhole-cover-monitoring.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.
