# GIOT by Gimasi

English Guide Books

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td></td><td></td><td></td><td></td><td></td></tr><tr><td></td><td>Journey to Getting Started with GIOT</td><td></td><td><a href="/files/309HDO5lxZedxhF3rYdt">/files/309HDO5lxZedxhF3rYdt</a></td><td><a href="/pages/LuAaD5Xn6vPDmOJctcgF">/pages/LuAaD5Xn6vPDmOJctcgF</a></td></tr><tr><td></td><td></td><td></td><td></td><td></td></tr></tbody></table>

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td></td><td>Platform User  Guide Book</td><td></td><td><a href="/pages/DMY3esMBJfBLrNP9GQOa">/pages/DMY3esMBJfBLrNP9GQOa</a></td><td><a href="/files/sh1UjkP9j8BoOi5Z7zpn">/files/sh1UjkP9j8BoOi5Z7zpn</a></td></tr><tr><td></td><td>Level Meter Full Device Guide Book</td><td></td><td><a href="/pages/na6FOd33pe3leE3nu82U">/pages/na6FOd33pe3leE3nu82U</a></td><td><a href="/files/SsLIIY4hzyLPKLQMx6eh">/files/SsLIIY4hzyLPKLQMx6eh</a></td></tr><tr><td></td><td>Low Cost Tracker Full Device Guide Book</td><td></td><td><a href="/pages/xxE2wklApzPLAqlIUrUE">/pages/xxE2wklApzPLAqlIUrUE</a></td><td><a href="/files/A1CB6BBArOBHjJGtTIwH">/files/A1CB6BBArOBHjJGtTIwH</a></td></tr><tr><td>Low Cost Tracker - Device Transport Rules</td><td></td><td></td><td><a href="/pages/M4RvB3AoiEr3Q5l7UvKc">/pages/M4RvB3AoiEr3Q5l7UvKc</a></td><td><a href="/files/Dm8o1IoXyLQ9n786n6oD">/files/Dm8o1IoXyLQ9n786n6oD</a></td></tr><tr><td>Level Meter - Device Transport Rules</td><td></td><td></td><td><a href="/pages/StDiFbvT4bgTSEAKPaS0">/pages/StDiFbvT4bgTSEAKPaS0</a></td><td><a href="/files/jffa17i0oLFmDbMeAKMx">/files/jffa17i0oLFmDbMeAKMx</a></td></tr><tr><td></td><td>.PDF Guide BOOKs</td><td></td><td><a href="/pages/b2qiqAmArJ1sDOzSbfcH">/pages/b2qiqAmArJ1sDOzSbfcH</a></td><td><a href="/files/hEFPe31GVRMEXe1B9XYI">/files/hEFPe31GVRMEXe1B9XYI</a></td></tr><tr><td></td><td>.PDF Conceptual</td><td></td><td><a href="/pages/AZWkxVsF5DpAyGo5NzGh">/pages/AZWkxVsF5DpAyGo5NzGh</a></td><td><a href="/files/nhUYjkFLumTpiS9AgabA">/files/nhUYjkFLumTpiS9AgabA</a></td></tr><tr><td></td><td>.PDF Technical</td><td></td><td><a href="/pages/cqRtjf204PF3ErcIaDmf">/pages/cqRtjf204PF3ErcIaDmf</a></td><td><a href="/files/QANimnCPwNJYbfjzCzyl">/files/QANimnCPwNJYbfjzCzyl</a></td></tr><tr><td>FAQs -</td><td></td><td></td><td><a href="/pages/G1P2VAzWD447E6y3k86D">/pages/G1P2VAzWD447E6y3k86D</a></td><td><a href="/files/wofXU6FLBgdVyaZHWK4J">/files/wofXU6FLBgdVyaZHWK4J</a></td></tr></tbody></table>


# Introduction to gIot Documentations

Understand how this document-based website operates.

The website is powered by AI, allowing you to search the entire document in your preferred language using the search bar located in the top-right corner. Answers will be provided directly or with references to the sources from which they are generated.

From the menu on the right, you can access all sections and files.

**Platform User Guide:** Comprehensive instructions detailing all sections and functions of the platform.

{% hint style="info" %}
User Guide Book\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/138/platform-user-guide-book](/platform-user-guide-book)<br>
{% endhint %}

**Level Meter Full Guide Book** and **Low Cost Tracker Full Guide Book:** Complete instructions for each device, including handling information and detailed explanations of all platform functions specific to the device type.

{% hint style="info" %}
LEVEL METER Full Guide Book\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/138/level-meter-full-device-guide-book](/level-meter-full-device-guide-book)
{% endhint %}

{% hint style="info" %}
Low Cost Trackeer Full Guide Book\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/138/low-cost-tracker-full-device-guide-book](/low-cost-tracker-full-device-guide-book)
{% endhint %}

**PDF Files for Download:** General documents categorized into **Conceptual**, **Technical**, and **Platform and Device** sections.

> **NOTE:** You can download any guide, page, or section from this website by clicking ***Export as PDF*** on the right side of the screen.

### Also, review the handling instructions provided for each device type.

{% hint style="info" %}
Level Meter Handling\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/138/level-meter-full-device-guide-book/level-meter-handeling-information-book](/level-meter-full-device-guide-book/level-meter-handeling-information-book)
{% endhint %}

{% hint style="info" %}
Low Cost Tracker  Handling\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/138/low-cost-tracker-full-device-guide-book/low-cost-tracker-handling-information-book](/low-cost-tracker-full-device-guide-book/low-cost-tracker-handling-information-book)
{% endhint %}

### Here, you can access and read the hardware datasheets.

{% hint style="info" %}
Level  Meter Data sheet\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/140/level-meter-full-device-guide-book/level-meter-handeling-information-book/level-meter-technical-specification](/level-meter-full-device-guide-book/level-meter-handeling-information-book/level-meter-technical-specification)
{% endhint %}

{% hint style="info" %}
Low Cost Tracker Data Sheet\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/140/low-cost-tracker-full-device-guide-book/low-cost-tracker-handling-information-book/low-cost-tracker-technical-specification](/low-cost-tracker-full-device-guide-book/low-cost-tracker-handling-information-book/low-cost-tracker-technical-specification)
{% endhint %}


# Journey to Getting Started with giot

### **Embarking on Your giot Journey**

This section serves as a comprehensive walkthrough, guiding you through the initial steps of your experience in the giot environment. From setting up your profile to configuring devices, managing alarms, and creating custom dashboards, this guide ensures you are equipped to navigate and maximize the platform's capabilities effectively.<br>

<figure><img src="/files/309HDO5lxZedxhF3rYdt" alt=""><figcaption></figcaption></figure>


# 1. First Log-in

Login to the Tenant or Subtenant using the invitation link sent upon profile creation. Depending on the admin’s settings, login may require either a password-only method or Two-Factor Authentication (2FA) via a third-party app. If **Optional 2FA** is enabled, users can choose whether to Login via only Pw. or with 2FA. Additionally, the admin can enforce security policies such as limiting password attempts, setting restrictions per user, or disabling accounts if necessary.

{% hint style="success" %}
Follow the link to the Step Guide to Login\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/304/platform-user-guide-book/user-registration-and-account-confirmation](/platform-user-guide-book/user-registration-and-account-confirmation)
{% endhint %}

{% hint style="warning" %}
**Attention:** If login is unsuccessful for any reason, contact your Super-Admin for clarification and assistance.
{% endhint %}

{% hint style="success" %}
Download **Microsoft Authenticator** APP on your SmartPhone; \
**Android:** <https://play.google.com/store/apps/details?id=com.azure.authenticator&hl=en&pli=1>\
**Apple:** <https://apps.apple.com/us/app/microsoft-authenticator/id983156458>
{% endhint %}

{% hint style="success" %}
Download **Google Authenticator** APP on your SmartPhone; \
**Android:** <https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2&hl=en>

**Apple:** <https://apps.apple.com/us/app/google-authenticator/id388497605>
{% endhint %}


# 2. Update Profile Password

It is strongly advised that new users create a personal password that meets high-security standards upon their first login.

{% hint style="success" %}
Update Psswrod.\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/140/platform-user-guide-book/user-registration-and-account-confirmation/user-profile/change-or-update-profile-password](/platform-user-guide-book/user-registration-and-account-confirmation/user-profile/change-or-update-profile-password)
{% endhint %}


# 3. Edit User Profile

Choose your preferred language for the platform and set general profile details such as username and location.

{% hint style="success" %}
User Profile general settings.\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/145/platform-user-guide-book/user-registration-and-account-confirmation/user-profile/settings](/platform-user-guide-book/user-registration-and-account-confirmation/user-profile/settings)
{% endhint %}

Update your profile picture to ensure your team can recognize you immediately.

{% hint style="success" %}
Profile Avatar\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/145/platform-user-guide-book/user-registration-and-account-confirmation/user-profile/profile-avatar](/platform-user-guide-book/user-registration-and-account-confirmation/user-profile/profile-avatar)
{% endhint %}

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfEQ6KpTjmszWVWQqgcEa%2Fuploads%2FZrQFRFB7dYLGIMVHNIbZ%2FProfile%20editing%20eng..mp4?alt=media&token=2be55712-36d4-4620-9242-5a503c724f8e>" %}


# 4. Platform Overview and Dashboard

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfEQ6KpTjmszWVWQqgcEa%2Fuploads%2FWQFJbT3SKYYbifan09eT%2FFirst%20LogIn%20Intro%20EN.mp4?alt=media&token=b3422dbc-c0dc-4cc8-bd26-499e608640e9>" fullWidth="false" %}

## The difference between the sidebar menu in ***Asset*** and ***Cockpit*** lies in their functionality and focus:

{% hint style="success" %}
Assets Menu\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/145/platform-user-guide-book/user-registration-and-account-confirmation/assets-menu](/platform-user-guide-book/user-registration-and-account-confirmation/assets-menu)
{% endhint %}

{% hint style="success" %}
Cockpit Menu\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/145/platform-user-guide-book/user-registration-and-account-confirmation/cockpit-menu](/platform-user-guide-book/user-registration-and-account-confirmation/cockpit-menu)
{% endhint %}

### Understand the **Home Screen (Home Dashboard)**, including **Quick Access** and **Widgets**.

Customize your dashboard: select existing dashboards or create new ones to have quick access in the **Assets View** menu.

{% hint style="success" %}
Select New home Dashboard\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/145/platform-user-guide-book/dashboards/select-home-dashboard](/platform-user-guide-book/dashboards/select-home-dashboard)
{% endhint %}

{% hint style="success" %}
Create new or modify widgets on Dashboards\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/145/platform-user-guide-book/dashboards/create-new-dashboard](/platform-user-guide-book/dashboards/create-new-dashboard)
{% endhint %}

{% hint style="success" %}
Select more dashboard as Quick-Access, for an agile work flow monitoring.\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/145/platform-user-guide-book/dashboards/quick-access-dashboard](/platform-user-guide-book/dashboards/create-quick-access-dashboard)
{% endhint %}


# 5. User Management

**Understand Super-Admin user privileges vs. regular user permission.**

SuperAdmin privileges grant unrestricted access to all features and settings within the platform, including user management, tenant configuration, and advanced administrative controls. Other users are assigned specific roles with permissions tailored to their needs, which means there is no 'regular user'—access levels vary depending on the permissions granted to their role. These roles allow for granular control, ensuring each user has access only to the functions necessary for their responsibilities.

**Add user to the  Tenant/ Subtenant.**

{% hint style="success" %}
Create new User [https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/145/platform-user-guide-book/administration/user/create-new-user](/platform-user-guide-book/administration/user/create-new-user)
{% endhint %}

**Assign/Modify Role to Tenant's user**&#x20;

{% hint style="success" %}
Assign Role to User\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/145/platform-user-guide-book/administration/user/assign-role-to-user](/platform-user-guide-book/administration/user/switch-role-to-a-user)
{% endhint %}


# 6. Device Activation and set its properties

All devices are automatically onboarded to your Tenant profile upon purchase. Once received, ensure the new device is activated to complete the bootstrap process and connect it seamlessly to the platform.

### Activate the device LCT and LM Devices

{% hint style="success" %}
Activate Low Cost Tracker \
\
[**VIDEO INSTRUCTION**](/low-cost-tracker-full-device-guide-book/low-cost-tracker-handling-information-book/low-cost-tracker-activation-process)\
\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/145/low-cost-tracker-full-device-guide-book/low-cost-tracker-handling-information-book/low-cost-tracker-initial-setup](/low-cost-tracker-full-device-guide-book/low-cost-tracker-handling-information-book/low-cost-tracker-activation-process)
{% endhint %}

{% hint style="success" %}
Activate Level Meter\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/145/level-meter-full-device-guide-book/level-meter-handeling-information-book/level-meter-activation-procedure](/level-meter-full-device-guide-book/level-meter-handeling-information-book/level-meter-activation-procedure)
{% endhint %}

### How to identify Bootstrap state? And the device Properties.

{% hint style="success" %}
Device page introduction\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/145/platform-user-guide-book/device/device-page-introduction](/platform-user-guide-book/device/device-page-introduction)
{% endhint %}

### Device card shows - Not Activated - ?

<figure><img src="/files/r1s7GgWOMRnx4FiSXBEI" alt=""><figcaption><p>Device not Activated</p></figcaption></figure>

{% hint style="success" %}
Follow the link to lean more about devices Not Activated:\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/313/platform-user-guide-book/device/device-page-introduction](/platform-user-guide-book/device/device-page-introduction)
{% endhint %}

### From the PROPERTIES section you can also:

* Rename device.
* Add a device description.&#x20;
* Upload asset pictures.


# 7. Finding Devices on the platform

### Find the Device on the platoform via Serial Number, printed o the device or on the device page

{% hint style="success" %}
LCT - Device Serial Number/ Search Device\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/151/low-cost-tracker-full-device-guide-book/locating-an-lct-device-on-the-giot-platform](/low-cost-tracker-full-device-guide-book/locating-a-lct-device-on-the-giot-platform)
{% endhint %}

{% hint style="success" %}
LM- Device Serial Number/ Search Deivce\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/151/level-meter-full-device-guide-book/locating-an-lm-device-on-the-giot-platform](/level-meter-full-device-guide-book/locating-an-lm-device-on-the-giot-platform)
{% endhint %}


# 8. Device Configuration

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfEQ6KpTjmszWVWQqgcEa%2Fuploads%2FoYUxDfA8DrICBD41tRlg%2FLM%20and%20LCT%20configuration%20EN.mp4?alt=media&token=a7b963b7-168c-4720-91da-0375cf763e6c>" %}

### Configuring individual devices

{% hint style="success" %}
Device Configuration\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/151/platform-user-guide-book/device/device-dashboard-details/device-configuration](/platform-user-guide-book/device/device-dashboard-details/device-configuration)
{% endhint %}

### Share configurations across multiple devices.

You can Copy one device configuration to group of devices.

{% hint style="success" %}
Copy Configuration\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/351/platform-user-guide-book/device/device-dashboard-details/device-configuration/copy-configuration](/platform-user-guide-book/device/device-dashboard-details/device-configuration/copy-configuration)<br>
{% endhint %}

### Understand Adaptive Configuration.

Adaptive Configuration allows the platform to dynamically adjust device settings based on specific triggers, such as entering or leaving a geofence area. This feature ensures tailored configurations are applied to devices only when needed, optimizing performance and resource usage. By leveraging Adaptive Configuration, users can create responsive and efficient workflows, minimizing manual intervention.


# 9. Device Dashboards

### Let's look at each device Dashboard Type&#x20;

{% hint style="success" %}
LM Device Dashboard - overview\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/151/level-meter-full-device-guide-book/level-meter-greater-than-giots-function/lm-device-dashboard](/level-meter-full-device-guide-book/level-meter-greater-than-giots-function/lm-device-dashboard)
{% endhint %}

{% hint style="success" %}
LCT Device Dashboard - Overview\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/151/low-cost-tracker-full-device-guide-book/low-cost-tracker-greater-than-giots-functions/lct-device-dashboard](/low-cost-tracker-full-device-guide-book/low-cost-tracker-greater-than-giots-functions/lct-device-dashboard)
{% endhint %}

### Add widgets to device dashboard

