v4.1.0

* HAL: Reworked "Listen-Before-Talk" feature to have more flexibility to define
LBT channels frequency, and to be able to have spectral scan running in parallel
* HAL: Updated lgw_time_on_air() function for FSK packets
* HAL: Disabled GPS UART input being re-echoed as output to avoid sending wrong
commands to GPS module
* HAL: Fixed IF frequency configuration check issue for channel bandwidths 250K
and 500HKz.
* FPGA: Updated to v33 for new LBT and and v31 for spectral scan.
* util_spectral_scan: updated to match new spectral scan FPGA sequence
* util_lbt_test: updated to match LBT rework

Note: The provided LBT feature has been validated for Japan only, and supports
8 downlink channels maximum.

Author: mcoracin

Makefile

@@ -10,17 +10,17 @@ all:
 	$(MAKE) all -e -C libloragw
 	$(MAKE) all -e -C util_pkt_logger
 	$(MAKE) all -e -C util_spi_stress
-	$(MAKE) all -e -C util_lbt_test
 	$(MAKE) all -e -C util_tx_test
+	$(MAKE) all -e -C util_lbt_test
 	$(MAKE) all -e -C util_tx_continuous
 	$(MAKE) all -e -C util_spectral_scan
 
 clean:
 	$(MAKE) clean -e -C libloragw
 	$(MAKE) clean -e -C util_pkt_logger
 	$(MAKE) clean -e -C util_spi_stress
-	$(MAKE) clean -e -C util_lbt_test
 	$(MAKE) clean -e -C util_tx_test
+	$(MAKE) clean -e -C util_lbt_test
 	$(MAKE) clean -e -C util_tx_continuous
 	$(MAKE) clean -e -C util_spectral_scan
 

VERSION

@@ -1 +1 @@
-4.0.0
+4.1.0

fpga/SX1301_FPGA_125K_NOTCH_LBT_bitmap_v27.bin

@@ -16,13 +16,19 @@ Reference Design board (SX1301AP2-PCB_E336) flash memory.
 
 The different images contain the following features:
 
-* SX1301_FPGA_125K_NOTCH_LBT_bitmap_v27.bin:
-    - 125K Notch filter for TX
-    - Listen-Before-Talk
+* SX1301_FPGA_200K_NOTCH_LBT_SPECTRAL_SCAN_863_v33.hex:
+    - 200KHz Notch filter for TX (not programmable)
+    - Listen-Before-Talk for 863+MHz frequency range
+    - Background Spectral Scan (limited)
 
-* SX1301_FPGA_125K_NOTCH_SPECTRAL_SCAN_bitmap_v27.bin:
-    - 125K Notch filter for TX
-    - Background Spectral Scan
+* SX1301_FPGA_200K_NOTCH_LBT_SPECTRAL_SCAN_915_v33.hex:
+    - 200KHz Notch filter for TX (not programmable)
+    - Listen-Before-Talk for 915+MHz frequency range
+    - Background Spectral Scan (limited)
+
+* SX1301_FPGA_NOTCH_PROG_SPECTRAL_SCAN_v31.hex:
+    - Programmable notch filter for TX
+    - Background Spectral Scan (full)
 
 2. Usage
 --------

fpga/SX1301_FPGA_125K_NOTCH_SPECTRAL_SCAN_bitmap_v27.bin

@@ -31,41 +31,60 @@ Maintainer: Michael Coracin
 #define LGW_REG_SUCCESS 0
 #define LGW_REG_ERROR -1
 
+#define LGW_MIN_NOTCH_FREQ      126000U /* 126 KHz */
+#define LGW_MAX_NOTCH_FREQ      250000U /* 250 KHz */
+#define LGW_DEFAULT_NOTCH_FREQ  129000U /* 129 KHz */
+
 /*
 auto generated register mapping for C code
 this file contains autogenerated C struct used to access the FPGA registers
 this file is autogenerated from registers description
 */
+
 #define LGW_FPGA_SOFT_RESET 0
