summaryrefslogtreecommitdiff
path: root/loragw_spi_stress/README
diff options
context:
space:
mode:
authorSylvain Miermont <smiermont@semtech.com>2013-12-12 15:31:52 +0100
committerSylvain Miermont <smiermont@semtech.com>2013-12-12 15:31:52 +0100
commitb665027754e4a050b5c3ea2da999dce8bf3ab710 (patch)
treed028dbe74bb59bd5d5e7a96c7ac2d550927310e1 /loragw_spi_stress/README
parent0d3fcabc3616d95f9fbeeb367087926dcdb32ca1 (diff)
downloadlora_gateway-b665027754e4a050b5c3ea2da999dce8bf3ab710.tar.gz
lora_gateway-b665027754e4a050b5c3ea2da999dce8bf3ab710.tar.bz2
lora_gateway-b665027754e4a050b5c3ea2da999dce8bf3ab710.zip
v1.1.1v1.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
Diffstat (limited to 'loragw_spi_stress/README')
-rw-r--r--loragw_spi_stress/README68
1 files changed, 68 insertions, 0 deletions
diff --git a/loragw_spi_stress/README b/loragw_spi_stress/README
new file mode 100644
index 0000000..98c4f40
--- /dev/null
+++ b/loragw_spi_stress/README
@@ -0,0 +1,68 @@
+ / _____) _ | |
+ ( (____ _____ ____ _| |_ _____ ____| |__
+ \____ \| ___ | (_ _) ___ |/ ___) _ \
+ _____) ) ____| | | || |_| ____( (___| | | |
+ (______/|_____)_|_|_| \__)_____)\____)_| |_|
+ ©2013 Semtech-Cycleo
+
+Lora Gateway SPI stress test
+=============================
+
+1. Introduction
+----------------
+
+This software is used to check the reliability of the link between the host
+platform (on which the program is run) and the Lora concentrator register file
+that is the interface through which all interaction with the Lora concentrator
+happens.
+
+2. Dependencies
+----------------
+
+This program only access the Lora gateway HAL library through its loragw_reg
+"named registers" access sub-module.
+
+It was tested with v1.0.0 of the libloragw library, and should be compatible
+with any later version of the library and the hardware, assuming the registers
+used for the tests are still present.
+
+The registers used are:
+ * LGW_VERSION
+ * LGW_IMPLICIT_PAYLOAD_LENGHT
+ * LGW_FSK_REF_PATTERN_LSB
+ * LGW_RX_DATA_BUF_ADDR
+ * LGW_RX_DATA_BUF_DATA
+
+A data buffer accessible through the 2 registers above must be implemented.
+
+3. Usage
+---------
+
+The tests run forever or until an error is detected.
+Press Ctrl+C to stop the application.
+
+When an error is detected, diagnosis information are displayed. Please refer to
+the source code for more details on what is displayed for diagnosis.
+
+All tests use pseudo-random data generated by the rand() function. The random
+generator is not seeded, and the same sequence of data will be use each time the
+program is launched.
+
+Basically, some random data is written, read back and then compared to the
+initial written data. Some "useless" read on others registers might be inserted
+to be sure that the data read back is coming from the hardware, and not from the
+internal buffer(s) of the software driver(s).
+
+Test 1 > R/W on a simple 8-bit register
+
+Test 2 > R/W on a simple 8-bit register with interstitial reads on VERSION
+
+Test 3 > R/W on a 32-bit register (short SPI bursts access)
+
+Test 4 > data buffer R/W (long SPI bursts access)
+
+4. Changelog
+-------------
+
+2013-10-24, v1
+Initial version.