{% hint style="success" %}
LM - Add widget\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/151/level-meter-full-device-guide-book/level-meter-greater-than-giots-function/lm-device-dashboard/lm-add-widgets](/level-meter-full-device-guide-book/level-meter-greater-than-giots-function/lm-device-dashboard/lm-add-widgets)
{% endhint %}

{% hint style="success" %}
LCT - Add widget [https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/151/low-cost-tracker-full-device-guide-book/low-cost-tracker-greater-than-giots-functions/lct-device-dashboard/lct-widgets](/low-cost-tracker-full-device-guide-book/low-cost-tracker-greater-than-giots-functions/lct-device-dashboard/lct-add-widgets)
{% endhint %}

### Copy one device dashboard to a group of Device

{% hint style="success" %}
Copy LM Device Dashboard\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/151/level-meter-full-device-guide-book/level-meter-greater-than-giots-function/lm-device-dashboard/lm-copy-dashboard](/platform-user-guide-book/device/device-dashboard-details/copy-device-dashboard)
{% endhint %}

### Reset Default dashboard

{% hint style="success" %}
Reset Device Dashboard\
<https://docs.g-iot.io/platform-user-guide-book/device/device-dashboard-details/reset-default-dashboard>
{% endhint %}


# 10. Tracking  a Device

Learn how to configure your  device's location type to **Dynamic** or **Static**. This setting ensures optimal functionality tailored to your device's intended use case, whether for tracking moving assets or monitoring stationary objects.

{% hint style="success" %}
Location Type\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/202/low-cost-tracker-full-device-guide-book/low-cost-tracker-greater-than-giots-functions/lct-device-properties/lct-details-page/location-type ](/low-cost-tracker-full-device-guide-book/low-cost-tracker-greater-than-giots-functions/lct-device-properties/lct-details-page/location-type)
{% endhint %}

{% hint style="warning" %}
Only when the device is set to Dynamic it will be possible to generate the history locations of the device.
{% endhint %}

### Track Last position or&#x20;

To visualize the last position of the **device**, simply add the **Map Widget** to the device dashboard. This will display the most recently updated position of the device.

{% hint style="success" %}
Widget- LCT Map [https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/203/low-cost-tracker-full-device-guide-book/low-cost-tracker-greater-than-giots-functions/lct-device-dashboard/lct-add-widgets/lct-map-widget ](/low-cost-tracker-full-device-guide-book/low-cost-tracker-greater-than-giots-functions/lct-device-dashboard/lct-add-widgets/lct-map-widget)
{% endhint %}

### See positions within specific Timeframe

To view the **position history** of the **device** within a specific timeframe, ensure that the **Position Type** is set to **Dynamic**. Then, configure the **Map Widget** settings to define the desired timeframe. It is also possible to see the **Events time** directly on the **Map Widget side**

<figure><img src="/files/alDQRlsISWYFZuJcvv6V" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Set location Type\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/202/low-cost-tracker-full-device-guide-book/low-cost-tracker-greater-than-giots-functions/lct-device-properties/lct-details-page/location-type ](/low-cost-tracker-full-device-guide-book/low-cost-tracker-greater-than-giots-functions/lct-device-properties/lct-details-page/location-type)
{% endhint %}


# 11. Manage Events

### Differentiating between device-generated and backed-received events

Device-generated events are initiated directly by the device, such as motion detection, temperature readings, or geolocation updates. These events are transmitted to the platform in real time. Backend-received events are those processed and logged by the platform after analyzing device data, such as alarms triggered by exceeding thresholds or geofence breaches. Understanding this distinction helps users identify whether an issue originates at the device or within the platform's processing logic.<br>

### Understand what is visible in the Event View page.

{% hint style="success" %}
Events and Device Events\
<https://docs.g-iot.io/platform-user-guide-book/events>
{% endhint %}


# 12. Manage Rules

Rules allow users to define automated actions and alerts based on device data or specific conditions, ensuring efficient monitoring and management. By setting up rules, users can trigger alarms, send notifications, or modify device behavior based on predefined criteria such as temperature, geofencing, or battery levels. Creating a rule involves selecting the rule type, defining its parameters, and configuring notifications, all tailored to the device's capabilities and operational needs.

### How to set and What are the LM and LCT rules?

{% hint style="success" %}
LM - Rules\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/152/level-meter-full-device-guide-book/level-meter-greater-than-giots-function/lm-rules](/level-meter-full-device-guide-book/level-meter-greater-than-giots-function/lm-rules)
{% endhint %}

{% hint style="success" %}
LCT - Rules\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/152/low-cost-tracker-full-device-guide-book/low-cost-tracker-greater-than-giots-functions/lct-rules](/low-cost-tracker-full-device-guide-book/low-cost-tracker-greater-than-giots-functions/lct-rules)
{% endhint %}


# 13. Set and manage Alarms

Managing alarms allows users to efficiently monitor and respond to critical events. The platform provides tools to view, categorize, and resolve alarms based on their severity levels, such as Critical, Major, Minor, or Warning. Users can customize these severity levels to align with their operational priorities, ensuring timely action and streamlined workflows. By tailoring alarm settings, notifications, and resolutions, the platform ensures that alarms are both actionable and relevant to your needs.

### Learn everything about Alarms page, for devices and Cockpit menu.

{% hint style="success" %}
Device Alarms: [Alarms](/platform-user-guide-book/alarms)
{% endhint %}

{% hint style="success" %}
Monitor and resolve Alarms: [Alarm Monitoring and Resolution](https://docs.g-iot.io/~/revisions/4dPVbfVG3VvIKuPhDs4P/platform-user-guide-book/alarms/alarm-monitoring-and-resolution)
{% endhint %}


# 14. Template > Configuration

Learn the Configuration page details.

{% hint style="success" %}
Configuration Page.\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/152/platform-user-guide-book/template/configuration-page](/platform-user-guide-book/template/configuration-page)
{% endhint %}

### **Advantages of Configurations Templates**

Using configuration templates streamlines the process of managing device settings across multiple devices. Templates offer the following advantages:

1. **Consistency**: Ensure uniform settings across devices of the same type, reducing the risk of configuration errors.
2. **Efficiency**: Save time by avoiding manual configuration for each device. Set up once and apply to multiple devices.
3. **Scalability**: Easily manage large groups of devices with consistent parameters, even as your fleet grows.
4. **Adaptability**: Quickly update configurations across devices by editing a single template.

### **Assigning Configurations to Devices**

1. **By Rules**: Use adaptive configuration rules to apply it in the LTC device

{% hint style="success" %}
LCT - Adaptive Configuration Rules\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/152/low-cost-tracker-full-device-guide-book/low-cost-tracker-greater-than-giots-functions/lct-rules/lct-adaptive-configuration-rule](/low-cost-tracker-full-device-guide-book/low-cost-tracker-greater-than-giots-functions/lct-rules/lct-adaptive-configuration-rule)
{% endhint %}


# 15. Create and Apply Geofences

### Understand what Geofences are and where can be applied

{% hint style="success" %}
Geofence\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/152/platform-user-guide-book/geofence](/platform-user-guide-book/geofence)
{% endhint %}

### How to Create Geofence

{% hint style="success" %}
Create Grofence\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/152/platform-user-guide-book/geofence/create-geofence](/platform-user-guide-book/geofence/create-geofence)
{% endhint %}


# 16. Group and Subgroup Management

## Understand how to create Groups and Subgroups

{% hint style="success" %}
Create Group\
<https://docs.g-iot.io/platform-user-guide-book/group/create-groups>
{% endhint %}

{% hint style="success" %}
Create SubGroups\
<https://docs.g-iot.io/platform-user-guide-book/group/create-subgroups>
{% endhint %}

### Assign Device to Group or SubGroup

{% hint style="success" %}
Assign Device to the Group\
&#x20;<https://docs.g-iot.io/platform-user-guide-book/group/assign-device-to-group><br>
{% endhint %}

### Is possible to also assign the Device to a Specific Groups

{% hint style="success" %}
LM-Group pages\
\
<https://docs.g-iot.io/level-meter-full-device-guide-book/level-meter-greater-than-giots-function/lm-device-properties/lm-groups-page>
{% endhint %}

{% hint style="success" %}
LCT -Groups Page\
<https://docs.g-iot.io/low-cost-tracker-full-device-guide-book/low-cost-tracker-greater-than-giots-functions/lct-device-properties/lct-groups-page>
{% endhint %}


# 17. Subtenant Management

### Learn how to Create Sub-Tenants&#x20;

{% hint style="success" %}
Create Subtenant.[<br>](https://docs.g-iot.io/platform-user-guide-book/administration/tenant/create-subtenants)<https://docs.g-iot.io/platform-user-guide-book/administration/tenant/create-subtenants>
{% endhint %}

### Assign User to Sub-Tenant

{% hint style="success" %}
Add User to Sub-Tenant.\
<https://docs.g-iot.io/platform-user-guide-book/administration/tenant/create-subtenants/add-user-to-sub-tenant>
{% endhint %}

### Assigning devices to Sub-Tenants

{% hint style="success" %}
Add Devices to SubTenant\
<https://docs.g-iot.io/platform-user-guide-book/administration/tenant/create-subtenants/subtenant-devices>
{% endhint %}

{% hint style="warning" %}
The giot platform supports up to **5 subtenants** per tenant by default. Additional subtenants can be enabled upon specific request to the giot support team.
{% endhint %}


# 18. Generating Reports

## **Understand how to generate and dowload data reports.**

Creating reports on GIOT involves exporting data directly from various sections of the platform, such as devices, alarms, events, or device lists with a specif battery level. These exports allow users to analyze data in external tools. Follow these general steps:

* **Use Filters to Narrow Data:** Apply filters in the desired section (e.g., Devices, Alarms, or Events) to focus on specific criteria, such as device type, status, or date range.
* **Export the Data:** Click on the export icon (usually available in the top-right corner) to download the filtered data. Choose the format, such as **CSV** or **JSON**.
* **Customize the Output:** Use the platform's flexible filtering options to tailor the exported data to your needs, ensuring only relevant information is included.

<figure><img src="/files/CIDP8BlXlHrYYMRbyCEv" alt=""><figcaption></figcaption></figure>


# 19. API Integration

## **API Integration**

* Overview of API capabilities for integrating the platform with external systems.

{% hint style="success" %}
Tenant API: <https://docs.g-iot.io/platform-user-guide-book/administration/api-swagger>
{% endhint %}


# Platform User guide book

<figure><img src="/files/sh1UjkP9j8BoOi5Z7zpn" alt=""><figcaption></figcaption></figure>

This user guide provides essential information and step-by-step instructions for navigating and utilizing the platform. It covers everything from account setup and login procedures to accessing, configuring, and managing devices within the tenant. Designed for both new and experienced users, this guide ensures a streamlined experience on the platform.


# User Registration and Account Confirmation

Providing information on

<figure><img src="/files/TV03ixctiNam8iu6ZiOL" alt=""><figcaption><p>User First Registration</p></figcaption></figure>

## **Receive Invitation**

{% hint style="warning" %}
To access the platform, new users must receive an invitation from an existing user within the tenant. Upon invitation, the user will receive an email to confirm account creation.
{% endhint %}

1. **Check Email in-box:** \
   User will receive in the inbox the invitation email, with the link to confirm your account.
2. **Confirm Account**
3. **Click on the provided link in the email to verify account and complete the registration process.**

## Submit Login Information

After confirming the account, proceed with the following steps to log in:

1. **Create Password**
2. **Set a secure password as prompted.**
3. **Log In**
4. **Go to the login page, enter email address and password, then click the Log-In button to access the tenant dashboard.**

{% hint style="info" %}
Set a secure password as prompted:\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/platform-user-guide-book/user-registration-and-account-confirmation/user-profile/change-or-update-profile-password](/platform-user-guide-book/user-registration-and-account-confirmation/user-profile/change-or-update-profile-password)
{% endhint %}

## 2FA Login&#x20;

Admin might request user to enter via **2FA (Two Facthor Authorization)** login method.

2FA Requires users to verify their identity using a third-party authenticator app (**e.g., Google Authenticator or Microsoft Authenticator**), which generates a unique code for secure access.

<figure><img src="/files/bolyHSRyjh2VARsVT4KU" alt=""><figcaption><p>2FA Login</p></figcaption></figure>

1. **Enter Credentials:** Log in using your email address and previously created password.
2. **Scan QR Code:** Use a third-party authentication app (e.g., Microsoft Authenticator or Google Authenticator) to scan the QR code displayed on the screen.
3. **Enter Authentication Code:** Once scanned, the page will automatically refresh, and you must enter the generated code from your authentication app into the GIoT login page.
4. **Complete Login:** Click N**ext** to access your account securely.

{% hint style="success" %}
Download **Microsoft Authenticator** APP on your SmartPhone; \
**Android:** <https://play.google.com/store/apps/details?id=com.azure.authenticator&hl=en&pli=1>\
**Apple:** <https://apps.apple.com/us/app/microsoft-authenticator/id983156458>
{% endhint %}

{% hint style="success" %}
Download **Google Authenticator** APP on your SmartPhone; \
**Android:** <https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2&hl=en>

**Apple:** <https://apps.apple.com/us/app/google-authenticator/id388497605>
{% endhint %}

{% hint style="info" %}
To create new User follow the instructions **Create New Use**r: [https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/93/platform-user-guide-book/administration/user/create-new-user](/platform-user-guide-book/administration/user/create-new-user)
{% endhint %}


# User Profile

1. **Open profile**: Click on the username.
2. **Open the Avatar page**: Upload the picture.
   * Drag and drop the file.
   * Upload from the computer's drive.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcgrt12Vv9J6rw7Gixk2qGNlcErQxxc6dJpGXofMk6lMaRt7iHWzG_ZnXpdSga1kOzHnqK5KDvsZsNJdiMVWP-Sp_lszO3v2NeKirBwkI9bHUZpbv38iYbjaps25i7VBWtQS49qZw?key=M-g4csUEzYvWKn331EzU-Woy" alt=""><figcaption><p>User Profile</p></figcaption></figure>

1. From any page on the platform, click on your name and email located at the top right corner.
2. Select Profile to open the Profile Settings.


# Settings

<figure><img src="/files/qw40gjvVo3zK5InENd2m" alt=""><figcaption><p>User Settings page</p></figcaption></figure>

* View their registered email address.
* Update their first name.
* Update their last name.
* Change the timezone.
* Select a preferred language (options include German, English, Italian, and French).


# Profile Avatar

Upload a profile avatar picture for the personal user profile

<figure><img src="/files/hUzlLMG0hhS6dH7LUzR8" alt="" width="429"><figcaption><p>Choose Avatar</p></figcaption></figure>

1. Open profile: click  on the user name
2. Open the  Avatar page: upload picture\
   &#x20;\- drag and drop the file (.JPG, .JPEG, .PNG)\
   &#x20;\- upload from computer's drive.


# Change or Update profile Password

Authentication: Update Password

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXc7dy7CmxfvfYuKq75WTb_78jMYc0qTWbum3dolaCw9ciYXj-9VVMdi1R_LhIHpUgqc24YixDtwYbBH3tMfMbc2GVrqeES2xnjjEuE5aU5h9-jIXUJyO6YVbN-KoS5zZP5mnYw6xg?key=M-g4csUEzYvWKn331EzU-Woy" alt=""><figcaption><p>Update password</p></figcaption></figure>

1. **Access Profile Settings:** Navigate to your profile settings by clicking on your avatar or username in the top-right corner.
2. **Open the Authentication Section:** Click on the **Authentication** tab to access the password update form.
3. **Enter Current Password:** Input your current password in the designated field.
4. **Enter New Password:** Provide your new password in the respective field.
5. **Confirm New Password:** Re-enter the new password in the confirmation field to verify.
6. **Save Changes:** Click the **Save** button to update your password.

{% hint style="info" %}
*Make Sure to use a strong password:*&#x20;

