Teltonika FMB003 User manual

https://wiki.teltonika-gps.com/view/FMB003_Getting_Started_with_AWS_IoT_Core

FMB003 Getting Started with AWS IoT Core

Main Page > OBD Trackers > FMB003 > FMB003 Manual > FMB003 Getting Started with AWS IoT Core

Contents

1 Document Information

1.1 Glossary

1.2 Revision History (Version, Date, Description of change)

2 Overview

3 Hardware Description

3.1 DataSheet

3.2 Standard Kit Contents

3.3 User Provided Items

4 Set up your Development Environment

4.1 Tools Installation (IDEs, Toolchains, SDKs)

4.2 Other software required to develop and debug applications for the device

5 Set up your hardware

6 Document Information

6.1 Glossary

7 Other software required to develop and debug applications for the device

8 Setup your AWS account and Permissions

9 Create Resources in AWS IoT

10 Provide Device with credentials

10.1 AWS IoT Core Configuration

10.1.1 Setting up AWS IoT Core

10.1.2 Finding device data endpoint (server domain)

10.2 Merging certificates into a single file (FW Ver. 03.28.03.Rev.311)

10.3 Configuring the device

10.3.1 Security and certificates

10.3.1.1 Using certificate, private key and root certificate. (Via Cable)

10.3.2 Using FW Ver. 03.28.03.Rev.311 and merged_cert.pem file. (Via

FOTA WEB)

10.3.3 Device GPRS configuration for AWS IoT Custom MQTT settings

11 Checking received data and sending commands in the AWS IoT core

12 Debugging

13 Troubleshooting

14 Troubleshooting

15 Debugging

Document Information

Glossary

FMB003 (tracker) – GNSS tracking device manufactured by Teltonika Telematics.

Wiki – Teltonika IoT knowledge base - https://wiki.teltonika-iot-group.com/.

FOTA – Firmware Over The Air.

Configurator – Tool to configure Teltonika Telematics devices.

Crowd support forum – knowledge base dedicated for Troubleshooting.

Revision History (Version, Date, Description of change)

Version Date Description

v1.5 2023.02.14 Links updated

v1.4 2022.12.19 Minor information update

v1.3 2022.11.29 Page created

Overview

FMB003 is an ultra-small plug and play device dedicated to OBD applications of next generation.

The main feature of FMB003 is its possibility to read OEM parameters (PIDs) via OBD port. With this

device, you will be able to read Real Odometer and Real Fuel Level data. What’s more, our device

comes with the supported vehicles and data list, so no need to guess anymore – now you know what

data you can read from a specific vehicle.

It is a perfect tracker for a wide range of use cases – including fleet management of light commercial

vehicles, driver log-book, insurance telematics (UBI), car rental & leasing and more.

The device supports various BLE 4.0 sensors, beacons, hands-free headsets, firmware and

configuration updates via Bluetooth, thus, expanding its already rich set of features.

FMB003 – setting a new standard in OBD tracking!

Currently for MQTT solution evaluation firmware is required to be used - 03.27.10.Rev.520.

For firmware supporting MQTT please contact your sales manager or contact directly via Teltonika

Helpdesk.

Changes in firmware versions and update information can be found in device wiki page: FMB003

firmware errata

Hardware Description

DataSheet

FMB003 device data sheet can be downloaded here: DataSheet

Standard Kit Contents

STANDARD PACKAGE CONTAINS

20 pcs. of FMB003 trackers

Packaging box with Teltonika branding

Teltonika suggest standard order codes for the device purchase, by contacting us, we can create

special order code which would fulfill user needs.

More ordering information at: Ordering

User Provided Items

Power supply (10-30V).

MicroUSB to USB A cable.

Set up your Development Environment

Tools Installation (IDEs, Toolchains, SDKs)

FMB003 comes with our created firmware, therefore no additional development or scripting is

required for this unit to support AWS IoT. Only by using Teltonika Configurator FM Configurator

versions, connection point of AWS IoT server is required.

