Download
Share
Print this page
  1. Manuals
  2. Brands
  3. Multitech Manuals
  4. Computer Hardware
  5. MTXDot MTXDOT-NA1
  6. Developer's manual

Multitech MTXDot MTXDOT-NA1 Developer's Manual

Developer kit
Hide thumbs

Advertisement

Quick Links

Download this manual
®
MTXDot
Developer Kit
Developer Guide

Advertisement

loading
Need help?

Need help?

Do you have a question about the MTXDot MTXDOT-NA1 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Multitech MTXDot MTXDOT-NA1

Summary of Contents for Multitech MTXDot MTXDOT-NA1

  • Page 1 ® MTXDot Developer Kit Developer Guide...
  • Page 2 Legal Notices The MultiTech products are not designed, manufactured or intended for use, and should not be used, or sold or re-sold for use, in connection with applications requiring fail-safe performance or in applications where the failure of the products would reasonably be expected to result in personal injury or death, significant property damage, or serious physical or environmental damage.
  • Page 3 CONTENTS Contents Chapter 1 – Product Overview ..........................7 Overview ..................................7 Documentation Overview ............................... 7 Related Documentation ..............................7 Product Build Options ..............................8 Developer Kit Package Contents ............................. 8 Chapter 2 – Getting Started with the xDot Developer Kit ..................9 COM Port Enumeration by Operating System ........................
  • Page 4 CONTENTS Pin Information ................................25 Pull-Up/Down ................................26 LoRa .................................... 27 Sleep and Wake Pins ..............................27 xDot Pinout Design Notes ............................. 28 Serial Pinout Notes ..............................28 Serial Settings ................................28 LoRa ....................................28 Throughput Rates ............................... 28 Range ..................................29 Resetting the xDot ................................
  • Page 5 CONTENTS Chapter 10 – Developer Board Assembly Diagram and Schematics ................42 Assembly Diagram - Top ............................... 42 Assembly Diagram - Bottom ............................43 Block Diagram ................................44 Power .................................... 45 USB Hub/Linear Regulator ............................46 Chapter 11 – Design Considerations ........................47 Noise Suppression Design .............................
  • Page 6 CONTENTS Using Ethernet with LoRa Packet Forwarder ........................ 61 Configuring the xDot ..............................61 Configuring the Network for the xDot .......................... 62 Connecting the xDot to the Network and Sending and Receiving Data ............... 63 Index ..................................64 ® xDot Developer Guide...
  • Page 7 Related Documentation xDot AT Command Guide: (S000768) Includes details on the AT commands available for xDots. MultiTech Developer Site: This site includes information on using the Conduit with xDots. Go to: www.multitech.net Documentation for related products, such as the Conduit gateways and LoRa accessory cards are available https://www.multitech.com/resources/manuals...
  • Page 8 PRODUCT OVERVIEW Product Build Options Product ordering part numbers Description Region MTXDOT-NA1-B10-TR-500 xDot Advanced, UFL/Tace antenna support. Tape and Reel, North America 500 pack. MTXDOT-WW1-B10-TR-500 xDot Advanced, UFL/ Tace antenna support. Tape and Reel, Worldwide 500 pack. MTXDOT-NA1-B15-TR-500 xDot Essential, Tace antenna support. Tape and Reel, 500 North America pack.
  • Page 9 GETTING STARTED WITH THE XDOT DEVELOPER KIT Chapter 2 – Getting Started with the xDot Developer The xDot Developer kit consists of an xDot module pre-attached to the USB developer board. It ships with pre- installed firmware that supports AT Commands. For AT Commands, refer to the separate xDot AT Command Reference Guide.
  • Page 10 GETTING STARTED WITH THE XDOT DEVELOPER KIT On Mac systems, COM ports appear in the Device Manager as: /dev/cu.usbmodemx Where x is a string of numbers and possibly letters, ending in a number. The COM port with lower number is the AT command port and COM port with the higher number is the debug port.
  • Page 11 GETTING STARTED WITH THE XDOT DEVELOPER KIT AT+SENDB=01F4E25671 ® xDot Developer Guide...
  • Page 12 Firmware Files Firmware files for the xDot are available at: https://www.multitech.net/developer/downloads#xdot Differential and Compressed Upgrade Files Differenital and compressed upgrade files can be used to reduce the size of firmware upgrades sent over-the-air (FOTA). Smaller files reduce the time required to deliver an update. Smaller FOTA sessions increase end-device battery life.
  • Page 13 UPDATING FIRMWARE At the bootloader command prompt, type upgrade Send firmware file with CRC appended via ymodem. Updating Firmware with FOTA (FUOTA) xDot Advanced only Firmware Over the Air (FOTA) also known as Firmware Update Over the Air (FUOTA) is a way to upgrade xDot end devices using multicast and file fragmentation packages defined in the LoRaWAN specification.
  • Page 14 UPDATING FIRMWARE Device sends an uplink. Multicast setup message is downlinked to the device. Device sends a multicast setup response. FOTA operation queues fragmentation setup message. Device sends an uplink. Fragmentation setup is downlinked to the device. Device sends a fragmentation setup response from device. Fragmentation ®...
  • Page 15 If AT+SLEEP is used during the FOTA session, the xDot will miss packets and the session will likely fail. The FOTA session sends down packets every 1.5 seconds (assuming no duty cycle) and parity packets every 3 seconds by default. For best results, Multitech recommends users suspend all normal xDot operations until the FOTA session is complete.
  • Page 16 UPDATING FIRMWARE Make sure the Conduit is sending the fragments by checking the Conduit logs in /var/log/log_fota*. Problem: xDot cannot complete the FOTA session. Troubleshooting: If the xDot misses too many packets, the FOTA session cannot be completed. If the xDotwas able to reconstruct the file using parity fragments, it sends a CRC check to the Conduit. Check the xDot debug log for Sending CRC.
  • Page 17 UPDATING FIRMWARE Problem: Stop FOTA Session / FOTA Session won’t start (FOTA in progress) / Stop Multicast Session Troubleshooting: To end a FOTA session that is in progress, send 'ps -A | grep fota'. Find the PID associated with lora-fota (not lora-fota-demo).
  • Page 18 MECHANICAL DRAWINGS WITH PINOUTS Chapter 4 – Mechanical Drawings with Pinouts xDot ® xDot Developer Kit Developer Guide for AT Command Users...
  • Page 19 MECHANICAL DRAWINGS WITH PINOUTS Note: The xDot development board uses a land pattern that matches the xDot land pattern in the previous image. All pads are 0.028 inches square except the large one, which is 0.098 inches x 0.028 inches. Note: The xDot development board uses a land pattern that matches the xDot land pattern in the previous image.
  • Page 20 SPECIFICATIONS AND PIN INFORMATION Chapter 5 – Specifications and Pin Information MTXDOT Specifications Category Description General Compatibility LoRaWAN 1.1 specifications Interfaces Note that pin functions are multiplexed. Up to 19 digital I/O Wake pin Reset pin Full UART Simple UART (RX & TX only) Programming interface CPU Performance 100 MHz...
  • Page 21 SPECIFICATIONS AND PIN INFORMATION Operating range is 2.4-3.57V. When operating voltage is below 3.3V, radio power is affected as shown in the following table: SX1262 +22 dBm VBAT = 2.7 V -2dB SX1262 +22 dBm VBAT = 2.4 V -3dB 868 MHz ISM Band Specifications and Approvals Category Description...
  • Page 22 SPECIFICATIONS AND PIN INFORMATION Category Description ISM Bands North America: US902-928 MHz Other Asia-Pacific: AS920-923 MHz (“AS1”) Certifications and Compliance US: FCC Part 15 Class B CA: ICES-003 Radio US: FCC 15.247:2022 / CA: RSS-247 2:2017 US: FCC 15.109:2023 US: FCC 15.107:2023 Safety US: UL 60950-1 2nd Edition CA: cUL 60950-1 2nd Edition...
  • Page 23 SPECIFICATIONS AND PIN INFORMATION Plug the xDot developer board back into the computer. Set wake pin to wake, AT+WP=6. Set wake mode to interrupt, AT+WM=1. Put the xDot to sleep, AT+SLEEP=0|1. Put jumper across JP5. Note: After this step, AT command and debug ports no longer work. Measure current draw.
  • Page 24 SPECIFICATIONS AND PIN INFORMATION Power Draw Note: Inrush charge is the highest observed value from took five separate measurements. Power measurements are similar for all models. Power measurements are the same for packet sizes of 11 bytes and 53 bytes. Multi-Tech Systems, Inc.
  • Page 25 SPECIFICATIONS AND PIN INFORMATION Pin Information Note: Using the mbed platform expands your pin functionality options. Pins are on a 0.07 inch grid, and are 0.028 inches square (except for upper left) The xDot is 0.045 x 0.045, board is 0.93 x 0.93 xDot Pin xDot Pin Name MAX32670 Pin...
  • Page 26 SPECIFICATIONS AND PIN INFORMATION xDot Pin xDot Pin Name MAX32670 Pin MAX32670 Pin Name MAX32670 Net Name Number Number UART1_RX P0.28 MBED_RX UART1_TX) P0.29 MBED_TX GPIO0 P0.30 GPIO0 NRESET RSTN NRESET VCORE VREG1 3,4 -VDD VDD3_3 VDD3_3 1, 5, 17, 20,35, 36, 38, 39, 40, 41, 42, 43, 44, 45, 46,...
  • Page 27 SPECIFICATIONS AND PIN INFORMATION PU/PD xDot Pin Pin Name SW Name Value P0.16 SCK for LoRa Radio 100K LoRa Function P0.14 LORA_MISO P0.15 LORA_MOSI P0.16 LORA_SCK P0.17 LORA_NSS P0.20 LORA_RESET P0.21 LORA_BUSY P0.22 LORA_DIO1 Sleep and Wake Pins xDot Pin Description P0.8 UART1_RX...
  • Page 28 SPECIFICATIONS AND PIN INFORMATION xDot Pinout Design Notes Refer to the mechanical drawing for your model for pin locations. All I/O pins that go off board are directly connected to the processor Refer to Pin Information table for pull up and pull down information. xDots allow you to program pins depending on your application: Serial: Available out of the box.
  • Page 29 SPECIFICATIONS AND PIN INFORMATION Range Variables effecting the range include TX power, antenna gain, RX sensitivity, fade margin , earth's curvature. Use the following formula to calculate the maximum range: Fade margin is an allowance used to account for unknown variables. The higher the fade margin, the better the overall link quality will be.
  • Page 30 SPECIFICATIONS AND PIN INFORMATION Resetting the xDot To reset the xDot Drive the RESET signal low for at least T NRESET Select either: Allow RESET to float. The internal pull-up resistor pulls it up. Drive the RESET line high. The processor starts executing code after the RESET line is high. ®...
  • Page 31 DEVELOPER KIT OVERVIEW Chapter 6 – Developer Kit Overview xDot Developer Kit The xDot developer kit comes with an xDot already mounted on the developer board. Simply plug the developer kit into a USB port on your computer to test, program, and evaluate your application. Developer Kit Package Contents Your Developer Kit includes the following: Developer Board...
  • Page 32 DEVELOPER KIT OVERVIEW xDot Developer Kit Mechanical Drawings ® xDot Developer Kit Developer Guide for AT Command Users...
  • Page 33 DEVELOPER KIT OVERVIEW Note: The Reset and Wake buttons reset and wake the xDot processor. ® xDot Developer Kit Developer Guide for AT Command Users...
  • Page 34 DEVELOPER KIT OVERVIEW Micro Developer Board LEDs Description LED1 User-definable LED. Programming Status. Power, blue light when the board has power. ® xDot Developer Kit Developer Guide for AT Command Users...
  • Page 35 ANTENNAS Chapter 7 – Antennas Antenna System The LoRa antenna performance depends on the implementation and antenna design. The integration of the antenna system into the product is a critical part of the design process; therefore, it is essential to consider it early so the performance is not compromised.
  • Page 36 < 2.0 Gain 1.0 dBi Radiation Omni Polarization Vertical RSMA-to-U.FL Coaxial Cables Coaxial Cable Specifications Optional antenna cables can be ordered from MultiTech. Cable Type Coaxial Cable Attenuation <1.0db Connector Impedance 50 ohm Maximum Cable Length 16" (40 cm) OEM Integration FCC &...
  • Page 37 ANTENNAS FCC Grant Notes The OEM should follow all the grant notes listed below. Otherwise, further testing and device approvals may be necessary. FCC Definitions Portable: (§2.1093) — A portable device is defined as a transmitting device designed to be used so that the radiating structure(s) of the device is/are within 20 centimeters of the body of the user.
  • Page 38 SAFETY INFORMATION Chapter 8 – Safety Information Handling Precautions To avoid damage due to the accumulation of static charge use proper precautions, such as an ESD strap, when handling any cellular device to avoid exposure to electronic discharge during handling and mounting the device. Radio Frequency (RF) Safety Due to the possibility of radio frequency (RF) interference, it is important that you follow any special regulations regarding the use of radio equipment.
  • Page 39 Do not expose the device to water, rain, or spilled beverages. It is not waterproof. Exposure to liquids could result in damage to the device. Using accessories, such as antennas, that MultiTech has not authorized or that are not compliant with the device's accessory specifications may invalidate the warranty.
  • Page 40 SAFETY INFORMATION If the device is not working properly, contact MultiTech Technical Support. User Responsibility Respect all local regulations for operating your wireless device. Use the security features to block unauthorized use and theft. End user must operate product per country laws and rules.
  • Page 41 LABELS Chapter 9 – Labels Label Examples Note: Actual labels vary depending on the regulatory approval markings and content. This device complies with part 15 of the FCC Rules. Operation is subject to the following two conditions: (1) This device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation.
  • Page 42 LABELS Chapter 10 – Developer Board Assembly Diagram and Schematics Assembly Diagram - Top L1 C34 and R30 share the same spot View from Top side (Scale 3:1) LED2 LED3 LED1 ® xDot Developer Kit Developer Guide for AT Command Users...
  • Page 43 DEVELOPER BOARD ASSEMBLY DIAGRAM AND SCHEMATICS Assembly Diagram - Bottom View from Bottom side (Scale 3:1) C16 C15 ® xDot Developer Kit Developer Guide for AT Command Users...
  • Page 44 DEVELOPER BOARD ASSEMBLY DIAGRAM AND SCHEMATICS Block Diagram SERIAL INTERFACE OpenSDA DEBUG USB VCP SWD INTERFACE SWD INTERFACE OpenSDA CONNECTOR USB A CONNECTOR USB HUB BUFFERS 5V to 3.3V LDO USB SERIAL XDOT MODULE Flash (FOTA) XDOT DK Build Configuration 7-Level Project Title -NOTICE- Model Name...
  • Page 45 DEVELOPER BOARD ASSEMBLY DIAGRAM AND SCHEMATICS Power USB to UART Note: Test Points through-hole test points in the interior UART1_RX_X UART1_RX JP5: Isolate xDot VMK_33 VMK_33 SWCLK_X VMK_33 No Relief S2: User Button ANTENNA CHIP 900MHZ ISM 6X2 VMK_33 MBED_RX_B XDOT-NA1-A00-SLZD VMK_33 Flash for FOTA...
  • Page 46 DEVELOPER BOARD ASSEMBLY DIAGRAM AND SCHEMATICS USB Hub/Linear Regulator USB Hub USB_U_D_N 4-PIN-USB USB Connector OVCJ and PWRJ are disabled Linear Regulator Test headers for VCC_USB5V, VCC, VDD3_3, VMK_33, and GND XDOT DK Build Configuration 7-Level Project Title -NOTICE- Model Name Antenna Type DISPLAYED, USED DISTRIBUTED OR MODIFIED WITHOUT THE PRIOR WRITTEN 2022 MULTI-TECH SYSTEMS, INC.
  • Page 47 DESIGN CONSIDERATIONS Chapter 11 – Design Considerations Noise Suppression Design Adhere to engineering noise-suppression practices when designing a printed circuit board (PCB). Noise suppression is essential to the proper operation and performance of the device and surrounding equipment. Any OEM board design must consider both on-board and off-board generated noise that can affect digital signal processing.
  • Page 48 Take precautions to avoid exposure to electrostatic discharge during handling. MultiTech uses and recommends that others use anti-static boxes that create a faraday cage (packaging designed to exclude electromagnetic fields). MultiTech recommends that you use our packaging when returning a product and when you ship your products to your customers.
  • Page 49 Council Directive 2014/53/EU on radio equipment and telecommunications terminal equipment and the mutual recognition of their conformity. MultiTech declares that this device is in compliance with the essential requirements and other relevant provisions of Directive 2014/53/EU. The declaration of conformity may be downloaded at https://www.multitech.com/red...
  • Page 50 MultiTech provides software code meant to operate the radio to a level that maintains compliance with the operating modes under which these radio devices were certified. To ensure this level of compliance, the software code is provided in binary form only.
  • Page 51 REGULATORY INFORMATION software will void the certification of this product. ® xDot Developer Kit Developer Guide for AT Command Users...
  • Page 52 REGULATORY INFORMATION Industry Canada Class B Notice This Class B digital apparatus meets all requirements of the Canadian Interference-Causing Equipment Regulations. Cet appareil numérique de la classe B respecte toutes les exigences du Reglement Canadien sur le matériel brouilleur. This device complies with Industry Canada license-exempt RSS standard(s). The operation is permitted for the following two conditions: the device may not cause interference, and this device must accept any interference, including interference that may cause undesired operation of...
  • Page 53 Substances) complements the WEEE Directive by banning the presence of specific hazardous substances in the products at the design phase. The WEEE Directive covers all MultiTech products imported into the EU as of August 13, 2005. EU-based manufacturers, distributors, retailers and importers are obliged to finance the costs of recovery from municipal collection points, reuse, and recycling of specified percentages per the WEEE requirements.
  • Page 54 2015/863 of the European Parliament (Restriction of the use of certain Hazardous Substances in electrical and electronic equipment - RoHS 3). These MultiTech products do not contain the following banned chemicals Lead, [Pb] < 1000 PPM Mercury, [Hg] <...
  • Page 55 MOUNTING XDOTS AND PROGRAMMING EXTERNAL TARGETS Chapter 14 – Tape and Reel Specifications and Guidelines Text of first paragraph. Text of second paragraph. Note: Text of note. Text of third paragraph. Text of first list item. Text of second list item. Text of third list item.
  • Page 56 MOUNTING XDOTS AND PROGRAMMING EXTERNAL TARGETS Chapter 15 – Mounting xDots and Programming External Targets Mounting the Device on Your Board A footprint diagram is included on the xDot Mechanical Drawing in Chapter 4. Stencil Match the stencil aperture size and layout to the mechanical footprint of the xDot (1:1). We recommend a stencil thickness of 5 mil.
  • Page 57 MOUNTING XDOTS AND PROGRAMMING EXTERNAL TARGETS Setpoints (Celsius) Zone Bottom Conveyer Speed 32.0 inch/minute Max Rising Slope Max Falling Slope Soak Time 150- Peak Temp Total Time /218C 170C Position Slope Slope Time Temp Time <TC2> 1.38 -0.63 28.82 240.22 -30% 43.61 -55%...
  • Page 58 Recommended Programming Hardware for Production Note: MultiTech does not recommend using the MTMDK-XDOT developer board for production programming. It doesn't have ESD protection, isn't enclosed, and wasn’t tested to be a robust solution for production. MultiTech recommends using the following programming hardware for production: Segger J-Link programmer - SEG-JLINK https://www.segger.com/products/debug-probes/j-link...
  • Page 59 MOUNTING XDOTS AND PROGRAMMING EXTERNAL TARGETS J-Link 9-Pin Cortex-M Adapter - https://www.segger.com/products/debug-probes/j- link/accessories/adapters/9-pin-cortex-m-adapter JTAG/SWD Connector The developer board uses an unshrouded 9-pin header. Suitable connector headers include: Harwin: M50-3500542 Mouser: 855-M50-3500542 Samtec shrouded header: FTSH-105-01-F-D-K The Samtec FTSH-105 header dimensions are 0.25"x 0.188" (6.35mm x 4.78mm). Ensure that you connect your cable correctly, typically by matching the "1"...
  • Page 60 CONNECTING THE XDOT WITH A CONDUIT AND A LORA NETWORK Appendix A – Connecting the xDot with a Conduit and a LoRa Network Overview ® ® This section describes the setup needed to connect an xDot , to a Conduit gateway or Conduit AP and connect to the Radio Bridge Chirpstack server to get date to the cloud.
  • Page 61 CONNECTING THE XDOT WITH A CONDUIT AND A LORA NETWORK Click on Advanced and continue to 192.168.2.1. mPower opens in Commissioning Mode. The system requires you to set up an admin user. Enter your desired username and click OK. Enter and confirm a password following the on screen rules. Login using the new credentials.
  • Page 62 CONNECTING THE XDOT WITH A CONDUIT AND A LORA NETWORK Configuring Network for the Conduit This sets up the Conduit on the Radio Bridge Chirpstack. Go to the Radio Bridge console, https://console.radiobridge.com/login. Create a new account if you do not already have one. If you do, login. On the left side and select Gateways.
  • Page 63 CONNECTING THE XDOT WITH A CONDUIT AND A LORA NETWORK Open the Windows Device Manager. (Press the Windows key and type Device Manager or open the Control Panel > Hardware and Sound > Devices and Printers > Device Manager.) It will show the COM ports added.
  • Page 64 CONNECTING THE XDOT WITH A CONDUIT AND A LORA NETWORK Select Region: For the Region, select US915 or EU868. (If your channel plan is not for US but in the 900’s, select US915. If your channel plan is not for Europe but in the 800’s, select EU868.) Click Continue.
  • Page 65 INDEX Index schematics drag and drop ..............12 Developer Board ....... 42 43 44 45 46 electrical characteristics ..........22 antenna ..............35 36 electromagnetic interference ........47 assembly diagrams electrostatic discharge ..........48 Developer Board ..........42 43 EMI ................47 AT command ESD .................
  • Page 66 INDEX JTAG connector ............. 58 radio bridge ..............62 Radio Bridge Chirpstack ..........61 radio frequency interference ........38 KDB 447498 Section 8 ........... 36 range ................28 receive sensitivity ............20 receiving data ..............63 related products .............. 7 labeling reset ................
  • Page 67 INDEX user responsibility ............40 network configuration ..........62 network connect ............63 radio bridge .............. 62 Windows ................. 9 ymodem ................ 12 xDot configuration ............61 ® xDot Developer Kit Developer Guide for AT Command Users...

This manual is also suitable for:

Mtxdot mtxdot-ww1