* be at least 10 characters long;
* include at least one uppercase letter (from A to Z);
* include at least one digit from the first 10 base numbers (from 0 to 9);
* include at least one non-alphabetic character (e.g., !,$,#,%).
  {% endhint %}

<br>


# Assets Menu

<figure><img src="/files/mgCUBFMueTlXHOVHFg1r" alt=""><figcaption><p>Asset Page Overview</p></figcaption></figure>

At the top left, the Asset view provides quick access to the Home page, quick access to the dashboards, and an overview of All Groups and their associated devices.

Clicking on the search bar, the user can search for groups by name or by device serial number. The user can also create new groups directly from the search bar by clicking the "+".

Below the search bar, the user will find several options:

* Home: allows the user to access the tenant's Home.
* Dashboards: quick access to the dashboards.
* All Groups: displays the groups. Clicking on it will reveal a list of the group's name and its associated devices. The Unassigned devices group is a default group that gathers all devices that are not yet assigned to any of the tenant's groups.

{% hint style="info" %}
**White-filled** folder icon indicates that the g**roup contains sub-groups.**\
If the icon is as no **color**, the group **does not contain any sub-groups**.
{% endhint %}

\
![](/files/T0XRrK3CxNf91wYIz6jr)


# Cockpit Menu

<figure><img src="/files/amijtsM72jMEBSPbsypI" alt=""><figcaption><p>Cockpit menu Overview</p></figcaption></figure>

The **Cockpit Menu** serves as the central hub for accessing all functional pages of the platform, including Devices, Groups, Alarms, Templates, Administration, and FOTA\* . This section is designed to support the organizational aspects of the platform, providing users with tools for device and group management, alarm configurations, and administrative actions. Unlike other sections, the Cockpit Menu emphasizes operational tasks, featuring elements such as Groups, the Home button, and Quick Access Dashboards, making it a streamlined and action-oriented interface for day-to-day operations.

{% hint style="warning" %}
\*FOTA ( Firmware update Over The Air ) is not available on all tenants and is enabled on request.
{% endhint %}


# Device

The Device section provides centralized access to all devices within the platform, enabling users to monitor, configure, and manage individual or grouped devices in real time. It offers tools for viewing device status, battery levels, and data metrics, supporting efficient device administration. Users can also apply rules, assign devices to groups, and set configurations tailored to specific operational needs.


# Device Page Introduction

The **Device Dashboard** is your central hub for monitoring and managing an individual device. From here, you can view real-time data, add and customize widgets (such as location, temperature, or battery status), access the device’s rules, events, alarms, and configuration settings.

<figure><img src="/files/tjl5hNyWkN0HYxrWaRHV" alt=""><figcaption></figcaption></figure>

**How to access**

1. Navigate to the **Cockpit** menu.
2. Click on **Device**.
3. The page displays the complete list of devices associated with the tenant.

### **Filter**

The Filter function allows users to refine the device list using multiple criteria, providing full flexibility and visibility to create a customized device view. Once a filter is applied, the resulting list can also be exported using the **Export** function.

<figure><img src="/files/elcjkHJFpsfDimmNVYUB" alt=""><figcaption></figcaption></figure>

#### Filtering options

1. Click the **Filter** option located in the top-right corner of the page (funnel icon).
2. Select one or more filter criteria.
3. Click **Apply** to display the filtered device list.

#### **Available filter options**

* **Device type**
* **Device group**
* **Status**:
  * Active
  * Online
  * Offline
  * Configuration update pending
  * Last online
  * Exchanged (device has been successfully replaced by a new one; see the *Exchange* section of this guide)
* **Planned for exchange**
  * If the tenant has the required permission, users can enable *Show only devices planned for exchange*.
  * These devices are also visually identifiable by a red banner on their device card.
* **Firmware version**
* **Battery level** (selectable via slider)
* **Faulty battery** (checkbox to show devices with battery issues)
* **TX interval** (enter the desired interval value)

{% hint style="info" %}
Filtering helps build precise device lists for monitoring, troubleshooting, and reporting. Filtered results can be exported for further analysis or sharing.
{% endhint %}

### **Export a file**

export the filtered list or a file as a .CSV or .JSON file.&#x20;

### Sorting

Users can sort the device list by clicking on the **up and down arrows** displayed next to each sortable column. This allows the list to be reordered in either ascending or descending order based on the selected field.

**Sortable fields include**

* Serial Number
* TX Interval
* Registration date
* Last uplink date

## Device Card

The Device Card offers a quick overview of each device’s key details, such as status, battery level, and recent data updates. It provides easy access to essential actions, allowing users to monitor, configure, and manage devices efficiently. Through the card’s menu, users can access advanced settings, rules, and configurations specific to each device.<br>

<figure><img src="/files/vxpRfbfTCSFBg6DSBiy8" alt=""><figcaption><p>Device Card Explanation</p></figcaption></figure>

### Device '' Not Activated '' Activation and Migration Status

<figure><img src="/files/r1s7GgWOMRnx4FiSXBEI" alt=""><figcaption><p>Device not activated</p></figcaption></figure>

{% hint style="info" %}
By default, the device list is filtered to hide **Not Activated** devices. To view them, open the **Filter panel** and remove the filter.
{% endhint %}

Devices migrated from **COT Cloud** may display different statuses:

* **COT-not-ready** → Device has not bootstrapped on COT. Activation via NFC is required. ( as shown in picture above )
* **COT-ready** → Device bootstrapped on COT, and configuration changes will be sent soon.
* **COT-updated** → The new configuration has been successfully updated on COT.
* **COT-migrated** → Configuration has been sent to the device, and on the next uplink, it will appear on the Gimasi Platform.

If there are any issues, contact your **Admin** to verify the correct on boarding of the device.

### Device Card blink Yellow.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfEQ6KpTjmszWVWQqgcEa%2Fuploads%2FYLYQp1kbFgsiQ871x6DM%2Fdevice%20card%20blink1s.mp4?alt=media&token=77ba4c82-51e6-49ee-b8bd-31e511ac2fa7>" fullWidth="true" %}

The device card blinks **yellow** when it is actively **receiving data** in real-time. This indicates that the device is currently communicating with the platform and updating its status.

### Device Card - Planned for Exchange&#x20;

<figure><img src="/files/384HChzcnzK83mKK59Ba" alt=""><figcaption></figcaption></figure>

**Planned for Exchange** indicates that a device is in the process of being replaced with a newer or more multifunctional device. This functionality is part of the GIOT platform and is managed by the **Gimasi team** to support smooth hardware transitions without service disruption.

When a device is marked as *Planned for Exchange*, it means the replacement process has been initiated and the existing device is scheduled to be switched to a new target device.

From the device card, users can click on the **top red banner** to access exchange-related actions. If the tenant has been granted the required permissions, the user can:

* **Delete the device**, or
* **Merge it with the new target device**

#### **Important notes:**

{% hint style="info" %}
When a device is **merged**, existing configurations such as **rules, group assignments, and other settings are preserved** and transferred to the new device.

This ensures continuity and minimizes reconfiguration effort during device replacement.
{% endhint %}

> **Please follow the link to learn more about device exchanges.** [**here**](https://docs.g-iot.io/~/revisions/dDse6CcuAdnnenXpuqlL/platform-user-guide-book/administration/exchanges)


# Device dashboard details

The Device Page provides an in-depth view of a selected device, displaying detailed metrics, configurations, and real-time status updates. Here, users can access specific settings, apply rules, view data history, and configure alerts tailored to the device. This page serves as the central hub for managing and monitoring each device’s individual performance and operational parameters

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXc6lBTiYhCMHgJLG-AhFMTYCj7iiI8cZSusjfzWY5kQTMzw1mso3Fop4U5NBy_C84Mjolj8KrNhQEnBQC5Nfchioveqk2giQumKUDt1QmpHGGBJlsi-QtH5pmlNucbJFMeOwk7hqw?key=M-g4csUEzYvWKn331EzU-Woy" alt=""><figcaption><p>Device page Overview</p></figcaption></figure>

* **Reset the dashboard to the default layout:** Restore the dashboard to its original layout,deleting any customization to its layout.
* **Add widget:** The user can select widgets to be assigned to the devices in the group.
* **Copy layout:** to duplicate the dashboard to other devices by selecting the group o sub-group containing the target devices.

{% hint style="warning" %}
Only compatible devices will be shown.
{% endhint %}

<figure><img src="/files/ydACCCqJ7cneUyNllegs" alt=""><figcaption><p>Device dashbord pages</p></figcaption></figure>

* **Dashboard:** View all widgets associated with the device, modify existing configurations, or add and set up new widgets.
* **Configuration:** display the most recent synced configuration, which initially matches the device's bootstrap settings. When widget settings are changed, a "configuration pending" status appears. The configuration updates will be applied when the device next connects to the GiOT backend.
* **Rules:** Access and add rule widgets, such as Battery Level Alarm, Geofence Alarm, and Alarm to Email Rule.
* **Alarms:** View all generated alarms, prioritized by importance.
* **Events:** Track all events triggered by the device.
* **Timeseries:** Select one or more measurements to display a related data graph; use the calendar icon to set the time interval.
* **Properties:** Edit and view device information, including name, serial number, timezone, container details, and a descriptive text about the device.


# Add Widget to device Dashboard

Refer to the **LM or LCT Full Device Guide Book** to learn how to add widgets, including details about which widgets are available for each device type.

{% hint style="success" %}
LM - Add Widget to Device Dashboard\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/151/level-meter-full-device-guide-book/level-meter-greater-than-giots-function/lm-device-dashboard/lm-add-widgets](/level-meter-full-device-guide-book/level-meter-greater-than-giots-function/lm-device-dashboard/lm-add-widgets)
{% endhint %}

{% hint style="success" %}
LCT - Add Widget to Device Dahsboard\
<https://docs.g-iot.io/low-cost-tracker-full-device-guide-book/low-cost-tracker-greater-than-giots-functions/lct-device-dashboard/lct-add-widgets>
{% endhint %}


# Reset Default Dashboard

This function allows users to reset the configured dashboard layout into the original one.&#x20;

<figure><img src="/files/YmDm47Z4SRfeX7rROeur" alt=""><figcaption><p>LM Reset Default Dashboard</p></figcaption></figure>


# Copy Device Dashboard

This function allows users to replicate a configured dashboard layout across multiple groups or devices. Users can select one or more groups, and within those groups, choose specific compatible devices to apply the setup. This ensures that only devices matching the dashboard's configuration are displayed for selection, streamlining the process and maintaining compatibility.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXc5TqQkvoGLT5ou0H3j7n6VVu0En-YZsa_88pnRwqgUzK1FxHsEs_sqTVtv27upp-j6OzHJk_8sF_v5dxnM23b6nq_FcJ-eDjZtvjZFOGfOQHPhJdN4cjmJl5jOVnzEv4Dg-0rEOw?key=6Q0L8l71kf0rf1QHDmG1DmN7" alt=""><figcaption><p>LM Copy Dashboard Action</p></figcaption></figure>

1. **Click on the Copy Dashboard Icon:** Locate and click the Copy Dashboard icon on the device dashboard page.
2. **Select Target:** In the pop-up window, choose the group, subgroup, or specific device(s) where you want to copy the dashboard layout.
3. **Confirm Copy:** Click Copy to replicate the dashboard layout to the selected targets.


# Device configuration

Configuration Widgets display the most recent synced configuration, which initially aligns with the device’s bootstrap settings.

The user can Activate the device configuration clicking on the toggle switch.

If any widget settings are modified, a "configuration pending" status will appear. To update the device configuration, the next time it connects to the GiOT backend, click **SAVE.**

<figure><img src="/files/p7TRIsRaOoTHRVA2Bdju" alt=""><figcaption><p>Device Configuration</p></figcaption></figure>

## (LM) Level Meter Configuration

* **Transmission Interval:** Specifies how frequently level data is sent.
* **Level Detection:** Enables users to set threshold values for alarm triggers, such as transmission time interval, empty distance, warning distance, and critical distance.

{% hint style="success" %}
Learn more: [https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/68/level-meter-full-device-guide-book/level-meter-greater-than-giots-function/lm-configurations](/level-meter-full-device-guide-book/level-meter-greater-than-giots-function/lm-configurations)
{% endhint %}

## (LCT) Low Cost Tracker Configuration

* **Transmission Interval:** Determines the frequency of data transmission.
* **Temperature Monitoring:** Enables tracking of temperature readings.
* **Motion Detection:** Detects device movement.
* **Freefall:** Monitors occurrences of freefall, useful for orientation or impact sensitivity.
* **BLE Beacon:** Acts as a Bluetooth Low Energy beacon for proximity detection and location services.
* **Time-Driven Configuration:** Allows users to disable specific events for a defined period to conserve battery and avoid false alarms. Options include disabling freefall tracking, motion start/stop, tamper alerts, temperature threshold alerts (both high and low), and Bluetooth beacon signals.

These configurations help tailor the platform to specific operational requirements, enhancing monitoring and control capabilities for each device type.

{% hint style="success" %}
Learn more : [https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/68/low-cost-tracker-full-device-guide-book/low-cost-tracker-greater-than-giots-functions/lct-configuration](/low-cost-tracker-full-device-guide-book/low-cost-tracker-greater-than-giots-functions/lct-configuration)
{% endhint %}


# Copy Configuration

The Copy Configuration function allows users to replicate an existing device configuration and apply it to other devices of the same type. This feature streamlines configuration management and ensures consistency across devices.

<figure><img src="/files/WjSQtV47nsKr0tx4A9VR" alt=""><figcaption><p>LM - Copy Configuration</p></figcaption></figure>

## Steps to Use the Copy Configuration Function:

1. **Navigate to Device Configuration:**
   * From the Cockpit menu, go to the Devices section and select the desired device.
   * Open the device's configuration page.
2. **Access Copy Configuration:**
   * Click the Copy icon located on the right side of the configuration page.
3. **Select Target Devices:**
   * Choose the group or individual devices to which the configuration will be applied.
   * Only devices of the same type will be available for selection.
4. **Apply Configuration:**
   * Confirm the selection to replicate and apply the configuration to the selected devices.

{% hint style="warning" %}
NOTE: The Copy Configuration function is restricted to devices with:\
The same firmware version&#x20;

The same hardware version&#x20;

The same hardware capabilities&#x20;

The same device model name (eg LowCostTrackerNG - Advanced)
{% endhint %}


# Add Device Rules

At the Rules level, IoT smart rules can be added through widgets.

Click on the ''+'' icon to Add new lot rule widget

{% hint style="warning" %}
Important: Only rule widgets compatible with the device's specific capabilities are available for selection in the portal.
{% endhint %}

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcqrtZc4odmuFbqjLhwHKr6XtJ4sb2i4qZ88iQ7h3sBEFbXOmBTyUh7dbtwrxm0dmHKeScShmJ-PnY6XJCr3F1lp74ndQ-p5NghYJVLvy6J5vOSADF4FVgx-pM6HXwNyvmkEyhRrA?key=M-g4csUEzYvWKn331EzU-Woy" alt=""><figcaption><p>Add new device rule</p></figcaption></figure>

{% hint style="success" %}
LM - Rules\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/level-meter-full-device-guide-book/level-meter-greater-than-giots-function/lm-rules](/level-meter-full-device-guide-book/level-meter-greater-than-giots-function/lm-rules)
{% endhint %}

{% hint style="success" %}
LCT - Rules\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/low-cost-tracker-full-device-guide-book/low-cost-tracker-greater-than-giots-functions/lct-rules](/low-cost-tracker-full-device-guide-book/low-cost-tracker-greater-than-giots-functions/lct-rules)
{% endhint %}


# Device rules per device type

The platform offers pre-defined IoT smart rules that can be applied according to each device's capabilities. These rules activate on specific device events and may generate alarms, which can all be accessed in the Alarms menu.

Clicking on the "+" icon the user can create (LCT) or (LM) Rules

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXd_RALGvtJbhhHOyrbtI4sUw6ruWPby5DVxKwgsrd1begGys2BwiFBOVW-0WlLuuVwz5a9IS04aOFcAEbzIDVSogA3fvISv0nRFao_wbCYHqwIy6vTS-FyPypF-4EENaUKsVEM3tQ?key=M-g4csUEzYvWKn331EzU-Woy" alt=""><figcaption><p>Device rules</p></figcaption></figure>

## (LM) Level Meter Smart Rules

* **Battery Level Alarm:** Allows setting a specific battery level that will trigger an alert, along with the endpoint type and alarm severity level.
* **Geofence Alarm:** Defines a geofence area that triggers an alert when the device enters or exits the designated boundary.
* **Alarm to Email Rule:** Sets the endpoint for email notifications to be sent when data triggers an alarm.

