From b665027754e4a050b5c3ea2da999dce8bf3ab710 Mon Sep 17 00:00:00 2001 From: Sylvain Miermont Date: Thu, 12 Dec 2013 15:31:52 +0100 Subject: v1.1.1 - bugfix: fixed some range checks that did not prevent segfaults - test: removed systematic register dump in test_loragw_hal.c - modified Makefiles for easier cross-compilation - added root README and removed TXT extension of other READMEs --- loragw_tx_test/Makefile | 6 ++-- loragw_tx_test/README | 72 +++++++++++++++++++++++++++++++++++++++++++++++ loragw_tx_test/README.TXT | 72 ----------------------------------------------- 3 files changed, 75 insertions(+), 75 deletions(-) create mode 100644 loragw_tx_test/README delete mode 100644 loragw_tx_test/README.TXT (limited to 'loragw_tx_test') diff --git a/loragw_tx_test/Makefile b/loragw_tx_test/Makefile index 8ece9b9..3de440b 100644 --- a/loragw_tx_test/Makefile +++ b/loragw_tx_test/Makefile @@ -3,7 +3,7 @@ APP_NAME=loragw_tx_test ### constant symbols - +CROSS_COMPILE= CC=gcc CFLAGS=-O2 -Wall -Wextra -Iinc C99FLAGS=-O2 -Wall -Wextra -std=c99 -Iinc @@ -29,7 +29,7 @@ clean: ### main program compilation and assembly obj/$(APP_NAME).o: src/$(APP_NAME).c - $(CC) -c $(C99FLAGS) -o obj/$(APP_NAME).o $(LGW_INC) src/$(APP_NAME).c $(FLAG_AUX) + $(CROSS_COMPILE)$(CC) -c $(C99FLAGS) -o obj/$(APP_NAME).o $(LGW_INC) src/$(APP_NAME).c $(FLAG_AUX) $(APP_NAME): $(LGW_PATH)/libloragw.a obj/$(APP_NAME).o - $(CC) -o $(APP_NAME) obj/$(APP_NAME).o -L$(LGW_PATH) $(LGW_LNK) + $(CROSS_COMPILE)$(CC) -o $(APP_NAME) obj/$(APP_NAME).o -L$(LGW_PATH) $(LGW_LNK) diff --git a/loragw_tx_test/README b/loragw_tx_test/README new file mode 100644 index 0000000..435b162 --- /dev/null +++ b/loragw_tx_test/README @@ -0,0 +1,72 @@ + / _____) _ | | + ( (____ _____ ____ _| |_ _____ ____| |__ + \____ \| ___ | (_ _) ___ |/ ___) _ \ + _____) ) ____| | | || |_| ____( (___| | | | + (______/|_____)_|_|_| \__)_____)\____)_| |_| + ©2013 Semtech-Cycleo + +Lora Gateway packet sender +=========================== + +1. Introduction +---------------- + +This software is used to send test packets with a Lora concentrator. The packets +contain little information, on no protocol (ie. MAC address) information but +can be used to assess the functionality of a gateway downlink using other +gateways as receivers. + +2. Dependencies +---------------- + +This program is a typical example of Lora Gateway HAL usage for sending packets. + +Only high-level functions are used (the ones contained in loragw_hal) so there +is no hardware dependencies assuming the HAL is matched with the proper version +of the hardware. +Data structures of the sent packets are accessed by name (ie. not at a +binary level) so new functionalities can be added to the API without affecting +that program at all. + +It was tested with v1.0.0 of the libloragw library, and should be compatible +with any later version of the library assuming the API is downward-compatible. + +3. Usage +--------- + +The application runs until the specified number of packets have been sent. +Press Ctrl+C to stop the application before that. + +Use the -f option followed by a real number (decimal point and scientific +'E notation' are OK) to specify the modulation central frequency. + +Use the -s option to specify the Spreading Factor of Lora modulation (values 7 +to 12 are valid). + +Use the -b option to set Lora modulation bandwidth in kHz (accepted values: 125, +250 or 500). + +Use the -p option to set the concentrator TX power in dBm. Not all values are +supported by hardware (typically 14 et 20 dBm are supported, other values might +not give expected power). Check with a RF power meter before connecting any +sensitive equipment. + +Use the -t option to specify the number of milliseconds of pause between +packets. Using zero will result in a quasi-continuous emission. + +Use the -x option to specify how many packets should be sent. + +Use the -i option to invert the Lora modulation polarity. + +The packets are 20 bytes long, and protected by the smallest supported ECC. + +The payload content is: +[T][E][S][T][packet counter MSB][packet counter LSB] followed by ASCII padding. +All Lora data is whitened, so the padding has no influence whatsoever on the +packet error rate. + +4. Changelog +------------- + +2013-10-24, v1 +Initial version. diff --git a/loragw_tx_test/README.TXT b/loragw_tx_test/README.TXT deleted file mode 100644 index 435b162..0000000 --- a/loragw_tx_test/README.TXT +++ /dev/null @@ -1,72 +0,0 @@ - / _____) _ | | - ( (____ _____ ____ _| |_ _____ ____| |__ - \____ \| ___ | (_ _) ___ |/ ___) _ \ - _____) ) ____| | | || |_| ____( (___| | | | - (______/|_____)_|_|_| \__)_____)\____)_| |_| - ©2013 Semtech-Cycleo - -Lora Gateway packet sender -=========================== - -1. Introduction ----------------- - -This software is used to send test packets with a Lora concentrator. The packets -contain little information, on no protocol (ie. MAC address) information but -can be used to assess the functionality of a gateway downlink using other -gateways as receivers. - -2. Dependencies ----------------- - -This program is a typical example of Lora Gateway HAL usage for sending packets. - -Only high-level functions are used (the ones contained in loragw_hal) so there -is no hardware dependencies assuming the HAL is matched with the proper version -of the hardware. -Data structures of the sent packets are accessed by name (ie. not at a -binary level) so new functionalities can be added to the API without affecting -that program at all. - -It was tested with v1.0.0 of the libloragw library, and should be compatible -with any later version of the library assuming the API is downward-compatible. - -3. Usage ---------- - -The application runs until the specified number of packets have been sent. -Press Ctrl+C to stop the application before that. - -Use the -f option followed by a real number (decimal point and scientific -'E notation' are OK) to specify the modulation central frequency. - -Use the -s option to specify the Spreading Factor of Lora modulation (values 7 -to 12 are valid). - -Use the -b option to set Lora modulation bandwidth in kHz (accepted values: 125, -250 or 500). - -Use the -p option to set the concentrator TX power in dBm. Not all values are -supported by hardware (typically 14 et 20 dBm are supported, other values might -not give expected power). Check with a RF power meter before connecting any -sensitive equipment. - -Use the -t option to specify the number of milliseconds of pause between -packets. Using zero will result in a quasi-continuous emission. - -Use the -x option to specify how many packets should be sent. - -Use the -i option to invert the Lora modulation polarity. - -The packets are 20 bytes long, and protected by the smallest supported ECC. - -The payload content is: -[T][E][S][T][packet counter MSB][packet counter LSB] followed by ASCII padding. -All Lora data is whitened, so the padding has no influence whatsoever on the -packet error rate. - -4. Changelog -------------- - -2013-10-24, v1 -Initial version. -- cgit v1.2.3