MatchX LPWAN User Manual

Lora development board with grove sensors

Advertisement

Quick Links

MatchX Dev Kit
LoRa Development Board with Grove Sensors
User Guide
Rev 1.0

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the LPWAN and is the answer not in the manual?

Questions and answers

Summary of Contents for MatchX LPWAN

  • Page 1 MatchX Dev Kit LoRa Development Board with Grove Sensors User Guide Rev 1.0...
  • Page 2 MATCHX No part of the specifications may be reproduced in any form or by any means or used to make any derivative such as translation, transformation, or adaptation without permission from MatchX GmbH All rights reserved. First release, Nov 2017...
  • Page 3: Table Of Contents

    Contents Introduction ........... . 5 Product overview .
  • Page 4 Hardware selectable options ........21 Sensor connection .
  • Page 5: Introduction

    The LPWAN Dev Kit by MatchX is a high performance, ready to use development platform allowing you to kick-start your IoT project. Together with a MatchX Core module the Dev Kit is an incredibly flexible solution that can be deployed in a various number of applications which require long distance communication and long battery life.
  • Page 6: Ble

    The module offers a novel firmware solution upgrade by augmenting LoRa, together with Bluetooth Low Energy (BLE). As LoRa protocol is not suitable for transmitting large amounts of data, MatchX has combated this with BLE, offering a quick, robust and remote way of updating your software.
  • Page 7: Hardware Architecture - Som Module

    Pin-out and pin description of the SoM module The pin-out of the MatchX Core SoM module can be seen on Figure 2.1 and the description of the pins in Table 2.1. On top of the module there are two UF.L RF connectors, the one on the left is the LoRa antenna connector, a suitable 868MHz in EU and 915MHz in US, 50 Ohm antenna is expected to be connected on these port.
  • Page 8 Chapter 2. Hardware Architecture - SoM module num- Name Description V3P3_LDO 3.3V output of the internal LDO Ground VDD_RFS Supply voltage of the radio front-end LED1 Open drain output type, LED driver LED2 Open drain output type, LED driver LED3 Open drain output type, LED driver RESET Reset signal, active high...
  • Page 9: Dimensions

    2.1 Pin-out and pin description of the SoM module that no voltage higher than V3P3_LDO is presented to any GPIO. This may happen when powering external devices, that connect to SoM module, from a boost converter. Figure 2.2: Block diagram of the Core module. 2.1.1 Dimensions Figure 2.3: Dimension of the SoM module.
  • Page 10: Operating Frequency Bands

    868.10 MHz 868.30 MHz 868.50 MHz The SoM is preconfigured to work with the MatchX Box gateway and additionally to the 3 mandatory channels 5 additional channels are defined. The list of all preconfigured channels can be found in Table 2.4.
  • Page 11 2.2 Operating frequency bands Class 1 sub- Band num- class number Channel access and from according occupation rules Operational Fre- Maximum e.r.p EC Decision Commission (e.g. Duty cycle or quency band 2013/752/EU Decision LBT + AFA) [i.3] 2000/299/EU [i.7] 0,1% duty cycle 863,000 MHz to 25 mW e.r.p.
  • Page 12 Chapter 2. Hardware Architecture - SoM module Channel number Frequency Channel number Frequency 903.90 MHz 904.70 MHz 904.10 MHz 904.90 MHz 904.30 MHz 905.10 MHz 904.50 MHz 905.30 MHz Table 2.5: Modules operating frequencies (uplink) in US 902-928MHz ISM Band. Channel number Frequency Channel number...
  • Page 13: Hardware Architecture - Evaluation Board

    3. Hardware Architecture - Evaluation Board Block Diagram The development board comprises of two main subsystems: 1. MatchX SoM with LoRa and Bluetooth radios 2. SIMCom SIM7000E NB-IOT module with 3G/4G and GPS Figure 3.1: Block diagram of the Dev Kit.
  • Page 14 Chapter 3. Hardware Architecture - Evaluation Board MatchX SoM is the core of the Dev Kit. It is responsible for controlling the SIMCom module, accessing the sensors, I/O expender, RGB LED etc. It also controls different power rails enabling low power modes.
  • Page 15: Hardware Features

    Figure 3.2: Hardware features of the Dev Kit. Components marked on the Figure 3.2 are: Optional SIMCOM SIM7000E NB-IOT module with 3G/4G and GPS MatchX SoM module with LoRa and Bluetooth SIM28ML GPS receiver 3.3V low power converter for sensors supply PCA6416A I2C I/O expander 3.3V LDO for powering the optional SIM7000E module...
  • Page 16: Connectors

    NET indication LED of the SIM7000E LED indicating presence of SIM card Connectors Figure 3.3: Connectors on the Dev Kit. Connectors marked on the Figure 3.3 are: J102 MatchX SoM modules I/Os J201 SIM7000E I/Os and signals J103 PCA6416A I/Os...
  • Page 17: Connectors Pin-Out

    Connectors pin-out Figure 3.4: Pin-out of the Dev Kit. The J102 connector, shown on Figure 3.5 routs out all GPIOs available on the MatchX SoM module. Some of these GPIOs are used by default to control functions of the Dev Kit.
  • Page 18 TPS62740 P3_2 USR_BUTTON User button connection V3P3 3.3V 3.3V power, the source selectable by J402 jumper Ground Table 3.1: Functions assignment of the MatchX SoM GPIOs Figure 3.5: Pin-out of J102 connector. Figure 3.6: Pin-out of J301 connector.
  • Page 19 3.3 Connectors The J103 connector, shown on Figure 3.7, exposes all pins available on the PCA6416A I2C I/O expander. It offers 16 I/Os organized in two ports P0 and P1. Each pin can be configured individually as a input or output, and its state can be read and set by the I2C commands. Additionally there is a interrupt line EXP_INT that is being driven by the PCA6416A when input IO changes it state.
  • Page 20: Jumpers And Test Connectors

    J111, J112 - connect the P1_3 and P0_7 to Grove D1 and D2 lines J104, J108 - connect the P4_2 and P4_3 to I2C_SDA and I2C_SCL J105, J109 - connect P1_2 and P2_3 of MatchX SoM to UART_SIM_TX and UART_SIM_RX of the SIM7000E module J107 - connects the enable line of the 3.3V LDO that powers SIM7000E ether to EXT_P0_2...
  • Page 21: Hardware Selectable Options

    3.5 Hardware selectable options J106 - cconnects SIM_PWR_KEY of the SIM7000E to EXT_P0_0 of the I/O expander J404 - test connector of the battery voltage J401 - connects USB +5V to the input of the LDO, it is bypassed by a 0R resistor by default J403 - connects power to the input of the low power 3.3V converter, the source of the power is USB +5V or battery if the +5V is not present.
  • Page 22 Chapter 3. Hardware Architecture - Evaluation Board 0R jumper connects P3_4 of SoM module to PS_EN, a enable signal of the low power 3.3V converter 0R jumper selectin the source of VDD_RFS (the radio frontend power). The 0R connected on the left side connects the VDD_RFS to low power 3.3V converter, jumper soldered on the right side connects VDD_RFS to the V3P3_LDO (the output of internal LDO of the SoM) 2.2M Ohm resistor connected in the upper position pulls the enable line of the low power 3.3V...
  • Page 23: Sensor Connection

    4. Sensor connection The Dev Kit is specifically designed to work with all different sorts of sensors, which can be attached to its GROVE connector or to 2.54mm pin headers. This makes it a very flexible solution that can be adjusted to specific applications and individual needs.
  • Page 24: Grove Uart

    Chapter 4. Sensor connection Name Function Primary analog I/0 Secondary analog I/0 Power for Grove module Ground for Grove module Table 4.2: Pin-out of the Grove analog connector Grove UART The Grove UART modules use two signal lines RX and TX. There are, for example, RFID module that controlled by UART pins TX and RX.
  • Page 25: Quick Installation Guide

    5. Quick Installation Guide The Core module incorporated in the Dev Kit is by default configured to connect with MatchX LoraWAN cloud server if the network coverage is present. Nonetheless some settings can be changed and some set up may be required in order to use the Dev Kit in a custom application. This installation guide will introduce how to set up the LoRa parameters and establish LoraWAN network connection.
  • Page 26: Bluetooth Connection

    The products will come with a QR code sticker, which gives the Serial Number of the device. By typing in the S/N at the registration of the MatchX LPWAN Cloud, the preprogrammed APP EUI, MAC address and DevKey will be associated automatically.
  • Page 27: Setting Deveui, Appeui And Devkey

    5.5 Setting DevEUI, AppEUI and DevKey Figure 5.2: Creating new node. can click on ’View’ under ’Frame Logs’ to see all messages belonging to the node like it is shown on Figure 5.3. Figure 5.3: Nodes messages. Setting DevEUI, AppEUI and DevKey To ensure the highest level of security in LoRaWAN network and Over the Air Activation (OTTA) 3 different keys have to be programmed into every end node.
  • Page 28: Region Selection

    Chapter 5. Quick Installation Guide DevKey - 16 bytes unique AES-128 key These keys are programmed by MatchX and stored in a special region of the nonvolatile memory of the Dialog microcontroller. They will be preserved during flashing of the new firmware, however they will be lost by performing full flash erase.
  • Page 29 5.6 Region Selection param x value where x = 5 for changing the region, value is a region number in hexadecimal (see Table 5.1). If value parameter is set to FF firmware will unset regional parameter and the board will return to reading jumpers settings.
  • Page 30: Software Development Guide

    The purpose of this chapter is to help user to quickly install all necessary software components and establish hardware connections needed to start software development using MarchX Core SoM and Development Kit. MatchX is providing the Dev Kit Firmware (DKF) to be a starting point for further software development according to individual needs.
  • Page 31: Software Development Under Windows Os

    Download the Dialog’s Semiconductor SmartSnippets DA1468x SDK (in the example the SDK version 1.0.8.1050.1 has been used) and MatchX Dev Kit Frmware. Both SDK and Dev Kit Firmware should be put in one folder (for example SmartSnippet workspace folder). DKF folder contains a make file which can be executed by navigating to the firmware folder and typing make in the...
  • Page 32 Chapter 6. Software Development Guide Figure 6.2: Compilation process of DKF. these pins the firmware will output the console messages. The output information sent after reset and UART configuration can be seen on Figure 6.5. Figure 6.3: Example of programming command. Figure 6.4: Programming completed successfully.
  • Page 33: Using Smartsnippet Studio

    6.3.1 Using SmartSnippet Studio As MatchX DKF is a makefile based project it is possible to port it quite easily to different IDE and use different operating systems. SmartSnippet Studio is a Dialog Semiconductors IDE based on Eclipse. It offers makefile project import capabilities.
  • Page 34 Chapter 6. Software Development Guide going to Project->Build All or pressing the build icon. To program the just compiled firmware into DK you need to import "scripts" project to your workspace. To do that go to File->Import and choose ’Existing Projects into Workspace’ like on Figure 6.7.
  • Page 35 6.3 Software development under Windows OS Figure 6.9: Browse window. Figure 6.10: Scripts. It is best to copy the ’suota_initial_flash_jtag_win’ script by right clicking on it and pressing ’Duplicate’ then renaming it. The ’Argument’ section has to be modified to contain correct path to compiled firmware.
  • Page 36: Software Development Under Linux

    UM-B-057 User guide from Dialog. Download the Dialog’s Semiconductor SmartSnippets DA1468x SDK (in the example the SDK version 1.0.8.1050.1 has been used) and MatchX Dev Kit Frmware. Both SDK and Dev Kit Firmware should be put in one folder (for example SmartSnippet workspace folder).
  • Page 37: Product Specification

    7. Product specification The LPWAN Dev Kit is designed for enhanced LPWAN performance and manageability. In this chapter we briefly introduce the specifications for both hardware and software. Software environment To facilitate an easy network deployment, we have included many software features, which include...
  • Page 38: Rf Performance

    Chapter 7. Product specification Item Description DA14680, 0 Hz up to 96 MHz 32-bit ARM Cortex-M0 Memory 8Mb Flash, 64kB OTP, 128kB ROM, 144kB SRAM Interfaces C, I S, PCM, SPI, UART, USB, GPIOs Wireless Bluetooth 4.1 and LoRa Battery 2.0mm pitch connector Size 32 x 148 x 32mm (including Hat)
  • Page 39: Antenna Characteristics

    7.2 Hardware environment Symbol Description Unit Current consumption, MCU awake, no RF activity IDLE Current consumption,sending LoRa packet SEND Current consumption in sleep mode <10 SLEEP Table 7.5: Current consumption of the core module. 7.2.3 Antenna characteristics The SoM module is equipped with two U.FL connectors: 2.4GHz for Bluetooth and one for 868MHz (915MHz in US version) LoRa antenna.
  • Page 40: Dimensions

    Chapter 7. Product specification Dimensions Figure 7.1: Dimension of the Dev Kit (top view), all dimensions in mm.
  • Page 41: Certification

    7.4 Certification Certification CE and FCC certification pending.

Table of Contents