These rules provide automated alerts and notifications, ensuring that critical device status updates are promptly communicated.

{% hint style="success" %}
Learn more: [https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/68/level-meter-full-device-guide-book/level-meter-greater-than-giots-function/lm-rules](/level-meter-full-device-guide-book/level-meter-greater-than-giots-function/lm-rules)
{% endhint %}

## (LCT) Low Cost Tracker Smart Rules

* LCT Temperature Alarm: Triggers an alert when temperature readings exceed or drop below defined thresholds.
* Battery Level Alarm: Monitors the device's battery status, providing alerts for low levels.
* LCT Tamper Contact: Detects unauthorized access or tampering, triggering security alerts.
* Alarm to Email Rule: Sends email notifications based on the selected alarm type configured by the user.
* Geofence Alarm: Sets alerts when a device enters, exits, or moves within a predefined area, with optional email notifications.
* LCT Adaptive Configuration: Generates a new configuration version based on geolocation, automatically updating parameters based on location changes.

These smart rules enable automated monitoring and response for various device events, enhancing security and operational awareness.<br>

{% hint style="success" %}
Learn more: [https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/68/low-cost-tracker-full-device-guide-book/low-cost-tracker-greater-than-giots-functions/lct-rules](/low-cost-tracker-full-device-guide-book/low-cost-tracker-greater-than-giots-functions/lct-rules)
{% endhint %}


# Copy Rules to Group of Device

The **Copy Device Rules to Device Group** function allows users to efficiently apply existing device rules to multiple devices within a group. Instead of manually configuring rules for each individual device, this feature enables a streamlined process where selected rules from one device can be **copied and assigned** to an entire group, ensuring consistency and reducing configuration time.

With this tool, users can:

* Select a source device with predefined rules.
* Choose a target group where the rules will be applied.
* Ensure that only compatible devices within the group receive the copied rules.

This function is especially useful for managing large-scale deployments, ensuring uniform rule application, and reducing manual setup efforts.

<figure><img src="/files/VBxhtRwS03jTMcjUI6Kn" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
NOTE: The Copy Rules function is restricted to devices with:\
The same firmware version&#x20;

The same hardware version&#x20;

The same hardware capabilities&#x20;

The same device model name (eg LowCostTrackerNG - Advanced)
{% endhint %}

#### **Steps to Copy Device Rules to a Device Group**

1. **Open Devices:** From the **Cockpit menu**, navigate to **Devices** and select the desired device.
2. **Access Rules Section:** Open the **device dashboard** and click on the **Rules** tab.
3. **Ensure Rules Are Configured:** Verify that all necessary rules have been properly set up for the selected device.
4. **Initiate Rule Copy:** Click on the **Copy Rules** icon located at the **top-right corner** of the Rules page.
5. **Select Target Group:** Choose the **device group** where the rules should be copied.
6. **Confirm and Apply:** Click **Continue** to proceed, and the rules will be copied to **all compatible devices** within the selected group.


# Group

The Group section allows users to organize devices into groups and subgroups, enabling streamlined management, targeted configurations, and efficient data aggregation. It provides tools for assigning devices, managing rules, and visualizing alarms and events, all within a structured card and tree-based interface.&#x20;

{% hint style="info" %}
Only **Super Admins** or users with specifically **granted permissions** can create new groups.\
Standard users **cannot create groups** independently. Instead, they are assigned to one or more existing groups when their **role is configured** by an Administrator or Super Admin in the **User Management section**.

This ensures that group structures are centrally managed and aligned with organizational policies.
{% endhint %}

<figure><img src="/files/H7NjAP2UljeY09kuLMYs" alt=""><figcaption><p>Group's page</p></figcaption></figure>


# Group Page - Cockpit View

Overview

<figure><img src="/files/kW2WVdAl6UMGe9VhsxWz" alt=""><figcaption><p>Group's Page - Cockpit Menu</p></figcaption></figure>

### **Access the Groups Page**

1. **Open the Cockpit Menu**\
   From the left sidebar, click on the **Cockpit** menu to expand the available sections.
2. **Click on "Groups"**\
   Select **Groups** to open the dedicated page.
3. **View Group Structure**\
   Here, you can **visualize all existing groups** or **only the groups assigned** to your user role, depending on your access level.

<figure><img src="/files/rf88WoEMR2tvopFDNY1d" alt=""><figcaption><p>Access to the Group's Page </p></figcaption></figure>

### **Group Page Functions**

In the **top-right corner** of the **Groups page**, **Super Admins** or users with **granted permissions** will find all available group management functions:

#### **Filter by Group Type**

You can apply the following filters:

**Group Type:**

* **All Groups** – Displays every group and subgroup.
* **Top-Level Groups** – Shows only the main parent groups.
* **Subgroups Only** – Displays only the subgroups without parent groups.

**Group with Devices Filter:**

* **"Group with no devices" ON** – Only shows groups that currently have **zero devices** assigned.
* **"Group with no devices" OFF** – Shows **all groups**, regardless of whether devices are assigned or not.

#### **Create Group**&#x20;

<https://docs.g-iot.io/platform-user-guide-book/group/create-groups>

Click on **Create Group** to:

* Manually create a new group.
* Or **upload a list of devices via CSV**.

  > The CSV file must contain a single column, starting from cell **A1**, with each row listing one **Device ID**.

#### **Manage Group Operations**

&#x20;[**https://docs.g-iot.io/\~/revisions/uNl6q0i0bNyEz2E3VbFf/platform-user-guide-book/group/assign-device-to-group**](https://docs.g-iot.io/~/revisions/uNl6q0i0bNyEz2E3VbFf/platform-user-guide-book/group/assign-device-to-group)

Click the **Manage** icon to:

* **Assign Devices**: Add selected devices from one group to another (device will belong to both).
* **Move Devices**: Move devices to a new group (they will be removed from the source group).

  > If the source group becomes empty, you’ll be prompted to **delete** it.
* A clean UI shows both **source** and **target groups** side-by-side for easy management.

#### &#x20;**Switch View**

[**https://docs.g-iot.io/\~/revisions/uNl6q0i0bNyEz2E3VbFf/platform-user-guide-book/group/group-page-card-and-tree-view**](https://docs.g-iot.io/~/revisions/uNl6q0i0bNyEz2E3VbFf/platform-user-guide-book/group/group-page-card-and-tree-view)

Toggle between:

* **Card View**: Quick overview with group stats.
* **Tree View**: Visualize the full **group hierarchy**, including all **subgroups**.

#### **Sort Groups**

Sort the list by:

* **Creation Date**
* **Alphabetical Order**

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcYsvk5CEtE8ia36JQ7SHkX8WkzTEKxebVLTRSJ9hQ5lnm6QC5mlGj78jTKbXtXP0LUmnduibsqYuFPuaOG5gA2D3sjVo43Tj9ZskZSOFZDleUgsoPjnnnncT9j2lFyn94qFgcjKg?key=M-g4csUEzYvWKn331EzU-Woy" alt=""><figcaption><p>Group Page Fuctions</p></figcaption></figure>

### Group Card Options

Each group card includes a **⋮ (ellipsis)** menu offering several management actions. These are available **only** to **Super Admins** or users with granted permissions.

**Manage**

* **Assign or Remove Devices** – Add or remove devices from the group.
* **Move Devices Between Groups** – Transfer selected devices to another group.
* **Edit Group Name and Description** – Adjust key identifiers for organizational clarity.

**Edit**

* **Group Name** – Rename the group.
* **Group Description** – Add or update a description for context.
* **Group Icon and Color** – Select a visual identity for the group.
* **Upload Avatar** – Optionally upload a custom image or logo for the group card.

**Delete**

* **Permanently deletes the group**, including:
  * All of its **subgroups**
  * All **device assignments**

**Note:** This action is **irreversible** and must be used with caution.

{% hint style="warning" %}
**Permission Note;** Only Super Admins or users with explicitly granted permissions can access Manage, Edit, or Delete functions.
{% endhint %}


# Group Page - Card and Tree View

When opening a specific group, the view is automatically set to **Tree View**, allowing for the management of device assignments within the group and the creation of subgroups.

The user can find all the generated groups in the Groups section.

**Card View:**\
Visible only on the **landing page** of the group dashboard, this view provides a larger and more detailed overview of all groups and subgroups. Each group or subgroup card displays key information, including:

* **Device Count:** The number of devices assigned to the group.
* **All Devices:** The total number of devices assigned to the group and its subgroups (if any).
* **Subgroups Count:** The total number of subgroups within the group.

**Tree View:**\
Automatically opens or can be selected when managing groups to streamline the organization and management of groups and their devices. This view provides a hierarchical structure for easier navigation and editing.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdNx4FcmaK8KGSvplud37guLTOSokHyr6RSpfZFm-QVqo61bYAm5rOeJPMiwCQasMO3Po6FqLwwkfzc53djeF3obedFgIrtcC0f5zdOlCMrXTbNefWbPjmQO_WNny0EFglFAPDANw?key=M-g4csUEzYvWKn331EzU-Woy" alt=""><figcaption><p>Group Page, Tree view</p></figcaption></figure>


# Group's Dashboard

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXf1Y8UQrTrD8ZFk3iTMiDV1ANUF1xHoRt-WrPtkvXidaiytEp0km4EqGDHIqbqXj08T1b1y3H6IdKwdZNCyyn_9lUTRsM3TDy0-SOMUvvuyyijigbITyQ4xfnc_S2zwsMNqFdRn?key=M-g4csUEzYvWKn331EzU-Woy" alt=""><figcaption><p>Group's Dashboard</p></figcaption></figure>

### Accessing the Group Dashboard

To access a group's dashboard:

1. Navigate to the **Assets View** from the sidebar.
2. Click on the **name of the group** you want to open.
3. The **Group Dashboard** will load.

***

#### Within the dashboard, you can:

* **Reset the dashboard layout** to default if needed.
* **Add or remove widgets** to customize how data is displayed. (discover the widgets here:&#x20;
* **Copy the dashboard** layout to other groups for consistency.
* **Access the full device list** assigned to the group.
* **View and manage Rules** linked to devices in the group.
* **Monitor Alarms and Events**  related to the devices in the group, for real-time operational awareness.

***

This centralized dashboard provides a streamlined view for managing, monitoring, and configuring everything related to the selected group.


# Group’s Dashboard Widgets

The **Group’s Dashboard** provides a consolidated view of all devices belonging to a specific group.\
It is composed of configurable widgets that allow users to quickly monitor status, analyze data, and detect anomalies across the group.

#### Available Widgets

* **Main Statistics**
* **Table Data**
* **Alarms**
* **Graphs**
* **Map**
* **Level Meter Summary**

<figure><img src="/files/3z8W8CX40euHPKaaC7vf" alt=""><figcaption></figcaption></figure>

#### Table Data

The **Table** widget presents detailed device information in a structured tabular format, allowing users to easily compare parameters across all devices in the group.

**Configuration:**\
The widget can be configured by:

* Selecting the **device type**
* Selecting one or more **parameters** to be displayed as table columns
* Clicking multiple parameters to show them simultaneously in the same table

This widget is especially useful for operational analysis, troubleshooting, and bulk monitoring of device parameters.

***

#### Alarms

The **Alarms** widget provides a real-time overview of all alarms generated by devices within the group.

The widget displays alarms by severity:

* Critical
* Major
* Minor
* Warning

**Configuration:**\
No configuration is required.\
All alarms associated with the group are automatically displayed.

Users can click on any severity section to open a detailed view showing the alarms belonging to that specific severity level.

Alarm rules are defined elsewhere in the platform; this widget focuses on visualization and navigation at group level.

***

#### Graphs

The **Graphs** widget visualizes time-series data for one or more parameters across the group, enabling trend analysis and performance comparison.

**Configuration:**\
The widget requires:

* Selection of the **device type**
* Selection of one or more **parameters (metrics)**

Multiple parameters can be displayed within the same graph, or users can create multiple graphs to visualize metrics in the most effective configuration.

Graphs can be displayed using different chart types, such as line charts or bar charts, depending on the selected data.

***

#### Map

The **Map** widget displays the geographical location of all devices in the group, providing spatial awareness and location-based monitoring.

**Configuration:**\
No configuration is required.\
All geolocated devices within the group are automatically shown on the map.

Devices are represented using different colored pins to indicate their current state (for example, online, offline, or alarmed).

***

#### Level Meter Summary

The **Level Meter Summary** widget provides an aggregated view of level-based data (such as fill level, capacity, or percentage metrics) across the group.

The widget displays level ranges in predefined bands:

* 0–10%
* 10–20%
* 20–30%
* …
* 90–100% (completely full)

For each level range, the widget shows the number of devices belonging to that group.

**Configuration:**\
No configuration is required.

Users can click on a specific level range to explore which devices are currently in that state.\
It is also possible to export the list of devices for a selected level range in **CSV format**.

***

#### Level Meter Table

The **Level Meter Table** widget provides a detailed, configurable table view of level-related device data.

**Configuration:**\
Users can:

* Select which columns are most relevant for their use case
* Drag and reorder columns to define the preferred layout
* Display up to **11 columns**, including for example:
  * Level %
  * Serial number
  * Device name
  * Group
  * Level (mm)
  * Container ID
  * Battery level
  * Warning level
  * Critical level

Once configured, the layout can be saved to generate the table according to the selected configuration.


# Create Groups

COCKPIT and ASSETS menu

{% hint style="danger" %}
**Permission Note;** Only Super Admins or users with explicitly granted permissions can access Manage, Edit, or Delete functions.
{% endhint %}

Groups are a powerful way to organize and manage devices efficiently within the platform. By categorizing devices into groups, you can streamline configurations, apply rules, and analyze data specific to subsets of your devices. Groups help maintain clarity and efficiency, especially when managing large numbers of devices.

### Create a Group

Creating a new group on the GIOT platform helps you organize and manage devices effectively. The ability to create groups is now available again from the **Assets View**, but with access limitations depending on user roles.

***

{% hint style="success" %}
**Who Can Create Groups?**

* **Super Admins** or users with explicitly granted permissions can create groups from multiple areas of the platform.
* **Restricted Users** can only create **subgroups** within their assigned group structure (i.e., under existing groups they have access to).
  {% endhint %}

***

### Where to Create a Group (Super Admin)

Super Admins can create new groups from three locations:

**1. Group Index – Card View**

*

```
<figure><img src="/files/g4kGkCujrcm3uigZt1Rw" alt=""><figcaption></figcaption></figure>
```

* Go to **Cockpit Menu > Group**.
* Switch to **Card View**.
* Click the **“Create Group”** button in the top right corner.

**2. Group Index – Tree View**

<figure><img src="/files/wqSsi5edDgqBZZSjJ9m6" alt=""><figcaption></figcaption></figure>

* From **Group Tree View**, click the **“Create Group”** button at the top.
* This allows you to add a top-level group to the hierarchy.

**3. Group Index – Tree View (⋮ Ellipse Menu)**

<figure><img src="/files/mRLX5ZZWFxvS8EcgQyhh" alt="" width="266"><figcaption></figcaption></figure>

* Hover over a **parent group**, click the **three dots (⋮)**.
* Select **“Create Subgroup”**.
* This lets you create a **subgroup within a group**, respecting its hierarchy.

***

#### Add Devices via CSV Upload

<div data-full-width="true"><figure><img src="/files/LkhhTV6222MAAmx3ToCJ" alt="" width="187"><figcaption></figcaption></figure></div>

During group creation, it is also possible to add devices in bulk by uploading a **CSV file** containing the list of device serial numbers. This feature simplifies and speeds up group setup when working with a large number of devices, eliminating the need to manually add each device individually. Once the file is uploaded, all valid devices are automatically associated with the newly created group.

***

### Group Creation for Restricted Users

Restricted users **cannot use the main “Create Group” buttons**, but they **can create subgroups** using:

* **Group Index – Tree View**
* Click **⋮ on a group** they are assigned to
* Select **“Create Subgroup”**

This ensures that restricted users stay within their allowed structure and cannot create groups outside their permission scope.

***

{% hint style="info" %}
**Regular Create Group buttons** will place the new group in the general group structure, which **may not be visible** to restricted users.\
**Subgroup creation via the three-dot menu** ensures the group is placed **within accessible areas** for restricted profiles.
{% endhint %}


# Create SubGroups

## **Introduction to Subgroups**

Subgroups allow for further organization within a primary group, enabling more granular control of devices, configurations, and management. This hierarchy is particularly useful for segmenting devices by location, functionality, or any specific categorization needed for streamlined operations.

Creating a subgroup is practically identical to creating a main group, ensuring a seamless and intuitive process. Once a subgroup is created, it inherits the primary group's settings but can also be customized to meet unique requirements. Subgroups provide flexibility in managing devices while maintaining a clear organizational structure.

## When a Group Contains SubGroups? How to recognize it ?

* **With Subgroups**: When a group contains subgroups, the folder icon is color-filled, indicating that additional levels of hierarchy exist within the group.
* **Without Subgroups**: Groups without subgroups are represented by an unfilled folder icon (e.g., white), signifying no further subdivisions.

These visual cues make it easy to distinguish between groups with and without subgroups at a glance.

<figure><img src="/files/jUM8KmfslaU90muNRWje" alt="" width="358"><figcaption><p>Subgroup icon</p></figcaption></figure>

## CREATE SUBGROUPS

<figure><img src="/files/GyUMSxdAKhSRbBwz3514" alt=""><figcaption><p>Create a Subgroup</p></figcaption></figure>

### Steps to Create Subgroups:

1. **Locate the Parent Group**:\
   Navigate to the Assets view or Groups section and find the group you want to add a subgroup to.
2. **Open Parent Group Menu**:\
   Click the ⋮ (ellipse) icon on the parent group card to open the menu.
3. **Select Create Subgroup**:\
   From the drop down menu, click on **Create Subgroup**.
4. **Enter Subgroup Details**:\
   In the popup window, fill in the following:
   * **Name**: Provide a name for the subgroup.
   * **Description**: Add an optional description to identify the subgroup.
5. **Save the Subgroup**:\
   Click **Create** to finalize and create the subgroup.

> **Note**: The process mirrors that of creating a group, with the only difference being that the subgroup is nested under a parent group. After creation, subgroup management (e.g., assigning devices) can be performed in the same way as for groups.


# Assign devices to a group

### Assign or Move Devices to a Group

Whether you're organizing newly onboarded devices or reorganizing your infrastructure, you can **assign** or **move** devices to a specific group directly from the **Assets View**.

<figure><img src="/files/IvlucwtjTEY1KczxCn3X" alt=""><figcaption><p>Assign Devices to a Group</p></figcaption></figure>

### Steps to Assign or Move Devices to a Group

1. **Go to Assets View**\
   From the sidebar, click on **Assets View**.
2. **Open Groups Page**\
   Click on **Groups**, then&#x20;
3. **Select the group you** wish to add devices to.
4. **Open Group Management Menu**\
   On the group's card, click the **ellipsis (⋯) icon** in the top-right corner.
5. **Click Manage**\
   From the dropdown, choose **Manage**.
6. **Open Device Assignment**\
   Inside the Manage menu, select **Device Assignment**.
7. **Browse or Search Devices**
   * A list of all available devices will appear.
   * Devices already assigned to this group will be **highlighted in green**.
   * Use the **scroll** function or **search bar** to find a specific device by ID or name.
8. **Select Devices**
   * Click the checkbox next to one or more devices to select them.
9. **Choose Action: Assign or Move**

   * **Assign**: Adds the selected device(s) to this group **without removing them** from any other group they are already part of.

   * **Move**: Transfers the device(s) to this group **and removes them** from any previously assigned group(s).

   > **Note:** If the device is **newly added** and has **not yet been assigned** to any group, both **Assign** and **Move** will result in the **same outcome** — assigning the device to this group.
10. **Confirm the Action**
    * Complete the process and the device(s) will now appear in the selected group.

{% hint style="info" %}

* Use **Assign** when a device should be visible in **multiple groups** (e.g., for shared management).
* Use **Move** when a device should belong to **only one group** and be removed from others.
* Group assignments help structure device visibility and dashboard views efficiently, especially in large-scale deployments.
  {% endhint %}

{% hint style="warning" %}
Only when creating a new group, it is possible to add all devices in one click by uploading a **CSV file**; see the **Create New Group** page for details.
{% endhint %}


# Move Devices from Group to Group

The **Assign/Move function** allows Super Admins or users with the right permissions to efficiently organize devices across groups.

You can either:

* **Assign**: Add devices to another group **without removing them** from their original group.
* **Move**: Transfer devices **from one group to another**, **removing them** from the original group.

<figure><img src="/files/BQZtwVzBJe9crJO93sjU" alt=""><figcaption><p>Move Devices from Group to Group</p></figcaption></figure>

## Steps to Assign Device to Group

1. **Access the Assets View**\
   From the sidebar, go to **Assets View**.
2. **Open Groups Page**\
   Click on **“Groups”** to view the full group list.
3. **Click the Assign/Move Icon**\
   In the top right corner, click the icon with **two inverse arrows** (⇄).
4. **Select Source Group**\
   In the pop-up window:
   * Use the **left column** to browse or search for the group from which you want to transfer devices.
   * Select the desired **Source Group**.
5. **Select Target Group**
   * Use the **right column** to browse or search for the group you want to assign or move the devices to.
   * Select the desired **Target Group**.
6. **Choose Action: Assign or Move**
   * Click **Assign** to **copy** the devices into the target group (they’ll remain in the original group too).
   * Click **Move** to **transfer** the devices and remove them from the original group.
7. **Confirm Action**
   * A summary window will appear.
   * Confirm the operation. If **moving**, you’ll also be given the option to **delete the source group** if it becomes empty.

#### Steps to Assign or Move Devices

* **Assign**: Add devices to another group **without removing them** from their original group.
* **Move**: Transfer devices **from one group to another**, **removing them** from the original group.

<br>


# Import device list to a group

Import device list to **Add/Move/Remove Devices** to streamlines the process of managing devices within a group, allowing users to efficiently update device assignments. This feature provides three options:

* **Add to Group**: Assigns the device to the target group while keeping it in any existing groups.
* **Move to Group**: Transfers the device to the target group and removes it from its current group.
* **Remove from group**

<figure><img src="/files/V54TSvZSfMeCygPOAQMg" alt=""><figcaption><p>Import device List</p></figcaption></figure>

### Steps to import device list to a group

**Access Cockpit Menu**: Navigate to the Cockpit menu.&#x20;

**Go to Groups**: Open the Groups section and locate the desired group.

1. **Open Group Dashboard**: Click on the group name to access its dashboard.
2. **Click Import CSV**: On the top-right corner of the screen, click the Import CSV icon.
3. **Select Action**: In the pop-up window, choose the desired action—Add, Move, or Remove devices.
4. **Upload CSV File**: Select the .csv file containing the device list to be imported.
5. **Verify Target Group**: Ensure the target group is correct. If needed, delete the selected group and choose a new one.
6. **Review and Confirm**: Click Next, review all details, and verify the information before uploading the file.


# Events

The Events Page provides a centralized view of all events generated by both Low-Cost Trackers (LCT) and Level Meters (LM) devices. It allows users to monitor device activity in real-time, analyze event details, and filter results based on device type, event category, or time period. This comprehensive interface ensures users can efficiently track and respond to device-generated or backend-processed events, enhancing operational oversight across all connected devices.

<figure><img src="/files/6MThxLFJT6mAmbpSQ5S2" alt=""><figcaption><p>Events Page</p></figcaption></figure>

Follow the link to the Specific Device type Events page to learn how to manage each Event.

{% hint style="success" %}
LM -Events Page\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/151/level-meter-full-device-guide-book/level-meter-greater-than-giots-function/lm-device-events](/level-meter-full-device-guide-book/level-meter-greater-than-giots-function/lm-device-events)
{% endhint %}

{% hint style="success" %}
LCT - Events Page\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/151/low-cost-tracker-full-device-guide-book/low-cost-tracker-greater-than-giots-functions/lct-device-events](/low-cost-tracker-full-device-guide-book/low-cost-tracker-greater-than-giots-functions/lct-device-events)
{% endhint %}


