| Line 1: |
Line 1: |
| − | ==Introduction==
| + | [[Image:flespi.png|300px|frame]] |
| − | [[Image:Flespi.png|300px|frame]] | + | <b>flespi</b> is compatible with most of Teltonika's Mobility devices<br><br><br><br><br><br> |
| − | Many clients who own a Teltonika device ask how to create a server to send data to. To get you a quick start, we present you a tutorial with the most important steps that have to be taken, when setting up your device to send data to the server – flespi platform!
| |
| − | <br><br><br><br><br><br> | |
| | | | |
| − | ==First time with flespi== | + | ==Description == |
| − | <b>1.</b> Go to [https://flespi.io/ flespi.io]<br>
| + | flespi is an innovative backend platform by Gurtam connecting telematics hardware of any type to various BI and telematics systems, providing unified data communication via REST API. The service can receive and process data from almost any telematics device on the market regardless of the protocol and store them in a standardized JSON format. Unified messages are easily accessible and instantly ready-for-use in your software.<br> |
| − | <b>2.</b> Click on <b>Login/Register</b> button<br>
| |
| − | <b>3.</b> Click on one of the icons to register with<br>
| |
| | | | |
| − | <i>In the example, registering is done as shown in the picture:</i>
| + | flespi ecosystem currently includes:<br> |
| − | [[Image:Flespi_register.png|1000px|frame|center]]<br>
| |
| | | | |
| − | <b>4.</b> After clicking the ‘<b>@</b>’ icon, click the <b>REGISTER</b> button<br> | + | *[https://flespi.com/telematics-hub Telematics hub] – connect versatile trackers to multiple platforms quicker. Aggregate data from devices by multiple manufacturers and stream it to fleet management, IoT, or BI platforms from a feature-rich visual interface.<br> |
| | + | *[https://flespi.com/device-management Device management platform] – configure your tracking devices in a single spot. Send commands via GPRS or SMS from a user-friendly universal device configurator and easily debug any issues in Toolbox.<br> |
| | + | *[https://flespi.com/mqtt-broker MQTT broker] – enable fast and secure M2M communication. Establish reliable connectivity within your IoT infrastructure using advanced features from the MQTT 5.0 specification.<br> |
| | + | *[https://flespi.com/database Telematics database] — store telemetry from tracking devices, readings from sensors, pics & videos from cameras, and more. Get the data in an instant in your applications once needed.<br> |
| | | | |
| − | [[Image:Flespi_register1.png|1000px|frame|center]]<br>
| + | ==Supported devices== |
| | | | |
| − | <b>5.</b> Fill the required fields in order to register<br>
| + | 3Dtracking supports all the main Teltonika Telematics tracking devices. For any specific queries, please address the service provider directly. |
| | + | ==External links== |
| | + | https://flespi.com/ |
| | | | |
| − | [[Image:Flespi_register2.png|1000px|frame|center]]<br>
| + | Never used <i>flespi.io</i> before? Please read our guide <b>[[First_time_with_flespi_platform|here]]</b>. |
| − | | |
| − | <b>NOTE:</b> When logging in the first time, a platform generates a <i>MASTER FLESPI TOKEN</i>, therefore you
| |
| − | will not be required to use a password, when logging into the platform next time. To login next
| |
| − | time, simply to press the fingerprint icon, visual example is shown below<br>
| |
| − | | |
| − | [[Image:Flespi_login.png|1000px|frame|center]]<br>
| |
| − | | |
| − | ==How to add a device==
| |
| − | | |
| − | <b>1.</b> Click on <b>Telematics Hub</b> to expand the panel<br>
| |
| − | <b>2.</b> Click <b>Devices tab</b><br>
| |
| − | <b>3.</b> To add a device, click '<b>+</b>' button, which is at the bottom right corner of the screen<br>
| |
| − | <b>4.</b> After '<b>+</b>' clicking button, a Device tab appears in which you have to fill the fields<br>
| |
| − | | |
| − | [[Image:Device_add.png|1000px|frame|center]]<br>
| |
| − | | |
| − | <b>5.</b> Once saved, a created device in device tab appears<br>
| |
| − | | |
| − | [[Image:Example_device_tab.png|1000px|frame|center]]<br>
| |
| − | | |
| − | ==How to create a channel==
| |
| − | | |
| − | <b>1.</b> Click on <b>Telematics Hub</b> to expand the panel<br>
| |
| − | <b>2.</b> Click <b>Channels tab</b><br>
| |
| − | <b>3.</b> To add a channel, click '<b>+</b>' button, which is at the bottom right corner of the screen<br>
| |
| − | <b>4.</b> After '<b>+</b>' clicking button, a Channel tab appears in which you have to fill the following fields<br>
| |
| − | | |
| − | [[Image:Example_Channel_add.png|1000px|frame|center]]<br>
| |
| − | | |
| − | <b>5.</b> Once the saving is done, a channel is created. In example below, a channel named TELTONIKA_TEST is created<br>
| |
| − | <br>
| |
| − | [[Image:Channel_domain-port.png|1000px|frame|center]]<br>
| |
| − | | |
| − | ==How to connect a device to created channel==
| |
| − | In instructions [[First_time_with_flespi_platform#How_to_create_a_Channel| <i>'How to create a channel'</i>]] a channel has been created with channel <b>IP Address/Domain and Port</b> numbers. To connect to that
| |
| − | channel, the device must be configured. <b>IP Address/Domain and Port</b> numbers are shown in image below.<br>
| |
| − | <br>
| |
| − | [[Image:Channel_domain-port.png|1000px|frame|center]]<br>
| |
| − | | |
| − | <b>Teltonika configurator: Setting up a device for communication with the server</b>
| |
| − | {|style="width: 100%;"
| |
| − | |[[Image:GPRS_settings.png|right]]
| |
| − | <b>1.</b> Press <b>GPRS</b> tab<br>
| |
| − | * <b>''GPRS Context'' field requires you to enter your SIM providers' APN settings. Make sure to fill this in based on the SIM provider you are using with your Teltonika device.</b>
| |
| − | More information about ''GPRS'' panel and it's parameters for each device can be found here:
| |
| − | | |
| − | [[TST100 GPRS settings|TST100]] | [[TFT100 GPRS settings|TFT100]] | [[GH5200 GPRS settings|GH5200]] | [[TMT250 GPRS settings|TMT250]]
| |
| − | |}
| |
| − | | |
| − | {|style="width: 100%;"
| |
| − | |[[Image:Server_settings.png|right]]
| |
| − | <b>2.</b> In <b>GPRS</b>-><b>Server settings</b> -> <b>Domain</b> field, enter <b>flespi domain</b><br>
| |
| − | <b>3.</b> In <b>Port</b> field, enter <b>flespi domain port</b> number<br>
| |
| − | |}
| |
| − | | |
| − | <b>Note:</b> To configure how frequently the device sends data to the <i>flespi</i> platform, go to <b>Data Acquisition settings</b>
| |
| − | and set <b>On stop</b>, <b>Moving</b> parameters in the configurator. In the example below, the device has been
| |
| − | configured to:<br>
| |
| − | * <i>Min Period</i> – Acquire a new record every 5 seconds <br>
| |
| − | * <i>Min Saved Records </i> – Have minimum 5 records in one data packet that can be sent to the server<br>
| |
| − | * <i>Send Period</i> – Send records to the server every 30 seconds.<br>
| |
| − | | |
| − | More information about ''Data acquisition'' panel for each device can be found here:
| |
| − | | |
| − | [[TST100_Data_acquisition_settings|TST100]] | [[TFT100_Data_acquisition_settings|TFT100]] | [[GH5200_Data_acquisition_settings|GH5200]] | [[TMT250_Data_acquisition_settings|TMT250]]
| |
| − | | |
| − | | |
| − | <br>
| |
| − | [[Image:Data_acquisition_flespi.png|1000px|frame|center]]<br>
| |
| − | | |
| − | ==Tracking proximity records on flespi==
| |
| − | Before going any further, make sure you have configured proximity settings!<br>
| |
| − | | |
| − | * <b>To find out more about proximity feature visit:</b> [[Proximity|About proximity]]
| |
| − | * <b>To start a Proximity Quick Start Guide visit:</b> [[Proximity functionality Quick Start Guide|Proximity functionality Quick Start Guide]]<br>
| |
| − | <br>
| |
| − | <div style="text-align: center;">[[File:Alert.png|30px]]</div>
| |
| − | <div style="text-align: center;"><b>To use proximity feature or track proximity records, device proximity firmware is required!</b></div>
| |
| − | <div style="text-align: center;"><b>We recommend to use the latest version of the firmware. Contact your sales manager to get Teltonika Drive link and download the latest version.</b></div><br>
| |
| − | | |
| − | <b>1.</b> Go to [https://flespi.io/ flespi.io] platform<br>
| |
| − | <b>2.</b> Login and select <b>Channels</b> panel<br>
| |
| − | <b>3.</b> Tap on a <b>channel</b><br>
| |
| − | <b>4.</b> When selected, a channel window appears. Click on <b>TOOLBOX</b></b><br>
| |
| − | <b>5.</b> When <b>TOOLBOX</b></b> is opened, a new screen appears, where records from the device sent to the channel can be seen<br>
| |
| − | <b>6.</b> Click on icon, which is at the bottom right side as shown in the picture below<br>
| |
| − | | |
| − | [[Image:Server_icons.png|1000px|frame|center]]<br>
| |
| − | | |
| − | <b>7.</b> In the search field, search for these parameters:<br>
| |
| − | * proximity.duration<br>
| |
| − | * proximity.violation.ident<br>
| |
| − | * custom.param.889<br>
| |
| − | <b>Click on the eye button to add each of the searched columns</b><br>
| |
| − | | |
| − | <b>8.</b> If everything is done correctly, at the bottom, three new recently added columns are visible<br>
| |
| − | | |
| − | [[Image:New_columns_flespi.png|1000px|frame|center]]<br>
| |
| − | | |
| − | <b>9.</b> Now unplug the devices and test proximity feature. When proximity event happens, the device sends data to the flespi platform.<br>
| |
| − | | |
| − | [[Image:Proximity_flespi_violation.png|1000px|frame|center]]<br>
| |
| − | | |
| − | <div style="text-align: center;"><b>Information about parameters:</b></div>
| |
| − | {| class="wikitable" style="margin: 1em auto;"
| |
| − | | |
| − | |-
| |
| − | | <b>Column name</b>
| |
| − | | <b>Description</b>
| |
| − | |-
| |
| − | | proximity.duration || Time period proximity event has happened in seconds
| |
| − | |-
| |
| − | | proximity.violation.ident || IMEI number of devices that have violated the personal space.
| |
| − | |-
| |
| − | | custom.param.889 || AVL ID – 889 Shows proximity state: <b>On-Entrace</b> event sends value – 16, <b>On-Exit</b> event sends value – 0
| |
| − | |-
| |
| − | |}
| |
| − | | |
| − | ==Tracking ManDown records on flespi==
| |
| − | * <b>To find out about ManDown feature visit:</b> [[GH5200_Features_settings#ManDown|GH5200]] | [[TMT250_Features_settings#ManDown|TMT250]]
| |
| − | * <b>To learn how to configure a ManDown feature visit:</b> [[How_to_configure_ManDown_scenario|ManDown scenario]]<br>
| |
| − | <b>1.</b> Go to [https://flespi.io/ flespi.io] platform<br>
| |
| − | <b>2.</b> Login and select <b>Channels</b> panel<br>
| |
| − | <b>3.</b> Tap on a <b>channel</b><br>
| |
| − | <b>4.</b> When selected, a channel window appears. Click on <b>TOOLBOX</b></b><br>
| |
| − | <b>5.</b> When <b>TOOLBOX</b></b> is opened, a new screen appears, where records from the device sent to the channel can be seen<br>
| |
| − | <b>6.</b> Click on icon, which is at the bottom right side as shown in the picture below<br>
| |
| − | | |
| − | [[Image:Server_icons.png|1000px|frame|center]]<br>
| |
| − | | |
| − | <b>7.</b> In the search field, search for <b>mandown.alarm.status</b> parameter<br>
| |
| − | <b>Click on the eye button to add a column</b><br>
| |
| − | <b>8.</b> If everything is done correctly, at the bottom, a new recently added column is visible: <b>mandown.alarm.status</b>
| |
| − | | |
| − | [[Image:ManDown_flespi.png|1000px|frame|center]]<br>
| |
| − | | |
| − | <b>9.</b> When a ManDown event happens, the device sends a record to flespi platform</b><br>
| |
| − | | |
| − | [[Image:Mandown_flespi_true.png|1000px|frame|center]]<br>
| |
| − | | |
| − | ==In door tracking using BLE advertising Beacons on flespi==
| |
| − | <br>
| |
| − | <div style="text-align: center;">[[File:Alert.png|30px]]</div>
| |
| − | <div style="text-align: center;"><b>Before going any further be sure that your Beacon is enabled and ready for configuration!</b></div><br>
| |
| − | | |
| − | <b>To learn how to configure in door tracking using BLE advertising Beacons visit:</b> [[How to read data from BLE Beacons]]
| |
| − | | |
| − | <b>1.</b> Go to [https://flespi.io/ flespi.io] platform<br>
| |
| − | <b>2.</b> Login and select <b>Channels</b> panel<br>
| |
| − | <b>3.</b> Tap on a <b>channel</b><br>
| |
| − | <b>4.</b> When selected, a channel window appears. Click on <b>TOOLBOX</b></b><br>
| |
| − | <b>5.</b> When <b>TOOLBOX</b></b> is opened, a new screen appears, where records from the device sent to the channel can be seen<br>
| |
| − | <b>6.</b> Click on icon, which is at the bottom right side as shown in the picture below<br>
| |
| − | | |
| − | [[Image:Server_icons.png|1000px|frame|center]]<br> | |
| − | | |
| − | <b>7.</b> In the search field, search for <b>ble.beacons</b> parameter<br>
| |
| − | <b>Click on the eye button to add a column</b><br>
| |
| − | | |
| − | [[Image:BLE_BEACONS_FLESPI.png|1000px|frame|center]]<br>
| |
| − | | |
| − | <b>8.</b> If everything is done correctly, at the bottom, a new recently added column is visible: <b>ble.beacons</b>
| |
| − | | |
| − | [[Image:Blebeacons_column.png|1000px|frame|center]]<br>
| |
| − | | |
| − | <b>9.</b> Beacon data is sent to flespi platform, where beacon UUID can be seen and its radio signal strength
| |
| − | | |
| − | [[Image:Ble_beacon_packet.png|1000px|frame|center]]<br>
| |
| | | | |
| | + | {{Template: trademark disclaimer}} |
| | [[Category: Fleet Management platforms]] | | [[Category: Fleet Management platforms]] |