Libre FreeRTOS-MAVID Manuale utente

Libre Wireless Technologies LIBRE CONFIDENTIAL Page 1of 21
FreeRTOS-MAVID (EVB)
Quick Start Guide
Revision: 1.2

FreeRTOS-MAVID (EVB)
Libre Wireless Technologies Quick Start Guide: Ver. 1.2 Page 2of 21
LIBRE CONFIDENTIAL
Libre Wireless Technologies Private Limited
librewireless.com
Copyright © 2020 Libre Wireless Technologies. All rights reserved.
Circuit diagrams and other information relating to Libre Wireless Technologies products are included as a means
of illustrating typical applications. Consequently, complete information sufficient for construction purposes is not
necessarily given. Although the information has been checked and is believed to be accurate, no responsibility is
assumed for inaccuracies. Libre Wireless Technologies reserves the right to make changes to specifications and
product descriptions at any time without notice. Contact your local Libre Wireless Technologies sales office to
obtain the latest specifications before placing your product order. The provision of this information does not
convey to the purchaser of the described semiconductor devices any licenses under any patent rights or other
intellectual property rights of Libre Wireless Technologies or others. All sales are expressly conditional on your
agreement to the terms and conditions of the most recently dated version of Libre Wireless Technologies standard
Terms of Sale Agreement dated before the date of your order (the "Terms of Sale Agreement"). The product may
contain design defects or errors known as anomalies which may cause the product's functions to deviate from
published specifications. Anomaly sheets are available upon request. Libre Wireless Technologies products are
not designed, intended, authorized or warranted for use in any life support or other application where product
failure could cause or contribute to personal injury or severe property damage. Any and all such uses without
prior written approval of an Officer of Libre Wireless Technologies and further testing and/or modification will
be fully at the risk of the customer. Copies of this document or other Libre Wireless Technologies literature, as
well as the Terms of Sale Agreement, may be obtained by visiting Libre Wireless Technologies website.
LIBRE WIRELESS TECHNOLOGIES DISCLAIMS AND EXCLUDES ANY AND ALL WARRANTIES, INCLUDING
WITHOUT LIMITATION ANY AND ALL IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
PARTICULAR PURPOSE, TITLE, AND AGAINST INFRINGEMENT AND THE LIKE, AND ANY AND ALL
WARRANTIES ARISING FROM ANY COURSE OF DEALING OR USAGE OF TRADE. IN NO EVENT SHALL LIBRE
WIRELESS TECHNOLOGIES BE LIABLE FOR ANY DIRECT, INCIDENTAL, INDIRECT, SPECIAL, PUNITIVE, OR
CONSEQUENTIAL DAMAGES; OR FOR LOST DATA, PROFITS, SAVINGS OR REVENUES OF ANY KIND;
REGARDLESS OF THE FORM OF ACTION, WHETHER BASED ON CONTRACT; TORT; NEGLIGENCE OF LIBRE
WIRELESS TECHNOLOGIES OR OTHERS; STRICT LIABILITY; BREACH OF WARRANTY; OR OTHERWISE;
WHETHER OR NOT ANY REMEDY OF BUYER IS HELD TO HAVE FAILED OF ITS ESSENTIAL PURPOSE, AND
WHETHER OR NOT LIBRE WIRELESS TECHNOLOGIES HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
DAMAGES

