Page 2
WiperLock, Wireless DNA, and ZENA are trademarks of Microchip Technology Incorporated in the U.S.A. and other countries. SQTP is a service mark of Microchip Technology Incorporated in the U.S.A. Microchip received ISO/TS-16949:2009 certification for its worldwide headquarters, design and wafer fabrication facilities in Chandler and Silicon Storage Technology is a registered trademark of Microchip Tempe, Arizona;...
2.4.8.3 mac set ar <state> ..............28 2.4.8.4 mac set bat <level> ..............28 2.4.8.5 MAC Set Channel Commands ..........29 2.4.8.6 mac set class <class> ............... 31 2.4.8.7 mac set devaddr <address> ............31 2015-2018 Microchip Technology Inc. DS40001784G-page 3...
Page 4
2.5.5.1 radio set afcbw <autoFreqBand> ..........47 2.5.5.2 radio set bitrate <fskBitrate> ............47 2.5.5.3 radio set bt <gfBT> ..............47 2.5.5.4 radio set bw <bandWidth> ............48 2.5.5.5 radio set cr <codingRate> ............48 2015-2018 Microchip Technology Inc. DS40001784G-page 4...
Page 5
3.5.2.1 Update RN2483 Module Firmware Using LoRaDevUtility ..59 3.5.2.2 LoRaDevUtility - Boot Load Recover ......... 60 3.5.2.3 Bootloading Operation complete ..........60 Appendix A. Current Firmware Features and Fixes Worldwide Sales and Service ..................64 2015-2018 Microchip Technology Inc. DS40001784G-page 5...
- Gives further information on the bootloader usage and protocol commands. • Appendix A. “Current Firmware Features and Fixes ” – Provides information on the release notes for each revision of the firmware. 2015-2018 Microchip Technology Inc. DS40001784G-page 6...
Page 7
Curly brackets and pipe Choice of mutually exclusive errorlevel {0|1} character: { | } arguments; an OR selection Ellipses... Replaces repeated text var_name [, var_name...] Represents code supplied by void main (void) user { ... 2015-2018 Microchip Technology Inc. DS40001784G-page 7...
Page 8
Microchip consultant program member listing • Business of Microchip – Product selector and ordering guides, latest Microchip press releases, listing of seminars and events, listings of Microchip sales offices, distributors and factory representatives 2015-2018 Microchip Technology Inc. DS40001784G-page 8...
Page 9
(FAE) for support. Local sales offices are also available to help customers. A listing of sales offices and locations is included in the back of this document. Technical support is available through the website at: http://www.microchip.com/support. 2015-2018 Microchip Technology Inc. DS40001784G-page 9...
Page 10
2.4.8.11, 2.4.8.12, 2.4.8.13, 2.4.8.14, 2.4.8.15, and 2.4.8.16; Updated Table 2-8, Figure 2-1, added sections 2.4.9.5, 2.4.9.12, 2.4.9.13, and 2.4.9.14; Added section 3.1, 3.1.1 and 3.1.2; Updated section 3.2, 3.3, 3.4; Other minor corrections. 2015-2018 Microchip Technology Inc. DS40001784G-page 10...
Port: Data: 23A5 Application These devices deal with These entities hold secret keys These devices relay encrypted plaintext application data that can encrypt/decrypt application data without being application data able to decrypt it 2015-2018 Microchip Technology Inc. DS40001784G-page 11...
RN2483 LoRa Technology Module Command Reference User’s Guide The flow of data can be followed as it gets generated by an end device and transported on the network. FEATURES • LoRaWAN Class A and Class C protocol compliance • Integrated FSK, GFSK and LoRa technology transceiver allowing the user to transmit custom packets using these protocols •...
Break condition calculation is as follows: /bps Where: = time required for Break condition * Nb = number of bits required for Break condition * bps = current bit rate = 13/57600 = 226 s 2015-2018 Microchip Technology Inc. DS40001784G-page 13...
RN2483 LoRa TECHNOLOGY MODULE COMMAND REFERENCE USER’S GUIDE Chapter 2. Command Reference The RN2483 LoRa technology module supports a variety of commands for configuration. This section describes these commands in detail and provides examples. COMMAND SYNTAX To issue commands to the RN2483 module, the user sends keywords followed by optional parameters.
RN2483 LoRa Technology Module Command Reference User’s Guide After configuring the LoRaWAN protocol settings, the user must save them to EEPROM with the mac save command. Once the settings have been saved, they will be retained after a reboot or Reset.
After factoryRESET, the RN2483 module will automatically reset and all configuration parameters are restored to factory default values. All LoRaWAN protocol settings set by the user will be lost. Example: sys factoryRESET // Restores factory default values. 2015-2018 Microchip Technology Inc. DS40001784G-page 17...
RN2483 LoRa Technology Module Command Reference User’s Guide 2.3.5 System Set Commands TABLE 2-3: SYSTEM SET COMMANDS Parameter Description Stores <data> to a location <address> of user EEPROM. Allows user to set and clear available digital pins. pindig Allows user to set the functionality of a pin to either digital input, digital output pinmode or analog input (if available).
This command informs the RN2483 module to do an ADC conversion on the V . The measurement is converted and returned as a voltage (mV). Example: sys get vdd // Returns mV measured on the V module. 2015-2018 Microchip Technology Inc. DS40001784G-page 19...
RN2483 LoRa Technology Module Command Reference User’s Guide 2.3.6.4 sys get hweui Response: hexadecimal number representing the preprogrammed EUI node address This command reads the preprogrammed EUI node address from the RN2483 module. The value returned by this command is a globally unique number provided by Microchip.
// Sets the default values and selects the 868 default band. Note: This command will set default values for most of the LoRaWAN parameters. Everything set prior to this command will lose its set value. 2015-2018 Microchip Technology Inc. DS40001784G-page 21...
RN2483 LoRa Technology Module Command Reference User’s Guide 2.4.2 mac tx <type> <portno> <data> string representing the uplink payload type, either cnf or uncnf (cnf – <type>: confirmed, uncnf – unconfirmed) <portno>: decimal number representing the port number, from 1 to 223 hexadecimal value.
Page 23
Based on this scenario, the following responses will be displayed by the module: • mac tx cnf 4 AB • ok • mac_rx 1 AC • mac_rx 1 AF • mac_tx_ok 2015-2018 Microchip Technology Inc. DS40001784G-page 23...
RN2483 LoRa Technology Module Command Reference User’s Guide 2.4.3 mac join <mode> string representing the join procedure type (case-insensitive), either otaa <mode>: or abp (otaa – over-the-air activation, abp – activation by personalization). Response: this command may reply with two responses. The first response will be received immediately after entering the command.
• rx2 parameters: RX Window 2 parameters - freq: Frequency - status: Status • upctr: Uplink Frame Counter Example: mac save // Saves the LoRaWAN Class A protocol configuration parameters to the user EEPROM. 2015-2018 Microchip Technology Inc. DS40001784G-page 25...
RN2483 LoRa Technology Module Command Reference User’s Guide 2.4.5 mac forceENABLE Response: ok The network can issue a certain command (Duty Cycle Request frame with parameter 255) that would require the RN2483 module to go silent immediately. This mechanism disables any further communication of the module, effectively isolating it from the network.
Example: mac set appkey 00112233445566778899AABBCCDDEEFF Note: If this parameter was previously saved to user EEPROM by issuing the mac save command, after modifying its value, the mac save command should be called again. 2015-2018 Microchip Technology Inc. DS40001784G-page 27...
RN2483 LoRa Technology Module Command Reference User’s Guide 2.4.8.2 mac set appskey <appSesskey> <appSessKey>: 16-byte hexadecimal number representing the application session Response: ok if key is valid invalid_param if key is not valid This command sets the application session key for the module. This key provides security for communication between module and application server.
9. Note: If this parameter was previously saved to user EEPROM by issuing the mac save command, after modifying its value, the mac save command should be called again. 2015-2018 Microchip Technology Inc. DS40001784G-page 29...
Page 30
RN2483 LoRa Technology Module Command Reference User’s Guide 2.4.8.5.3 mac set ch drrange <channelID> <minRange> <maxRange> <channelID>: decimal number representing the channel number, from 0 to 15 <minRange>: decimal number representing the minimum data rate, from 0 to 7 <maxRange>: decimal number representing the maximum data rate, from 0 to 7...
Example: mac set deveui 0004A30B001A55ED Note: If this parameter was previously saved to user EEPROM by issuing the mac save command, after modifying its value, the mac save command should be called again. 2015-2018 Microchip Technology Inc. DS40001784G-page 31...
RN2483 LoRa Technology Module Command Reference User’s Guide 2.4.8.9 mac set dnctr <fCntDown> <fCntDown>: decimal number representing the value of the downlink frame counter that will be used for the next downlink reception, from 0 to 4294967295. Response: ok if parameter is valid...
Example: mac set mcastdevaddr 54ABCDEF Note: If this parameter had previously been saved to user EEPROM by issuing the mac save command, after modifying its value, the mac save command should be called again. 2015-2018 Microchip Technology Inc. DS40001784G-page 33...
RN2483 LoRa Technology Module Command Reference User’s Guide 2.4.8.15mac set mcastdnctr <fMcastCntDown> <fMcastCntDown>: decimal number representing the value of the multicast downlink frame counter from 0 to 4294967295. Response: ok if parameter is valid invalid_param if the parameter is not valid This command sets the value of the multicast downlink frame counter that will be used for the next downlink reception.
865 MHz. Note: If this parameter had previously been saved to user EEPROM by issuing the mac save command, after modifying its value, the mac save command should be called again. 2015-2018 Microchip Technology Inc. DS40001784G-page 35...
RN2483 LoRa Technology Module Command Reference User’s Guide 2.4.8.21 mac set rxdelay1 <rxDelay> <rxDelay>: decimal number representing the delay between the transmission and the first Reception window in milliseconds, from 0 to 65535. Response: ok if <rxDelay> is valid invalid_param if <rxDelay> is not valid This command will set the delay between the transmission and the first Reception window to the <rxDelay>...
Response: 8-byte hexadecimal number representing the application EUI. This command will return the application identifier for the module. The application identifier is a value given to the device by the network. Default: 0000000000000000 Example: mac get appeui 2015-2018 Microchip Technology Inc. DS40001784G-page 37...
RN2483 LoRa Technology Module Command Reference User’s Guide 2.4.9.3 mac get ar Response: string representing the state of the automatic reply, either on or off. This command will return the current state for the automatic reply (AR) parameter. The response will indicate if the AR is on or off.
Page 39
Example: mac get ch status 2 Note: <channelID> parameters must be issued prior to enabling the status of that channel. If a channel is disabled through the <status>, all channel parameters must be reconfigured prior to enabling. 2015-2018 Microchip Technology Inc. DS40001784G-page 39...
RN2483 LoRa Technology Module Command Reference User’s Guide 2.4.9.5 mac get class Response: A single letter A or C This command will return the LoRaWAN operation class as set in the module. Default: A Example: mac get class 2.4.9.6 mac get dcycleps Response: decimal number representing the prescaler value, from 0 to 65535.
2.4.9.16 mac get pwridx Response: decimal number representing the current output power index value, from 0 to 5. This command returns the current output power index value. Default: 1 Example: mac get pwridx 2015-2018 Microchip Technology Inc. DS40001784G-page 41...
RN2483 LoRa Technology Module Command Reference User’s Guide 2.4.9.17 mac get retx Response: decimal number representing the number of retransmissions, from 0 to 255. This command will return the currently configured number of retransmissions which are attempted for a confirmed uplink communication when no downlink response has been received.
7 – APB_delay 8 – Class C RX2 1 open 9 – Class C RX2 2 open NbRep is the number of repetitions for unconfirmed packets (for more details, refer to the LoRaWAN™ Specification V1.0.2). 2015-2018 Microchip Technology Inc. DS40001784G-page 43...
RN2483 LoRa Technology Module Command Reference User’s Guide RADIO COMMANDS TABLE 2-11: RADIO COMMANDS Parameter Description This command configures the radio to receive simple radio packets according to prior configuration settings. This command configures a simple radio packet transmission according to prior configuration settings.
• busy – if the transceiver is currently busy Response after the effective transmission: • radio_tx_ok – if transmission was successful • radio_err – if transmission was unsuccessful (interrupted by radio Watchdog Timer time-out) This command transmits the <data> passed. 2015-2018 Microchip Technology Inc. DS40001784G-page 45...
RN2483 LoRa Technology Module Command Reference User’s Guide Example: radio tx 48656c6C6F // Transmits a packet of [0x48][0x65][0x6c][0x6C][0x6F]; Hello. Note: In order to meet ETSI regulations in the given frequency bands, the radio has to use either Listen Before Talk (LBT) + Adaptive Frequency Agility (AFA) or duty cycle limitations.
<gfBT> other than none will result in a Gaussian Filter BT being applied to transmissions in FSK mode. Example: radio set bt none // Data shaping in FSK mode is disabled or null. 2015-2018 Microchip Technology Inc. DS40001784G-page 47...
RN2483 LoRa Technology Module Command Reference User’s Guide 2.5.5.4 radio set bw <bandWidth> <bandWidth>: decimal representing the operating radio bandwidth, in kHz. Parameter values can be: 125, 250, 500. Response: ok if the bandwidth is valid invalid_param if the bandwidth is not valid This command sets the operating radio bandwidth for LoRa operation.
Response: ok if the spreading factor is valid invalid_param if the spreading factor is not valid This command sets the spreading factor used during transmission. Example: radio set sf sf7 2015-2018 Microchip Technology Inc. DS40001784G-page 49...
RN2483 LoRa Technology Module Command Reference User’s Guide 2.5.5.15 radio set sync <syncWord> <syncWord>: hexadecimal value representing the Sync word used during communication. For LoRa modulation one byte is used, for FSK up to eight bytes can be entered. Response: ok if the sync word is valid invalid_param if the sync word is not valid This command configures the sync word used during communication.
1.0, 0.5, 0.3. This command reads back the current configuration for data shaping applied to FSK transmissions. Default: 0.5 Example: radio get bt // Reads the current data shaping FSK configuration. 2015-2018 Microchip Technology Inc. DS40001784G-page 51...
RN2483 LoRa Technology Module Command Reference User’s Guide 2.5.6.4 radio get bw Response: decimal representing the current operating radio bandwidth, in kHz. Parameter values can be: 125, 250 or 500. This command reads back the current operating radio bandwidth used by the transceiver.
250, 125, 62.5, 31.3, 15.6, 7.8, 3.9, 200, 100, 50, 25, 12.5, 6.3, 3.1, 166.7, 83.3, 41.7, 20.8, 10.4, 5.2, 2.6. This command reads back the signal bandwidth used for receiving. Default: 25 Example: radio get rxbw // Reads back the receive signal bandwidth. 2015-2018 Microchip Technology Inc. DS40001784G-page 53...
RN2483 LoRa Technology Module Command Reference User’s Guide 2.5.6.15 radio get sf Response: string representing the current spreading factor. This command reads back the current spreading factor being used by the transceiver. Parameter values can be: sf7, sf8, sf9, sf10, sf11, sf12”...
COMMAND REFERENCE USER’S GUIDE Chapter 3. Bootloader Usage This chapter describes the operation of the bootloader on the RN2483 LoRa modules. The bootloader can be used to upgrade the firmware in the field without requiring the use of a hardware programming tool.
RN2483 LoRa Technology Module Command Reference User’s Guide PROTOCOL The RN2483 bootloader is similar to other Microchip bootloaders. This section describes the specifics of RN2483 bootloader protocol. Table 3-1 provides the list of commands required to update the RN2483 module firmware.The Microchip standard...
TABLE 3-6: WRITE FLASH Byte: Values: 0x55 0x02 0x00 Key1 Key2 Address Byte: Len Number of bytes (9 through 8+Len) Values: Data[0]-Data[Len-1] 2015-2018 Microchip Technology Inc. DS40001784G-page 57...
Page 58
RN2483 LoRa Technology Module Command Reference User’s Guide This command writes data into the Flash memory. The length field can range from 0 to 255. This determines the number of bytes written to Flash. The Write Flash command does not erase any Flash memory before writing data; therefore, this command should be preceded by an Erase Flash command for proper operation.
Device Firmware Update (DFU) function as used by the RN2483 modules. 3.5.2.1 UPDATE RN2483 MODULE FIRMWARE USING LORADEVUTILITY 1. Launch the LoRaDevUtility.jar application. 2. The LoraDevUtility probes all the available serial ports on the PC. The left win- 2015-2018 Microchip Technology Inc. DS40001784G-page 59...
RN2483 LoRa Technology Module Command Reference User’s Guide dow pane lists all of the Microchip LoRaWAN devices found. 3. The RN2483 module is displayed as RN Module n. Where n is a unique number assigned by the LoRaDevUtility. Select “RN Module” in the left pane.
• Fixed an issue that may have caused the RN2483 module to mishandle data on LoRaWAN port 0 • Fixed an issue that may have caused the module to fail joining • Fixed radio get snr command to display correct value 2015-2018 Microchip Technology Inc. DS40001784G-page 61...
Page 62
- mac set class - mac get class - radio get rssi • Added support for Block Link ADR, additional command support • Added support for Join duty cycle back-off (based on duration of Join attempts) 2015-2018 Microchip Technology Inc. DS40001784G-page 62...
New York, NY Tel: 46-31-704-60-40 Tel: 631-435-6000 Sweden - Stockholm San Jose, CA Tel: 46-8-5090-4654 Tel: 408-735-9110 UK - Wokingham Tel: 408-436-4270 Tel: 44-118-921-5800 Canada - Toronto Fax: 44-118-921-5820 Tel: 905-695-1980 Fax: 905-695-2078 2015-2018 Microchip Technology Inc. DS40001784G-page 64 08/15/18...
Need help?
Do you have a question about the RN2483 LoRa and is the answer not in the manual?
Questions and answers