Other software required to develop and debug applications for the device

For debugging situations, device internal logs can be downloaded OTA by using our FotaWEB

platform or by using Teltonika Configurator.

Set up your hardware

All details about FMB003 can be located in our dedicated wiki page FMB003 Wiki

Basic device startup instructions provided in FMB003 First Start.

Device characteristics, power supply information: FMB003 General description

FMB003 firmware change can be performed via FotaWEB (direct buyer gets access to this

platform) or via device Configurator

Device LED information: FMB003 LED Status

USB driver download, datasheet and quick start guide downloads: FMB003 Downloads

Document Information

Glossary

Wiki – Teltonika IoT knowledge base - https://wiki.teltonika-iot-group.com/.

FOTA – Firmware Over The Air.

Configurator – Tool to configure Teltonika Telematics devices.

Crowd support forum – knowledge base dedicated for Troubleshooting.

For firmware supporting MQTT please contact your sales manager or contact directly via

Teltonika Helpdesk.

Other software required to develop and debug applications

for the device

For debugging situations, device internal logs can be downloaded OTA by using our FotaWEB

platform or by using Teltonika Configurator.

Setup your AWS account and Permissions

Refer to the online AWS documentation at Set up your AWS Account. Follow the steps outlined in

the sections below to create your account and a user and get started:

Create a user and grant permissions

Open the AWS IoT console

Pay special attention to the Notes.

Create Resources in AWS IoT

Refer to the online AWS documentation at Create AWS IoT Resources. Follow the steps outlined in

these sections to provision resources for your device:

Create an AWS IoT Policy

Create a thing object

Pay special attention to the Notes.

Provide Device with credentials

Whole device, AWS IoT and testing information can be downloaded in PDF format here.

NOTE: MQTT will not work without uploaded TLS certificates.

AWS IoT Core Configuration

Setting up AWS IoT Core

When logged in the AWS console, click on Services on the top left hand side screen, to access IoT

core.

Figure 1. Accessing AWS IoT core from AWS console

NOTE: If you can't see "Services" in the top left, click on "My account" in the top right and "AWS

Management Console"

Select Manage, Security, Policies (Manage > Security > Policies) and press Create policy or Create

buttons.

Figure 2. Accessing policy creation

In the Create Policy window, enter Policy name. In the Policy document tab for Policy Action (1)

select “*” and for Policy resource (2) enter “*” and press create.

Figure 3. Creating a policy

Now, that you have created a policy, select Manage on the sidebar on the left side, then select All

devices, Things (Manage>All devices>Things). And click on Create things.

Figure 4. Accessing Things

Afterwards select Create single thing and click Next.

Figure 5. Creating single thing

After creating a single thing, enter Thing’s name and in the Device Shadow tab select Unnamed

shadow (classic). Then click Next.

Figure 6. Thing's properties

Then when selecting Device certificate, select Auto-generate a new certificate and click Next.

Figure 7. Certificate configuration

Now, select the policy you have created before to attach it to the certificate and thing. After that

click Create thing.

Figure 8. Attaching policy to certificate

Then window with Certificate files and key files download options should pop out. It‘s recommended

to download all files, because later some of them will not be available for download. The files that

are required for usage with FMX devices are: Device certificate (1), private key(2), and Amazon Root

CA 1 file(3), but it‘s recommended to download them all and store them in secured place.

Figure 9. Certificate and key download

Finding device data endpoint (server domain)

To receive server domain (in AWS endpoint) click on the side bar on the left Settings (AWS

IoT->Settings). Or click on the side bar on left side Things, select the created thing, after it click

Interact->View Settings. Whole path - (Things->*YourThingName*->Interact->ViewSettings). Page

containing endpoint will open. Copy the whole endpoint address. Port for accessing this endpoint is

8883.

Figure 10. Device data endpoint

Merging certificates into a single file (FW Ver. 03.28.03.Rev.311)

Merger download: Media:Crt_MRGs.zip

NOTE: for FW Ver. 03.28.03.Rev.311 it is possible to upload a single merged file instead of 3