FreeRTOS-MAVID (EVB)
Libre Wireless Technologies Quick Start Guide: Ver. 1.2 Page 3of 21
LIBRE CONFIDENTIAL
Table of Contents
1. Document Information...........................................................................................................................5
1.1. Abstract.................................................................................................................................................................... 5
1.2. Document Convention........................................................................................................................................ 5
1.3. Document Revision History............................................................................................................................. 5
2. FreeRTOS MAVID (EVB) ......................................................................................................................... 6
2.1 MAVID Evaluation Board (EVB)..................................................................................................................... 6
2.2 EVB Product UI...................................................................................................................................................... 7
3. Libre FreeRTOS IoT Application Development .............................................................................9
3.1. Hardware Requirement..................................................................................................................................... 9
3.2. Software Requirement....................................................................................................................................... 9
3.3. Hardware Setup..................................................................................................................................................10
3.3.1. UART debugging ............................................................................................................................................11
3.4. Application Project Development ...............................................................................................................11
3.4.1 Download SDK from GitHub .....................................................................................................................11
3.4.2 Launching demo project.............................................................................................................................12
3.4.3 Update Credentials .......................................................................................................................................12
3.4.4 Compiling MQTT Demo Application......................................................................................................14
3.4.4.1 Monitoring MQTT messages on the cloud......................................................................................14
3.4.5 Compiling Demo Application for Device Shadow ............................................................................15
3.4.6 Loading and Debugging Demo Application ........................................................................................16
3.4.7 Writing Custom Application .....................................................................................................................18
3.4.8 Generating customized ENV .....................................................................................................................18
4. LED Indication Status........................................................................................................................... 20
4.1 System LED...........................................................................................................................................................20
5. Troubleshooting .................................................................................................................................... 21

FreeRTOS-MAVID (EVB)
Libre Wireless Technologies Quick Start Guide: Ver. 1.2 Page 4of 21
LIBRE CONFIDENTIAL
Table of Figures
Figure 2.1-1: EVB PCBA Top View..................................................................................................................6
Figure 2.1-2: EVB PCBA Bottom View...........................................................................................................7
Figure 3.3-1: EVB PCBA Bottom View........................................................................................................ 10
Figure 3.4.2-1: IAR Project View.................................................................................................................. 12
Figure 3.4.5-1: CONFIG_SHADOW_DEMO_ENABLED........................................................................... 15
Figure 3.4.6-1: JTAG .......................................................................................................................................... 16
Figure 3.4.6-2: MQTT Demo Application logs......................................................................................... 17
Figure 3.4.6-3: Shadow Demo Application logs ..................................................................................... 18

FreeRTOS-MAVID (EVB)
Libre Wireless Technologies Quick Start Guide: Ver. 1.2 Page 5of 21
LIBRE CONFIDENTIAL
1. Document Information
1.1. Abstract
This document explains the content of MAVID package for FreeRTOS.
1.2. Document Convention
Icon
Meaning
Description
Note
Provides information good to know
Caution
Indicates situation that might result
in loss of data or hardware damage
1.3. Document Revision History
Revision
Date
Description of change
Author
1.2
July 19, 2020
Added section Update
Credentials
Sachin
1.1
June 25, 2020
Made changes to section
3.4, 3.4.1, 3.4.3, 3.4.4
Sachin
1.0
May 18, 2020
Added section 5
Ramya
0.1
May 08, 2020
Initial Draft
Ramya

FreeRTOS-MAVID (EVB)
Libre Wireless Technologies Quick Start Guide: Ver. 1.2 Page 6of 21
LIBRE CONFIDENTIAL
2. FreeRTOS MAVID (EVB)
2.1 MAVID Evaluation Board (EVB)
EVB is a MAVID device-based reference design, used for customer evaluation purpose.
Figure 2.1-1: EVB PCBA Top View

FreeRTOS-MAVID (EVB)
Libre Wireless Technologies Quick Start Guide: Ver. 1.2 Page 7of 21
LIBRE CONFIDENTIAL
Figure 2.1-2: EVB PCBA Bottom View
Refer the sections: UART debugging, Network setup, MAC ID update, and APP usage for
more details.
2.2 EVB Product UI
The MAVID EVB board has the following Switches and defined functionality as mentioned
below:
Switch#
Short press
Functionality
Long press
Functionality
MAVID MCU port
RTC GPIO
MAVID Pin#
SW11
Push-To-Talk
(Action)
SETUP
PI11
YES
P57
SW16
MIC ON/OFF
POWER ON/OFF
PA0
YES
P109
SW10
Play/Pause
BT pairing
PB4
NO
P84
SW7
VOL-
PREV
PD13
NO
P110
SW8
VOL+
NEXT
PF10
NO
P111
SW9
RESERVED
RESERVED
PD6
NO
P86
•The Top Side of EVB board there is right angled button for Reset.
•Simultaneous press of SW10 and SW11 results in Factory Default Reset (FDR) functionality.
•SW9 is reserved for user to define the functionality.

