Damian Gabino / picoGW_hal

Host driver/HAL to build a LoRa Picocell Gateway which communicates through USB with a concentrator board based on Semtech SX1308 multi-channel modem and SX1257/SX1255 RF transceivers.

util_tx_test/readme.md@0:102b50f941d0, 2018-04-11 (annotated)

Committer:
dgabino
Date:
Wed Apr 11 14:38:42 2018 +0000
Revision:
0:102b50f941d0
Initial commit

Who changed what in which revision?

UserRevisionLine numberNew contents of line
dgabino 0:102b50f941d0 1 / _____) _ | |
dgabino 0:102b50f941d0 2 ( (____ _____ ____ _| |_ _____ ____| |__
dgabino 0:102b50f941d0 3 \____ \| ___ | (_ _) ___ |/ ___) _ \
dgabino 0:102b50f941d0 4 _____) ) ____| | | || |_| ____( (___| | | |
dgabino 0:102b50f941d0 5 (______/|_____)_|_|_| \__)_____)\____)_| |_|
dgabino 0:102b50f941d0 6 (C)2013 Semtech-Cycleo
dgabino 0:102b50f941d0 7
dgabino 0:102b50f941d0 8 LoRa concentrator packet sender
dgabino 0:102b50f941d0 9 ================================
dgabino 0:102b50f941d0 10
dgabino 0:102b50f941d0 11 1. Introduction
dgabino 0:102b50f941d0 12 ----------------
dgabino 0:102b50f941d0 13
dgabino 0:102b50f941d0 14 This software is used to send test packets with a LoRa concentrator. The packets
dgabino 0:102b50f941d0 15 contain little information, on no protocol (ie. MAC address) information but
dgabino 0:102b50f941d0 16 can be used to assess the functionality of a gateway downlink using other
dgabino 0:102b50f941d0 17 gateways as receivers.
dgabino 0:102b50f941d0 18
dgabino 0:102b50f941d0 19 2. Dependencies
dgabino 0:102b50f941d0 20 ----------------
dgabino 0:102b50f941d0 21
dgabino 0:102b50f941d0 22 This program is a typical example of LoRa concentrator HAL usage for sending
dgabino 0:102b50f941d0 23 packets.
dgabino 0:102b50f941d0 24
dgabino 0:102b50f941d0 25 Only high-level functions are used (the ones contained in loragw_hal) so there
dgabino 0:102b50f941d0 26 is no hardware dependencies assuming the HAL is matched with the proper version
dgabino 0:102b50f941d0 27 of the hardware.
dgabino 0:102b50f941d0 28 Data structures of the sent packets are accessed by name (ie. not at a
dgabino 0:102b50f941d0 29 binary level) so new functionalities can be added to the API without affecting
dgabino 0:102b50f941d0 30 that program at all.
dgabino 0:102b50f941d0 31
dgabino 0:102b50f941d0 32 3. Usage
dgabino 0:102b50f941d0 33 ---------
dgabino 0:102b50f941d0 34
dgabino 0:102b50f941d0 35 The application runs until the specified number of packets have been sent.
dgabino 0:102b50f941d0 36 Press Ctrl+C to stop the application before that.
dgabino 0:102b50f941d0 37
dgabino 0:102b50f941d0 38 Use the -h to get help and details about available options.
dgabino 0:102b50f941d0 39
dgabino 0:102b50f941d0 40 The payload content is:
dgabino 0:102b50f941d0 41 [T][E][S][T][packet counter MSB][packet counter LSB] followed by ASCII padding.
dgabino 0:102b50f941d0 42
dgabino 0:102b50f941d0 43 All LoRa data is scrambled and whitened, so the padding has no influence
dgabino 0:102b50f941d0 44 whatsoever on the packet error rate.
dgabino 0:102b50f941d0 45
dgabino 0:102b50f941d0 46 4. License
dgabino 0:102b50f941d0 47 -----------
dgabino 0:102b50f941d0 48
dgabino 0:102b50f941d0 49 Copyright (c) 2013, SEMTECH S.A.
dgabino 0:102b50f941d0 50 All rights reserved.
dgabino 0:102b50f941d0 51
dgabino 0:102b50f941d0 52 Redistribution and use in source and binary forms, with or without
dgabino 0:102b50f941d0 53 modification, are permitted provided that the following conditions are met:
dgabino 0:102b50f941d0 54
dgabino 0:102b50f941d0 55 * Redistributions of source code must retain the above copyright
dgabino 0:102b50f941d0 56 notice, this list of conditions and the following disclaimer.
dgabino 0:102b50f941d0 57 * Redistributions in binary form must reproduce the above copyright
dgabino 0:102b50f941d0 58 notice, this list of conditions and the following disclaimer in the
dgabino 0:102b50f941d0 59 documentation and/or other materials provided with the distribution.
dgabino 0:102b50f941d0 60 * Neither the name of the Semtech corporation nor the
dgabino 0:102b50f941d0 61 names of its contributors may be used to endorse or promote products
dgabino 0:102b50f941d0 62 derived from this software without specific prior written permission.
dgabino 0:102b50f941d0 63
dgabino 0:102b50f941d0 64 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
dgabino 0:102b50f941d0 65 ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
dgabino 0:102b50f941d0 66 WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
dgabino 0:102b50f941d0 67 DISCLAIMED. IN NO EVENT SHALL SEMTECH S.A. BE LIABLE FOR ANY
dgabino 0:102b50f941d0 68 DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
dgabino 0:102b50f941d0 69 (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
dgabino 0:102b50f941d0 70 LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
dgabino 0:102b50f941d0 71 ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
dgabino 0:102b50f941d0 72 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
dgabino 0:102b50f941d0 73 SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
dgabino 0:102b50f941d0 74
dgabino 0:102b50f941d0 75 *EOF*