PatrIoT Manual for Transparent Serial and AT Command

DSPWORKS LORA MANUAL

  • Transparent Serial
  • AT Command

Contents

  1. Introduction.
  2. Hardware Setup.
  3. Configuration.
  4. Transparent Serial
  5. AT Command Mode.
  6. Detailed Description of AT Command.
  7. Warnings. 11

1. Introduction

This document presents detail information on how to used PatrIoT (DSPWorks’ 30dBm LoRa module) for serial communication between two nodes as well as using AT Commands on PatrIoT. This also guides on hardware setup and utilities needed for setting up connection between PatrIoT and PC. This revision support EEPROM functionality.

Note: Never use any node without an antenna.

2. Hardware Setup

You will need following for serial transparent application.

  1. PatrIoT (30dBm LoRa Module) with Antenna 2 nos.
  2. USB-UART modules 2 nos.
  3. PatrIoT to USB-UART jumper cables 2 set

Please refer to image below for connection

Figure 1 Connection between PatrIoT and USB-UART

Connections between PatrIoT and USB-UART are detailed in Table 1

Table 1 Connections between PatrIoT and USB-UART

Sr# Color Signal
1 Red 5V power supply, provided from USB port
2 Black Ground Signal
3 Purple RXD of PatrIoT, connected to TXD of USB-UART
4 Blue TXD of PatrIoT, connected to RXD of USB-UART

 

PatrIoT module will need around 800mA of peak current for transmission so make sure the power source is capable of providing the same. In case your USB supply is not able to supply this current, use a separate power supply.

 

Note: Please make sure antenna is connected to PatrIoT before you power it up. Powering up the PatrIoT without antenna may damage the module or least degrade the RF performance.

3. Configuration

Any serial terminal emulator can be used for serial communication between PatrIoT and PC, however we recommend use of PuTTY and the document describes all the steps considering setup in PuTTY only. User must corelate their serial emulator with steps for PuTTY shown below.

Follow below Steps for setting up serial communication between PatrIoT and PC

  • Connect the setup (PatrIoT with USB-UART) to a USB port.
  • Find the USB port number to which PatrIoT is connected, this can be found in device manager. In device manager, look for “Silicon Labs CP210x …” in Ports list to determine the port number

Figure 2 Device Manager to determine the USB UART port number

  • Open PuTTY and setup it with below settings.
  • Serial line: COM3 (use your port number)
  • Baud rate: 9600
  • Connection type: Serial

Figure 3 PuTTY Configuration Category Session

  • Go to Category->Terminal tab and do following settings.
  • Local Echo: Force On
  • CR in every LF and LF in every CR: Checked (Enabled)

Figure 4 PuTTY Configuration Category Terminal

  • Go to Category->Connection->Serial tab and do following settings.
  • Parity: None
  • Flow control: None

Figure 5 PuTTY Configuration Category Connection

  • Click Open button to start console.

 

4.    Transparent Serial

In this mode, nodes will communicate with each other and data available on serial port will be transmitted over LoRa. As you write on A’s console, it will also be shown on B’s console and vice versa. Nodes should be set in same configuration for them to communicate among themselves.

5. AT Command Mode

Steps for using command mode

  1. To enter into command mode, press ctrl + ] .
  2. Enter command in UPPERCASE.
  3. To exit from command mode, press Enter.

Note: Once you set value it gets stored in EEPROM.

There are two types of commands

  1. Read Command  : To get value of parameter.

format: <command>?

  1. Write Command : To set value.

format: <command><value>

Following is list of AT commands

Table 2 List of AT Commands

AT+FREQ For checking and setting transmission frequency
AT+TXPWR For checking and setting transmit power
AT+BW For checking and setting bandwidth
AT+SF For checking and setting spread factor
AT+RSSI For checking received signal strength indicator
AT+RRSSI For checking remote node received signal strength indicator

6 Detailed Description of AT Command

6.1 AT+FREQ

 

Table 3 For checking and setting transmission frequency

Read Command

AT+FREQ?

Response

<n>

Parameter

See Write Command

Write Command

AT+FREQ<n>

Successful Response

Input should be in kHz.

Done

 

Unsuccessful Response

Invalid Command

Parameter

<n> 865000–867000   Transmission Frequency in kHz

Note

Default 866500 kHz

 

 

6.2 AT+TXPWR

 

Table 4 For checking and setting transmit power

Read Command

AT+TXPWR?

Response

<n>

Parameter

See Write Command

Write Command

AT+TXPWR<n>

Successful Response

Done

 

Unsuccessful Response

Invalid Command

Parameter

<n>     0-9        Range for Transmit Power in dBm

Note

Default 8 dBm

 

6.3 AT+BW

 

Table 5 For checking and setting bandwidth

Read Command

AT+BW?

Response

<n>

 

Parameter

See Write Command

Write Command

AT+BW<n>

Successful Response

Done

 

Unsuccessful Response

Invalid Command

Parameter

<n>      0                        125kHz

1                            250kHz

2                            500kHz

Note

Default 1 (i.e. 250 kHz)

 

 

6.4 AT+SF

 

Table 6 For checking and setting spread factor

Read Command

AT+SF?

 

 

 

Response

<n>

Parameter

See Write Command

Write Command

AT+SF<n>

Successful Response

Done

 

Unsuccessful Response

Invalid Command

Parameter

<n>       7-12                     Range of SF7- SF12

Note

Default 7 (i.e. SF7)

 

 

6.5 AT+RSSI

 

Table 7 For checking received signal strength indicator

Read Command

AT+RSSI?

Response

<n>

This command gives RSSI of received packet.

 

6.6 AT+RRSSI

 

Table 8 For checking remote node received signal strength indicator

Read Command

AT+RRSSI?

Response

<n>

This command gives RSSI of packet received at remote node.

 

7. Warnings

  • Never use any node without an antenna.
  • Make sure the power supply polarity is correct, there is no reverse polarity protection on board
  • Make sure power supply is capable of supplying 800mA of peak current else TX power cannot be guaranteed

 

 

Leave a Reply

Your email address will not be published. Required fields are marked *