{"id":9039,"date":"2026-11-19T12:16:00","date_gmt":"2026-11-19T12:16:00","guid":{"rendered":"https:\/\/lora.vsb.cz\/?p=9039"},"modified":"2026-11-20T08:33:20","modified_gmt":"2026-11-20T08:33:20","slug":"lora-169-gateway-installation-and-operation-guide","status":"publish","type":"page","link":"https:\/\/lora.vsb.cz\/index.php\/lora-169-gateway-installation-and-operation-guide\/","title":{"rendered":"LoRa-169 Gateway \u2013 Installation and Operation Guide"},"content":{"rendered":"<table style=\"height: 66px;\" width=\"356\">\n<tbody>\n<tr>\n<td style=\"text-align: left; min-width: 100px;\" width=\"10%\"><strong>Frequency:<\/strong><\/td>\n<td>Europe 169,4\u2013169,475 MHz<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left; min-width: 100px;\" width=\"10%\"><strong>Duty Cycle:<\/strong><\/td>\n<td>1 %<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left; min-width: 100px;\" width=\"10%\"><strong>Using Docker:<\/strong><\/td>\n<td>Yes<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left; min-width: 100px;\" width=\"10%\"><strong>Last updated:<\/strong><\/td>\n<td>Sep 20, 2026<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-medium wp-image-9378 aligncenter\" src=\"http:\/\/lora.vsb.cz\/wp-content\/uploads\/2026\/11\/gateway-3d-top-300x204.png\" alt=\"\" width=\"300\" height=\"204\" srcset=\"https:\/\/lora.vsb.cz\/wp-content\/uploads\/2026\/11\/gateway-3d-top-300x204.png 300w, https:\/\/lora.vsb.cz\/wp-content\/uploads\/2026\/11\/gateway-3d-top-1024x695.png 1024w, https:\/\/lora.vsb.cz\/wp-content\/uploads\/2026\/11\/gateway-3d-top-768x521.png 768w, https:\/\/lora.vsb.cz\/wp-content\/uploads\/2026\/11\/gateway-3d-top-1536x1042.png 1536w, https:\/\/lora.vsb.cz\/wp-content\/uploads\/2026\/11\/gateway-3d-top.png 1568w\" sizes=\"auto, (max-width: 300px) 100vw, 300px\" \/><\/p>\n<p>This guide describes the setup and configuration of the <strong>LoRa-169 Gateway<\/strong> based on the open-source project <a href=\"https:\/\/github.com\/lysek01\/LoRa-169\" target=\"_blank\" rel=\"noopener\">LoRa-169<\/a>.<br \/>\nIt explains hardware wiring, software installation, configuration via MQTT, and troubleshooting tips.<\/p>\n<hr \/>\n<h2>Requirements<\/h2>\n<ul>\n<li><strong>Hardware:<\/strong> Raspberry Pi 3 or 4, SX127x LoRa module (169 MHz version)<\/li>\n<li><strong>Interfaces:<\/strong> SPI enabled, GPIO pins for CS, Reset, and DIO0<\/li>\n<li><strong>Operating system:<\/strong> Debian \/ Ubuntu based (Raspberry Pi OS recommended)<\/li>\n<li><strong>Software:<\/strong> Python 3.7+, MQTT broker (e.g. Mosquitto)<\/li>\n<li><strong>Network:<\/strong> Internet or local network connection<\/li>\n<\/ul>\n<hr \/>\n<h2>Hardware Wiring<\/h2>\n<p>Connect the LoRa module to the Raspberry Pi as follows:<\/p>\n<ul>\n<li>SPI Bus 0, CS 0<\/li>\n<li>GPIO 25 \u2013 Reset<\/li>\n<li>GPIO 5 \u2013 DIO0 interrupt pin<\/li>\n<\/ul>\n<p>Use an antenna suitable for the 169 MHz band. Ensure proper grounding, shielding, and filtering for stable RF performance.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\" wp-image-9379 aligncenter\" src=\"http:\/\/lora.vsb.cz\/wp-content\/uploads\/2026\/11\/gateway-schematic-300x208.png\" alt=\"\" width=\"1126\" height=\"781\" srcset=\"https:\/\/lora.vsb.cz\/wp-content\/uploads\/2026\/11\/gateway-schematic-300x208.png 300w, https:\/\/lora.vsb.cz\/wp-content\/uploads\/2026\/11\/gateway-schematic-1024x711.png 1024w, https:\/\/lora.vsb.cz\/wp-content\/uploads\/2026\/11\/gateway-schematic-768x533.png 768w, https:\/\/lora.vsb.cz\/wp-content\/uploads\/2026\/11\/gateway-schematic-1536x1066.png 1536w, https:\/\/lora.vsb.cz\/wp-content\/uploads\/2026\/11\/gateway-schematic-2048x1422.png 2048w\" sizes=\"auto, (max-width: 1126px) 100vw, 1126px\" \/><\/p>\n<hr \/>\n<h2>Software Installation<\/h2>\n<ol>\n<li>Clone the repository:\n<pre><code>git clone https:\/\/github.com\/lysek01\/LoRa-169.git<\/code><\/pre>\n<\/li>\n<li>Enter the project directory:\n<pre><code>cd LoRa-169\/gateway<\/code><\/pre>\n<\/li>\n<li>Run the installation script:\n<pre><code>sudo bash install.sh<\/code><\/pre>\n<p>This script will install all dependencies (Python3, venv, git), create a virtual environment, install packages, and register systemd services.<\/li>\n<li>Enable and start the services:\n<pre><code>sudo systemctl enable loravsb-gateway\r\nsudo systemctl start loravsb-gateway<\/code><\/pre>\n<\/li>\n<li>Check service status:\n<pre><code>sudo systemctl status loravsb-gateway\r\nsudo journalctl -u loravsb-gateway -f<\/code><\/pre>\n<\/li>\n<\/ol>\n<hr \/>\n<h2>Configuration<\/h2>\n<p>The <code>config.json<\/code> file contains LoRa radio parameters such as:<\/p>\n<ul>\n<li><code>frequency<\/code> (e.g. 169.4375 MHz)<\/li>\n<li><code>spreading_factor<\/code>, <code>bandwidth<\/code>, <code>coding_rate<\/code><\/li>\n<li><code>ldro_enable<\/code>, <code>preamble_length<\/code>, <code>sync_word<\/code>, <code>crc_enable<\/code><\/li>\n<li><code>tx_power<\/code>, <code>rx_gain<\/code><\/li>\n<\/ul>\n<h3>MQTT Configuration Topics<\/h3>\n<ul>\n<li><code>loravsb\/169\/config\/get<\/code> \u2013 request current configuration<\/li>\n<li><code>loravsb\/169\/config\/set<\/code> \u2013 set new parameters (JSON payload)<\/li>\n<li><code>loravsb\/169\/config\/ack<\/code> \u2013 acknowledgment message<\/li>\n<\/ul>\n<p>Example MQTT message to update configuration:<\/p>\n<pre><code>mosquitto_pub -h &lt;broker&gt; -t loravsb\/169\/config\/set -m '{\"frequency\":169437500,\"tx_power\":17}'<\/code><\/pre>\n<hr \/>\n<h2>Usage Examples<\/h2>\n<h3>Receiving packets<\/h3>\n<pre><code>mosquitto_sub -h &lt;broker&gt; -t loravsb\/169\/rx<\/code><\/pre>\n<h3>Transmitting packets<\/h3>\n<p>Send a hexadecimal payload:<\/p>\n<pre><code>mosquitto_pub -h &lt;broker&gt; -t loravsb\/169\/tx\/hex -m \"48656C6C6F\"<\/code><\/pre>\n<p>Send an ASCII message:<\/p>\n<pre><code>mosquitto_pub -h &lt;broker&gt; -t loravsb\/169\/tx\/ascii -m \"Hello\"<\/code><\/pre>\n<p><strong>Example applications:<\/strong> sensor networks, telemetry, experimental radio links, or university IoT projects.<\/p>\n<hr \/>\n<h2>Troubleshooting<\/h2>\n<ul>\n<li><strong>Gateway does not start:<\/strong> SPI not enabled, incorrect GPIO mapping, missing dependencies.<\/li>\n<li><strong>No packets received:<\/strong> wrong frequency \/ parameters, no nearby devices, missing antenna.<\/li>\n<li><strong>Configuration not applied:<\/strong> config service not running, invalid JSON, write permissions issue.<\/li>\n<\/ul>\n<p>Use logs for debugging:<\/p>\n<pre><code>sudo journalctl -u loravsb-gateway -f<\/code><\/pre>\n<hr \/>\n<h2>Advanced Improvements<\/h2>\n<ul>\n<li>Enable TLS\/SSL for MQTT and add authentication.<\/li>\n<li>Integrate metrics export (Prometheus \/ Grafana).<\/li>\n<li>Add watchdog or structured logging for reliability.<\/li>\n<li>Support multiple radios or OTA configuration updates.<\/li>\n<\/ul>\n<hr \/>\n<h2>References<\/h2>\n<ul>\n<li><a href=\"https:\/\/github.com\/lysek01\/LoRa-169\" target=\"_blank\" rel=\"noopener\">Project repository on GitHub<\/a><\/li>\n<li>License: MIT<\/li>\n<li>Author: <a href=\"https:\/\/github.com\/lysek01\" target=\"_blank\" rel=\"noopener\">lysek01<\/a><\/li>\n<\/ul>\n<hr \/>\n<p><em>\u26a0\ufe0f Note: Always verify that the 169 MHz band is legally permitted for IoT or experimental use in your country.<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Frequency: Europe 169,4\u2013169,475 MHz Duty Cycle: 1 % Using Docker: Yes Last updated: Sep 20, 2026 This guide describes the setup and configuration of the LoRa-169 Gateway based on the open-source project LoRa-169. It explains hardware wiring, software installation, configuration via MQTT, and troubleshooting tips. Requirements Hardware: Raspberry Pi 3 or 4, SX127x LoRa module [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-9039","page","type-page","status-publish","hentry","post"],"_links":{"self":[{"href":"https:\/\/lora.vsb.cz\/index.php\/wp-json\/wp\/v2\/pages\/9039","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lora.vsb.cz\/index.php\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/lora.vsb.cz\/index.php\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/lora.vsb.cz\/index.php\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/lora.vsb.cz\/index.php\/wp-json\/wp\/v2\/comments?post=9039"}],"version-history":[{"count":9,"href":"https:\/\/lora.vsb.cz\/index.php\/wp-json\/wp\/v2\/pages\/9039\/revisions"}],"predecessor-version":[{"id":9383,"href":"https:\/\/lora.vsb.cz\/index.php\/wp-json\/wp\/v2\/pages\/9039\/revisions\/9383"}],"wp:attachment":[{"href":"https:\/\/lora.vsb.cz\/index.php\/wp-json\/wp\/v2\/media?parent=9039"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}