User Guide for ThingPark Wireless - Version 5.1

User Guide for ThingPark Wireless - Version 5.1

This article is the official documentation provided by Actility for the 5.1 release.
It will contain User's Guide, Product Description, and other reference documents. 




User's Guide
  • Address Manager User's Guide: This document, addressed to Operators’ administrators, shows how to use the Address Manager to prepare and manage LoRa DevAddr and DevEUI addresses for IoT developers and Suppliers of ABP and OTAA devices, so that Subscribers can create devices with validated addresses in the Device Manager-Verification Code.
    The Address Manager is displayed as a tab in the Operator Manager.
  • Device Manager User's Guide: The ThingPark Wireless Device Manager is the back-end User Interface that allows managing all LoRaWAN™ devices. The scope of this document is to provide end users with guidelines on the entire Device Manager GUI, including:
    • The general use of the interface,
    • The device provisioning, configuration and management, 
    • The alarm monitoring and management,
    • The connectivity plans, Application Servers, and AS routing servers’ association.
  • Network Manager User's Guide: The purpose of the Network Manager is to add Gateways to create a LoRaWAN™ network or to add Gateways/Long-Range Routers (LRRs) to an LoRaWAN™ existing network. This guide is intended for Subscribers.
  • Operator User's Guide: The scope of this User Guide is to provide administrators of an Operator with guidelines on the entire Operator role to get started and use the Operator application, in order to perform the following tasks, according to the group they belong:
    • Log in for the first time and every day
    • Manage administrators accounts
    • Set the Operator account and security policy
    • Access other accounts by invitation or impersonation
    • Manage others roles as Suppliers, Vendors, Subscribers
    • Manage the wireless network at the Operator’s technical top-level.
  • Quick Start User's Guide: The scope of this document is to describe the first step to set a turn-key ThingPark ecosystem.
  • Radio Parameters User's Guide: The scope of this document is to provide guidelines to ThingPark Wireless radio parameters optimization in ThingPark release 4.1.2. The target audience of this document is LoRaWAN™ radio network planning and optimization teams, as well as quality assurance teams. The document is divided into 3 main sections:
    • Description of the main radio algorithms: Adaptive Data Rate (ADR), RX1/RX2 selection and Antenna Diversity
    • Description of RF region concept, associating each base station to an RF region, configurable parameters per RF region
    • Interaction between parameters configured in device profile, connectivity plan
  • Supplier User's Guide: The scope of this User Guide is to provide the guidelines on the entire role, user management, connectivity plans creation and management, base stations creation and network management and to provide applications and/or devices.
  • Wireless Supplier User's Guide: The aim of this User Guide is to provide users with guidelines on the Connectivity Manager Application within the Connectivity Supplier Interface.
    The document describes general points such as Users’ creation and management along with Connectivity Plans and Licenses’ management as a Connectivity Supplier.
  • Wireless Logger User's Guide: The scope of this document is to provide Operators, Network Managers, Subscribers and End-Users with guidelines on the entire Graphical User Guide (GUI) to supervise frames, history export, data decoding for the ThingPark Wireless Logger tool. The ThingPark Wireless Logger is the back-end User Interface (UI) that allows you to monitor data frames of the LoRaWAN™ devices.

Network Tools, Optimizations, Cellular Coexistence Analysis

  • BS Commissioning tool User's Guide: The scope of this document is to provide users with guidelines on how to use the ThingPark Wireless BS Commissioning tool. This tool is part of ThingPark Wireless TWA platform and typically used by Base Station commissioners to complete the following tasks:
    • Record Base Station engineering parameters such as antenna’s-built characteristics (antenna gain, cable losses, antenna type, azimuth for directional antennas, surrounding clutter environment and obstacles, delay between the Base Station equipment and the antenna, and so forth…). The electrical characteristics of the antenna can be either based on on-site measurements or provided in equipment datasheets. These engineering parameters are then used by the tool to update the maximum conducted TX power of the Base Station, considering the radiated power levels set in the LRR configuration files.
    • Validate that the Base Station is up and running after commissioning, by checking its “Status” in real time, as well as testing its connectivity to ThingPark core network. Using an appropriate test device provided to commissioners (for instance, LoRa® demonstrator), the tool allows testing connectivity between the Base Station and the network by displaying the packets exchanged in real time.
  • Network Survey User's Guide: The Network Survey tool helps visualize device data (radio metrics, payload information) on the map. It also computes additional UL metrics based on those reported by LRR to LRC. This tool is very useful to assess LoRa network coverage status through walk/drive
    tests, and detect any coverage gaps if proper payload decoder is used. DL radio measurements can also be available in the tool if they are sent by the device in UL frame payload.
    As prerequisites:
    • Test device has to be configured to report GPS coordinates in its UL payload. To analyze DL measurements, the device should additionally report DL RSSI & DL SNR in its UL payloads
    • Proper payload decoder corresponding to the test device has to be available.
    • Application Session Key (AppSKey) has to be provisioned in ThingPark Wireless during device provisioning
  • Spectrum Analysis User's Guide: The scope of this document is to present Spectrum Analysis. This tool is used to display noise scan results generated by the Base Station, and to determine the noise level seen by each frequency within the defined spectrum.and RF region.
    Noise-Scan statistics are used to derive the average interference level (that is rise above thermal noise floor) to be used for the link budget analysis. It is also mandatory for the appropriate selection of physical frequencies related to LoRaWAN™ logical channels.
  • TWA Exporter User's Guide: The scope of this document is to provide users with guidelines using the TWA-Export tool version 1.10.1.
    This tool allows extracting information from the Network Manager, the Device Manager and the Wireless Logger tools using API OSS and API Wireless Logger. It also gathers the data into a downloadable file. Exports can be made from a GUI or directly with a URL. It is also possible to make automatic exports using the URL to save the generated file into a specific folder and to send it by email.



    • Related Articles

    • User Guide for ThingPark Wireless & ThingPark OS - Version 4.3

      This article is the official documentation provided by Actility for the 4.3 release. It will contain User's Guide, Product Description, and other reference documents.  The release notes can be found  in the release notes section Today (end of 2017), ...

    • User Guide for ThingPark Wireless & ThingPark OS - Version 4.2

      This article is the official documentation provided by Actility for the 4.2 release. It will contain User's Guide, Product Description, and other reference documents.  The release notes can be found  in the release notes section Today (end of 2017), ...

    • Configuration Guides for ThingPark Wireless - Version 5.2

            Configuration Guides for ThingPark Wireless - Version 5.2  This article is the official documentation provided by Actility for the 5.2 release. It will contain configuration guides for:  LRR Administration Guide Kafka Administration Guide HSM ...

    • Developer Guides for ThingPark Wireless - Version 5.2

            Since 5.0 release, the OSS-API description is available at https://oss-api.thingpark.com/ ( website powered by Swagger). Developer Guides for ThingPark Wireless - Version 5.2 This article is the official documentation provided by Actility for ...

    • Functional Descriptions for ThingPark Wireless - Version 5.2

            Functional Descriptions for ThingPark Wireless - Version 5.2 This article is the official documentation provided by Actility for the 5.2 release. It will contain functional descriptions for ThingPark Wireless products but not all ThingPark ...