-#define LGW_FPGA_FPGA_FEATURE 1
-#define LGW_FPGA_VERSION 2
-#define LGW_FPGA_FPGA_STATUS 3
-#define LGW_FPGA_CTRL_FEATURE_START 4
-#define LGW_FPGA_CTRL_RADIO_RESET 5
-#define LGW_FPGA_CTRL_INPUT_SYNC_I 6
-#define LGW_FPGA_CTRL_INPUT_SYNC_Q 7
-#define LGW_FPGA_CTRL_OUTPUT_SYNC 8
-#define LGW_FPGA_CTRL_INVERT_IQ 9
-#define LGW_FPGA_HISTO_RAM_ADDR 10
-#define LGW_FPGA_HISTO_RAM_DATA 11
-#define LGW_FPGA_HISTO_TEMPO 12
-#define LGW_FPGA_HISTO_NB_READ 13
-#define LGW_FPGA_TIMESTAMP 14
-#define LGW_FPGA_LBT_TIMESTAMP_CH 15
-#define LGW_FPGA_LBT_TIMESTAMP_SELECT_CH 16
-#define LGW_FPGA_LBT_TIMESTAMP_NB_CH 17
-#define LGW_FPGA_SPI_MASTER_SPEED_DIVIDER 18
-#define LGW_FPGA_NB_READ_RSSI 19
-#define LGW_FPGA_PLL_LOCK_TIME 20
-#define LGW_FPGA_RSSI_TARGET 21
-#define LGW_FPGA_LSB_START_FREQ 22
-#define LGW_FPGA_SPI_MUX_CTRL 23
-#define LGW_FPGA_TOTALREGS 24
+#define LGW_FPGA_FEATURE 1
+#define LGW_FPGA_LBT_INITIAL_FREQ 2
+#define LGW_FPGA_VERSION 3
+#define LGW_FPGA_STATUS 4
+#define LGW_FPGA_CTRL_FEATURE_START 5
+#define LGW_FPGA_CTRL_RADIO_RESET 6
+#define LGW_FPGA_CTRL_INPUT_SYNC_I 7
+#define LGW_FPGA_CTRL_INPUT_SYNC_Q 8
+#define LGW_FPGA_CTRL_OUTPUT_SYNC 9
+#define LGW_FPGA_CTRL_INVERT_IQ 10
+#define LGW_FPGA_CTRL_ACCESS_HISTO_MEM 11
+#define LGW_FPGA_CTRL_CLEAR_HISTO_MEM 12
+#define LGW_FPGA_HISTO_RAM_ADDR 13
+#define LGW_FPGA_HISTO_RAM_DATA 14
+#define LGW_FPGA_HISTO_NB_READ 15
+#define LGW_FPGA_LBT_TIMESTAMP_CH 16
+#define LGW_FPGA_LBT_TIMESTAMP_SELECT_CH 17
+#define LGW_FPGA_LBT_CH0_FREQ_OFFSET 18
+#define LGW_FPGA_LBT_CH1_FREQ_OFFSET 19
+#define LGW_FPGA_LBT_CH2_FREQ_OFFSET 20
+#define LGW_FPGA_LBT_CH3_FREQ_OFFSET 21
+#define LGW_FPGA_LBT_CH4_FREQ_OFFSET 22
+#define LGW_FPGA_LBT_CH5_FREQ_OFFSET 23
+#define LGW_FPGA_LBT_CH6_FREQ_OFFSET 24
+#define LGW_FPGA_LBT_CH7_FREQ_OFFSET 25
+#define LGW_FPGA_SCAN_FREQ_OFFSET 26
+#define LGW_FPGA_LBT_SCAN_TIME_CH0 27
+#define LGW_FPGA_LBT_SCAN_TIME_CH1 28
+#define LGW_FPGA_LBT_SCAN_TIME_CH2 29
+#define LGW_FPGA_LBT_SCAN_TIME_CH3 30
+#define LGW_FPGA_LBT_SCAN_TIME_CH4 31
+#define LGW_FPGA_LBT_SCAN_TIME_CH5 32
+#define LGW_FPGA_LBT_SCAN_TIME_CH6 33
+#define LGW_FPGA_LBT_SCAN_TIME_CH7 34
+#define LGW_FPGA_RSSI_TARGET 35
+#define LGW_FPGA_HISTO_SCAN_FREQ 36
+#define LGW_FPGA_NOTCH_FREQ_OFFSET 37
+#define LGW_FPGA_TOTALREGS 38
 
 /* -------------------------------------------------------------------------- */
 /* --- PUBLIC FUNCTIONS PROTOTYPES ------------------------------------------ */
 
-int lgw_fpga_configure(void);
+int lgw_fpga_configure(uint32_t tx_notch_freq);
 
 /**
 @brief LoRa concentrator FPGA register write

fpga/SX1301_FPGA_200K_NOTCH_LBT_SPECTRAL_SCAN_863_v33.hex

@@ -60,7 +60,7 @@ Maintainer: Sylvain Miermont
 /* concentrator chipset-specific parameters */
 /* to use array parameters, declare a local const and use 'if_chain' as index */
 #define LGW_IF_CHAIN_NB     10    /* number of IF+modem RX chains */
