文件列表:

LICENSE.txt (34519, 2018-07-11)
VERSION.txt (3, 2018-07-11)
hoperf (0, 2018-07-11)
hoperf\LoRa.py (37078, 2018-07-11)
hoperf\LoRaArgumentParser.py (3764, 2018-07-11)
hoperf\__init__.py (21, 2018-07-11)
hoperf\board_config.py (4426, 2018-07-11)
hoperf\constants.py (5256, 2018-07-11)
lora_util.py (1811, 2018-07-11)
rx_cont.py (3523, 2018-07-11)
socket_client.py (740, 2018-07-11)
socket_transceiver.py (4149, 2018-07-11)
test_code_for_lopys (0, 2018-07-11)
test_code_for_lopys\loratest_rx.py (2514, 2018-07-11)
test_code_for_lopys\loratest_tx.py (2411, 2018-07-11)
test_lora.py (5059, 2018-07-11)
tx_beacon.py (4369, 2018-07-11)

# Overview This is a python interface for the Raspberry Pi+ LoRa(TM) Expansion Board by Uputronics (https://store.uputronics.com/index.php?route=product/product&path=61&product_id=68). This board uses the Hope RFs patented LoRaTM modulation technique RFM95/96/97/***(W) The code is derived and adapted from: https://github.com/mayeranalytics/pySX127x with the help of the indications in: https://electron-tinker.blogspot.com.es/2016/08/raspberry-pi-lora-hoperf-python-code.html # Installation Make sure SPI is activated on you RaspberryPi: [SPI](https://www.raspberrypi.org/documentation/hardware/raspberrypi/spi/README.md) **pyUputronics** requires these two python packages: * [RPi.GPIO](https://pypi.python.org/pypi/RPi.GPIO") for accessing the GPIOs, it should be already installed on a standard Raspian Linux image * [spidev](https://pypi.python.org/pypi/spidev) for controlling SPI In order to install spidev download the source code and run setup.py manually: ```bash wget https://pypi.python.org/packages/source/s/spidev/spidev-3.1.tar.gz tar xfvz spidev-3.1.tar.gz cd spidev-3.1 sudo python setup.py install ``` At this point you may want to confirm that the unit tests pass. For example, you can run the scripts `lora_util.py` that dumps the registers. ```bash rasp$ sudo ./lora_util.py hoperf LoRa registers: mode SLEEP freq 434.000000 MHz coding_rate CR4_5 bw BW125 spreading_factor 128 chips/symb implicit_hdr_mode OFF ... and so on .... ``` # Script references ### Continuous receiver `rx_cont.py` The hoperf is put in RXCONT mode and continuously waits for transmissions. Upon a successful read the payload and the irq flags are printed to screen. ``` usage: ./rx_cont.py [-h] [--ocp OCP] [--sf SF] [--freq FREQ] [--bw BW] [--cr CODING_RATE] [--preamble PREAMBLE] Continous LoRa receiver optional arguments: -h, --help show this help message and exit --ocp OCP, -c OCP Over current protection in mA (45 .. 240 mA) --sf SF, -s SF Spreading factor (6...12). Default is 7. --freq FREQ, -f FREQ Frequency --bw BW, -b BW Bandwidth (one of BW7_8 BW10_4 BW15_6 BW20_8 BW31_25 BW41_7 BW62_5 BW125 BW250 BW500). Default is BW125. --cr CODING_RATE, -r CODING_RATE Coding rate (one of CR4_5 CR4_6 CR4_7 CR4_8). Default is CR4_5. --preamble PREAMBLE, -p PREAMBLE Preamble length. Default is 8. ``` ### Simple LoRa beacon `tx_beacon.py` A small payload is transmitted in regular intervals. ``` usage: ./tx_beacon.py [-h] [--ocp OCP] [--sf SF] [--freq FREQ] [--bw BW] [--cr CODING_RATE] [--preamble PREAMBLE] [--single] [--wait WAIT] A simple LoRa beacon optional arguments: -h, --help show this help message and exit --ocp OCP, -c OCP Over current protection in mA (45 .. 240 mA) --sf SF, -s SF Spreading factor (6...12). Default is 7. --freq FREQ, -f FREQ Frequency --bw BW, -b BW Bandwidth (one of BW7_8 BW10_4 BW15_6 BW20_8 BW31_25 BW41_7 BW62_5 BW125 BW250 BW500). Default is BW125. --cr CODING_RATE, -r CODING_RATE Coding rate (one of CR4_5 CR4_6 CR4_7 CR4_8). Default is CR4_5. --preamble PREAMBLE, -p PREAMBLE Preamble length. Default is 8. --single, -S Single transmission --wait WAIT, -w WAIT Waiting time between transmissions (default is 0s) ``` # Code Examples ### Overview First import the modules ```python from hoperf.LoRa import * from hoperf.board_config import BOARD ``` then set up the board GPIOs ```python BOARD.setup() ``` The LoRa object is instantiated and put into the standby mode ```python lora = LoRa() lora.set_mode(MODE.STDBY) ``` Registers are queried like so: ```python print lora.version() # this prints the hoperf chip version print lora.get_freq() # this prints the frequency setting ``` and setting registers is easy, too ```python lora.set_freq(433.0) # Set the frequency to 433 MHz ``` In applications the `LoRa` class should be subclassed while overriding one or more of the callback functions that are invoked on successful RX or TX operations, for example. ```python class MyLoRa(LoRa): def __init__(self, verbose=False): super(MyLoRa, self).__init__(verbose) # setup registers etc. def on_rx_done(self): payload = self.read_payload(nocheck=True) # etc. ``` In the end the resources should be freed properly ```python BOARD.teardown() ``` ### More details Most functions of `hoperf.Lora` are setter and getter functions. For example, the setter and getter for the coding rate are demonstrated here ```python print lora.get_coding_rate() # print the current coding rate lora.set_coding_rate(CODING_RATE.CR4_6) # set it to CR4_6 ``` # Class Reference The interface to the hoperf LoRa modem is implemented in the class `hoperf.LoRa.LoRa`. The most important modem configuration parameters are: | Function | Description | |------------------|---------------------------------------------| | set_mode | Change OpMode, use the constants.MODE class | | set_freq | Set the frequency | | set_bw | Set the bandwidth 7.8kHz ... 500kHz | | set_coding_rate | Set the coding rate 4/5, 4/6, 4/7, 4/8 | | | | | @todo | | Most set_* functions have a mirror get_* function, but beware that the getter return types do not necessarily match the setter input types. ### Register naming convention The register addresses are defined in class `hoperf.constants.REG` and we use a specific naming convention which is best illustrated by a few examples: | Register | Modem | Semtech doc. | pyUputronics | |----------|-------|-------------------| ---------------------------| | 0x0E | LoRa | RegFifoTxBaseAddr | REG.LORA.FIFO_TX_BASE_ADDR | | 0x0E | FSK | RegRssiCOnfig | REG.FSK.RSSI_CONFIG | | 0x1D | LoRa | RegModemConfig1 | REG.LORA.MODEM_CONFIG_1 | | etc. | | | | ### Hardware Hardware related definition and initialisation are located in `hoperf.board_config.BOARD`. If you use a SBC other than the Raspberry Pi you'll have to adapt the BOARD class. --- --- # Contributors Please feel free to comment, report issues, or contribute! Contact me via my company website [Mayer Analytics](http://mayeranalytics.com) and my private blog [mcmayer.net](http://mcmayer.net). Follow me on twitter [@markuscmayer](https://twitter.com/markuscmayer) and [@mayeranalytics](https://twitter.com/mayeranalytics). # Roadmap ### Semtech SX1272/3 vs. SX1276/7/8/9 **pyUputronics** is not entirely compatible with the 1272. The 1276 and 1272 chips are different and the interfaces not 100% identical. For example registers 0x26/27. But the pyUputronics library should get you pretty far if you use it with care. Here are the two datasheets: * [Semtech - SX1276/77/78/79 - 137 MHz to 1020 MHz Low Power Long Range Transceiver](http://www.semtech.com/images/datasheet/sx1276_77_78_79.pdf) * [Semtech SX1272/73 - 860 MHz to 1020 MHz Low Power Long Range Transceiver](http://www.semtech.com/images/datasheet/sx1272.pdf) ### HopeRF transceiver ICs ### HopeRF has a family of LoRa capable transceiver chips [RFM92/95/96/***](http://www.hoperf.com/) that have identical or almost identical SPI interface as the Semtech SX1276/7/8/9 family. ### Microchip transceiver IC ### Likewise Microchip has the chip [RN2483](http://ww1.microchip.com/downloads/en/DeviceDoc/50002346A.pdf) # LoRaWAN LoRaWAN is a LPWAN (low power WAN) and, and **pyUputronics** has almost no relationship with LoRaWAN. Here we only deal with the interface into the chip(s) that enable the physical layer of LoRaWAN networks. # References ### Hardware references * [Semtech SX1276/77/78/79 - 137 MHz to 1020 MHz Low Power Long Range Transceiver](http://www.semtech.com/images/datasheet/sx1276_77_78_79.pdf) * [Modtronix inAir9](http://modtronix.com/inair9.html) * [Spidev Documentation](http://tightdev.net/SpiDev_Doc.pdf) * [Make: Tutorial: Raspberry Pi GPIO Pins and Python](http://makezine.com/projects/tutorial-raspberry-pi-gpio-pins-and-python/) ### LoRa performance tests * [Extreme Range Links: LoRa 868 / 900MHz SX1272 LoRa module for Arduino, Raspberry Pi and Intel Galileo](https://www.cooking-hacks.com/documentation/tutorials/extreme-range-lora-sx1272-module-shield-arduino-raspberry-pi-intel-galileo/) * [UK LoRa versus FSK - 40km LoS (Line of Sight) test!](http://www.instructables.com/id/Introducing-LoRa-/step17/Other-region-tests/) * [Andreas Spiess LoRaWAN World Record Attempt](https://www.youtube.com/watch?v=adhWIo-7gr4) ### Spread spectrum modulation theory * [An Introduction to Spread Spectrum Techniques](http://www.ausairpower.net/OSR-0597.html) * [Theory of Spread-Spectrum Communications-A Tutorial](http://www.fer.unizg.hr/_download/repository/Theory%20of%20Spread-Spectrum%20Communications-A%20Tutorial.pdf) (technical paper) # Copyright and License © 2015 Mayer Analytics Ltd., All Rights Reserved. ### Short version The license is [GNU AGPL](http://www.gnu.org/licenses/agpl-3.0.en.html). ### Long version pyUputronics is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. pyUputronics is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details. You can be released from the requirements of the license by obtaining a commercial license. Such a license is mandatory as soon as you develop commercial activities involving pyUputronics without disclosing the source code of your own applications, or shipping pyUputronics with a closed source product. You should have received a copy of the GNU General Public License along with pySX127. If not, see .

近期下载者：

相关文件：

评论：[我要评论] [举报此文件]

收藏者：