Download Print this page

Ezurio RM126 Series User Manual

At interface application
Hide thumbs Also See for RM126 Series:

Advertisement

Quick Links

User Guide
RM126x AT Interface Application
Version 1.7

Advertisement

loading
Need help?

Need help?

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

Questions and answers

Summary of Contents for Ezurio RM126 Series

  • Page 1 User Guide RM126x AT Interface Application Version 1.7...
  • Page 2 Senthooran Ragavan 2024 P2P optimisation (GA1.4). Corrected width of AT%S parameters 635, 636 and 637. 6 August Added quotes around message parameter for AT+SEND and Greg Leach Senthooran Ragavan 2024 AT+P2PT commands. https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 3 MAC commands. Added details of TX Power Limit (715) ATS parameter to allow a maximum transmit power level to be defined. P2P Broadcast address reverted to 64. https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 4 4.7.1 AT+DUTY ............................................20 4.7.2 AT+LINKC ............................................ 20 4.7.3 AT+SEND ............................................ 20 4.7.4 AT+TIME ............................................21 P2P Commands ..........................................21 4.8.1 AT+P2PE ............................................21 4.8.2 AT+P2PS ............................................21 4.8.3 AT+P2PT ............................................21 https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 5 TX ..............................................31 5.2.11 WAKE ............................................31 Low Power UART Operation ........................................32 Appendix A – References ........................................... 33 Appendix B – Definitions, Abbreviations and Acronyms ............................... 34 Additional Information ..........................................35 https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 6 Peer to Peer operation obviates the need for LoRaWAN infrastructure. In this mode, devices communicate directly with each other using LoRa modulation. An addressing system is used to filter incoming messages to determine when a response needs to be sent to a request. Refer to for further details. https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 7 Non-printable characters can be embedded in the new value. These should be escaped using the three- character \hh sequence where hh is the ASCII value of the character in hexadecimal. For example, to null terminate the string “Hello”, it is entered as “Hello\00” https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 8 Responses ERROR 4.3.2 AT&F Command AT&F Description Sets all writable parameters to default values clears the trusted device bond database then performs a warm reset. Possible Responses OK (after warm reset) ERROR https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 9 1: AT&F issued • 2: ATZ issued • 17: Hard fault • • 18: Bus fault • 19: Usage fault • 33: Brown out • 34: Brown out while in low energy mode https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 10 Possible values are as follows: 0: LoRa • 1: GFSK • Module Type 3005 This is a single digit code representing the module type. Possible values are as follows: 0: RM1261 • 1: RM1262 • https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 11 This is the maximum number of bytes that can be sent during a send slot for the configured P2P data rate. 4004 P2P Slot Delay This is the time in milliseconds between successive send and/or receive slots. P2P Minimum Window Length 4005 https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 12 AD routines to properly scale input voltages against the reference value defined here. This defaults to 3300mV. UART Baud rate This specifies the baud rate to use for host UART commands and data transfer. Defaults to 115200bps. https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 13 Ping Slot Periodicity For Class B devices, sets the number of ping slots following an uplink. 0: Ping slot every 1s 1: Ping slot every 2s https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 14 0. The device at address 0 acts as the synchronisation point for all other devices in the network. P2P Network Size This is the number of P2P devices in the network, with allowable values between 2 and https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 15 This is the longest packet size intended for sending across the P2P network. This represents the longest packet size, with shorter packet lengths also being permitted for sending. This parameter should be used to optimise the network Minimum Window Length. https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 16 Each preamble character is set to a hexadecimal value of 0xFF, with an STX character (0x02) being used to indicate the start of asynchronous message data. A maximum of 10 preamble characters can be sent. Defaults to 0. https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 17 TW923: 0 .. 14 US915: 0 .. 22 The minimum value permitted in all cases is 0. Setting this value to -1 disables the TX Power Limit. Defaults to -1. Possible Responses ERROR https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 18 This section describes available LoRaWAN Class A associated commands. 4.5.1 AT+DROP Command AT+DROP Description This command is used to drop a connection to a network, or to cancel any pending join requests. Possible Responses ERROR https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 19 AT+MCGL groupId Description This command is used to remove a multicast group. This is the 8-bit id used to identify the group, allowable values between 0 and 3. groupId Possible Responses ERROR https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 20 Refer to for asynchronous responses. For Class A devices where downlink messages can only be sent following an uplink, refer to (LoRaWAN) for asynchronous messages associated with downlink events. Possible Responses ERROR https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 21 Possible Responses ERROR 4.9 SIO Commands AT Commands with the SIO extension are used to interact with single device SIOs. https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 22 Vout = (4096 / Vsupply) x (returned AD counts) The integer value returned has a starting \n character and ending \r character. Note: Refer to [D] for examples of the single SIO input variants being used. Possible Responses ERROR https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 23 1 indicating the device at CS1 and a value of 2 indicating the device at CS2 hexDataString This is the hexadecimal data sent to the device outLength This is the number of bytes to read back from the device. Possible Responses ERROR https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 24 When started, the transmitting device sends its DevEUI in a LoRa packet every 5s at 1dBm transmit power. A frequency of 902.5kHz is always used, with Spreading Factor 10 and Coding Rate of 4/5 also being fixed for each message transmitted. Possible Responses ERROR https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 25 The SUPC command cancels a scheduled module supply voltage measurement request queued using AT+SUPS. Possible Responses ERROR 4.12.4 AT+SUPI Command AT+SUPI Description The SUPI command performs an immediate measurement of the module supply voltage. Possible Responses ERROR https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 26 Voltage drop is most severe here due to the current consumption of the LoRa radio during transmit operations. Refer to for asynchronous responses. Possible Responses ERROR https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 27 LoRa No RX Message LoRa Multicast Group Recall Failed LoRa Multicast Group Create Failed LoRa TX Set Fail LoRa Invalid Class Parameter write only Functionality not coded 5.1.2 A command was successfully processed. https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 28 This is the RSSI of the last received message from the device in Continuous Transmit mode. This is the SNR of the last received message from the device in Continuous Receive mode. https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 29 The demodulation margin in dB. Values at 0 and close to 0 indicate poor connection quality. Optimal values are at and close to the transmit power of the module. The value used relates to the gateway with the best margin. gateway_count The number of gateways that detected the link check request. https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 30 The SUP asynchronous message is issued upon completion of a scheduled supply voltage measurement via AT+SUPS. Parameters returned are defined as follows. supply_voltage This is the measured supply voltage in millivolts from the last scheduled supply voltage measurement. https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 31 The WAKE asynchronous message is issued upon successful wake up of the host UART from low power mode. Reception of this message can be interpreted as an indication from the module that messages can now be received from the host. https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 32 The UART interface that is embedded inside the microcontroller at the heart of the Ezurio module consumes about 1 milliamp when it is open. Ezurio has shown that it is possible to operate the module in doze mode so that the total current consumption can be as low as sub 2 microamps.
  • Page 33 RM126x Firmware Options and Upgrading application note https://www.ezurio.com/documentation/user-guide-firmware-options-and-upgrading-rm126x-series Application Note – Peripheral Interface Guide – Lyra, Lyra 24 & RM126x Series https://www.ezurio.com/documentation/application-note-peripheral-interface-guide-lyra-lyra24-and-rm126x Application Note – P2P User Guide – RM126x Series https://www.ezurio.com/documentation/application-note-p2p-user-guide-rm126x-series https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 34 Universal Asynchronous Receiver Transmitter Established technology used to send and receive data in a serial manner Whitespace Any non-printable character with an ASCII code of 0x20 and lower is treated as a whitespace character. https://www.ezurio.com/ © Copyright 2025 Ezurio All Rights Reserved...
  • Page 35 Ezurio materials or products for any specific or general uses. Ezurio or any of its affiliates or agents shall not be liable for incidental or consequential damages of any kind. All Ezurio products are sold pursuant...