Traxmate REST API
Traxmate has rich integration capabilities which can be used to connect Traxmate to your existing services. Use our REST API, subscribe to socket events, or use our pre-integrations towards external systems.
Read more about our API specification here
LORIOT LoRWAN Network Server (LNS) supports every LoRaWAN® Gateway and sensor in the market.
Add a Network
Networks are simply a collection of LoRaWAN gateways, and provide an efficient environment to monitor and manage your gateways.
When adding a new gateway, it needs to be assigned to a network, It can be either by itself or with a collection of other gateways.
A typical method to group gateways into networks is by geographic location, model, client, or whatever structure works best for you.
There are no restrictions to how many gateways can be included in a network (as long as within the account gateway limit), but each gateway can only belong to a single network.
Add your first Gateway
Start your LoRaWAN network by adding your first gateway! You can also follow Loriot step by step to register a Gateway or Base Station guide to get started.
We create a gateway(Basics Station Semtech) here as an example. Navigate to Network
, then click the network you just added. Click Add Gateway
.
On the bottom half of the page a list of gateways will appear, select the relevant gateway model by clicking on its picture. To register the gateway, the eth0 MAC address of the gateway (six octets separated by colons) needs to be entered.
Finally, its location can be set up that can be defined in two different ways. Either by selecting a location on the map or filling out the required information to register the address manually.
Configure your gateway certificate
In the Certificate
page you will find the Network Server Address, Network Server Port, and will be able to download or copy the TLS CA Certificate in order to configure your gateway model.
In your gateway’s user interface, select “LoRa Basics Station” as the mode of operation. Please be sure to configure the address, port, and server certificate using the information obtained in the last step. This is to establish the connection between the gateway and the LORIOT Network Management System.
Go back to the LORIOT´S UI and verify that your LoRa Basics™ Station is now online and properly functioning with the LORIOT Network Management System.
Add an Application
Applications are simply where we register, manage, and organize devices and select the output destination for the device data. When adding a new device(s), it is assigned to an application, this informs the server of the application your device(s) are registered within and the details of your chosen data output.
As long as the total number of devices doesn’t exceed the user’s account limit, any number of devices can be added to an application no matter the sensor type or manufacturer.
Typically, an application will contain all the devices of a specific use case (e.g. all sensors in a smart building) or devices of the same type (e.g. temperature sensors).
Add your first device(SenseCAP T1000 Tracker)
Click Enroll Device
The LORIOT Network Server supports both LoRaWAN 1.0.x and 1.1 devices. The device can be added via two different enrollment process. OTAA (Over-The-Air-Activation) is the recommended option for most devices, but ABP (activation by personalization) is also available. After successfully connecting to the Tracker using SenseCAP Mate App Bluetooth, you can obtain OTAA information on this tab.
Set the platform to other platform, and then copy the Device EUI/APP EUI/APP Key.
Finally, Select Enroll. Once you have added your device(s), you will be able to see the data stream on Loriot.
How to integrate SenseCAP T1000 Tracker
SenseCAP T1000 is a tracker powered by Semtech LR1110, SenseCAP T1000 LoRaWAN® tracker utilizes GNSS/Wi-Fi/Bluetooth for both outdoor and indoor location tracking. With its compact card size, self-geo-adaptive capabilities, local data storage, and battery life lasting months, it’s perfect for various applications for location and status monitoring. Plus, its temperature, light, and motion sensors make it ideal for use in a variety of settings too. Learn more here.
Architecture Overview
Below you find brief summaries, but please read the rest of the document to get the full picture.
● Login to Traxmate and create your building(s).
● Deploy some more Wi-Fis and/or Bluetooth beacons (if needed).
● Perform an indoor survey to check the provided accuracy of your already installed Wi-Fi and/or Bluetooth infrastructure.
● Make a new indoor survey to validate.
● Either repeat the above steps or start using the indoor positioning solution.
● Connect SenseCAP T1000 LoRaWAN Tracker to TTN and send data to Traxmate.
Deploy the Wi-Fi/Bluetooth Beacons
If you do not already have an installed infrastructure of Wi-Fi access points and/or Bluetooth beacons, you can make a deployment that is optimized for positioning. Most already deployed infrastructures of Wi-Fi access points have been placed out most likely to optimize the range and performance of data connection. When considering positioning as well – think “spread it out and keep it close to corners and walls, and at a higher density in areas where you want higher accuracy”.
TIP Bluetooth beacons are most often battery powered, and can then more easilybe deployed. Wi-Fi access points have a longer range. A dense grid of Bluetooth beacons provides better accuracy than a sparse grid of Wi-Fi access points. Check E5 Bluetooth Location Beacon Deployment for more details.
Add Places
Navigate to Places
-> Add New
, then click the map or search an address or a name, click the Add place
popup and submit the details.
The next step is to specify the number of floors of the building and upload floor maps to the floors where you would like to enable indoor positioning. The uploading of floor maps supports PNG and JPEG files. Once you have uploaded the file you use tools to scale, rotate, and place it correctly on the map. There is also a tool to crop the PNG/JPEG file along the shape of the building.
After setting up the building, click SAVE
.
Do the survey
Once the building has been added, upload floor maps and update them.
- For each building, specify the number of floors and upload detailed floor plans (PNG or JPEG) for each floor where you would like to enable indoor positioning.
- On each floor plan in Traxmate Dashboard, you should add the respective level height associated with them in Indicate Level Height. Start from the lowest floor with 0 meters, then add up the respective meters to the higher ones
When you are done with floor maps it is time to perform the survey by using the Combain Indoor Survey APP ( Android version)
-
- Download the “Combain AR Indoor Survey” app from the Play Store here: Combain Indoor Survey – Apps on Google Play
Install it and start the app. - Grant all permissions from app prompts, usually, it is 5 prompts; “Take pictures and record video”, “Device location”, “Physical activity”, “Relative position” and “Allow notifications”.
- Log in using your Traxmate account
- Download the “Combain AR Indoor Survey” app from the Play Store here: Combain Indoor Survey – Apps on Google Play
TIP Android normally has a limitation of how often apps can scan for Wi-Fi, it is set to once per 30 second. For the purpose of getting a more accurate survey you are recommended to turn off this throttling. You have to set Android in developer mode to be able to do this. Go to Settings > Developer options > find “Wi-Fi scan throttling” > disable it (or Settings>System>Advanced>Developer options).
Device Integration
You will have a list of decoded devices that is ready to use. Traxmate support 1000+ of devices out-of-the-box but it can be configured to support any type of device.
In just a few clicks, you can connect a device and start consuming live data.
No coding is required!