# Alarms

The Alarms Summary page provides a summary of alarms for either a selected device or a group of devices. It allows users to view the number of active alarms per severity level and provides key information such as the alarm type and trigger time.

<figure><img src="/files/kBJwexAobXZE1q7wrCcd" alt=""><figcaption></figcaption></figure>

## Steps to Access to Alarms Cards

1. From the **Device Alarms** front page to **View Alarm Details**:
   * To explore detailed actions or associated information for an alarm, click the **arrow icon** on the relevant alarm card. <img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfGoeF8S03gS2ks-K0uzEVf3Lgj9F95Ah4w2-EAfKJXyRGbljgW6ApXxtrM_E41PEYjha5VAi4ZPZ4Q_65iENC9fWH6w364SWTNjh0M0Mr_yrnqmof0A97AW7Z69ufJRBK0rjFOBw?key=6Q0L8l71kf0rf1QHDmG1DmN7" alt="" data-size="line">
2. **Navigate to Alarm Pages**:
   * The arrow icon redirects you to the **Device Alarms Card** page, to manage alarm actions.

## &#x20;Alarms Card Explanation

<figure><img src="/files/H8kwbszTHLIspNcKAJsc" alt=""><figcaption></figcaption></figure>

From the list of all the registered alarms, for each alarm card the user finds useful information:

1. The date and the right time when the alarm is registered,
2. The name and the series number of the device
3. That the alarm was confirmed or left open.

## Manage Alarm Status

The **Alarm Status Management** page enables users to monitor and manage alarms generated by device configurations. It provides a comprehensive list of alarms, displaying their **status** (completed or ongoing) and allowing updates as necessary.<br>

## Steps to Access to Alarm Detail Page

1. **From the Alarms Summary Page**:

* To view all alarms reported by a device, click the **“Show Alarms”** icon located in the top-right corner of each Alarm Level card.

2. **Alarms Details Page**:

* This page displays a detailed list of all active alarms, including:

  * Device Name
  * Alarm Level
  * Alarm Status
  * Specific Alarm Triggered

  <div align="center"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfVT5ypxxsFZ2Z7MV0iPBgU7_yB1vys8zpa6hBLrpDaZAxM1oO6tEcvIhH1jfy-u18butPMhH0lGfsUimafedWI-4X6Y9r_qw1Wgem98SgqHxhjSohHkkZxJv-m7jVqPt_RySJs?key=6Q0L8l71kf0rf1QHDmG1DmN7" alt=""><figcaption><p>Alarms Detail's Function</p></figcaption></figure></div>

#### Filters

1. **Alarm Status**:
   * **ON**: Indicates the alarm has been triggered and is actively monitoring a condition (e.g., temperature exceeded, motion detected, geofence entered).
   * **OFF**: Indicates the alarm condition has been resolved, cleared, or acknowledged. The event has either stopped, been corrected, or manually turned off.
2. **Alarm Level**:
   * **Critical**
   * **Major**
   * **Warning**
   * **All**: View all alarms regardless of severity level.
3. **Timeframe**:

   * Select a specific period for alarm data, then click **Apply** to save and filter the results.

   <div align="center"><figure><img src="/files/D8Jrj6UMvw8hmGBBA6eT" alt="" width="375"><figcaption><p>FIlter Icon </p></figcaption></figure></div>

#### 4. Export Alarms Data

* Click the export icon to download either the entire list or a filtered subset of alarms for further analysis or record-keeping.

  <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeloDp4tzammoJloBCKvT905ahag9e33SfOzB0XSDs3sOE8WgQw2Rop-35goolrfhicW61EMIwEihflLQUOOXB3przFRLVJwSo5A-trtcxvDHgCCpZX9iLuYRxdj0OB6BwIg9WOWg?key=6Q0L8l71kf0rf1QHDmG1DmN7" alt="" width="375"><figcaption><p>Export Icon</p></figcaption></figure>

5. Confirm Alarm:
   * Opens the **Update Alarm Status** panel, allowing the user to confirm or resolve all alarms.
   * Click **Update** to save the changes.


# Alarm Monitoring and Resolution

LCT- LM Alarm monitoring and resolution

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXezqgZGQMvTCLHNFFgsNHkmDHy5ZU1UdzByLXfPv0rcosHhaUimjzYmfvVJ5koBr2EO1Nh_18K1T1e0UR0XEzgo6QDO4eaeNODFmx0Xo2215kUiu0PZtEFw0285anI5rZkZddSytA?key=6Q0L8l71kf0rf1QHDmG1DmN7" alt=""><figcaption><p>Manage Device Alarm Status</p></figcaption></figure>

1. Click the arrow on the right side of the specific alarm card to expand the section and visualize this page.
2. If the alarm is unresolved, the user can choose between two actions:
   * **Confirm Alarm**: Acknowledges that the user has taken charge of the alarm request sent by the device.
   * **Resolve Alarm**: Indicates that the alarm, previously acknowledged and addressed, has been fully resolved.


# Template

<figure><img src="/files/Sm2pag512Z5vR6PiuqiP" alt=""><figcaption></figcaption></figure>


# Configuration page

The Configurations page allows users to create, view, and manage device configuration templates efficiently. These templates provide tailored settings for specific operational requirements and are categorized by device type, such as LM (Level Meter) and LCT (Low-Cost Tracker).

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXekyzxPCY7iYB9XV4NGZFmHVOtZBJYtW2LI2-DrxkrtiO2131rfRWRJrFwa9pTTZTTqO_1SYYXie095C5LFR_FGIheJOisDYyACKlrzCapHg68FgtC6BDYhpUft08K9qzl677Aokg?key=M-g4csUEzYvWKn331EzU-Woy" alt=""><figcaption><p>Configuration page</p></figcaption></figure>


# Configurations per device type

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeh3S51bMJzvd_RM8KfFLI7ZfZmx5S94HAuwjDlhIi3CwDNTjT5klODwILEqZIx4Pak2sr-mT_8U6LylC7k6PFrIWzlVeG9JZOHTj2a1-UIKu228bq3bVNqn_5XmVb7Sgk3ZZdsnA?key=M-g4csUEzYvWKn331EzU-Woy" alt=""><figcaption><p>Configuration per device type</p></figcaption></figure>


# (LM) Level Meter Configurations

* **Transmission Interval:** Set the data transmission interval using default or custom time slots.
* **LM Level Detection Configuration:** Configure threshold values, transmission intervals, and measurement time intervals for level detection.


# (LCT)  Low-Cost Tracker

* **Free Fall Detection:** Enable or disable free fall event detection on the device.
* **TOIL Transmission Interval:** Set the transmission interval using default or custom time slots.
* **Time-Driven Configuration:** Schedule days and times to deactivate all configurations during specified time periods.
* **BLE Beacon:** Enable or disable BLE functionality, set the broadcasting interval, and define the broadcast message.
* **Motion Tracking:** Enable or disable motion tracking and configure start/stop motion detection parameters.
* **Tamper Monitoring:** Enable or disable monitoring of the tamper contact sensor.


# Add new Configuration

The Configuration section enables the creation and management of configuration templates that can be assigned to groups of devices. These templates allow for standardized settings to be applied across multiple devices, streamlining the configuration process and ensuring consistency. Designed for efficiency, this section supports assigning predefined configurations to specific device groups, simplifying large-scale device managemet

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcCejxqGzR78tDOFxAKnnqe8ZmzYon7CS5IweDuF1fJi3kh_dIN7ecgCQvtkP2CydJ9TYNQ0CZcIpNUjdqc305OazSxTK4hPFCffR-GJ8r1oxfpOxs5QkUVUpJIahOyafWP0ae2?key=M-g4csUEzYvWKn331EzU-Woy" alt=""><figcaption><p>Add configuration</p></figcaption></figure>

#### Steps to Create a New Configuration:

1. **Access Template Section:**\
   Navigate to the **Cockpit Menu** and click on **Template**.
2. **Initiate Configuration Creation:**\
   Click on the **+ icon** in the top-left corner to start creating a new configuration.
3. **Enter Configuration Details:**
   * **Device Type:** Select the device type from the dropdown menu.
   * **Name:** Enter a name for the configuration.
4. **Save Configuration:**\
   Click **Save** to finalize and create the new configuration


# Geofence

Geofence functionality allows the creation of virtual boundaries, or geographical areas, that devices can detect when entering or exiting. These Geofences are fundamental for location-based automation and monitoring, enabling enhanced control and responsiveness across the platform.

