SX1272 Development Kit User Guide
SX1272 Development Kit User Guide
USER GUIDE
WIRELESS & SENSING PRODUCTS
USER GUIDE
Table of Contents
Index of Figures
1 Preamble
This document describes how to use the SX1272 Evaluation kit. This document describes especially the
SX1272 Eiger platform and the SX1272 SKA User Interface. We strongly recommend for the user to read
thoroughly the datasheet of the SX1272 prior to start working on the device. Most of this document
assumes a general knowledge on the SX1272 and modern RF communications.
2 Introduction
The SX1272 is a single-chip integrated circuit ideally suited for today's high performance ISM band RF
applications. Added to the renowned, high-performance and low-cost, FSK / OOK RF transceiver modem,
the SX1272 is also equipped with the LoRa proprietary transceiver modem. This advanced feature set,
including a state of the art packet engine, greatly simplifies system design whilst the high level of
integration reduces the external BOM to a handful of passive decoupling and matching components. It is
intended for use as high-performance, long range, half-duplex bi-directional RF links, and where stable
and constant RF performances are required over the full operating range of the device down to 1.8V.
The SX1272 is intended for applications over a wide frequency range, including the 868 MHz European
and the 902-928 MHz North American ISM bands. Coupled with a link budget in excess of 135 dB in FSK
in excess of 155 dB in LoRa, the SX1272 really offers the possibility of two modems in one single
package. The SX1272 complies with both ETSI and FCC regulatory requirements and is available in a
5x5 mm QFN 28 lead free package.
The SX1272 Evaluation kit, based around the Eiger platform, allows the user to test every aspect of the
radio, both from the system and RF point of view.
On one hand, the Eiger platform is a touch screen portable device which has been design to enable quick
and easy testing of the PER performances of the SX1272. On the other hand, the SX1272SKA is a PC
based evaluation tool which allows in depth testing of the radio.
This document is therefore divided in two parts: the first part present the SX1272 Eiger module and how
to perform PER test in LoRa and FSK; the second part of this document present the SX1272 SKA and
how it can be used to test every single aspect of the radio.
3 Getting Started
3.1 Evaluation Kit Contents
The SX1272SKA evaluation kit consists of:
2 x Eiger platforms
2 x SX1272 modules
2 x ½ wave dipole antennas
2 x Mini-USB cables
Insert sheet
For more information on each of the options available, please, contact your local Semtech representative.
The SX1272SKA evaluation software, the firmware, drivers and all SX1272 related materials are available
on the Semtech website: http://www.semtech.com/wireless-rf/rf-transceivers/
Once the RLink drivers are installed, the firmware upgrade is done through the update.bat file which will
upload the correct version of the firmware depending on several options related to the Eiger platform or
module being used. When launching the application, the following window opens:
The upgrader then needs to know which version of the SX1272 is used with the Eiger platform. Most
users should have the Version 2 of the device. In case of doubt, please contact your Semtech
representative.
If the Eiger platform is not powered up, is wrongly connected or if the RLink drivers are not installed, the
following message will be displayed on the screen:
In this situation, the user need to make sure the device is correctly powered and turned on. Please, refer
to section 4.1 of this document for more information.
This is what the full upgrader should look like at the end of the software update.
Once the software has been upgraded, it is recommended to reset all the internal settings on the Eiger
platform. For more information on how to achieve this, please, refer to section 5.2.1.1 of this document.
S_VDC_Switch
Leave in uppermost position
Charging LEDs
Bottom red: charging
Top green: battery is charged
Red+Green: charging error or battery
fully charged Plaform main USB connector
Mini-B USB type
Use to charge the platform
battery or power it when
battery is off or empty. It is also
Eiger platform function ‘buttons’ used to update the firmware
Only used to move between screens
Battery switch
Switch the Eiger platform
STM32 daughter board ON or OFF (indicated by ‘1’
This USB should only be and ‘0’).
plug for the SX1272SKA
to enable communication
with PC software
The circuit has been specifically match to offer the best performances in the 860-930MHz range.
The idea behind the PER demo is to set one of the Eiger platform as a transmitter and the other one as a
receiver. Then both platforms can me moved away one from the other, in an urban or in an open field
environment, to easily capture the PER between the transmitter and the receiver.
The PER demo operates in FSK or in LoRa modes so that the advantages and drawbacks of each
modulation can been seen easily.
Battery level
Firmware version
Temperature
5.2.1.1 Settings
In case of miss-operation or to simply reset the Eiger module into a known state, it is possible the reset
the touch screen parameters or to reset the device parameters to their default parameters.
Once a box is ticked, “clicking” on the Apply button will reset the selected parameters. The ticked box will
then go un-ticked.
5.2.1.2 Battery
Indicates the battery state
5.2.1.3 Bootloader
Reboot the system
5.2.1.4 About
The PER Demo menu is the core of the Eiger platform testing. The menu is divided in three main areas,
Tx, Rx and Settings. The PER Settings menu allows the user to set several parameters of the Radio for
Tx and Rx.
A text in green indicates that the value can be changed. For example, on the first window of the PER
Setting screen, you will see:
For a given modulation, there is only a limited set of parameters that can be set by the user. Most of the
parameters are set automatically in the software to keep the interface user friendly.
Set Device ID
Payload
Preamble SyncWord Payload CRC
length
(8 Bytes) (0x69-0x81-0x7E-0x96) (Platform ID, 32-bit packet cnt, ‘P’, ‘E’, ’R’, FCS, ‘Padding [xx Bytes]’) (2 Bytes)
(1 Byte)
The preamble length, the SyncWord and the basic payload structure cannot be changed by the user.
However, the payload length is adjustable and the ‘Padding’ field will increase or decrease depending of
the payload size. The CRC can also be enabled or disabled from the packet settings menu. All in all the
smallest packet will be 22 bytes long and the longest packet will be 78 bytes long in total.
Set Device ID
The preamble length, the Header and the basic payload structure cannot be changed by the user.
However, the payload length is adjustable and the ‘Padding’ field will increase or decrease depending of
the payload size. The CRC can also be enabled or disabled from the packet settings menu.
Once the RF parameters are set, putting the Eiger module in TX mode will initiate the packet transmission.
The TX window displays the RF parameters and the number of packet sent since the beginning of the test.
TX Modulation parameters
TX Modulation parameters
Packet indicator
PER
In LoRa mode, when sub-noise reception is occurring (SNR < 0), the displayed RSSI value is
extrapolated using the SNR indicator. When the SNR > 0, the actual SNR is not computed and the value
is clamped.
Packet indicator
PER
In Rx mode, a bar-graph indicates the distribution of the error over time. This is especially useful to detect
the cause of the error, whether a burst of noise in the frequency band or if the device in in the limit of
reception range. The examples below highlight what each case looks like:
As we can see in the picture below, the device lost many packets in a short amount of time.
SX1272SKA Version
Eiger Module Firmware Version
SX1272 Chipset Version
Radio config file
currently loaded
This chapter is presenting the various windows and field that controls the radio operations. While some
controls can be obvious, some others may need the user to refer to the datasheet to get a full description
of the commands.
A load radio configuration is implemented and allows the opening of SX1272SKA configuration files (.cfg).
This is implemented through a standard Windows file dialog box and may also be accessed through the
short cut buttons of the Window Toolbar.
In the same way, it is possible to save the SX1272SKA configuration files (.cfg). This is implemented
through a standard Windows file dialog box. The default file name is the last configuration file saved.
This window allows the user to write to and read from the contents of individual configuration register
addresses. Note that address and data are entered in hexadecimal format.
Refresh all
registers value
3
6
2: Set the parameters related to the transmission of the data such as output power.
3: Set the parameters related to the reception of the data such as AGC or LNA boost settings.
4: Set the mapping for the device IO pins. The Status of the IO is then displayed over time in the
section 5 of the window.
4
1
3: Set the payload to be transmitted control the emission or reception of the radio
The FSK menu is organized around several windows allowing the user to set the radio step by step. The
detail of each window is described from section 5.2.1.1 onward.
Some information are however global to the FSK radio operation and are thus displayed on every window
as shown on figure 9.
Refresh all
registers value
In FSK mode, it is possible to perform a quantitative spectrum analysis but reading the RSSI value across
a range of Frequency. It is also possible to have a qualitative measurement of the RSSI as it is detected
by the chipsets. This tool is especially useful when a more expensive spectrum analyzer is not at hand
reach.
When Monitor is set to ON, the GUI will constantly scan the status of the FSK IRQ register and displays
the status on the right hand side of the GUI. Setting Monitor to OFF disables this features.
The Common window allows the user to set the common Tx/Rx parameters for the modulation.
Parameters such as the modulation type (FSK or OOK), Frequency, Bitrate, frequency deviation or the
oscillator details can be entered in this window.
When Frequency Hopping is used, the control bit “Fast Hoping” need to be set so that the internal PLL
can optimize to jump from one frequency to the next in the smallest amount of time.
It is also in this window that the Gaussian Filter parameter is set for the transmission.
A general description would be:
2: Set the modulation Type and the Gaussian filter parameter (Tx Only)
As indicated through its name, the transmitter window groups the configuration parameters related to the
transmission:
1: This field allows the user to select the radio output pin. Depending of the SX1272 module version,
it may or may not be possible to select the RFO pin as output.
2: Set the output power of the radio. The maximum output power is 20dBm.
4: PLL Bandwidth
8
1 5
7 9
1: Set the reception bandwidth filter and set the AFC reception bandwidth filter
Please, note that the AFC bandwidth filter is disregarded if AFC Auto is set to OFF
2: Enable or disable the AGC and set the step threshold (I am not sure what it does actually)
3: Enable or disable the preamble detector and set the preamble detector parameters.
Please, note that the preamble detector must be enabled if the reception is triggered on preamble
detection.
6: Control the RSSI detection. If the reception is triggered on the RSSI detection, these parameters
allow controlling the level of RSSI triggering the reception and smoothing the peak detector to
avoid false detection in case of random peak in the frequency band.
7: These parameters control the events that trig a reception and the behavior of the receiver in case
of collision
8: Enable or Disable the bit synchronizer and configure the OOK demodulator
The IRQ and Mapping window is used to set and control the IRQs in the device:
2: Enable or disable the preamble detection IRQ (when starting on RSSI detection)
3: Configures the IRQ and how they are mapped with the DIOs of the device.
3 4
2: Once the packet structure has been defined, this view allows the user that all each field of the
packet structure is set correctly.
The sequencer window allows the user to setup the internal state machine of the device and control how
the device will react following an event. For more information on the FSK internal state machine, please,
refer to the datasheet.
7 How to...
7.1 … perform a simple transmission / reception in LoRa
Performing a simple Transmission – Reception in LoRa is fairly straight forward.
First, the user needs to set the RF transmission parameters:
It is important to notice that the device mode of operation is standby between packets, this is why the
Operating mode is left in “Standby”.
Then we need to set the device in reception after setting the Lora modulation parameters.
At this stage, the transmission – reception should be complete and the user should see the LEDs blinking
on the Eiger platforms.
In the transmitter, receiver and IRQ windows, all the parameters can be left at their default values and
then we simply need to set our packet structure.
The device is now sending packet. You can also see the Yellow LED flashing on the Eiger modules to
indicate that the device is currently transmitting.
It is also possible to set the device in Continuous Rx mode. In this mode, the device is continuously
receiving the packet sent from the transmitter.
Depending if you are in FSK mode or in LoRa mode, a different pop-up window will appear:
In FSK mode, the packet logger allows to the user to only log a
limited amount of packet (indicated by the value “Max Samples”).
Then, when the packets are being transmitted or received, the
number of desired packets will be logged in the file selected.
8 Troubleshooting
Each Eiger platform, radio module or software kit has been thoroughly tested before to be released for
customer evaluation. The section below highlights some of the common issues faced by users and how it
can be fixed.
8.1 The Eiger platform indicates very high PER even in short range
There are several reasons which can have a dramatic influence over the performance of the platform.
One of the common reasons is that the frequency selected is in the GSM or in another already used
frequency band. If the frequency you have selected is already used by another RF system, the
communication will obviously be affected. We therefore recommend to the user to check the RF band
usage in his location before to start any PER testing.
8.3 The SX1272SKA do not detect the device through the USB
This issue is usually caused by a wrong connection of the USB
The step below should fix the issue.
1- Make sure the Eiger Platform is powered down (Battery switch set to 0) and is not connected to
the PC through the USB.
2- Reconnect the side USB to the PC, the red LED on the left side should light up
3- Connect the bottom USB to the PC.
4- Power the device up (Battery switch set to 1)
5- Press the five-way central push button until the screen light up.
6- Launch the SX1272SKA on the PC
© Semtech 2013
All rights reserved. Reproduction in whole or in part is prohibited without the prior written consent of the copyright
owner. The information presented in this document does not form part of any quotation or contract, is believed to
be accurate and reliable and may be changed without notice. No liability will be accepted by the publisher for any
consequence of its use. Publication thereof does not convey nor imply any license under patent or other industrial
or intellectual property rights. Semtech assumes no responsibility or liability whatsoever for any failure or
unexpected operation resulting from misuse, neglect improper installation, repair or improper handling or unusual
physical or electrical stress including, but not limited to, exposure to parameters beyond the specified maximum
ratings or operation outside the specified range.
Semtech Corporation
Wireless & Sensing Products Division
200 Flynn Road, Camarillo, CA 93012
Phone: (805) 498-2111 Fax: (805) 498-3804
E-mail: [email protected]
[email protected]
Internet: http://www.semtech.com