separate files. First, double click certificate merger to execute the program.

Figure 11. Certificate merger

Then, a screen will pop out asking to select a certificate. Go to the folder with your certificate,

private key and root certificate. Select the certificate.

Figure 12. Selecting certificate

Another screen will pop out asking to select private key, so select private key.

Figure 13. Selecting private key

Last screen will ask you to select the root certificate.

Figure 14. Selecting root certificate

After selecting the root certificate your files will be merged and a new “Merged” folder will appear

inside your certificate folder. Inside it will be the merged_cert.pem.

Figure 15. Merged folder

Figure 16. Merged file

Configuring the device

Security and certificates

Using certificate, private key and root certificate. (Via Cable)

Find Certificate file ending with extension pem.crt (ending may be just .pem) Private key file and

AmazoonRootCA1 file (no need to change filenames). These files should have been downloaded when

creating Thing in AWS IoT Core.

Figure 17. Certificate, private key and root certificate

Upload the mentioned files in the Security tab in the Teltonika Configurator.

Figure 18. Uploading certificates and keys

After uploading certificates, go to System tab and in Data protocol section select - Codec JSON.

Figure 19. Choosing data protocol

Using FW Ver. 03.28.03.Rev.311 and merged_cert.pem file. (Via FOTA WEB)

NOTE: uploading merged certificate file is only possible using FW Ver. 03.28.03.Rev.311.

Open FOTA WEB and press devices side bar. Then select a device you want to upload merged

certificate to and press create task.

Other manuals for FMB003

Table of contents

Other Teltonika GPS manuals

Teltonika

Teltonika TMT250 User manual

Teltonika

Teltonika FMC230 Guide

Teltonika

Teltonika FMP100 User manual

Teltonika

Teltonika Telematics FTC921 Installation guide

Teltonika

Teltonika FM3622 User manual

Teltonika

Teltonika TMT250 User manual

Teltonika

Teltonika TAT100 User manual

Teltonika

Teltonika FMB225 Installation guide

Teltonika

Teltonika FMT100 Installation guide

Teltonika

Teltonika GH4000 User manual

Teltonika

Teltonika TMT250 Installation guide

Teltonika

Teltonika FMB910 User manual

Teltonika

Teltonika Telematics FTC921 User manual

Teltonika

Teltonika FM3622 User manual

Teltonika

Teltonika FM3200 User manual

Teltonika

Teltonika FMB010 Installation guide

Teltonika

Teltonika Telematics FMC150 Installation guide

Teltonika

Teltonika FMM13A Installation guide

Teltonika

Teltonika FMB122 Installation guide

Teltonika

Teltonika GH5200 User manual

Teltonika

Teltonika FMB209 Installation guide

Teltonika

Teltonika FMB010 User manual

Teltonika

Teltonika FMM125 User manual

Teltonika

Teltonika GH1200 User manual

Popular GPS manuals by other brands

Raven

Raven Cruizer II Manual

Hama

Hama 53118 Operating instruction

Garmin

Garmin SOUNDER 125 Owner's manual & reference

Garmin

Garmin DEZL 580 owner's manual

Jigabot

Jigabot EX quick start guide

Pointer

Pointer Cellocator CelloTrack XT LTE overview

Queclink

Queclink GV55LITE user manual

Voxson

Voxson Voxtrack GPS500 Quick user guide

Garmin

Garmin ECHOMAP PLUS owner's manual

Starcom Systems

Starcom Systems Kylos Compact user guide

Garmin

Garmin 15 H Series Technical specifications

Cobra

Cobra Marine MC 600Ci owner's manual

Cellocator

Cellocator CelloTrack T installation guide

Enfora

Enfora Mini-MT GSM2228UG001 user guide

Magellan

Magellan eXplorist 100 Reference manual

LTE

LTE G50B user manual

Garmin

Garmin DEZL OTR500 owner's manual

SkyGolf

SkyGolf SkyCaddie SG1 user guide