### Geofence can be applied at different levels.

* ***Geo-fence Alarm Rule*****:** Trigger alarms when devices enter or exit a predefined area.
* ***Adaptive Configuration Rule*****:** Apply specific configuration changes to devices based on their location relative to a geo-fence.
* **Configurations:** Used in Time-Driven Configurations to activate or deactivate settings based on geo-fence areas.
* **Device Grouping:** Automatically include devices in groups based on their location within a geo-fence.
* **Dashboards:** Visualize device locations and movement within geo-fenced areas using map widgets.

Geofences are intuitive to create and manage, ensuring seamless integration with the platform's rules, configurations, and monitoring tools.

<figure><img src="/files/wK6S8gpvjxbV9kOp1Mb6" alt=""><figcaption><p>Geofence Page Overview</p></figcaption></figure>


# Create Geofence

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdomtLJJ0A0Fy__SYDBfpFYFC63D9I1K7t8BYANqQFRMw0Zzy_V6Qsw0Zn2Ox8ZQgGhDlKQfpZvGnla3gJ0qVCV-snXrLd7aUdA3DLkJ0TY8-DIOLXxeGb5K8ZXqN8s4C6_qZ8lFw?key=M-g4csUEzYvWKn331EzU-Woy" alt=""><figcaption></figcaption></figure>

## **Steps to Create and Edit a Geofence**

1. **Navigate to Geofence Template:** Open the **Cockpit menu**, go to **Template**, and select **Geofence**.
2. **Create Geofence:** Click on the **+ icon** in the top-left corner to open the creation popup.
3. **Enter Geofence Details:** Provide a **name** for the geofence in the input field and click **Create** to generate a new geofence card.
4. **Edit Geofence:** Locate the newly created geofence card, click the **⋮ (ellipse)** menu, and select **Edit**.
5. **Define Geofence Area:** Access the map editor to draw and define the geofence boundary.

<figure><img src="/files/enCIJHrpfeTJCblxRCn2" alt=""><figcaption><p>Create Geofence</p></figcaption></figure>


# Dashboards

The Dashboard is a central feature of the platform, designed to provide users with a customizable and organized view of their device data and metrics. Dashboards support the visualization of real-time and historical data through various widgets, including charts, tables, and maps. They can be configured to display data for individual devices, groups of devices, or tenant-wide metrics, making them a powerful tool for monitoring, analysis, and decision-making.

Dashboards offer flexibility in usage, allowing them to be:

* Set as Home Dashboard: Displayed as the main dashboard for all users in the tenant.
* Shared Publicly: Made accessible via a public URL for external viewing.
* Quick Access Dashboards: Added to the side menu for streamlined navigation to frequently used dashboards.

This adaptability ensures critical information is always available in the most convenient and effective format.

<figure><img src="/files/w7NdiBZVC26D3bpUi90z" alt=""><figcaption><p>Dashboard Overview</p></figcaption></figure>


# Create new Dashboard

Users can create a dashboard template for the tenant, making it accessible to all users within the tenant. This ensures a unified view and standardization across the platform for team collaboration and data monitoring.

<figure><img src="/files/3ORiMWl89aQtBj0eZlp3" alt=""><figcaption><p>create custom dashboard - step1</p></figcaption></figure>

1. **Navigate to Dashboard Template:** From the **Cockpit menu**, go to **Template** and select **Dashboard**.
2. **Create Dashboard:** Click the **+ icon** in the top-left corner to open the creation popup.
3. **Enter Dashboard Details:** Fill in the **Name** and **Description** fields for the dashboard, then click **Create** to generate a new dashboard card.
4. **Edit Dashboard:** Locate the newly created dashboard card, click the **⋮ (ellipse)** menu, and select **Edit** to start configuring the dashboard by adding widgets.

## Set Up and Add Dashboard's widgets

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXd6EAiChU7puZDyQmrrjlspyp0qgb9xrWBAhSXKIISd3eH2jjIXI3krSQawuhIP-ujugwuvcGJDQPtZdngngZW9Dzap0toxgbNBzLqkdZI-9QgHlIcNhr5LeQH_7r2NUUyWvtlCxw?key=M-g4csUEzYvWKn331EzU-Woy" alt=""><figcaption><p>new Dashboard - add widgets</p></figcaption></figure>

1. From the Edit button, open the dashboard to configure it.
2. Click on Add Widgets and select the desired widget type to include in the dashboard.


# Dashboard's widgets

* **Graph:** Configure for a single device or a group of devices, select the parameters to display, and define the time frame.
* **Map:** Select a group of devices to show on the map from the list of existing groups within the tenant.
* **Table:** Configure for a single device or a group of devices, and select the parameters to display in the table.
* **General Statistics:** Provides a clear global overview of all devices in the tenant, including the total number of devices and their status (online, offline, or inactive).
* **Alarms Summary:** Configure for a group of devices to display a summary of all alarms generated by those devices.
* **LM Level Meters Summary:** Define the group for which a table will show an overview of all Level Meters within the group.

<figure><img src="/files/G81HFaBl1CKgTjpqrxhA" alt=""><figcaption></figcaption></figure>

Once the widgets are configured correctly, they will display relevant data. Widget settings can be adjusted at any time by clicking the **gear** ⚙️icon on the individual widget.


# Select Home-Dashboard

The Home Dashboard is the primary dashboard that appears on the platform’s homepage, providing an at-a-glance overview of key device metrics and data. It is customizable to display the most relevant widgets, allowing users to prioritize important information. Configured by the tenant administrator, the Home Dashboard ensures a unified view for all users within the tenant

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdbhFiyStdmnNLZUbpcuWpf9rhw_uvL7m79IXFFSTp8Onp426uTGWrGjqaDnqpQf3UEtteM7POlNyZuYmYlO6RwiQJta52QlqtNrRhiOIGG9v-HGep7Eidlreno6sEl8gDG1ZKyiw?key=M-g4csUEzYvWKn331EzU-Woy" alt=""><figcaption><p>home-dashboard</p></figcaption></figure>

## Set Up Home Dashboard

1. Ensure to be with-in the Cockpit menu and click on Dashboard.
2. Select an existing dashboard by its name or description.
3. Click on the ⋮ (ellipse) menu on the selected dashboard card and choose Edit.
4. Check the box labeled Home.
5. Click Save.

This sets the selected dashboard as your personal Home Dashboard. Be sure that the chosen dashboard contains the most relevant data for your team or personal use.

<br>


# Create Quick Access dashboard

Quick Access Dashboards provide a convenient way to streamline navigation and access frequently used dashboards. Once selected as Quick Access, these dashboards are added to the Dashboards section in the Assets menu, enabling users to quickly monitor key data without searching. Quick Access Dashboards are user-specific, ensuring each individual can personalize their experience without affecting others in the tenant.

![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXcJOefxfmJECz0v4lnOMb1IGFipjRUqeHrNNzJCjBEsCVZfPqn3GB_czlxbBwl4wdGFPVqVDCVDCfGQE-C7Jd7cNc-Hmp0Z8UaqiwN4pEqTX0ZN0F0ms4RsF0gZ1Wr01RZVMMThbQ?key=M-g4csUEzYvWKn331EzU-Woy)

## Add Quick-Access Dashboard

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfPQFEgaeyCs3bTPnZRUOGV-bfljjPImpt8WVKMXzC_73Zg5lSx9MdWBs8R7oo1Mc9-wgRzsdPtgJo_UB6hYS4iq294_MjpmUkduSeu_tt0IZMKuCrWtmwzGPPHeX7nMQxeIQ6aXA?key=M-g4csUEzYvWKn331EzU-Woy" alt=""><figcaption><p>add quick-access dasboard</p></figcaption></figure>

1. **Navigate to the Dashboard Section:**\
   From the Cockpit menu, go to **Template > Dashboard**.
2. **Locate the Dashboard Card:**\
   Use the name or description to find the desired dashboard card.
3. **Edit the Dashboard:**\
   Click the ⋮ (ellipse) menu on the selected dashboard card and choose **Edit**.
4. **Enable Quick Access:**\
   In the Edit Dashboard view, check the box labeled **Quick Access**.
5. **Save Changes:**\
   Click **Save** to finalize the selection.


# Public dashboard

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdCmGeDSLX8S_usAEAOlh2IOpkm12GUJVgXsUOOgQKl4pYUzFzWRXlDmhMmvMBEdUIbZOGuPLAHPEjLS7iNKvBnttXwnwnB-xtR-LEk_lB3RuA-5Itw1-yWs-qkvki2-qzHdfd49Q?key=M-g4csUEzYvWKn331EzU-Woy" alt=""><figcaption><p>create public dashbord</p></figcaption></figure>

1. **Navigate to the Dashboard Section:**\
   From the Cockpit menu, go to **Template > Dashboard**.
2. **Locate the Dashboard Card:**\
   Use the name or description to find the desired dashboard card.
3. **Edit the Dashboard:**\
   Click the ⋮ (ellipse) menu on the selected dashboard card and choose **Edit**.
4. **Enable Public Access:**\
   In the Edit Dashboard view, check the box labeled **Public**.
5. **Save Changes:**\
   Click **Save** to confirm the changes.
6. **Copy the URL:**\
   Once saved, the **Public URL** will appear below the checkbox. Copy the URL to share the dashboard with external users.

{% hint style="warning" %}
Shared dashboard will remain view-only for external users, ensuring secure access to critical data.
{% endhint %}


# Administration

{% hint style="danger" %}
All functions explained in the ADMINISTRATION section of this guide are accessible only to users with the appropriate privileged roles (e.g. SuperAdmin). If a user needs permissions for role administrations, contact the tenant administrator to apply for additional permissions.
{% endhint %}


# User

To begin creating a new user, ensure you're navigating from the **Cockpit Menu**.\
Click on **Administration**, then select **Users** from the sidebar.

This will open the **User Management** page, where you'll see a list of all users currently registered within the tenant or subtenant. From here, you can manage existing users or proceed to create a new one by following the guided steps.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfQ2DaButXdDnr61GL_72CwMT1x9uyWiz5VPNEHHnmBBlfcD8K429P7m2RAaaofCnXooX64SuqWbtaBk9p7W3tAbDmx1K9hBNFTCDiUWKdg8U6p43tRObKIRR4Ox6OXKV5rnOjjTA?key=ZzE-SQBxhtpTethCCNB9a49Q" alt=""><figcaption><p>User Dashboard Overview</p></figcaption></figure>

## To Access the User Dashboards:

1. Navigate to the Administration Section:
   * Ensure you are in the Cockpit menu and click on Administration.
2. Locate the User List:
   * The page will open with all the users already logged in.

**In the User Dashboard, Admin can:**

* Search for a Specific User:
  * Any specific user can be found by typing their name or email address in the search bar.
* Filter by User Name:
  * To filter the list by the user's name, click the filter button.
* Create a New User:
  * To create a new user, click the "+" icon.
* Export the User List:
  * To export the user list, click the export icon.
* Sort the List:
  * To toggle the sorting order, click the last icon on the right.

{% hint style="warning" %}
\*IMPORTANT: Ensure the format is .JSON or .CSV
{% endhint %}


# Create New User

The **Create New User** page allows Super Admins or permitted roles to onboard new users into the platform.\
During the creation process, it's essential to define the user's role and group access — both are mandatory for restricted users. Only one role can be assigned per user. You can either assign a specific group or give access to **All Groups**, which overrides any individual group selection.

Before assigning a **custom role**, ensure it has been previously created (see: *Create New Role*). Once all required fields are filled and settings confirmed, the user will receive an activation email to complete their registration.

<figure><img src="/files/f9SoLgYVtkpmA61li7ui" alt=""><figcaption></figcaption></figure>

### Steps to Create a New User

**1. Initiate User Creation**\
From the **User Management** page, click on **Create User**.

**2. Fill in User Details**\
Enter all required information, including the user’s **email address**, **first and last name**, and any optional details.

**3. Assign Groups or All Groups**\
You must now assign the user to either:

* **Specific Groups** (one or more), or
* **All Groups** (exclusive — no other group can be assigned if this is selected).

{% hint style="info" %}
Assigning a user to "All Groups" will automatically remove any previously selected individual groups.
{% endhint %}

**4. Assign Initial Role and Group Access**\
Select a predefined or custom role for the user.\
If you're assigning a **custom role**, ensure it’s been created beforehand (see: *How to Create Roles*).

Next, assign the group or groups the user will have access to.\
For each assigned group, you must also specify the **access level**:

* **Read**: The user can view data and dashboards but cannot modify device settings or platform configurations.
* **Write**: The user has full permission to modify devices, rules, dashboards, and other elements within the assigned group(s).

{% hint style="info" %}
If you're assigning a **custom role**, ensure it’s been created beforehand. You can learn how to create roles [here.](https://docs.g-iot.io/platform-user-guide-book/administration/role/create-new-role)
{% endhint %}

**5. Select Language Preference**\
Choose the user’s preferred language from the dropdown list.

**6. Automatic Tenant Assignment**\
The platform will automatically assign the **current tenant** to the user.

**7. Confirm Creation**\
Click **Create** to finalize the process. The user will receive an **activation email** to set up their password and log in.

### **Role & Group Assignment Rules:**

* **Only one role** can be assigned per user.
* For **restricted users** (non–Super Admins), assigning them to **at least one group** is **mandatory**.
* If the user is assigned the "**All Groups**" option:
  * All other group assignments will be **automatically removed**.
  * The user will gain access to all current and future groups within the Tenant.
* These rules ensure clarity in user access, improving organizational structure and minimizing risk.

{% hint style="warning" %}
\*IMPORTANT: Only super Admins or Users with account privileges can add new users.
{% endhint %}


# User Detail Page

By clicking on a tenant's user card, Admin can open the single User Administration Page, accessing managing function such:

<figure><img src="/files/IEaNSROZ3iOgy43u4vVK" alt=""><figcaption><p>User Detail Page</p></figcaption></figure>

1. **Roles:** This section allows you to assign a new role to the user, replacing the previously assigned one.\
   *Note: Each user can only be assigned **one role** at a time.*

<figure><img src="/files/RGkoEJ5OlFXBho7mleuq" alt="" width="563"><figcaption></figcaption></figure>

2. **Groups:** You can review and manage the user’s assigned groups by adjusting their access level—either **Read or Write—for each group**. Additionally, you can **remove group access** entirely or assign the user to one or more new groups as needed.

<figure><img src="/files/CUKBW9S05EJyASUACNqE" alt="" width="563"><figcaption></figcaption></figure>

3. **Logs:** Admin can monitor all the logs and actions the User as accessed to, within the Tenant&#x20;

<figure><img src="/files/ICHONEuyV8eX9lSjPhkS" alt="" width="371"><figcaption><p>User Logs page</p></figcaption></figure>

4. **Modify User information**: Name, Surname, Language and Location.
5. **User access Security:** Here Admin have the ability to select the user Log-in methods.

