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.

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.

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.

Here, you can access and read the hardware datasheets.

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.

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.

Assign/Modify Role to Tenant's user

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

How to identify Bootstrap state? And the device Properties.

Device card shows - Not Activated - ?

From the PROPERTIES section you can also:

• Rename device.

• Add a device description.

• Upload asset pictures.

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

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.

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

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

Let's look at each device Dashboard Type

Add widgets to device dashboard

Copy one device dashboard to a group of Device

Reset Default dashboard

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.

Understand what is visible in the Event View page.

Configuring individual devices

Share configurations across multiple devices.

You can Copy one device configuration to group of devices.

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.

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?

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.

Track Last position or

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.

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

Learn the Configuration page details.

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

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

Understand what Geofences are and where can be applied

How to Create Geofence

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.

Lean everything about Alarms page, for devices and Cockpit menu.

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

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.

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.

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.

Receive Invitation

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.

2FA Login

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.

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 Next to access your account securely.

Understand how to create Groups and Subgroups

Assign Device to Group or SubGroup

Is possible to also assign the Device to a Specific Groups

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.

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.

• 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).

Learn how to Create Sub-Tenants

Assign User to Sub-Tenant

Assigning devices to Sub-Tenants

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.

Upload a profile avatar picture for the personal user profile

1. Open profile: click on the user name

2. Open the Avatar page: upload picture - drag and drop the file (.JPG, .JPEG, .PNG) - upload from computer's drive.

API Integration

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

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.

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.

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.

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

• 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.

• 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.

To access the Device page:

1. Ensure you are in the Cockpit menu and click on Device.

2. The page will display the entire list of devices within the tenant.

Filter: Use filters to display only devices that meet specific criteria To find a specific device, use the search bar by entering the name, serial number, or description.

Create new device: name the new device and select its type

Export a file: export the filtered list or a file as a .CSV or .JSON file.

Modify the order list: choose the order of display.

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.

Device '' Not Activated '' Activation and Migration Status

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.

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.

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.

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.

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.