FreeRTOS-MAVID (EVB)
Libre Wireless Technologies Quick Start Guide: Ver. 1.2 Page 8of 21
LIBRE CONFIDENTIAL
Here are the supported features in Libre’s current EVB Rev 2.0.
•Micro USB for charging battery/Micro USB for powering up the EVB
•Battery charging circuit
•6 nos. of buttons + 1 reset button
-MIC mute/POWER ON-POWER OFF
-Network setup/PTT
-Play-pause/BT paring
-VOL-/PREV
-VOL+/NEXT
-Pin hole for RST
-SW11: Network setup (long press) and short press for (action –push
to talk)
-SW16: Power ON/POWER OFF (long press) and short press for Mic
mute (when the unit is ON)
-SW10: BT pair (long press) and short press for play/pause
-SW15: Only reset (to reboot MAVID device)
-J17: JTAG (it is for programming and debugging)
-CON3: Debug port connection
-J21: Zigbee Interface connector header
-J20, J16: MAVID for unused GPOIs
-TP3: AEC tuning
-TP92: D4 debug port

FreeRTOS-MAVID (EVB)
Libre Wireless Technologies Quick Start Guide: Ver. 1.2 Page 9of 21
LIBRE CONFIDENTIAL
3. Libre FreeRTOS IoT Application Development
The Libre application development platform provides the tools and development
environment for custom application development.
It is based on the latest AWS FreeRTOS kernel.
3.1. Hardware Requirement
The hardware requirements are as follows:
•MAVID Development Kit
•STlink debugger
•USB TTL Serial cable
•Power adapter of 5V /2A
for operating the device
3.2. Software Requirement
The software requirements are as follows:
•IAR version 7.70.1
Download the IAR version 7.70.1 from www.iar.com
This SDK is compatible with IAR version 7.70.1
•STM32 ST-LINK Utility v4.2.0
Download the ST-Link utility from https://stm32-st-link-
utility.software.informer.com/download/
•Teraterm/Putty/GTK-term or any similar serial port terminal application
Download Teraterm from https://tera-term.en.softonic.com/download
•Libre software development kit (contains software development SDK and ENV tool
to generate custom ENV binary)

FreeRTOS-MAVID (EVB)
Libre Wireless Technologies Quick Start Guide: Ver. 1.2 Page 10 of 21
LIBRE CONFIDENTIAL
3.3. Hardware Setup
Follow the below steps to setup the hardware components:
Step 1. Connect the USB TTL cable to the device as shown below:
Figure 3.3-1: EVB PCBA Bottom View
Step 2. Connect the micro USB power cable to the device.
Step 3. Launch the serial port terminal on the PC with the following settings:
Baud Rate
460800
Data
8 bits
Parity
none
Stop Bits
1 bit
Flow Control
none
Enable LF on the serial receive
Step 4. Press button SW15 to Power ON the device.
Indice
Manuali Hardware per computer popolari di altre marche

EMC2
EMC2 VNX Series Manuale del proprietario

Panasonic
Panasonic DV0PM20105 Manuale utente

Mitsubishi Electric
Mitsubishi Electric Q81BD-J61BT11 Manuale utente

Gigabyte
Gigabyte B660M DS3H AX DDR4 Manuale utente

Raidon
Raidon iT2300 Manuale utente

National Instruments
National Instruments PXI-8186 Manuale utente