{% hint style="success" %}
See the Security Section in Detail: [here](https://docs.g-iot.io/platform-user-guide-book/administration/user/user-security-log-in)
{% endhint %}


# User Security Log-in

From the user page, the Admin can define multiple access restrictions to enhance security.

<figure><img src="/files/Y8GxuZH9lf2w4ASzl3M4" alt=""><figcaption><p>user Log in Security</p></figcaption></figure>

* **Lock Account:** When this checkbox is marked, the user cannot access the account. The admin can unlock the account at any time.
* **Force Change Password:** When cliked, **t**he user will receive a new link via email, prompting them to create a new password to access the Tenant. This is useful when the user has forgotten their password or when the Admin prefers to request a specific user to create a new login password.
* **Login Type:** The Admin can modify the login type by requesting the user to use:

<figure><img src="/files/UQGSHXmJr6VRDXdwJ9v2" alt=""><figcaption></figcaption></figure>

1. &#x20;**Normal:**&#x41;ccess the Tenant using a password.
2. **2FA (Two-Factor Authentication),** Access is allowed only through a third-party app that generates a code.
3. **2FA OPTIONAL,** The user can choose to use either 2FA or a password.

* **IP address:** The Admin can define specific IP addresses that are allowed to connect to the Tenant, excluding all others.

{% hint style="info" %}
Login Type and IP address, can be set at Tenant Level as well as for specific user at User Level.
{% endhint %}


# Assign Group to User

When opening the User Profile, the user, SuperAdmin or a User with the appropriate role permissions, can assign groups to another user, limiting its access to only the devices assigned group(s).

<figure><img src="/files/afBrsmwLpk3uAwXHSbv2" alt=""><figcaption></figcaption></figure>

### **Steps to Assign a Group to an User**

1. **Open User Profile:**\
   Navigate to the user's profile by selecting their card.
2. **Access Group Management:**\
   Click on the **Groups** tab in the user profile.
3. **Initiate Group Assignment:**\
   Click the **Assign Group** icon and choose **Assign Group**.
4. **Select Target Group:**\
   Select the desired group from the dropdown menu.
5. **Confirm Assignment:**\
   Click **Assign** to complete the group allocation.


# Switch Role to a User

Only one role can be assigned per user.  SuperAdmins or Users with the appropriate permissions can switch a user’s role by revoking the previous one and assigning a new role. Each role defines the specific actions a user is authorized to perform within the platform.<br>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeF5z7zOaiUeHfQwcNQL6nrxgEvmw-Z6WkQD4FWL_N95v58_XgmxhdvABDXmiYBbOZYJCC3bDmor-rBRplYquz5Ua_amMSsPPauNgdizrHWy8hDyXMeZXMJFvvL9ANwHDbiFVANXw?key=ZzE-SQBxhtpTethCCNB9a49Q" alt=""><figcaption><p>Assign Role to a User</p></figcaption></figure>

1. **Access the User Management Page:**\
   From the **Cockpit**, navigate to **Administration** and click on **Users**.
2. **Edit the User:**\
   Locate the desired user, click on the **⋮ (ellipse)** icon, and select **Edit**.
3. **Add New Roles:**\
   Click on the **add icon** for new roles.
4. **Select Roles:**\
   Choose the roles from the dropdown menu.
5. **Confirm Role Assignment:**\
   Click **Assign** to save the changes.


# Role

The gIoT Platform offers predefined roles to the users, to simplify their management. Only users with the appropriate permission can create new roles or modify existing ones.

Role It’s a set of permissions from different categories that defines what actions a user is allowed to perform within the platform.&#x20;

The amount of the permissions in the role and the number of users assigned to that role are visible under the role name. Let’s see all the available roles:

* SuperAdmin: it has the highest permission, it’s allowed to access and modify every user’s information as well as request password update;
* Normal Access: it’s allowed to access to most of the functions and user’s information;
* Read only: it has access to all the functions but it’s unable to modify or export data;
* Custom Role: SuperAdmin or granted roles can easily create new roles;
* No create/No delete: it can’t either create, delete or modify roles.


# Create New Role

To create a new role, it's important to ensure you are in the Cockpit menu and then click on Administration. Then Click on Roles.

The page will open on all the roles already created.\ <br>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcF_13Sh0IWaGORdgSKAX4BHyerNAhFQgthdZ_UUcdtQND-zkV6OI_t5_32sjkcQPDdn8Sml4TxiQ3jELL986v7l-F-J5QYMrLVJCjEccoE1ZyaBLmy1uWxZlRF_UdXpN3tfMaOWw?key=ZzE-SQBxhtpTethCCNB9a49Q" alt=""><figcaption><p>Create New Role</p></figcaption></figure>

1. **Create a New Role:**\
   Click on **Create Role** in the top-left corner of the page.
2. **Enter Role Name:**\
   Provide a name for the new role in the designated field.
3. **Edit Role Permissions:**\
   Click on the **⋮ (ellipse)** icon of the created role and select **Edit**.
4. **Assign Permissions:**\
   Mark the checkboxes to assign specific permissions to the role.
5. **Save the Configuration:**\
   Click **Save** to finalize the role creation and permissions.

{% hint style="info" %}
When creating a new role, it’s best to group permissions from similar categories, such as a 'viewer role' with viewing rights across all categories, or a 'full administration role' with all user-related permissions. This keeps things clear, manageable, and secure.
{% endhint %}

<br>


# Tenant

<figure><img src="/files/zoYWqG2gkNcie0Kzr6Wb" alt=""><figcaption></figcaption></figure>

1. #### Summary

   Users have access to a **clear and friendly user interface** that provides an overall view of all assets within the tenant. The overview includes key aggregated statistics such as:

   * Total users
   * Total devices
   * Total groups
   * Total geofences

   Additionally, the statistics are **clearly divided by device type**, allowing quick insight into the asset distribution.

{% hint style="info" %}
These statistics are **read-only** and **not clickable**.
{% endhint %}

1. **Settings:**\
   Users can modify essential tenant details, including:
   * Tenant Name
   * URL and API URL
   * Time Zone
   * Language Preferences
2. **UI Customization:**\
   Customize the platform's appearance by:
   * Uploading a logo
   * Editing the top bar with custom text, font size, and text color
   * Selecting a background color
3. **API Management:**
   * Create new API tokens
   * Test API functions for seamless integration
4. **Subtenants Management:**
   * View all subtenants under the tenant
   * Edit or delete subtenants as needed
5. **Authorization:**
   * Max Login Attempts: Define the maximum number of failed login attempts before the account is temporarily locked for security.
   * IP Whitelisting: Restrict login access to specific IP addresses, ensuring only authorized networks can access the platform.
   * Two-Factor Authentication (2FA): Enforce an additional layer of security for all tenant users, requiring a second verification step during login.
6. **BSSID**\
   \
   The **BSSID Management** page allows users to manage the list of Wi-Fi access points (BSSIDs) associated with the tenant. Each BSSID represents a trusted reference point used for location accuracy and device positioning.

<figure><img src="/files/zc3acBpnukJoh0jHnAtx" alt="" width="375"><figcaption></figcaption></figure>

From this page, users can:

* View all configured BSSIDs in a structured table
* Search BSSIDs by name or identifier
* See the associated **latitude and longitude** for each BSSID
* Open the BSSID location directly on the **map**
* Delete existing BSSID entries (permission-based)

The table provides a **read-only overview** of the configured data, ensuring clarity and consistency across the tenant. Pagination controls allow easy navigation when managing larger BSSID lists.


# Tenant API

## API <a href="#tenant-api" id="tenant-api"></a>

The "Tenant API" refers to an API (Application Programming Interface) designed to manage and interact with the resources of a single Tenant.

<figure><img src="/files/nvid4lQ5nh9nrQ5HgGfx" alt=""><figcaption><p>Create API Tokens</p></figcaption></figure>

## Steps to Create API-Tokens

1. **Access Administration:**
   * Navigate to the cockpit menu, go to "Administration," and select "Tenant."
2. **Open API Section:**
   * Click on "API" to open the menu, then click the "Create" icon on the right side of the screen.
3. **Fill in Required Information:**
   * **Name:** Enter a required name for the API token.
   * **Description:** Add a description to facilitate the organization of the Tenant.
   * **Expiration Date (optional):** Set an expiration date if needed.
   * **Tenant:** Select the specific Tenant to receive the API call, or choose "All Tenants."
   * **Permissions:** Select or deselect permissions such as Read, Write, Create, Delete.
4. **Generate and Save API Token:**
   * Click "Next" to generate the API token. The token will be displayed and can be copied.
5. **Click "Save" to complete the process.**


# Create SubTenants

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeiJ7zjrFq-3NPJBi7BQmRvp2KBGl7XZN1WZvwlC6r_ib3AYh-g0INaaw4PZ9Lm2Mp2kL_NjuzxVrFgmFeUJ8bveNI0TRtHP3QIYbXPtdEsLlmD85etyt4dUXjZcgMR3u8wEyc_kw?key=ZzE-SQBxhtpTethCCNB9a49Q" alt=""><figcaption><p>Create Sub-Tenants</p></figcaption></figure>

{% hint style="success" %}
Ensure you’re in the Cockpit section, then click on Administration and on Tenant.
{% endhint %}

### Steps to Create Sub-Tenant

1. **Open Administration:**\
   Navigate to the **Administration** section from the Cockpit menu.
2. **Access Tenant Page:**\
   Select **Tenant** to open its management page.
3. **Navigate to SubTenants Section:**\
   Click on the **SubTenants** tab to access the SubTenant management area.
4. **Initiate SubTenant Creation:**\
   Click the **Create SubTenant** icon.
5. **Fill in Details:**\
   Enter all required information in the provided fields.
6. **Finalize Creation:**\
   Click **Create** to complete the process and add the SubTenant.


# Add User to Sub-Tenant

Once a Sub-Tenant has been created or identified for user assignment, navigate to the User page. Use the filter option to select the desired Sub-Tenant. From there, follow the steps to create a new user, ensuring they are correctly associated with the chosen SubTenant.

{% hint style="warning" %}
Existing users cannot be added to a Sub-Tenant. Admins must create a new user within the Sub-Tenant, even using the same email address as in the main Tenant. For security, it is recommended to set a unique password for the new user.
{% endhint %}

<figure><img src="/files/rLujqN3O7AKn6fPNUaYA" alt=""><figcaption><p>add user to Sub-Tenant</p></figcaption></figure>

## STEPS to Add User to Sub-Tenant

1. **Access Administration:** Navigate to the Administration menu and select the **Users** section.
2. **Filter SubTenant:** Click on the **Filter** icon at the top of the screen.
3. **Select Target SubTenant:** In the filter pop-out menu, choose the desired SubTenant name (e.g., *SubTenant - GIOT*).
4. **Apply Filter:** Click **Apply** to display only users within the selected SubTenant.
5. **Create New User:** Click on the **Create New User** icon and follow the steps to complete the user creation process.

{% hint style="info" %}
Follow the link to create new User:\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/199/platform-user-guide-book/administration/user/create-new-user](/platform-user-guide-book/administration/user/create-new-user)
{% endhint %}


# SubTenant Devices

Add Devices to Subtenant

The **Device in Sub-Tenant** section allows administrators to allocate devices to specific sub-tenants within the platform. This ensures a streamlined organization of resources, enabling precise management of devices across different sub-tenants. Devices assigned to a sub-tenant are exclusively visible and manageable within that sub-tenant's scope, supporting efficient operational control and enhanced data segmentation.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXera3SO9zEdR7Yx-MwaEsAV6OgRtjF0txXaQZRFJwcUshybaF4Xak89xQpca7XGrOB55LJNt-chUNnc9S4mO6UUpZFfMDQPQx1K9hBClQ_G25kFM8x8Fi5u8_lQLiJVoZAZPv6rdg?key=ZzE-SQBxhtpTethCCNB9a49Q" alt=""><figcaption><p>Add Device to Sub-Tenant</p></figcaption></figure>

## Steps to Assign Devices to a Sub-Tenant:

1. **Navigate to SubTenant Devices**
   * Open the **Administration** menu and go to **SubTenants Devices**.
2. **Select Target SubTenant:**
   * From the list on the right-hand side, choose the SubTenant to which devices will be assigned.
3. **Initiate Device Assignment:**
   * Click the **+ Assign Device to SubTenant** button.
4. **Select Devices:**
   * From the device list, use the check boxes to select the devices you wish to assign.
5. **Device are added:**
   * once the check box is clicked the device is automatically added to the subgroup

<br>


# Authorization

<figure><img src="/files/AY2EIx2Guxym9zthr7co" alt=""><figcaption><p>Authorization</p></figcaption></figure>

1. **Enable  max attempts:** The Super Admin can set a maximum number of login attempts for all users. If a user exceeds this limit by entering an incorrect password multiple times, their account will be temporarily locked. To regain access, the user must contact an administrator to request a password reset via an email link.
2. **Enable IP address:** The Admin can restrict access to the Tenant by allowing only specific IP addresses. This ensures that only approved environments, such as company devices or users connected through a designated internal VPN, can access the platform, enhancing security and control.
3. **Login Type:** The Admin can choose between different authentication methods for user access:

   * **Normal Login:** Standard password-based authentication.
   * **Two-Factor Authentication (2FA):** Requires users to verify their identity using a third-party authenticator app (e.g., Google Authenticator or Microsoft Authenticator), which generates a unique code for secure access.
   * **Optional 2FA:** Users can decide whether to enable Two-Factor Authentication for added security.

   <figure><img src="/files/jYhY4Pkaa7i1u2xxb6r3" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Download **Microsoft Authenticator** APP on your SmartPhone; \
**Android:** <https://play.google.com/store/apps/details?id=com.azure.authenticator&hl=en&pli=1>\
**Apple:** <https://apps.apple.com/us/app/microsoft-authenticator/id983156458>
{% endhint %}

{% hint style="success" %}
Download **Google Authenticator** APP on your SmartPhone; \
**Android:** <https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2&hl=en>

**Apple:** <https://apps.apple.com/us/app/google-authenticator/id388497605>
{% endhint %}


# Subtenant Device

The **Subtenant Device** section provides Super Admins and permitted roles with an overview and full control of device distribution across Subtenants. This feature allows centralized monitoring and management of which devices are assigned to each Subtenant, and ensures transparent tracking of asset ownership and group allocations within each tenant structure.

From this section, users can:

* Select a Subtenant and view the devices currently assigned to it.
* Manage individual device assignment to and from Subtenants.
* Assign entire groups — and their associated devices — to a selected Subtenant.

<figure><img src="/files/loiISapaCfFBkDZdFGgE" alt=""><figcaption></figcaption></figure>

#### Steps to Access the Logs Page

1. **Go to Cockpit Menu**\
   Navigate to the sidebar and click on the **Cockpit** menu.
2. **Click on Administration**\
   Within the Cockpit menu, select the **Administration** section.
3. **Select Logs**\
   Click on **Logs** to open the page.

Once opened, the page displays a chronological list of all tenant-related activities. Selecting a log entry opens the detailed log view with additional metadata and contextual information.

#### **Page Overview and Specific Functions**

**1. Subtenant Selection Panel (Left Column)**

* Lists all existing Subtenants.
* Click on a Subtenant to display its associated device data.

**2. Device Assignment Section**

* Shows the complete list of devices currently assigned to the selected Subtenant.
* Allows manual assignment or unassigned of individual devices.

**3. Group Assignment Panel**

* Enables the assignment of entire **Groups** to the Subtenant.
* All devices within the selected groups
* &#x20;will be assigned automatically to the Subtenant.
* Useful for organizing large sets of devices under structured Subtenant ownership.

{% hint style="info" %}

#### Only **Super Admins** can modify device or group assignments across Subtenants. All changes apply instantly and reflect across the platform.

{% endhint %}

{% hint style="danger" %}

#### **Attention**

When assigning a **Group** to a Subtenant, the action will only succeed if **all devices** within that group are **exclusively** assigned to that group.

If **any device** in the selected group is also assigned to **another group**, the platform **will block** the assignment to avoid conflicts in device ownership across Subtenants.

**Tip:** Before assigning, verify that all devices in the group belong **only** to that group or consider cleaning up group overlaps.
{% endhint %}

<figure><img src="/files/TXUlBXb83mdW4HSFhlkZ" alt=""><figcaption></figcaption></figure>


# API ( Swagger )

API settings can limit what actions (Create, Read, Delete…) can be performed based on the API key. Each key has specific permission, allowing or restricting data, while preventing updates or deletions. This is important for machine-to-machine communication, ensuring that each key can only access the designated operations. Additionally, API keys can be set up to control access to specific groups or devices, ensuring that only authorized machines can interact with those devices. This helps prevent unauthorized use of the API.\ <br>