(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.

(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.

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

(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.

(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.

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

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

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.

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.

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.

This function allows users to reset the configured dashboard layout into the original one.

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.

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.

• Filter Group Page List

• Create New Group

• Switch View: Switches between card view and tree view design.

• Export Groups Data

• Sort By

• Manage: Allows management of devices and user assignments.

• Edit: Enables editing the group's name, description, and UI settings.

• Delete: Deletes the group along with all its associated subgroups and device assignments.

• Reset Dafault dashboard: Restore the dashboard to its original layout, deleting any customizations to its layout.

• Add widget: The user can select widgets to be assigned to the devices in the group. IMPORTANT: If no devices are assigned to the group, the widget will not display any data.

• Copy Dashboard: Copy and paste the current group's dashboard configuration to another group selected from the list.

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.

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.

Multiple Ways to Create Groups

Groups can be created from different sections of the platform, each leading to the same result:

1. Assets menu: The primary and most intuitive way to create and manage groups, allowing direct device assignments and hierarchical subgroup creation.

2. Cockpit > Groups Section: This provides an alternative method for creating groups. Once the group is created, the view automatically switches back to the Assets menu for group management tasks, such as adding devices or creating subgroups.

This section will guide you through the process of creating groups specifically from the Assets menu, ensuring a seamless experience in managing your devices.

Steps to Create Groups

1. Navigate to Assets View:

   • From the main menu, go to Assets to access the groups and devices management page.

2. Click on Create Group:

   • Locate the Create Group icon (usually represented by a "+" symbol) at the top-left corner of the page and click on it.

3. Enter Group Details:

   • In the popup window, input the group name in the Name field.

   • Optionally, add a Description to provide context or details about the group.

4. Save the Group:

   • Click the Create button to finalize the group creation.

5. Manage the Group:

   • Add devices.

   • Create subgroups.

   • Configure settings and rules.

Note: If the group is created via Cockpit > Groups, the view will still redirect to Assets View for management and assignment.

Steps to Assign Device to Group

1. Define group and click Open

2. Click on device

3. Manage device

When finished, update the section to save the changes or reset the selection.

Use the same process to remove devices from a specific section.

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.

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

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.

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

Steps to import device list to a group

Access Cockpit Menu: Navigate to the Cockpit menu.

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.

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.

CREATE SUBGROUPS

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.

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).

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

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

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.

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.

Steps to Access to Alarms Cards

1. From the Device Alarms front page to View Alarm Details:
2. Navigate to Alarm Pages:

   • The arrow icon redirects you to the Device Alarms Card page, to manage alarm actions.

Alarms Card Explanation

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.

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.

1. Alarms Details Page:

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

  • Device Name

  • Alarm Level

  • Alarm Status

  • Specific Alarm Triggered

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.

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.

1. Confirm Alarm:

   • Opens the Update Alarm Status panel, allowing the user to confirm or resolve all alarms.

   • Click Update to save the changes.

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.

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.

• 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.

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.

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

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.

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.

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

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.

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.

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.

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.

Add Quick-Access Dashboard

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.

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

The page will open on all the users already logged.

1. Initiate User Creation: Click on Create User.

2. Fill in User Details: Complete all required fields, including the user's email address, name, and other details.

3. Assign Initial Role: Set the initial role for the user. This role can be updated later through the Edit User option.

4. Select Language Preference: Choose the user's preferred language from the available options.

5. Automatic Tenant Assignment: The tenant is automatically assigned to the user based on the tenant in which the user is being created.

6. Confirm Creation: Click Create to finalize the user setup. The user will receive a confirmation email at the provided address.

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

• 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, the 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:

1. Normal:Access 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.

SuperAdmin and users with the appropriate role and permissions, can assign also a role to a user, defining what it can do.

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.

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

1. Roles: Where the User’s role can be assigned or revoked;

2. Groups: Where one or more Device Groups can be assigned to a user.

3. Logs: Admin can monitor all the logs and actions the User as accessed to, within the Tenant

1. Modify User information: Name, Surname, Language and Location.

2. User access Security: Here Admin have the ability to select the user Log-in methods.

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.

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).

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.

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.

API

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

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.

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.

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.

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.

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.

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.

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;

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

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.

Steps to Swagger API

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.

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.

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.

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.

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

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.

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.

HOUSING MATERIAL

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):

The Level Meter must be installed in a location free from significant mechanical stresses, such as shocks, impacts, vibrations, bending, or torsional forces.

To ensure optimal cellular transmission, mount the device externally with a clear line of sight. Avoid blocking the view with metal or carbon fiber surfaces, as these can interfere with signals. Installation inside a closed metal container may fully block transmission and reception.

Other Certificates

The level meter regularly reports the current fill level of the container.

• Fill level thresholds are set according to specific requirements.

• When a threshold is reached, an alarm is triggered to ensure the container is replaced or emptied as quickly as possible.

Level Meter - On-demand collection

Thanks to the process of optimization, the collectionis not performed at set time intervals, but the Leve Meter automatically determines the fill level

• Optimization of container runs;

• Reduction of manual administrative overhead;

• Prevention of collections too early or too late.

Level Meter Advantages of IoT level measurement

Sustainable

• Process optimizations mean substantial reduction of CO2 emissions

Secure

• Connection with the company’s NB-IoT network IoT cloud services from the certified Cloud

Efficient

• Low costs and fixed price make for calculable costs

• No investment required in own wireless infrastructure

• Process optimizations mean fuel and manpower savings

Before first use, low-cost trackers must be awakened from sleep mode to start measurements and send transmissions. Follow these steps:

1. Remove the cover from the lens

2. Shake the device several times in the ToF direction.

3. Check the LED on the back of the device.

• If Step 2 was successfully completed, the LED on the back should light up (mode "Always On").

• If the LED does not light up, repeat Step 2.

1. Verify whether the registration was successful:

• Observe the LED:

+ The LED will blink rapidly for 3 seconds and then turn off, indicating that the device has been successfully activated.

+ This process can take up to 3 minutes. After successful activation, the LED will not light up even if Step 2 is repeated.

• Observe the LED:

+ If the LED turns off without blinking, the activation procedure has failed.

+ Possible causes:

a. An invalid network.

b. An issue with Deutsche Telekom's gIoT Cloud platform.