-#define LGW_PKT_FIFO_SIZE   8    /* depth of the RX packet FIFO */
+#define LGW_PKT_FIFO_SIZE   16    /* depth of the RX packet FIFO */
 #define LGW_DATABUFF_SIZE   1024    /* size in bytes of the RX data buffer (contains payload & metadata) */
 #define LGW_REF_BW          125000    /* typical bandwidth of data channel */
 #define LGW_MULTI_NB        8    /* number of LoRa 'multi SF' chains */
@@ -152,6 +152,9 @@ Maintainer: Sylvain Miermont
 /* Maximum size of Tx gain LUT */
 #define TX_GAIN_LUT_SIZE_MAX 16
 
+/* LBT constants */
+#define LBT_CHANNEL_FREQ_NB 8 /* Number of LBT channels */
+
 /* -------------------------------------------------------------------------- */
 /* --- PUBLIC TYPES --------------------------------------------------------- */
 
@@ -172,34 +175,42 @@ enum lgw_radio_type_e {
 @brief Configuration structure for board specificities
 */
 struct lgw_conf_board_s {
-    bool        lorawan_public; /*!> Enable ONLY for *public* networks using the LoRa MAC protocol */
-    uint8_t     clksrc;         /*!> Index of RF chain which provides clock to concentrator */
+    bool    lorawan_public; /*!> Enable ONLY for *public* networks using the LoRa MAC protocol */
+    uint8_t clksrc;         /*!> Index of RF chain which provides clock to concentrator */
+};
+
+/**
+@struct lgw_conf_lbt_chan_s
+@brief Configuration structure for LBT channels
+*/
+struct lgw_conf_lbt_chan_s {
+    uint32_t freq_hz;
+    uint16_t scan_time_us;
 };
 
 /**
 @struct lgw_conf_lbt_s
 @brief Configuration structure for LBT specificities
 */
 struct lgw_conf_lbt_s {
-    bool        enable;             /*!> enable or disable LBT */
-    uint8_t     rssi_target;        /*!> RSSI threshold to detect if channel is busy or not */
-    uint8_t     nb_channel;         /*!> number of LBT channels */
-    uint16_t    scan_time_us;       /*!> channel activity scan duration, in microseconds */
-    uint32_t    start_freq;         /*!> first LBT channel frequency */
-    uint32_t    tx_delay_1ch_us;    /*!> maximum time allowed to send a packet since channel was free, when TX is on one channel only */
-    uint32_t    tx_delay_2ch_us;    /*!> maximum time allowed to send a packet since channel was free, when TX is on two channels */
+    bool                        enable;             /*!> enable or disable LBT */
+    int8_t                      rssi_target;        /*!> RSSI threshold to detect if channel is busy or not (dBm) */
+    uint8_t                     nb_channel;         /*!> number of LBT channels */
+    struct lgw_conf_lbt_chan_s  channels[LBT_CHANNEL_FREQ_NB];
+    int8_t                      rssi_offset;        /*!> RSSI offset to be applied to SX127x RSSI values */
 };
 
 /**
 @struct lgw_conf_rxrf_s
 @brief Configuration structure for a RF chain
 */
 struct lgw_conf_rxrf_s {
-    bool            enable;         /*!> enable or disable that RF chain */
-    uint32_t        freq_hz;        /*!> center frequency of the radio in Hz */
-    float            rssi_offset;   /*!> Board-specific RSSI correction factor */
-    enum lgw_radio_type_e    type;  /*!> Radio type for that RF chain (SX1255, SX1257....) */
-    bool            tx_enable;      /*!> enable or disable TX on that RF chain */
+    bool                    enable;         /*!> enable or disable that RF chain */
+    uint32_t                freq_hz;        /*!> center frequency of the radio in Hz */
+    float                   rssi_offset;    /*!> Board-specific RSSI correction factor */
+    enum lgw_radio_type_e   type;           /*!> Radio type for that RF chain (SX1255, SX1257....) */
+    bool                    tx_enable;      /*!> enable or disable TX on that RF chain */
+    uint32_t                tx_notch_freq;  /*!> TX notch filter frequency [126KHz..250KHz] */
 };
 
 /**
@@ -385,10 +396,9 @@ const char* lgw_version_info(void);
 /**
 @brief Return time on air of given packet, in milliseconds
 @param packet is a pointer to the packet structure
-@param isBeacon indicates if the packet is a beacon or not
 @return the packet time on air in milliseconds
 */
-uint32_t lgw_time_on_air(struct lgw_pkt_tx_s *packet, bool isBeacon);
+uint32_t lgw_time_on_air(struct lgw_pkt_tx_s *packet);
 
 #endif