{% hint style="success" %}
access the API DOCUMENTATION here:\
[https://app.gitbook.com/o/DKrl40rifuf7Bl8WIqXK/s/fEQ6KpTjmszWVWQqgcEa/\~/changes/211/.pdf-files-for-download/technical-.pdf](/.pdf-files-for-download/api-documetation.pdf)
{% endhint %}

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcIZHmnmxgNgeM1lntcWsRsBle8M48gAy_nTrdJU117-Az-JmrEOexN_i6mqjRTUgzYfXnIVVIVpNQ7ILvhrVOkQc0sCYK7V35F061Dsc462dNPjDxQSpDhE_j9Xdk6PNzcKUpP?key=ZzE-SQBxhtpTethCCNB9a49Q" alt=""><figcaption><p>Swagger API Introduction</p></figcaption></figure>

## Steps to Swagger API&#x20;

1. Navigate to Administration Menu:
   * Ensure you are in the Cockpit menu, then click on Administration.
2. Access API Section:
   * Click on API to be redirected to Swagger.
3. Authorize API Access:
   * In Swagger, click on the Authorize button.
4. Enter API Key:
   * Provide the API key to complete the authentication process.


# Logs

The **Logs** page displays a complete list of actions performed by tenant users.\
Each entry shows **who performed the action**, **on which entity**, **what operation was executed**, and **the result of the operation**.\
By clicking on a log row, Superadmin users can open the detailed view to access additional information related to the selected action.

<figure><img src="/files/VW1syZxyCYVqoTuP44Em" alt=""><figcaption></figcaption></figure>

#### Steps to Access the Logs Page

1. **Go to Cockpit Menu**\
   Navigate to the sidebar and click on the **Cockpit** menu.
2. **Click on Administration**\
   Within the Cockpit menu, select the **Administration** section.
3. **Select Logs**\
   Click on **Logs** to open the page.

Once opened, the Logs page displays a chronological list of all recorded tenant activities. Clicking on a single log row opens the detailed log view, where additional metadata and operation-specific data are available.

***

#### Logs Table Configuration

From the Logs page, users can configure the table to control which data is displayed.

**Column Selection**

By clicking on the **Columns** button in the top-right corner of the page, users can show or hide table columns.\
The available columns are:

* **User**
* **Entity**
* **Entity Name / Serial**
* **Operation**
* **Status**

Changes are applied immediately to the table view.

***

#### Filtering Logs

Users can refine the displayed data by clicking on the **Filter** icon.\
Filters can be applied using the following criteria:

* **User** (by username or email)
* **Entity type** (e.g. device, tenant, group, device widget, and others)
* **Device serial number**
* **Group name**

Multiple filters can be combined to narrow down the results.

***

#### Export Logs

The currently displayed table can be exported by the user.\
Only the filtered and visible data is included in the export, which is generated as a **CSV file**.

{% hint style="danger" %}
The **Logs** page is only visible to users with **Superadmin** permissions. Other tenant users cannot access or view logs.
{% endhint %}


# Exchanges

The **Exchange** section provides an overview of all devices that are currently in progress to be exchanged with a new device.

The Exchange section is designed to manage device replacement processes, ensuring continuity of configuration and controlled device lifecycle management.

Within the Exchange section, users with the required access rights can:

* View all devices that are planned or currently in progress for exchange.
* Customize which columns are visible in the table.
* Filter, export, merge, or delete devices depending on granted permissions.

{% hint style="warning" %}
This section is **only visible to Super Admin users** with the appropriate access rights granted.
{% endhint %}

<figure><img src="/files/NEfd9j5R3qPI90bIjJr9" alt=""><figcaption></figcaption></figure>

#### How to Access the Exchange Section

1. Open the **Cockpit**.
2. Navigate to **Administration**.
3. Select **Exchange**.

#### Table Columns

The Exchange table allows users to select and visualize the following columns:

* **Old Device** – The device that is being replaced.
* **Exchange Status** – Current status of the exchange process.
* **New Device** – The target device for the exchange.
* **Exchange Date** – Date when the exchange was initiated or completed.
* **Action** – Available actions based on user permissions.

#### Filtering Devices

Users can filter the device list using the following criteria:

* **Exchange Status**
* **Exchange Date – Start**
* **Exchange Date – End**

This helps quickly identify devices based on their exchange progress and timeframe.

#### Export

Users can export the list of devices displayed in the table for reporting or external processing.

<figure><img src="/files/dK1ztNp9VV9CPawqA6or" alt=""><figcaption></figcaption></figure>

#### Table Columns

The Exchange table allows users to select and visualize the following columns:

* **Old Device** – The device that is being replaced.
* **Exchange Status** – Current status of the exchange process.
* **New Device** – The target device for the exchange.
* **Exchange Date** – Date when the exchange was initiated or completed.
* **Action** – Available actions based on user permissions.

#### Filtering Devices

Users can filter the device list using the following criteria:

* **Exchange Status**
* **Exchange Date – Start**
* **Exchange Date – End**

This helps quickly identify devices based on their exchange progress and timeframe.

#### Export

Users can export the list of devices displayed in the table for reporting or external processing.Actions

If the user has the required permissions, the following actions are available:

### Actions – Merge or Delete Device

This section describes the actions available for devices that are in progress of being exchanged.\
The available actions depend on the user’s role and granted permissions.

{% hint style="warning" %}
Only users with the appropriate granted permissions can see and use the **Merge** and/or **Delete** actions. Users without permissions will not see these actions at all.\
To enable these functions, please contact the **GIMASI Administration** team to request access activation.
{% endhint %}

**Delete Device**

* Completely removes the old device from the tenant.
* The device and all related data are permanently deleted.

**Merge Device**

* Merges the old device into a selected new device.
* **All configurations** (rules, groups, settings, and assignments) from the original device are retained.
* The device name is updated **only if the serial number in the name is complete**:
  * If the full serial number is present, the name will be updated with the new serial number.
  * If the serial number is incomplete, the device name will **not** be changed.

When clicking **Merge**, a popup dialog is displayed showing a list of available new device serial numbers that can be selected for merging.

<figure><img src="/files/gRuM3T1sPQmg4oS6fYuV" alt="" width="375"><figcaption></figcaption></figure>


# FOTA

The **FOTA** page within the GIoT platform allows you to remotely manage firmware updates for supported devices.\
From here, you can create **update campaigns**, track their progress, and ensure that all devices run the latest firmware version.\
This process eliminates the need for manual updates, saving time and ensuring consistency across your device fleet.

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

### **Steps to Access the FOTA Page**

1. **Open the Cockpit Menu**\
   From the main sidebar, navigate to the **Cockpit Menu**.
2. **Select FOTA**\
   Click on **FOTA** to access the firmware management section.
3. **Go to Campaigns**\
   Inside the FOTA section, click on **Campaigns** to view all existing campaigns and their current statuses.


# Create FOTA campaign

<figure><img src="/files/YnZFqP1FOmGHBP6y5IMV" alt=""><figcaption></figcaption></figure>

### Steps to Create a FOTA Campaign

#### 1. **Access the FOTA Campaign Section**

* From the **Cockpit Menu**, click on **FOTA**.
* Select the **Campaign** tab to view existing campaigns.
* In the top-right corner, click the **ellipsis icon (⋮)** and choose **Create Campaign**.

#### 2. **Fill in Campaign Details**

**General Information:**

* **Campaign Name**:\
  Use a clear and descriptive name (e.g., “LM Update – EU – Q3/2025”).
* **Device Type**:\
  Choose between:
  * **Level Meter (LM)**
  * **Low-Cost Tracker (LCT)**

{% hint style="info" %}
Device-specific rules apply depending on your selection.
{% endhint %}

### 3. For Level Meter (LM) Devices

When creating a campaign for **LM devices**, the following fields are required:

* **Campaign Name**
* **Group** (optional but recommended)
* **Device Type**: Must be set to *Level Meter (LM)*
* **Expected Firmware Version for A-series devices**
* **Expected Firmware Version for B-series devices**

**Important Notes**:

* Devices with serial numbers starting with:
  * **A...** or **B...** → ✅ Eligible for FOTA updates
  * **86...** → ❌ Not FOTA-compatible — they will be excluded automatically
* **Target Group (Optional but Recommended)**\
  Restrict the campaign to a **specific group**. Only devices within this group matching the selected **device type** and firmware rules will be included in the update.

### 4. For Low-Cost Tracker (LCT) Devices

When creating a campaign for **LCT devices**, the required fields are:

* **Campaign Name**
* **Group** (optional but recommended)
* **Device Type**: Must be set to *Low-Cost Tracker (LCT)*
* **Firmware Filename**: Must be a **numeric-only** value (letters are not allowed)
* **Expected Firmware Version**: Devices with the same or higher versions will be excluded
* **FTP Server IP**: Pre-filled as `172.25.102.151`, but can be changed
* **FTP Server Port**: Default is `21`, but can also be changed if needed

{% hint style="warning" %}
The new campaigns that contains devices already running the **expected firmware version** or a **higher version** will also be excluded.\
*Example: If you enter `2.1.1.1`, any device on `2.1.1.2` will not be updated.*
{% endhint %}

### 5. **Create the Campaign**

Once all necessary fields are completed:

* Click **Complete**.
* **Campaign card** will be created showing:
  * Total number of targeted devices
  * Campaign status
  * Assigned group name

{% hint style="info" %}
LCT Campaign cards and **do not include** `Update 1` and `Update 2` statuses. The update will jump directly to `Running`.
{% endhint %}

### Understanding Campaign Status (LM Devices)

| Status        | Description                                                         |
| ------------- | ------------------------------------------------------------------- |
| **Update 1**  | The FTP Server IP is sent to the device.                            |
| **Update 2**  | The update command is been sent to the device                       |
| **Running**   | The actual firmware update process is underway.                     |
| **Completed** | The firmware update has finished successfully.                      |
| **Error**     | Something went wrong during the process (e.g., device unreachable). |

> **LCT campaigns skip Update 1 & 2** and proceed directly to **Running** once initiated.

Campaign Overlap Restrictions

* You **cannot launch two FOTA campaigns** simultaneously if they share **any device**.
* If a second campaign includes a device already targeted in another running campaign, it will **fail to start** and show an error.
* In this case, you must manually start the second campaign **after the first has finished**.

***

### Best Practices

* Confirm firmware versions before launching campaigns.
* Always verify device serial numbers and expected versions.
* Start campaigns during low-traffic hours to minimize disruption.
* Avoid overlap by clearly grouping devices for unique campaigns.


# Level Meter Full Device Guide Book

<figure><img src="/files/SsLIIY4hzyLPKLQMx6eh" alt=""><figcaption><p>Introduction LM Device Book</p></figcaption></figure>

This guide provides a detailed exploration of the Level Meter (LM) device, highlighting its features, configurations, and practical applications. Designed to deliver precise monitoring of material levels within containers, the LM device combines advanced functionality with user-friendly configurations for efficient asset management.

**Key Focus Areas:**

* **Comprehensive Device Overview:** Understand the LM device's hardware, measurements, and operational parameters.
* **Configuration and Customization:** Step-by-step instructions for setting up thresholds, transmission intervals, and other device-specific settings.
* **Adaptive Rules and Alarm Management:** Learn how to integrate adaptive configurations and set alarms to ensure timely responses to critical conditions.
* **Application Scenarios:** Explore how the LM device optimizes operations, improves resource allocation, and enhances operational safety.

This guide equips you with the knowledge to integrate the Level Meter seamlessly into your operations, ensuring optimal performance and resource efficiency.


# Level Meter - Handeling Information Book

### Device advantages

1. **Low Prices**: Measure fill levels without putting a strain on the budget
2. **Universal Usage:** It’s usable even in the deepest basement, thanks to NB-LoT module;
3. **Metering:** it’s characterized by the maximum precision thanks to a infra-based method;&#x20;
4. **Easy to install:** For optimal transmission, the tracker should be installed outside an object with a clear view to the sky. The view must not be obstructed by metal or carbon fiber surfaces. Mounting in a closed metal enclosure can completely block radio signals, and transmitting and receiving them is no longer possible.
5. **Inside  Encapsulated electronics for robust applications with a battery service life of five years on average**


# Level Meter Technical Specification

| Communication Interface | REST, MQTT-SN                                                                                                                                                                                                                             |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Device Size             | 43.48 x 85.89 x 68.00mm                                                                                                                                                                                                                   |
| Weight                  | <200g                                                                                                                                                                                                                                     |
| IP Class                | IP65                                                                                                                                                                                                                                      |
| Operating Temperature   | Min -20°C Max 60°C (with Chip-SIM)                                                                                                                                                                                                        |
| Storage Temperature     | Optimum 20-30°C (with Chip-SIM)                                                                                                                                                                                                           |
| Operating Humidity      | 5% to 95% (non-condensing)                                                                                                                                                                                                                |
| Storage Humidity        | 5% to 70% (non-condensing)                                                                                                                                                                                                                |
| Number of SIM Slots     | 1x Chip-SIM                                                                                                                                                                                                                               |
| Power consumption       | Quiescent current < 15uA NB-IOT Transmission < 400mA NB-IOT Receiving current < 100mA Data acquisition current < 600mA Average power consumption 0.65mAh/day Typical battery lifetime > 5 years\@1.5 transmissions/day and 2 FOTA updates |


# ELECTRICAL SPECIFICATION

| Operational Voltage | 2.5- 3.0 Volt                       | DC  | AC |
| ------------------- | ----------------------------------- | --- | -- |
| Internal Battery    | 4800mAh\@3V (Li-MnO2), 1,6g Lithium | Yes | No |


# CONNECTIVITY

| LTE NB-IoT           | Cat NB2: B1/B2/B3/B4/B5/B8/B12/B13/B17/ B18/B19/B20/B25/B28/B66/B70/B85 |
| -------------------- | ----------------------------------------------------------------------- |
| Antenna designed for | B8\@900MHz B20\@800MHz Other bands can be supported upon request        |


# SENSOR AND IO

| Accelerometer      | 3-Axis Accelerometer                       |
| ------------------ | ------------------------------------------ |
| Temperature Sensor | Integrated Temperature Sensor              |
| Distance Sensor    | Time of Flight (ToF) 5cm-160cm (Version A) |
| Distance Sensor    | Time of Flight (ToF) 5cm-400cm (Version B) |


# SUPPORTED PROTOCOL LAYERS/SW FEATURES

<figure><img src="/files/vbGSInNXDMQh1HKOIxLd" alt=""><figcaption><p>SUPPORTED PROTOCOL</p></figcaption></figure>


# CERTIFICATES

| EN301489-1 V2.2.3 EN301489-52 V1.2.1 | EMC                            |
| ------------------------------------ | ------------------------------ |
| EN301908-1/-13                       | Conducted RF                   |
| EN62368                              | Safety                         |
| EN62311                              | SAR                            |
| 2011/65/EU                           | RoHS                           |
| 2012/19/EU                           | WEEE WEEE-Reg.-Nr.: DE16378411 |

**Other Certificates**

| UL1642                | Only for batteries          |
| --------------------- | --------------------------- |
| UN38.3                | Transportation              |
| 2006/66 EC 2013/56/EU | Battery Directive           |
| EN 60068-2-5          | UV resistance               |
| IEC60086-4:2014       | Safety of lithium batteries |


# SAFETY AND SECURITY

#### HOUSING MATERIAL

| Housing Materials | MAC-601 UV Modified PC/ABS Alloy                                                                                                                    |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| Main Features     | Excellent comprehensive performance Excellent weather resistance Good for paint and electro-plating Good solvent resistance Good impact performance |


# Level Meter Device Dimensions

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXc-xv2P8qxqaloeHs81pOMd7KdWnyEPREhUrFiFfWm0rUwE-uenlk71-Mhf41sS3KGQJpMfq0XV5g0eOBZvU2SdR-XE1EA49sXEL0yGsfCAObcaMg9bwX9vwbLUo-N7U0qkvdqqgQ?key=zUTPaoPRLjD2aYiaa_qIL38X" alt=""><figcaption><p>Level Meter Dimentions</p></figcaption></figure>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfmBTv5iqT_FYn7aERuOmxeb8Xq6mix9yGIJx2Oiv7_MEtko_UYRrsVR2GBf6MqxUBWQaF_XoAvhcQ4BTo1FPif6AB8xIWgT0r-BfhWdVD_wiyTLd8_EmbirsgvkRrdz0VaII6BhE0pp135n5S6LEM?key=oiChkJeU1fSx7CSxsNd2t_UB" alt=""><figcaption></figcaption></figure>


# Level Meter TOF Types

There are two types of Level Meter equipped with different time-of-flight (TOF) sensors. The types are identified by the first serial number letter (SN prefix):&#x20;

<br>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcnoec2alQsilraI7aHtrMTn1AnCQ9KEM-8itEpvFrVq0pdIDId_biiHdA3f3vqcs1z3RggJPKuaHX_HvXWXXbTJy0T-GR7vfwMAtZ6_O5eZ4CzNoPS03zgq-EOQyZyMmIE2lNl?key=zUTPaoPRLjD2aYiaa_qIL38X" alt=""><figcaption><p>Level Meter TOF</p></figcaption></figure>

<br>




---

[Next Page](/llms-full.txt/1)