Differences

This shows you the differences between two versions of the page.

--- wiki:lora:cpf_1.1.x:cpf_1.1.6:installation [2019/12/10 18:16]
mch
+++ wiki:lora:cpf_1.1.x:cpf_1.1.6:installation [2021/07/08 12:14] (current)
ehe [gateway EUI]
@@ Line 4: / Line 4: @@
 ===== How to install the Common Packet Forwarder? =====
-  - Choose the packet forwarder to install from the [[wiki:resources:resources#common_packet_forwarder|Wirnet products resource page]]. Choosing the latest version of the packet forwarder is recommended.
+  - Choose the packet forwarder to install from the [[wiki:resources:resources#packet_forwarder|Wirnet products resource page]]. Choosing the latest version of the packet forwarder is recommended.
   - Download the //"lorad"// and //"lorafwd"// ''.ipk'' packages files.
   - Install the ''.ipk'' files using the instructions of the [[wiki:keros_custo:sw_updates|software updates page]]. Packages can be installed simultaneously.
@@ Line 62: / Line 62: @@
     │   │   │   ├── RU864-RU_8CH_Legacy.json # ...
     │   │   │   └── US915-US_8CH.json        # ...
-    │   │   ├── wiis
+    │   │   └── wiis
-    │   │   │   ├── AS923-JP_8CH.json        # Frequency plan template
-    │   │   │   ├── AU915-AU_8CH.json        # ...
-    │   │   │   ├── EU868-FR_8CH.json        # ...
-    │   │   │   ├── IN865-IN_8CH.json        # ...
-    │   │   │   ├── RU864-RU_8CH.json        # ...
-    │   │   │   ├── RU864-RU_8CH_Legacy.json # ...
-    │   │   │   └── US915-US_8CH.json        # ...
-    │   │   └── fevo
     │   │       ├── AS923-JP_8CH.json        # Frequency plan template
     │   │       ├── AU915-AU_8CH.json        # ...
@@ Line 84: / Line 76: @@
     │   ├── lorad-wifc # lorad binary for iFemtoCell
     │   ├── lorad-wiis # lorad binary for iStation
-    │   ├── lorad-fevo # lorad binary for iFemtoCell-Evolution
     │   ├── lorafwd    # lorafwd binary
     │   ├── lorafwdctl
@@ Line 109: / Line 100: @@
   * Edit the template you copied to adapt it to your needs. Since the hardware of Wirnet iBTS and Wirnet iFemtoCell gateways is different, the configuration on each gateway differs (although it is quite similar).
-++++ Wirnet iFemtoCells and Wirnet iStation|
+++++ Wirnet iBTS|
-The Wirnet iFemtoCells and Wirnet iStation cannot listen to all LoRa frequencies simultaneously. Up to 8 frequencies can be handled at the same time by the demodulator (SX1301).\\
+Wirnet iBTS gateways cannot listen to all LoRa frequencies simultaneously. Up to 16 frequencies can be handled at the same time per LoRa board. There can be up to 4 LoRa boards in an iBTS.\\
 \\
-To understand how the frequency configuration works, it is necessary to know that the Wirnet iFemtoCells and Wirnet iStation hardware contain an RF front-ends connected to 2 SX1257 chips. A look at the [[wiki:lora:features#lora_specific_hardware|]] may help to understand. Each of these chips has a 0.8 MHz Bandwidth. Thus, all 8 channels must be contained within these two 0.8 MHz intervals.\\
+**Templates structure**\\
+Each template contains an object and an array:
+  * ''SX1301_array_conf'' is an array that contains the configuration of each LoRa board.\\
+  * ''gateway_conf'' is an object that contains the class B configuration.\\
+<code>
+{
+  "SX1301_array_conf": [
+      {...}, # LoRa board 1
+      {...}, # LoRa board 2
+       ...
+  ],
+  "gateway_conf":{
+      ...    # Class B configuration
+  }
+}
+</code>
+\\
+There are many configuration fields among the templates, but most of them are by default correctly filled.\\
+\\
+**Antennas configuration**\\
+The front-end board of each LoRa board integrates two duplicated TX and Rx paths (RF1 path and RF2 path). Each TX/RX path is connected to one SMB antenna port, referenced as RF1 and RF2 (Installation manual 1.5.4.4 Front-end boards). A look at the [[wiki:lora:features#lora_specific_hardware|]] may help to understand.\\
+To understand every possible antenna configurations, read chapter 4.6.2.5 of the Installation manual.
+  * ''rx_enable'': Is used to enable or disable emission of the antennas.
+  * ''tx_enable'': Is used to enable or disable reception of the antennas.
+  * ''antenna_gain'': Is used to define the gain of the antenna. This field has to be correctly filled, otherwise, the gateway will use more power to emits packets than what was initially planned by the LNS.
+  * ''insertion_loss'': Is used to define the attenuation due to the cable between the gateway and the antenna.
+__Single antenna configuration:__
+<code>
+"rf_chain_conf": [
+  {
+    "rx_enable": true,
+    "tx_enable": true,
+    "antenna_gain": 3,
+    "insertion_loss": 0.5,
+    "tx_freq_min": 863000000,
+    "tx_freq_max": 870000000
+  }
+],
+</code>
+__Dual antenna configuration:__
+<code>
+"rf_chain_conf": [
+  {
+    "rx_enable": true,
+    "tx_enable": true,
+    "antenna_gain": 3,
+    "insertion_loss": 0.5,
+    "tx_freq_min": 863000000,
+    "tx_freq_max": 870000000
+  },
+  {
+    "rx_enable": true,
+    "tx_enable": true,
+    "antenna_gain": 3,
+    "insertion_loss": 0.5,
+    "tx_freq_min": 863000000,
+    "tx_freq_max": 870000000
+  }
+],
+</code>
+**Radio Frequencies configurations**\\
+\\
+Each LoRaLoc module contains two SX1301. Each SX1301 can be configured to use 10 different frequencies. However, these channels need to be contained within a 3 MHz bandwidth.
+  * ''chip_center_freq'': Is used to define the center frequency of the SX1301. All 10 channels will be around this particular frequency (+/- 1.5 MHz).
+  * ''chan_rx_freq'': Are used to define each channel's center frequency. In order to respect SX1301 bandwidth, maximum values are defined by ''chip_center_freq'' +/- 1.4 MHz.
+  * ''chip_rf_chain'': Defines which rf chain is used by the SX1301. See antenna configuration for more details.
+<code>
+"SX1301_conf":[
+ {
+    "chip_rf_chain": 0,
+    "chip_center_freq": 866000000,
+    "chan_multiSF_0": { "chan_rx_freq": 865500000, "spread_factor": "7-12" },
+    "chan_multiSF_1": { "chan_rx_freq": 865700000, "spread_factor": "7-12" },
+    "chan_multiSF_2": { "chan_rx_freq": 865900000, "spread_factor": "7-12" },
+    "chan_multiSF_3": { "chan_rx_freq": 866100000, "spread_factor": "7-12" },
+    "chan_multiSF_4": { "chan_rx_freq": 866300000, "spread_factor": "7-12" },
+    "chan_multiSF_5": { "chan_rx_freq": 866500000, "spread_factor": "7-12" },
+    "chan_multiSF_6": { "chan_rx_freq": 867100000, "spread_factor": "7-12" },
+    "chan_multiSF_7": { "chan_rx_freq": 867300000, "spread_factor": "7-12" },
+    "chan_LoRa_std" : { "chan_rx_freq": 867300000, "bandwidth": 250000, "spread_factor": 7 },
+    "chan_FSK"      : { "chan_rx_freq": 866900000, "bandwidth": 125000, "bit_rate": 50000 }
+ },{
+    "chip_rf_chain": 1,
+    "chip_center_freq": 868000000,
+    "chan_multiSF_0": { "chan_rx_freq": 867500000, "spread_factor": "7-12" },
+    "chan_multiSF_1": { "chan_rx_freq": 867700000, "spread_factor": "7-12" },
+    "chan_multiSF_2": { "chan_rx_freq": 867900000, "spread_factor": "7-12" },
+    "chan_multiSF_3": { "chan_rx_freq": 868100000, "spread_factor": "7-12" },
+    "chan_multiSF_4": { "chan_rx_freq": 868300000, "spread_factor": "7-12" },
+    "chan_multiSF_5": { "chan_rx_freq": 868500000, "spread_factor": "7-12" },
+    "chan_multiSF_6": { "chan_rx_freq": 868700000, "spread_factor": "7-12" },
+    "chan_multiSF_7": { "chan_rx_freq": 868900000, "spread_factor": "7-12" },
+    "chan_LoRa_std" : { "chan_rx_freq": 868300000, "bandwidth": 250000, "spread_factor": 7 },
+    "chan_FSK"      : { "chan_rx_freq": 869100000, "bandwidth": 125000, "bit_rate": 50000 }
+}],
+</code>
+\\
+**Listen Before Talk configuration**\\
+\\
+Listen Before Talk (LBT) is a technique used in radiocommunications whereby a radio transmitter first senses its radio environment before starting a transmission.\\
+\\
+This feature is mandatory in a few countries (such as Japan and Korea).
+  * ''enable'': Enable or disable LBT.
+  * ''rssi_target'': The RSSI threshold to detect if channels are busy or not (dBm).
+  * ''chan_cfg'':
+    * ''freq_hz'': The LBT channel frequency in Hz. These frequencies needs to be the same as the one in the ''SX1301_conf'' array.
+    * ''scan_time_us'': The LBT channel scan time to be used (only two available values: 128µs or 5ms).
+    * ''transmit_time_ms'': Maximum transmission delay allowed (only two available values: 4000ms or 400ms).
+<code>
+"lbt_conf":{
+	"enable": true,
+	"rssi_target": -80,
+	"chan_cfg":[
+		{ "freq_hz": 922000000, "scan_time_us": 5000, "transmit_time_ms": 4000 },
+		{ "freq_hz": 922200000, "scan_time_us": 5000, "transmit_time_ms": 4000 },
+		{ "freq_hz": 922400000, "scan_time_us": 5000, "transmit_time_ms": 400 },
+		{ "freq_hz": 922600000, "scan_time_us": 5000, "transmit_time_ms": 400 },
+		{ "freq_hz": 922800000, "scan_time_us": 5000, "transmit_time_ms": 400 },
+		{ "freq_hz": 923000000, "scan_time_us": 5000, "transmit_time_ms": 400 },
+		{ "freq_hz": 923200000, "scan_time_us": 5000, "transmit_time_ms": 400 },
+		{ "freq_hz": 923400000, "scan_time_us": 150008, "transmit_time_ms": 400 }
+	]
+},
+</code>
+++++
+++++ Wirnet iFemtoCell and Wirnet iStation|
+<note important>Note that the class-B configuration does not apply to such gateways (Wirnet iFemtocell and Wirnet iStation) since they have no GPS.</note>
+The Wirnet iFemtoCell and Wirnet iStation cannot listen to all LoRa frequencies simultaneously. Up to 8 frequencies can be handled at the same time by the demodulator (SX1301).\\
+\\
+To understand how the frequency configuration works, it is necessary to know that the Wirnet iFemtoCell and Wirnet iStation hardware contain an RF front-ends connected to 2 SX1257 chips. A look at the [[wiki:lora:features#lora_specific_hardware|]] may help to understand. Each of these chips has a 0.8 MHz Bandwidth. Thus, all 8 channels must be contained within these two 0.8 MHz intervals.\\
 \\
 To properly configure the Rx channels, the center frequencies of the chips must be defined.
@@ Line 259: / Line 398: @@
-==== gateway EUI ====
-Gateway EUI is used by LNS to identify from which gateway messages come from.
-By default, EUI are generated this way:
-  * Wirnet iBTS: 7276FF002E<last 6 characters of the CPU serial number>
-  * Wirnet iFemtoCell: 7276FF00<last 8 characters of the CPU board serial number>
-  * Wirnet iStation: 7076FF00<last 8 characters of the CPU board serial number>
-  * Wirnet iFemtoCell-Evolution: 7076FF00<last 8 characters of the CPU board serial number>
-When lorafwd starts, a file containing the default EUI is generated.
-<code bash>
-cat /var/run/lora/gateway-id.toml
-gateway.id = 0x7076FF0064050789
-</code>
-If a new EUI has been defined under ''/user/etc/lorafwd'', then, this new EUI is used by lorafwd. Otherwise, the default EUI is used.
-++++

Wirnet™ i-series

User Tools

Site Tools

Differences

Page Tools