This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
wiki:lora:basic_station_forwarder [2024/02/01 14:41] ehe |
wiki:lora:basic_station_forwarder [2024/04/11 12:09] (current) ehe |
||
---|---|---|---|
Line 179: | Line 179: | ||
<note>Only available since [[bspf_v2.4.1|version 2.4]] ( for "Land Mobile Station" use cases, please contact Kerlink support)</note> | <note>Only available since [[bspf_v2.4.1|version 2.4]] ( for "Land Mobile Station" use cases, please contact Kerlink support)</note> | ||
- | By default, LBT is **NOT** activated for AS923-1 region. It needs to be activated manually by using following commands: | + | For LNS which doesn't embed AS923-1 with LBT, it needs to be activated manually by using following commands: |
<code bash> | <code bash> | ||
Line 219: | Line 219: | ||
- | ==== Packet buffering (Beta version) ==== | + | ==== Packet buffering ==== |
- | Packet buffering allows to store all uplink packets not correctly transmitted to LNS server. | + | Packet buffering allows to store uplink packets not transmitted to the LNS server when the link between gateway and server is broken. |
- | Application will then retry periodically to re-connect to LNS Server and as soon as the connection is back, all stored packets will be pushed in FIFO mode (First In, First Out) to respect packets chronology. | + | The application will then retry periodically to re-connect to the LNS Server and as soon as the connection is back, all stored packets will be pushed in FIFO mode (First In, First Out) to respect packets chronology. |
In order to activate it: | In order to activate it: | ||
- Copy ''/user/basic_station/etc/station.conf.example'' to ''/user/basic_station/etc/station.conf'' | - Copy ''/user/basic_station/etc/station.conf.example'' to ''/user/basic_station/etc/station.conf'' | ||
- | - Edit ''/user/basic_station/etc/station.conf'' and locate ''[database]'' section | + | - Edit ''/user/basic_station/etc/station.conf'' and locate the ''[database]'' section |
- Un-comment ''enable = True'' line | - Un-comment ''enable = True'' line | ||
- Save file | - Save file | ||
- Restart application ''/etc/init.d/station restart'' | - Restart application ''/etc/init.d/station restart'' | ||
+ | |||
+ | ==== Local DevAddr Filtering ==== | ||
+ | |||
+ | In the case the LNS does not provide any NetID filter in the router_config message, it is possible to set local filters in order to only forward LoRa uplinks provided by a subset of devices. | ||
+ | |||
+ | To configure this feature, use the '-f' option of the klk_bs_config tool, and provide inclusive and/or exclusive filters to indicate the sets of DevAddr to be kept and/or rejected. | ||
+ | |||
+ | ( see https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:lora:advanced_features#lorawan_frame_filtering for more details about filters values ) | ||
+ | |||
+ | ++++Example:| | ||
+ | |||
+ | <code bash> | ||
+ | klk_bs_config -e -f "24abcdef/7" -f "!24abcdef/12" | ||
+ | </code> | ||
+ | Will configure basic station to forward messages provided by devices with DevAddr between 0x24000000 and 0x249fffff , or between 0x24b00000 and 0x25ffffff . | ||
+ | |||
+ | ++++ | ||
+ | <note info> | ||
+ | The lead "0x" is not required before the base address of the filter. | ||
+ | </note> | ||
==== TTN LNS configuration tool ==== | ==== TTN LNS configuration tool ==== | ||
Line 298: | Line 318: | ||
<note important> | <note important> | ||
''klk_bs_config'' is still required after this to complete the Basic Station configuration. | ''klk_bs_config'' is still required after this to complete the Basic Station configuration. | ||
- | </note> | ||
- | <note warning> | ||
- | The Loriot Basic Station server does not respond to websocket pings. It is therefore advised to disable this functionality when connecting to such a server. | ||
</note> | </note> | ||
Line 307: | Line 324: | ||
# Use Loriot configuration tool in region US902 with 3 channel plans (US915_CH16_23, US915_CH40_47 and US915_CH56_63) | # Use Loriot configuration tool in region US902 with 3 channel plans (US915_CH16_23, US915_CH40_47 and US915_CH56_63) | ||
klk_loriot_config -k ABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJK-321abcdefgh -u https://eu1.loriot.io/1/nwk -n ABCD1234 -r US902-928 -p 3,6,8 | klk_loriot_config -k ABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJK-321abcdefgh -u https://eu1.loriot.io/1/nwk -n ABCD1234 -r US902-928 -p 3,6,8 | ||
- | # Disable websocket pings | ||
- | klk_bs_config --enable --ping_interval None | ||
</code> | </code> | ||
++++ | ++++ | ||
Line 406: | Line 421: | ||
+ | ++++ | ||
+ | ==== Actility LNS configuration tool ==== | ||
+ | |||
+ | To ease declaration of a gateway on the Actility LNS, use the ''klk_actility_config'' tool. | ||
+ | This tool creates the gateway on the server and installs the resulting LNS credentials on the gateway. | ||
+ | |||
+ | To use this tool, you need: | ||
+ | * an API Client ID and its secret | ||
+ | * the API server URL | ||
+ | * the actility LoRaWAN region ID ( see https://oss-api.thingpark.com/tpe/7.3/Things-Management/network-manager/documentation-network-manager.html#/rf-regions ) | ||
+ | <note important> | ||
+ | ''klk_bs_config'' is still required after this to complete the Basic Station configuration. | ||
+ | </note> | ||
+ | |||
+ | ++++Example:| | ||
+ | <code bash> | ||
+ | # Use Actility configuration tool in region EU868 on 8 channels | ||
+ | klk_actility_config -i sub-123456789/test -s Abcdef1234567890Ghijklm987654321 -u https://community.thingpark.io -r EU868_8channels.448 | ||
+ | </code> | ||
+ | ++++ | ||
+ | <note> | ||
+ | The ''klk_actility_config'' tool has been designed to be called from a [[wiki:systeme_mana:ztp|Zero Touch Provisioning]] job. | ||
+ | </note> | ||
+ | |||
+ | ++++How to generate an ACTILITY API key?| | ||
+ | |||
+ | [[https://community.thingpark.org/index.php/build-your-first-end-to-end-use-case/|ACTILITY- Access ThingPark Community Platform]] | ||
++++ | ++++ | ||
==== Gateway name customization option ==== | ==== Gateway name customization option ==== |