Wiki source code of Change Gateway Power
Version 18.1 by Kilight Cao on 2022/06/23 14:58
Show last authors
author | version | line-number | content |
---|---|---|---|
1 | = Overview: = | ||
2 | |||
3 | In LoRaWAN protocol, the gateway transmit packet uses the output power base on the Power Index from the LoRaWAN server downlink. for example, the LoRaWAN server sends a downlink with this info "rf_power=14", gateway got this info and it will search the index for rf_power=14 and use the related rf setting to set output power. In some cases, the LoRaWAN server might set the rf-power to a quite low value ( for example 0dB) which is not practical for use. In such a case, the User can manually change the rf_power=0's rf settings to a higher power out. Below are the methods. | ||
4 | |||
5 | |||
6 | = Change Power for Semtech UDP Paket forward connection = | ||
7 | |||
8 | ---- | ||
9 | |||
10 | In LoRaWAN protocol, the gateway output power refers to the downstream packets sent by Gateway. This output power is controlled by the LoRaWAN server. | ||
11 | |||
12 | Gateway maintains a power index in the file: /etc/lora/global_conf.json for example: | ||
13 | |||
14 | |||
15 | (% class="box" %) | ||
16 | ((( | ||
17 | "tx_lut_3": { | ||
18 | "desc": "TX gain table, index 3", ~/~/ Index 3 refer to rf_power: 15dB. device will set the pa_gain,mix_gain,dig_gain | ||
19 | "pa_gain": 2, ~/~/ to the value mentioned here so to generate 15dB output power. | ||
20 | "mix_gain": 10, | ||
21 | "rf_power": 15, | ||
22 | "dig_gain": 1 | ||
23 | }, | ||
24 | "tx_lut_4": { | ||
25 | "desc": "TX gain table, index 4", | ||
26 | "pa_gain": 2, | ||
27 | "mix_gain": 10, | ||
28 | "rf_power": 16, | ||
29 | "dig_gain": 0 | ||
30 | ))) | ||
31 | |||
32 | (% class="mark" %)Note: If when lorawan server specifies a rf_power that is not listed above. gateway will choose the closest power. profile. | ||
33 | |||
34 | |||
35 | When the LoRaWAN server sends a downlink stream, the server will also ask the gateway to use rf_power as output. So users don't need to consider controlling on the gateway side. | ||
36 | |||
37 | If users want to always use a higher power or a lower power. Users can modify the pa_gain,mix_gain, and dig_gain to specify rf_power to achieve this purpose. This is not recommended, because this might break the regulator for a specific country. | ||
38 | |||
39 | Please note, that the global_conf.json file will be overwritten by the match region files in /etc/lora/cfg-30x when changing settings on the web. So the user needs to change the files in /etc/lora/cfg-cfg-30x instead of global_conf.json | ||
40 | |||
41 | |||
42 | = Change Power for LoRaWAN Basic Station connection = | ||
43 | |||
44 | ---- | ||
45 | |||
46 | First, you need to find out what is the chip module of the gateway? | ||
47 | |||
48 | (% class="box infomessage" %) | ||
49 | ((( | ||
50 | cat /var/iot/chip | ||
51 | ))) | ||
52 | |||
53 | [[image:image-20220623140335-1.png||height="241" width="378"]] | ||
54 | |||
55 | Gateways using the SX1301 LoRaWAN Concentrator are the [[LG308>>https://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LG308-LG301/&file=Datasheet_LG308_LoRaWAN_Gateway.pdf]] and [[DLOS8>>https://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/DLOS8/&file=DLOS8_LoRaWAN_Gateway_User_Manual_v1.3.pdf]]. | ||
56 | |||
57 | |||
58 | **SX1301 Change Power for LoRaWAN Basic Station Connection example:** | ||
59 | |||
60 | Gateway maintains a power index in the file: /etc/station/station-sx1301.conf | ||
61 | |||
62 | (% class="box" %) | ||
63 | ((( | ||
64 | { | ||
65 | /* If slave-X.conf present this acts as default settings */ | ||
66 | "SX1301_conf": { /* Actual channel plan is controlled by server */ | ||
67 | "lorawan_public": true, /* is default */ | ||
68 | "clksrc": 1, /* radio_1 provides clock to concentrator */ | ||
69 | /* path to the SPI device, un-comment if not specified on the command line e.g., RADIODEV=/dev/spidev0.0 */ | ||
70 | "device": "/dev/spidev1.0", | ||
71 | /* freq/enable provided by LNS - only HW specific settings listed here */ | ||
72 | |||
73 | ~|<~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-(% style="color:red" %)Add parameters:"tx_gain_lut" : [ TX_GAIN_LUT, .. ] | ||
74 | |||
75 | "radio_0": { | ||
76 | "type": "SX1257", | ||
77 | "rssi_offset": -166.0, | ||
78 | "tx_enable": true, | ||
79 | "antenna_gain": 0 | ||
80 | }, | ||
81 | "radio_1": { | ||
82 | "type": "SX1257", | ||
83 | "rssi_offset": -166.0, | ||
84 | "tx_enable": false | ||
85 | } | ||
86 | /* chan_multiSF_X, chan_Lora_std, chan_FSK provided by LNS */ | ||
87 | }, | ||
88 | ))) | ||
89 | |||
90 | Add parameters:**"tx_gain_lut": [ TX_GAIN_LUT, .. ]** | ||
91 | |||
92 | (% class="box" %) | ||
93 | ((( | ||
94 | { | ||
95 | /* If slave-X.conf present this acts as default settings */ | ||
96 | "SX1301_conf": { /* Actual channel plan is controlled by server */ | ||
97 | "lorawan_public": true, /* is default */ | ||
98 | "clksrc": 1, /* radio_1 provides clock to concentrator */ | ||
99 | /* path to the SPI device, un-comment if not specified on the command line e.g., RADIODEV=/dev/spidev0.0 */ | ||
100 | "device": "/dev/spidev1.0", | ||
101 | /* freq/enable provided by LNS - only HW specific settings listed here */ | ||
102 | "tx_gain_lut":[ | ||
103 | {"rf_power": 12, "pa_gain": 2, "mix_gain": 11, "dig_gain": 2, "dac_gain": 3}, | ||
104 | {"rf_power": 13, "pa_gain": 2, "mix_gain": 10, "dig_gain": 0, "dac_gain": 3}, | ||
105 | {"rf_power": 14, "pa_gain": 2, "mix_gain": 12, "dig_gain": 2, "dac_gain": 3}, | ||
106 | {"rf_power": 15, "pa_gain": 2, "mix_gain": 13, "dig_gain": 2, "dac_gain": 3}, | ||
107 | |||
108 | /* Index 3 refer to rf_power: 15dB. device will set the pa_gain,mix_gain,dig_gain */ | ||
109 | |||
110 | /* to the value mentioned here so as to generate 15dB output power.*/ | ||
111 | {"rf_power": 16, "pa_gain": 2, "mix_gain": 13, "dig_gain": 1, "dac_gain": 3}, | ||
112 | {"rf_power": 17, "pa_gain": 2, "mix_gain": 14, "dig_gain": 1, "dac_gain": 3}, | ||
113 | {"rf_power": 18, "pa_gain": 2, "mix_gain": 15, "dig_gain": 2, "dac_gain": 3}, | ||
114 | {"rf_power": 19, "pa_gain": 2, "mix_gain": 15, "dig_gain": 1, "dac_gain": 3}, | ||
115 | {"rf_power": 20, "pa_gain": 2, "mix_gain": 15, "dig_gain": 1, "dac_gain": 3}, | ||
116 | {"rf_power": 21, "pa_gain": 3, "mix_gain": 9, "dig_gain": 0, "dac_gain": 3}, | ||
117 | {"rf_power": 22, "pa_gain": 3, "mix_gain": 10, "dig_gain": 0, "dac_gain": 3}, | ||
118 | {"rf_power": 23, "pa_gain": 3, "mix_gain": 11, "dig_gain": 1, "dac_gain": 3}, | ||
119 | {"rf_power": 24, "pa_gain": 3, "mix_gain": 12, "dig_gain": 0, "dac_gain": 3}, | ||
120 | {"rf_power": 25, "pa_gain": 3, "mix_gain": 14, "dig_gain": 0, "dac_gain": 3}, | ||
121 | {"rf_power": 26, "pa_gain": 3, "mix_gain": 14, "dig_gain": 0, "dac_gain": 3}, | ||
122 | {"rf_power": 27, "pa_gain": 3, "mix_gain": 14, "dig_gain": 0, "dac_gain": 3} | ||
123 | ], | ||
124 | "radio_0": { | ||
125 | "type": "SX1257", | ||
126 | "rssi_offset": -166.0, | ||
127 | "tx_enable": true, | ||
128 | "antenna_gain": 0 | ||
129 | }, | ||
130 | "radio_1": { | ||
131 | "type": "SX1257", | ||
132 | "rssi_offset": -166.0, | ||
133 | "tx_enable": false | ||
134 | } | ||
135 | /* chan_multiSF_X, chan_Lora_std, chan_FSK provided by LNS */ | ||
136 | }, | ||
137 | ))) | ||
138 | |||
139 | See this link for more station configuration parameters:[[Concentrator Design (v1.5) - LoRa Basics™ StationLoRa Basics™ Station ~| DEVELOPER PORTAL (semtech.com)>>url:https://lora-developers.semtech.com/build/software/lora-basics/lora-basics-for-gateways/?url=gw_v1.5.html]] | ||
140 | |||
141 | If users want to always use a higher power or a lower power. Users can modify the pa_gain,mix_gain, and dig_gain to specify rf_power to achieve this purpose. This is not recommended, because this might break the regulator for a specific country. | ||
142 | |||
143 | (% style="color:red" %)Note: When the Settings are complete, click "Save&Apply" on the gateway's Web UI | ||
144 | |||
145 | === **Checking station Logs** === | ||
146 | |||
147 | Run the command: | ||
148 | |||
149 | (% class="box infomessage" %) | ||
150 | ((( | ||
151 | tail -f /var/iot/station.log | ||
152 | ))) | ||
153 | |||
154 | [[image:image-20220623145437-2.png||height="501" width="694"]] | ||
155 | |||
156 |