mirror of
https://github.com/markqvist/Reticulum.git
synced 2024-11-22 13:40:19 +00:00
Compare commits
1 Commits
579d9bc268
...
94dd0e8580
Author | SHA1 | Date | |
---|---|---|---|
|
94dd0e8580 |
16
Changelog.md
16
Changelog.md
@ -1,19 +1,3 @@
|
|||||||
### 2024-10-02: RNS β 0.8.1
|
|
||||||
|
|
||||||
This release add BLE support to RNodeInterface, and support for configuring additional options to `rnodeconf`.
|
|
||||||
|
|
||||||
**Changes**
|
|
||||||
- Added Bluetooth Low Energy support to RNodeInterface
|
|
||||||
- Added RNode battery information to `rnstatus` output
|
|
||||||
- Added display blanking configuration to `rnodeconf`
|
|
||||||
- Added NeoPixel intensity configuration to `rnodeconf`
|
|
||||||
|
|
||||||
**Release Hashes**
|
|
||||||
```
|
|
||||||
f4b6b99b67d6b33b8a4562e5d5d5ac54c76814fff26e6c7a79950b82bd80123f rns-0.8.1-py3-none-any.whl
|
|
||||||
c2e540b4bf0f272bb51ae3e33a02f9c07f2619746d069d7ed83d88017bf7ea30 rnspure-0.8.1-py3-none-any.whl
|
|
||||||
```
|
|
||||||
|
|
||||||
### 2024-09-25: RNS β 0.8.0
|
### 2024-09-25: RNS β 0.8.0
|
||||||
|
|
||||||
This maintenance release improves the interface statistics API, and updates documentation.
|
This maintenance release improves the interface statistics API, and updates documentation.
|
||||||
|
@ -28,9 +28,6 @@ import time
|
|||||||
import math
|
import math
|
||||||
import RNS
|
import RNS
|
||||||
|
|
||||||
from able import BluetoothDispatcher, GATT_SUCCESS
|
|
||||||
from able.adapter import require_bluetooth_enabled
|
|
||||||
|
|
||||||
class KISS():
|
class KISS():
|
||||||
FEND = 0xC0
|
FEND = 0xC0
|
||||||
FESC = 0xDB
|
FESC = 0xDB
|
||||||
@ -57,7 +54,6 @@ class KISS():
|
|||||||
CMD_STAT_SNR = 0x24
|
CMD_STAT_SNR = 0x24
|
||||||
CMD_STAT_CHTM = 0x25
|
CMD_STAT_CHTM = 0x25
|
||||||
CMD_STAT_PHYPRM = 0x26
|
CMD_STAT_PHYPRM = 0x26
|
||||||
CMD_STAT_BAT = 0x27
|
|
||||||
CMD_BLINK = 0x30
|
CMD_BLINK = 0x30
|
||||||
CMD_RANDOM = 0x40
|
CMD_RANDOM = 0x40
|
||||||
CMD_FB_EXT = 0x41
|
CMD_FB_EXT = 0x41
|
||||||
@ -82,7 +78,6 @@ class KISS():
|
|||||||
ERROR_TXFAILED = 0x02
|
ERROR_TXFAILED = 0x02
|
||||||
ERROR_EEPROM_LOCKED = 0x03
|
ERROR_EEPROM_LOCKED = 0x03
|
||||||
ERROR_INVALID_FIRMWARE = 0x10
|
ERROR_INVALID_FIRMWARE = 0x10
|
||||||
ERROR_INVALID_BLE_MTU = 0x20
|
|
||||||
|
|
||||||
PLATFORM_AVR = 0x90
|
PLATFORM_AVR = 0x90
|
||||||
PLATFORM_ESP32 = 0x80
|
PLATFORM_ESP32 = 0x80
|
||||||
@ -94,10 +89,6 @@ class KISS():
|
|||||||
return data
|
return data
|
||||||
|
|
||||||
class AndroidBluetoothManager():
|
class AndroidBluetoothManager():
|
||||||
DEVICE_TYPE_CLASSIC = 1
|
|
||||||
DEVICE_TYPE_LE = 2
|
|
||||||
DEVICE_TYPE_DUAL = 3
|
|
||||||
|
|
||||||
def __init__(self, owner, target_device_name = None, target_device_address = None):
|
def __init__(self, owner, target_device_name = None, target_device_address = None):
|
||||||
from jnius import autoclass
|
from jnius import autoclass
|
||||||
self.owner = owner
|
self.owner = owner
|
||||||
@ -246,11 +237,6 @@ class RNodeInterface(Interface):
|
|||||||
Q_SNR_MAX = 6
|
Q_SNR_MAX = 6
|
||||||
Q_SNR_STEP = 2
|
Q_SNR_STEP = 2
|
||||||
|
|
||||||
BATTERY_STATE_UNKNOWN = 0x00
|
|
||||||
BATTERY_STATE_DISCHARGING = 0x01
|
|
||||||
BATTERY_STATE_CHARGING = 0x02
|
|
||||||
BATTERY_STATE_CHARGED = 0x03
|
|
||||||
|
|
||||||
@classmethod
|
@classmethod
|
||||||
def bluetooth_control(device_serial = None, port = None, enable_bluetooth = False, disable_bluetooth = False, pairing_mode = False):
|
def bluetooth_control(device_serial = None, port = None, enable_bluetooth = False, disable_bluetooth = False, pairing_mode = False):
|
||||||
if (port != None or device_serial != None) and (enable_bluetooth or disable_bluetooth or pairing_mode):
|
if (port != None or device_serial != None) and (enable_bluetooth or disable_bluetooth or pairing_mode):
|
||||||
@ -335,8 +321,7 @@ class RNodeInterface(Interface):
|
|||||||
self, owner, name, port, frequency = None, bandwidth = None, txpower = None,
|
self, owner, name, port, frequency = None, bandwidth = None, txpower = None,
|
||||||
sf = None, cr = None, flow_control = False, id_interval = None,
|
sf = None, cr = None, flow_control = False, id_interval = None,
|
||||||
allow_bluetooth = False, target_device_name = None,
|
allow_bluetooth = False, target_device_name = None,
|
||||||
target_device_address = None, id_callsign = None, st_alock = None, lt_alock = None,
|
target_device_address = None, id_callsign = None, st_alock = None, lt_alock = None):
|
||||||
ble_addr = None, ble_name = None, force_ble=False):
|
|
||||||
import importlib
|
import importlib
|
||||||
if RNS.vendor.platformutils.is_android():
|
if RNS.vendor.platformutils.is_android():
|
||||||
self.on_android = True
|
self.on_android = True
|
||||||
@ -383,19 +368,9 @@ class RNodeInterface(Interface):
|
|||||||
self.stopbits = 1
|
self.stopbits = 1
|
||||||
self.timeout = 150
|
self.timeout = 150
|
||||||
self.online = False
|
self.online = False
|
||||||
self.detached = False
|
|
||||||
self.hw_errors = []
|
self.hw_errors = []
|
||||||
self.allow_bluetooth = allow_bluetooth
|
self.allow_bluetooth = allow_bluetooth
|
||||||
|
|
||||||
self.use_ble = False
|
|
||||||
self.ble_name = ble_name
|
|
||||||
self.ble_addr = ble_addr
|
|
||||||
self.ble = None
|
|
||||||
self.ble_rx_lock = threading.Lock()
|
|
||||||
self.ble_tx_lock = threading.Lock()
|
|
||||||
self.ble_rx_queue= b""
|
|
||||||
self.ble_tx_queue= b""
|
|
||||||
|
|
||||||
self.frequency = frequency
|
self.frequency = frequency
|
||||||
self.bandwidth = bandwidth
|
self.bandwidth = bandwidth
|
||||||
self.txpower = txpower
|
self.txpower = txpower
|
||||||
@ -416,7 +391,6 @@ class RNodeInterface(Interface):
|
|||||||
self.last_id = 0
|
self.last_id = 0
|
||||||
self.first_tx = None
|
self.first_tx = None
|
||||||
self.reconnect_w = RNodeInterface.RECONNECT_WAIT
|
self.reconnect_w = RNodeInterface.RECONNECT_WAIT
|
||||||
self.reconnect_lock = threading.Lock()
|
|
||||||
|
|
||||||
self.r_frequency = None
|
self.r_frequency = None
|
||||||
self.r_bandwidth = None
|
self.r_bandwidth = None
|
||||||
@ -440,8 +414,6 @@ class RNodeInterface(Interface):
|
|||||||
self.r_symbol_rate = None
|
self.r_symbol_rate = None
|
||||||
self.r_preamble_symbols = None
|
self.r_preamble_symbols = None
|
||||||
self.r_premable_time_ms = None
|
self.r_premable_time_ms = None
|
||||||
self.r_battery_state = RNodeInterface.BATTERY_STATE_UNKNOWN
|
|
||||||
self.r_battery_percent = 0
|
|
||||||
|
|
||||||
self.packet_queue = []
|
self.packet_queue = []
|
||||||
self.flow_control = flow_control
|
self.flow_control = flow_control
|
||||||
@ -451,9 +423,6 @@ class RNodeInterface(Interface):
|
|||||||
self.port_io_timeout = RNodeInterface.PORT_IO_TIMEOUT
|
self.port_io_timeout = RNodeInterface.PORT_IO_TIMEOUT
|
||||||
self.last_imagedata = None
|
self.last_imagedata = None
|
||||||
|
|
||||||
if force_ble or self.ble_addr != None or self.ble_name != None:
|
|
||||||
self.use_ble = True
|
|
||||||
|
|
||||||
self.validcfg = True
|
self.validcfg = True
|
||||||
if (self.frequency < RNodeInterface.FREQ_MIN or self.frequency > RNodeInterface.FREQ_MAX):
|
if (self.frequency < RNodeInterface.FREQ_MIN or self.frequency > RNodeInterface.FREQ_MAX):
|
||||||
RNS.log("Invalid frequency configured for "+str(self), RNS.LOG_ERROR)
|
RNS.log("Invalid frequency configured for "+str(self), RNS.LOG_ERROR)
|
||||||
@ -519,7 +488,9 @@ class RNodeInterface(Interface):
|
|||||||
RNS.log("The contained exception was: "+str(e), RNS.LOG_ERROR)
|
RNS.log("The contained exception was: "+str(e), RNS.LOG_ERROR)
|
||||||
if len(self.hw_errors) == 0:
|
if len(self.hw_errors) == 0:
|
||||||
RNS.log("Reticulum will attempt to bring up this interface periodically", RNS.LOG_ERROR)
|
RNS.log("Reticulum will attempt to bring up this interface periodically", RNS.LOG_ERROR)
|
||||||
thread = threading.Thread(target=self.reconnect_port, daemon=True).start()
|
thread = threading.Thread(target=self.reconnect_port)
|
||||||
|
thread.daemon = True
|
||||||
|
thread.start()
|
||||||
|
|
||||||
|
|
||||||
def read_mux(self, len=None):
|
def read_mux(self, len=None):
|
||||||
@ -543,111 +514,83 @@ class RNodeInterface(Interface):
|
|||||||
else:
|
else:
|
||||||
raise IOError("No ports available for writing")
|
raise IOError("No ports available for writing")
|
||||||
|
|
||||||
# def reset_ble(self):
|
|
||||||
# RNS.log(f"Clearing previous connection instance: "+str(self.ble))
|
|
||||||
# del self.ble
|
|
||||||
# self.ble = None
|
|
||||||
# self.serial = None
|
|
||||||
# self.ble = BLEConnection(owner=self, target_name=self.ble_name, target_bt_addr=self.ble_addr)
|
|
||||||
# self.serial = self.ble
|
|
||||||
# RNS.log(f"New connection instance: "+str(self.ble))
|
|
||||||
|
|
||||||
def open_port(self):
|
def open_port(self):
|
||||||
if not self.use_ble:
|
if self.port != None:
|
||||||
if self.port != None:
|
RNS.log("Opening serial port "+self.port+"...")
|
||||||
RNS.log("Opening serial port "+self.port+"...")
|
# Get device parameters
|
||||||
# Get device parameters
|
from usb4a import usb
|
||||||
from usb4a import usb
|
device = usb.get_usb_device(self.port)
|
||||||
device = usb.get_usb_device(self.port)
|
if device:
|
||||||
if device:
|
vid = device.getVendorId()
|
||||||
vid = device.getVendorId()
|
pid = device.getProductId()
|
||||||
pid = device.getProductId()
|
|
||||||
|
|
||||||
# Driver overrides for speficic chips
|
# Driver overrides for speficic chips
|
||||||
proxy = self.pyserial.get_serial_port
|
proxy = self.pyserial.get_serial_port
|
||||||
if vid == 0x1A86 and pid == 0x55D4:
|
if vid == 0x1A86 and pid == 0x55D4:
|
||||||
# Force CDC driver for Qinheng CH34x
|
# Force CDC driver for Qinheng CH34x
|
||||||
RNS.log(str(self)+" using CDC driver for "+RNS.hexrep(vid)+":"+RNS.hexrep(pid), RNS.LOG_DEBUG)
|
RNS.log(str(self)+" using CDC driver for "+RNS.hexrep(vid)+":"+RNS.hexrep(pid), RNS.LOG_DEBUG)
|
||||||
from usbserial4a.cdcacmserial4a import CdcAcmSerial
|
from usbserial4a.cdcacmserial4a import CdcAcmSerial
|
||||||
proxy = CdcAcmSerial
|
proxy = CdcAcmSerial
|
||||||
|
|
||||||
self.serial = proxy(
|
self.serial = proxy(
|
||||||
self.port,
|
self.port,
|
||||||
baudrate = self.speed,
|
baudrate = self.speed,
|
||||||
bytesize = self.databits,
|
bytesize = self.databits,
|
||||||
parity = self.parity,
|
parity = self.parity,
|
||||||
stopbits = self.stopbits,
|
stopbits = self.stopbits,
|
||||||
xonxoff = False,
|
xonxoff = False,
|
||||||
rtscts = False,
|
rtscts = False,
|
||||||
timeout = None,
|
timeout = None,
|
||||||
inter_byte_timeout = None,
|
inter_byte_timeout = None,
|
||||||
# write_timeout = wtimeout,
|
# write_timeout = wtimeout,
|
||||||
dsrdtr = False,
|
dsrdtr = False,
|
||||||
)
|
)
|
||||||
|
|
||||||
if vid == 0x0403:
|
if vid == 0x0403:
|
||||||
# Hardware parameters for FTDI devices @ 115200 baud
|
# Hardware parameters for FTDI devices @ 115200 baud
|
||||||
self.serial.DEFAULT_READ_BUFFER_SIZE = 16 * 1024
|
self.serial.DEFAULT_READ_BUFFER_SIZE = 16 * 1024
|
||||||
self.serial.USB_READ_TIMEOUT_MILLIS = 100
|
self.serial.USB_READ_TIMEOUT_MILLIS = 100
|
||||||
self.serial.timeout = 0.1
|
self.serial.timeout = 0.1
|
||||||
elif vid == 0x10C4:
|
elif vid == 0x10C4:
|
||||||
# Hardware parameters for SiLabs CP210x @ 115200 baud
|
# Hardware parameters for SiLabs CP210x @ 115200 baud
|
||||||
self.serial.DEFAULT_READ_BUFFER_SIZE = 64
|
self.serial.DEFAULT_READ_BUFFER_SIZE = 64
|
||||||
self.serial.USB_READ_TIMEOUT_MILLIS = 12
|
self.serial.USB_READ_TIMEOUT_MILLIS = 12
|
||||||
self.serial.timeout = 0.012
|
self.serial.timeout = 0.012
|
||||||
elif vid == 0x1A86 and pid == 0x55D4:
|
elif vid == 0x1A86 and pid == 0x55D4:
|
||||||
# Hardware parameters for Qinheng CH34x @ 115200 baud
|
# Hardware parameters for Qinheng CH34x @ 115200 baud
|
||||||
self.serial.DEFAULT_READ_BUFFER_SIZE = 64
|
self.serial.DEFAULT_READ_BUFFER_SIZE = 64
|
||||||
self.serial.USB_READ_TIMEOUT_MILLIS = 12
|
self.serial.USB_READ_TIMEOUT_MILLIS = 12
|
||||||
self.serial.timeout = 0.1
|
self.serial.timeout = 0.1
|
||||||
else:
|
else:
|
||||||
# Default values
|
# Default values
|
||||||
self.serial.DEFAULT_READ_BUFFER_SIZE = 1 * 1024
|
self.serial.DEFAULT_READ_BUFFER_SIZE = 1 * 1024
|
||||||
self.serial.USB_READ_TIMEOUT_MILLIS = 100
|
self.serial.USB_READ_TIMEOUT_MILLIS = 100
|
||||||
self.serial.timeout = 0.1
|
self.serial.timeout = 0.1
|
||||||
|
|
||||||
RNS.log(str(self)+" USB read buffer size set to "+RNS.prettysize(self.serial.DEFAULT_READ_BUFFER_SIZE), RNS.LOG_DEBUG)
|
RNS.log(str(self)+" USB read buffer size set to "+RNS.prettysize(self.serial.DEFAULT_READ_BUFFER_SIZE), RNS.LOG_DEBUG)
|
||||||
RNS.log(str(self)+" USB read timeout set to "+str(self.serial.USB_READ_TIMEOUT_MILLIS)+"ms", RNS.LOG_DEBUG)
|
RNS.log(str(self)+" USB read timeout set to "+str(self.serial.USB_READ_TIMEOUT_MILLIS)+"ms", RNS.LOG_DEBUG)
|
||||||
RNS.log(str(self)+" USB write timeout set to "+str(self.serial.USB_WRITE_TIMEOUT_MILLIS)+"ms", RNS.LOG_DEBUG)
|
RNS.log(str(self)+" USB write timeout set to "+str(self.serial.USB_WRITE_TIMEOUT_MILLIS)+"ms", RNS.LOG_DEBUG)
|
||||||
|
|
||||||
elif self.allow_bluetooth:
|
elif self.allow_bluetooth:
|
||||||
if self.bt_manager == None:
|
if self.bt_manager == None:
|
||||||
self.bt_manager = AndroidBluetoothManager(
|
self.bt_manager = AndroidBluetoothManager(
|
||||||
owner = self,
|
owner = self,
|
||||||
target_device_name = self.bt_target_device_name,
|
target_device_name = self.bt_target_device_name,
|
||||||
target_device_address = self.bt_target_device_address
|
target_device_address = self.bt_target_device_address
|
||||||
)
|
)
|
||||||
|
|
||||||
if self.bt_manager != None:
|
if self.bt_manager != None:
|
||||||
self.bt_manager.connect_any_device()
|
self.bt_manager.connect_any_device()
|
||||||
|
|
||||||
else:
|
|
||||||
if self.ble == None:
|
|
||||||
self.ble = BLEConnection(owner=self, target_name=self.ble_name, target_bt_addr=self.ble_addr)
|
|
||||||
self.serial = self.ble
|
|
||||||
|
|
||||||
open_time = time.time()
|
|
||||||
while not self.ble.connected and time.time() < open_time + self.ble.CONNECT_TIMEOUT:
|
|
||||||
time.sleep(1)
|
|
||||||
|
|
||||||
|
|
||||||
def configure_device(self):
|
def configure_device(self):
|
||||||
self.resetRadioState()
|
|
||||||
sleep(2.0)
|
sleep(2.0)
|
||||||
thread = threading.Thread(target=self.readLoop, daemon=True).start()
|
thread = threading.Thread(target=self.readLoop)
|
||||||
|
thread.daemon = True
|
||||||
|
thread.start()
|
||||||
|
|
||||||
self.detect()
|
self.detect()
|
||||||
if not self.use_ble:
|
sleep(0.5)
|
||||||
sleep(0.5)
|
|
||||||
else:
|
|
||||||
ble_detect_timeout = 5
|
|
||||||
detect_time = time.time()
|
|
||||||
while not self.detected and time.time() < detect_time + ble_detect_timeout:
|
|
||||||
time.sleep(0.1)
|
|
||||||
if self.detected:
|
|
||||||
detect_time = RNS.prettytime(time.time()-detect_time)
|
|
||||||
else:
|
|
||||||
RNS.log(f"RNode detect timed out over {self.port}", RNS.LOG_ERROR)
|
|
||||||
|
|
||||||
if not self.detected:
|
if not self.detected:
|
||||||
raise IOError("Could not detect device")
|
raise IOError("Could not detect device")
|
||||||
@ -711,9 +654,6 @@ class RNodeInterface(Interface):
|
|||||||
self.setRadioState(KISS.RADIO_STATE_ON)
|
self.setRadioState(KISS.RADIO_STATE_ON)
|
||||||
time.sleep(0.15)
|
time.sleep(0.15)
|
||||||
|
|
||||||
if self.use_ble:
|
|
||||||
time.sleep(1)
|
|
||||||
|
|
||||||
def detect(self):
|
def detect(self):
|
||||||
kiss_command = bytes([KISS.FEND, KISS.CMD_DETECT, KISS.DETECT_REQ, KISS.FEND, KISS.CMD_FW_VERSION, 0x00, KISS.FEND, KISS.CMD_PLATFORM, 0x00, KISS.FEND, KISS.CMD_MCU, 0x00, KISS.FEND])
|
kiss_command = bytes([KISS.FEND, KISS.CMD_DETECT, KISS.DETECT_REQ, KISS.FEND, KISS.CMD_FW_VERSION, 0x00, KISS.FEND, KISS.CMD_PLATFORM, 0x00, KISS.FEND, KISS.CMD_MCU, 0x00, KISS.FEND])
|
||||||
written = self.write_mux(kiss_command)
|
written = self.write_mux(kiss_command)
|
||||||
@ -867,19 +807,16 @@ class RNodeInterface(Interface):
|
|||||||
raise IOError("An IO error occurred while configuring radio state for "+str(self))
|
raise IOError("An IO error occurred while configuring radio state for "+str(self))
|
||||||
|
|
||||||
def validate_firmware(self):
|
def validate_firmware(self):
|
||||||
if (self.maj_version > RNodeInterface.REQUIRED_FW_VER_MAJ):
|
if (self.maj_version >= RNodeInterface.REQUIRED_FW_VER_MAJ):
|
||||||
self.firmware_ok = True
|
if (self.min_version >= RNodeInterface.REQUIRED_FW_VER_MIN):
|
||||||
else:
|
self.firmware_ok = True
|
||||||
if (self.maj_version >= RNodeInterface.REQUIRED_FW_VER_MAJ):
|
|
||||||
if (self.min_version >= RNodeInterface.REQUIRED_FW_VER_MIN):
|
|
||||||
self.firmware_ok = True
|
|
||||||
|
|
||||||
if self.firmware_ok:
|
if self.firmware_ok:
|
||||||
return
|
return
|
||||||
|
|
||||||
RNS.log("The firmware version of the connected RNode is "+str(self.maj_version)+"."+str(self.min_version), RNS.LOG_ERROR)
|
RNS.log("The firmware version of the connected RNode is "+str(self.maj_version)+"."+str(self.min_version), RNS.LOG_ERROR)
|
||||||
RNS.log("This version of Reticulum requires at least version "+str(RNodeInterface.REQUIRED_FW_VER_MAJ)+"."+str(RNodeInterface.REQUIRED_FW_VER_MIN), RNS.LOG_ERROR)
|
RNS.log("This version of Reticulum requires at least version "+str(RNodeInterface.REQUIRED_FW_VER_MAJ)+"."+str(RNodeInterface.REQUIRED_FW_VER_MIN), RNS.LOG_ERROR)
|
||||||
RNS.log("Please update your RNode firmware with rnodeconf from https://github.com/markqvist/reticulum/")
|
RNS.log("Please update your RNode firmware with rnodeconf from https://github.com/markqvist/rnodeconfigutil/")
|
||||||
error_description = "The firmware version of the connected RNode is "+str(self.maj_version)+"."+str(self.min_version)+". "
|
error_description = "The firmware version of the connected RNode is "+str(self.maj_version)+"."+str(self.min_version)+". "
|
||||||
error_description += "This version of Reticulum requires at least version "+str(RNodeInterface.REQUIRED_FW_VER_MAJ)+"."+str(RNodeInterface.REQUIRED_FW_VER_MIN)+". "
|
error_description += "This version of Reticulum requires at least version "+str(RNodeInterface.REQUIRED_FW_VER_MAJ)+"."+str(RNodeInterface.REQUIRED_FW_VER_MIN)+". "
|
||||||
error_description += "Please update your RNode firmware with rnodeconf from: https://github.com/markqvist/rnodeconfigutil/"
|
error_description += "Please update your RNode firmware with rnodeconf from: https://github.com/markqvist/rnodeconfigutil/"
|
||||||
@ -887,7 +824,7 @@ class RNodeInterface(Interface):
|
|||||||
|
|
||||||
|
|
||||||
def validateRadioState(self):
|
def validateRadioState(self):
|
||||||
RNS.log("Waiting for radio configuration validation for "+str(self)+"...", RNS.LOG_VERBOSE)
|
RNS.log("Wating for radio configuration validation for "+str(self)+"...", RNS.LOG_VERBOSE)
|
||||||
if not self.platform == KISS.PLATFORM_ESP32:
|
if not self.platform == KISS.PLATFORM_ESP32:
|
||||||
sleep(1.00);
|
sleep(1.00);
|
||||||
else:
|
else:
|
||||||
@ -915,13 +852,6 @@ class RNodeInterface(Interface):
|
|||||||
else:
|
else:
|
||||||
return False
|
return False
|
||||||
|
|
||||||
def resetRadioState(self):
|
|
||||||
self.r_frequency = None
|
|
||||||
self.r_bandwidth = None
|
|
||||||
self.r_txpower = None
|
|
||||||
self.r_sf = None
|
|
||||||
self.r_cr = None
|
|
||||||
self.r_state = None
|
|
||||||
|
|
||||||
def updateBitrate(self):
|
def updateBitrate(self):
|
||||||
try:
|
try:
|
||||||
@ -1210,25 +1140,6 @@ class RNodeInterface(Interface):
|
|||||||
RNS.log(str(self)+" Radio reporting symbol time is "+str(round(self.r_symbol_time_ms,2))+"ms (at "+str(self.r_symbol_rate)+" baud)", RNS.LOG_DEBUG)
|
RNS.log(str(self)+" Radio reporting symbol time is "+str(round(self.r_symbol_time_ms,2))+"ms (at "+str(self.r_symbol_rate)+" baud)", RNS.LOG_DEBUG)
|
||||||
RNS.log(str(self)+" Radio reporting preamble is "+str(self.r_preamble_symbols)+" symbols ("+str(self.r_premable_time_ms)+"ms)", RNS.LOG_DEBUG)
|
RNS.log(str(self)+" Radio reporting preamble is "+str(self.r_preamble_symbols)+" symbols ("+str(self.r_premable_time_ms)+"ms)", RNS.LOG_DEBUG)
|
||||||
RNS.log(str(self)+" Radio reporting CSMA slot time is "+str(self.r_csma_slot_time_ms)+"ms", RNS.LOG_DEBUG)
|
RNS.log(str(self)+" Radio reporting CSMA slot time is "+str(self.r_csma_slot_time_ms)+"ms", RNS.LOG_DEBUG)
|
||||||
elif (command == KISS.CMD_STAT_BAT):
|
|
||||||
if (byte == KISS.FESC):
|
|
||||||
escape = True
|
|
||||||
else:
|
|
||||||
if (escape):
|
|
||||||
if (byte == KISS.TFEND):
|
|
||||||
byte = KISS.FEND
|
|
||||||
if (byte == KISS.TFESC):
|
|
||||||
byte = KISS.FESC
|
|
||||||
escape = False
|
|
||||||
command_buffer = command_buffer+bytes([byte])
|
|
||||||
if (len(command_buffer) == 2):
|
|
||||||
bat_percent = command_buffer[1]
|
|
||||||
if bat_percent > 100:
|
|
||||||
bat_percent = 100
|
|
||||||
if bat_percent < 0:
|
|
||||||
bat_percent = 0
|
|
||||||
self.r_battery_state = command_buffer[0]
|
|
||||||
self.r_battery_percent = bat_percent
|
|
||||||
elif (command == KISS.CMD_RANDOM):
|
elif (command == KISS.CMD_RANDOM):
|
||||||
self.r_random = byte
|
self.r_random = byte
|
||||||
elif (command == KISS.CMD_PLATFORM):
|
elif (command == KISS.CMD_PLATFORM):
|
||||||
@ -1301,319 +1212,48 @@ class RNodeInterface(Interface):
|
|||||||
if self.bt_manager != None:
|
if self.bt_manager != None:
|
||||||
self.bt_manager.close()
|
self.bt_manager.close()
|
||||||
|
|
||||||
if not self.detached:
|
self.reconnect_port()
|
||||||
self.reconnect_port()
|
|
||||||
|
|
||||||
def reconnect_port(self):
|
def reconnect_port(self):
|
||||||
if self.reconnect_lock.locked():
|
while not self.online and len(self.hw_errors) == 0:
|
||||||
RNS.log("Dropping superflous reconnect port job")
|
try:
|
||||||
return
|
time.sleep(self.reconnect_w)
|
||||||
|
if self.serial != None and self.port != None:
|
||||||
|
RNS.log("Attempting to reconnect serial port "+str(self.port)+" for "+str(self)+"...", RNS.LOG_EXTREME)
|
||||||
|
|
||||||
with self.reconnect_lock:
|
if self.bt_manager != None:
|
||||||
while not self.online and len(self.hw_errors) == 0:
|
RNS.log("Attempting to reconnect Bluetooth device for "+str(self)+"...", RNS.LOG_EXTREME)
|
||||||
try:
|
|
||||||
time.sleep(self.reconnect_w)
|
|
||||||
if self.serial != None and self.port != None:
|
|
||||||
RNS.log("Attempting to reconnect serial port "+str(self.port)+" for "+str(self)+"...", RNS.LOG_EXTREME)
|
|
||||||
|
|
||||||
if self.bt_manager != None:
|
self.open_port()
|
||||||
RNS.log("Attempting to reconnect Bluetooth device for "+str(self)+"...", RNS.LOG_EXTREME)
|
|
||||||
|
|
||||||
self.open_port()
|
if hasattr(self, "serial") and self.serial != None and self.serial.is_open:
|
||||||
|
self.configure_device()
|
||||||
|
if self.online:
|
||||||
|
if self.last_imagedata != None:
|
||||||
|
self.display_image(self.last_imagedata)
|
||||||
|
self.enable_external_framebuffer()
|
||||||
|
|
||||||
|
elif hasattr(self, "bt_manager") and self.bt_manager != None and self.bt_manager.connected:
|
||||||
|
self.configure_device()
|
||||||
|
if self.online:
|
||||||
|
if self.last_imagedata != None:
|
||||||
|
self.display_image(self.last_imagedata)
|
||||||
|
self.enable_external_framebuffer()
|
||||||
|
|
||||||
if hasattr(self, "serial") and self.serial != None and self.serial.is_open:
|
except Exception as e:
|
||||||
self.configure_device()
|
RNS.log("Error while reconnecting RNode, the contained exception was: "+str(e), RNS.LOG_ERROR)
|
||||||
if self.online:
|
|
||||||
if self.last_imagedata != None:
|
|
||||||
self.display_image(self.last_imagedata)
|
|
||||||
self.enable_external_framebuffer()
|
|
||||||
|
|
||||||
elif hasattr(self, "bt_manager") and self.bt_manager != None and self.bt_manager.connected:
|
|
||||||
self.configure_device()
|
|
||||||
if self.online:
|
|
||||||
if self.last_imagedata != None:
|
|
||||||
self.display_image(self.last_imagedata)
|
|
||||||
self.enable_external_framebuffer()
|
|
||||||
|
|
||||||
except Exception as e:
|
if self.online:
|
||||||
RNS.log("Error while reconnecting RNode, the contained exception was: "+str(e), RNS.LOG_ERROR)
|
RNS.log("Reconnected serial port for "+str(self))
|
||||||
|
|
||||||
if self.online:
|
|
||||||
RNS.log("Reconnected serial port for "+str(self))
|
|
||||||
|
|
||||||
def detach(self):
|
def detach(self):
|
||||||
self.detached = True
|
|
||||||
self.disable_external_framebuffer()
|
self.disable_external_framebuffer()
|
||||||
self.setRadioState(KISS.RADIO_STATE_OFF)
|
self.setRadioState(KISS.RADIO_STATE_OFF)
|
||||||
self.leave()
|
self.leave()
|
||||||
|
|
||||||
if self.use_ble:
|
|
||||||
self.ble.close()
|
|
||||||
|
|
||||||
def should_ingress_limit(self):
|
def should_ingress_limit(self):
|
||||||
return False
|
return False
|
||||||
|
|
||||||
def get_battery_state(self):
|
|
||||||
return self.r_battery_state
|
|
||||||
|
|
||||||
def get_battery_state_string(self):
|
|
||||||
if self.r_battery_state == RNodeInterface.BATTERY_STATE_CHARGED:
|
|
||||||
return "charged"
|
|
||||||
elif self.r_battery_state == RNodeInterface.BATTERY_STATE_CHARGING:
|
|
||||||
return "charging"
|
|
||||||
elif self.r_battery_state == RNodeInterface.BATTERY_STATE_DISCHARGING:
|
|
||||||
return "discharging"
|
|
||||||
else:
|
|
||||||
return "unknown"
|
|
||||||
|
|
||||||
def get_battery_percent(self):
|
|
||||||
return self.r_battery_percent
|
|
||||||
|
|
||||||
def ble_receive(self, data):
|
|
||||||
with self.ble_rx_lock:
|
|
||||||
self.ble_rx_queue += data
|
|
||||||
|
|
||||||
def ble_waiting(self):
|
|
||||||
return len(self.ble_tx_queue) > 0
|
|
||||||
|
|
||||||
def get_ble_waiting(self, n):
|
|
||||||
with self.ble_tx_lock:
|
|
||||||
data = self.ble_tx_queue[:n]
|
|
||||||
self.ble_tx_queue = self.ble_tx_queue[n:]
|
|
||||||
return data
|
|
||||||
|
|
||||||
def __str__(self):
|
def __str__(self):
|
||||||
return "RNodeInterface["+str(self.name)+"]"
|
return "RNodeInterface["+str(self.name)+"]"
|
||||||
|
|
||||||
class BLEConnection(BluetoothDispatcher):
|
|
||||||
UART_SERVICE_UUID = "6e400001-b5a3-f393-e0a9-e50e24dcca9e"
|
|
||||||
UART_RX_CHAR_UUID = "6e400002-b5a3-f393-e0a9-e50e24dcca9e"
|
|
||||||
UART_TX_CHAR_UUID = "6e400003-b5a3-f393-e0a9-e50e24dcca9e"
|
|
||||||
MAX_GATT_ATTR_LEN = 512
|
|
||||||
BASE_MTU = 20
|
|
||||||
TARGET_MTU = 512
|
|
||||||
|
|
||||||
MTU_TIMEOUT = 4.0
|
|
||||||
CONNECT_TIMEOUT = 7.0
|
|
||||||
RECONNECT_WAIT = 1.0
|
|
||||||
|
|
||||||
@property
|
|
||||||
def is_open(self):
|
|
||||||
return self.connected
|
|
||||||
|
|
||||||
@property
|
|
||||||
def in_waiting(self):
|
|
||||||
return len(self.owner.ble_rx_queue) > 0
|
|
||||||
|
|
||||||
def write(self, data_bytes):
|
|
||||||
with self.owner.ble_tx_lock:
|
|
||||||
self.owner.ble_tx_queue += data_bytes
|
|
||||||
return len(data_bytes)
|
|
||||||
|
|
||||||
def read(self):
|
|
||||||
with self.owner.ble_rx_lock:
|
|
||||||
data = self.owner.ble_rx_queue
|
|
||||||
self.owner.ble_rx_queue = b""
|
|
||||||
return data
|
|
||||||
|
|
||||||
def close(self):
|
|
||||||
try:
|
|
||||||
if self.connected:
|
|
||||||
RNS.log(f"Disconnecting BLE device from {self.owner}", RNS.LOG_DEBUG)
|
|
||||||
# RNS.log("Waiting for BLE write buffer to empty...")
|
|
||||||
timeout = time.time() + 10
|
|
||||||
while self.owner.ble_waiting() and self.write_thread != None and time.time() < timeout:
|
|
||||||
time.sleep(0.1)
|
|
||||||
# if time.time() > timeout:
|
|
||||||
# RNS.log("Writing timed out")
|
|
||||||
# else:
|
|
||||||
# RNS.log("Writing concluded")
|
|
||||||
|
|
||||||
self.rx_char = None
|
|
||||||
self.tx_char = None
|
|
||||||
self.mtu = BLEConnection.BASE_MTU
|
|
||||||
self.mtu_requested_time = None
|
|
||||||
|
|
||||||
if self.write_thread != None:
|
|
||||||
# RNS.log("Waiting for write thread to finish...")
|
|
||||||
while self.write_thread != None:
|
|
||||||
time.sleep(0.1)
|
|
||||||
|
|
||||||
# RNS.log("Writing finished, closing GATT connection")
|
|
||||||
self.close_gatt()
|
|
||||||
|
|
||||||
with self.owner.ble_rx_lock:
|
|
||||||
self.owner.ble_rx_queue = b""
|
|
||||||
|
|
||||||
with self.owner.ble_tx_lock:
|
|
||||||
self.owner.ble_tx_queue = b""
|
|
||||||
|
|
||||||
self.connected = False
|
|
||||||
self.ble_device = None
|
|
||||||
|
|
||||||
except Exception as e:
|
|
||||||
RNS.log("An error occurred while closing BLE connection for {self.owner}: {e}", RNS.LOG_ERROR)
|
|
||||||
RNS.trace_exception(e)
|
|
||||||
|
|
||||||
def __init__(self, owner=None, target_name=None, target_bt_addr=None):
|
|
||||||
super(BLEConnection, self).__init__()
|
|
||||||
self.owner = owner
|
|
||||||
self.target_name = target_name
|
|
||||||
self.target_bt_addr = target_bt_addr
|
|
||||||
self.connect_timeout = BLEConnection.CONNECT_TIMEOUT
|
|
||||||
self.ble_device = None
|
|
||||||
self.rx_char = None
|
|
||||||
self.tx_char = None
|
|
||||||
self.connected = False
|
|
||||||
self.was_connected = False
|
|
||||||
self.connected_time = None
|
|
||||||
self.mtu_requested_time = None
|
|
||||||
self.running = False
|
|
||||||
self.should_run = False
|
|
||||||
self.connect_job_running = False
|
|
||||||
self.write_thread = None
|
|
||||||
self.mtu = BLEConnection.BASE_MTU
|
|
||||||
self.target_mtu = BLEConnection.TARGET_MTU
|
|
||||||
|
|
||||||
self.bt_manager = AndroidBluetoothManager(owner=self)
|
|
||||||
|
|
||||||
self.should_run = True
|
|
||||||
self.connection_thread = threading.Thread(target=self.connection_job, daemon=True).start()
|
|
||||||
|
|
||||||
def write_loop(self):
|
|
||||||
try:
|
|
||||||
while self.connected and self.rx_char != None:
|
|
||||||
if self.owner.ble_waiting():
|
|
||||||
data = self.owner.get_ble_waiting(self.mtu)
|
|
||||||
self.write_characteristic(self.rx_char, data)
|
|
||||||
else:
|
|
||||||
time.sleep(0.1)
|
|
||||||
|
|
||||||
except Exception as e:
|
|
||||||
RNS.log("An error occurred in {self} write loop: {e}", RNS.LOG_ERROR)
|
|
||||||
RNS.trace_exception(e)
|
|
||||||
|
|
||||||
self.write_thread = None
|
|
||||||
|
|
||||||
def connection_job(self):
|
|
||||||
while self.should_run:
|
|
||||||
if self.bt_manager.bt_enabled():
|
|
||||||
if self.ble_device == None:
|
|
||||||
self.ble_device = self.find_target_device()
|
|
||||||
|
|
||||||
if self.ble_device != None:
|
|
||||||
if not self.connected:
|
|
||||||
if self.was_connected:
|
|
||||||
RNS.log(f"Throttling BLE reconnect for {BLEConnection.RECONNECT_WAIT} seconds", RNS.LOG_DEBUG)
|
|
||||||
time.sleep(BLEConnection.RECONNECT_WAIT)
|
|
||||||
|
|
||||||
self.connect_device()
|
|
||||||
|
|
||||||
else:
|
|
||||||
if self.connected:
|
|
||||||
RNS.log("Bluetooth was disabled, closing active BLE device connection", RNS.LOG_ERROR)
|
|
||||||
self.close()
|
|
||||||
|
|
||||||
time.sleep(2)
|
|
||||||
|
|
||||||
def connect_device(self):
|
|
||||||
if self.ble_device != None and self.bt_manager.bt_enabled():
|
|
||||||
RNS.log(f"Trying to connect BLE device {self.ble_device.getName()} / {self.ble_device.getAddress()} for {self.owner}...", RNS.LOG_DEBUG)
|
|
||||||
self.mtu = BLEConnection.BASE_MTU
|
|
||||||
self.connect_by_device_address(self.ble_device.getAddress())
|
|
||||||
end = time.time() + BLEConnection.CONNECT_TIMEOUT
|
|
||||||
while time.time() < end and not self.connected:
|
|
||||||
time.sleep(0.25)
|
|
||||||
|
|
||||||
if self.connected:
|
|
||||||
self.owner.port = f"ble://{self.ble_device.getAddress()}"
|
|
||||||
self.write_thread = threading.Thread(target=self.write_loop, daemon=True)
|
|
||||||
self.write_thread.start()
|
|
||||||
else:
|
|
||||||
RNS.log(f"BLE device connection timed out for {self.owner}", RNS.LOG_DEBUG)
|
|
||||||
if self.mtu_requested_time:
|
|
||||||
RNS.log("MTU update timeout, tearing down connection")
|
|
||||||
self.owner.hw_errors.append({"error": KISS.ERROR_INVALID_BLE_MTU, "description": "The Bluetooth Low Energy transfer MTU could not be configured for the connected device, and communication has failed. Restart Reticulum and any connected applications to retry connecting."})
|
|
||||||
self.close()
|
|
||||||
self.should_run = False
|
|
||||||
|
|
||||||
self.close_gatt()
|
|
||||||
|
|
||||||
self.connect_job_running = False
|
|
||||||
|
|
||||||
def device_disconnected(self):
|
|
||||||
RNS.log(f"BLE device for {self.owner} disconnected", RNS.LOG_NOTICE)
|
|
||||||
self.connected = False
|
|
||||||
self.ble_device = None
|
|
||||||
self.close_gatt()
|
|
||||||
|
|
||||||
def find_target_device(self):
|
|
||||||
found_device = None
|
|
||||||
potential_devices = self.bt_manager.get_paired_devices()
|
|
||||||
|
|
||||||
if self.target_bt_addr != None:
|
|
||||||
for device in potential_devices:
|
|
||||||
if (device.getType() == AndroidBluetoothManager.DEVICE_TYPE_LE) or (device.getType() == AndroidBluetoothManager.DEVICE_TYPE_DUAL):
|
|
||||||
if str(device.getAddress()).replace(":", "").lower() == str(self.target_bt_addr).replace(":", "").lower():
|
|
||||||
found_device = device
|
|
||||||
break
|
|
||||||
|
|
||||||
if not found_device and self.target_name != None:
|
|
||||||
for device in potential_devices:
|
|
||||||
if (device.getType() == AndroidBluetoothManager.DEVICE_TYPE_LE) or (device.getType() == AndroidBluetoothManager.DEVICE_TYPE_DUAL):
|
|
||||||
if device.getName().lower() == self.target_name.lower():
|
|
||||||
found_device = device
|
|
||||||
break
|
|
||||||
|
|
||||||
if not found_device:
|
|
||||||
for device in potential_devices:
|
|
||||||
if (device.getType() == AndroidBluetoothManager.DEVICE_TYPE_LE) or (device.getType() == AndroidBluetoothManager.DEVICE_TYPE_DUAL):
|
|
||||||
if device.getName().startswith("RNode "):
|
|
||||||
found_device = device
|
|
||||||
break
|
|
||||||
|
|
||||||
return found_device
|
|
||||||
|
|
||||||
def on_connection_state_change(self, status, state):
|
|
||||||
if status == GATT_SUCCESS and state:
|
|
||||||
self.discover_services()
|
|
||||||
else:
|
|
||||||
self.device_disconnected()
|
|
||||||
|
|
||||||
def on_services(self, status, services):
|
|
||||||
if status == GATT_SUCCESS:
|
|
||||||
self.rx_char = services.search(BLEConnection.UART_RX_CHAR_UUID)
|
|
||||||
|
|
||||||
if self.rx_char is not None:
|
|
||||||
self.tx_char = services.search(BLEConnection.UART_TX_CHAR_UUID)
|
|
||||||
|
|
||||||
if self.tx_char is not None:
|
|
||||||
if self.enable_notifications(self.tx_char):
|
|
||||||
RNS.log("Enabled notifications for BLE TX characteristic", RNS.LOG_DEBUG)
|
|
||||||
|
|
||||||
RNS.log(f"Requesting BLE connection MTU update to {self.target_mtu}", RNS.LOG_DEBUG)
|
|
||||||
self.mtu_requested_time = time.time()
|
|
||||||
self.request_mtu(self.target_mtu)
|
|
||||||
|
|
||||||
else:
|
|
||||||
RNS.log("Could not enable notifications for BLE TX characteristic", RNS.LOG_ERROR)
|
|
||||||
|
|
||||||
else:
|
|
||||||
RNS.log("BLE device service discovery failure", RNS.LOG_ERROR)
|
|
||||||
|
|
||||||
def on_mtu_changed(self, mtu, status):
|
|
||||||
if status == GATT_SUCCESS:
|
|
||||||
self.mtu = min(mtu-5, BLEConnection.MAX_GATT_ATTR_LEN)
|
|
||||||
RNS.log(f"BLE MTU updated to {self.mtu} for {self.owner}", RNS.LOG_DEBUG)
|
|
||||||
self.connected = True
|
|
||||||
self.was_connected = True
|
|
||||||
self.connected_time = time.time()
|
|
||||||
self.mtu_requested_time = None
|
|
||||||
|
|
||||||
else:
|
|
||||||
RNS.log(f"MTU update request did not succeed, mtu={mtu}, status={status}", RNS.LOG_ERROR)
|
|
||||||
|
|
||||||
def on_characteristic_changed(self, characteristic):
|
|
||||||
if characteristic.getUuid().toString() == BLEConnection.UART_TX_CHAR_UUID:
|
|
||||||
recvd = bytes(characteristic.getValue())
|
|
||||||
self.owner.ble_receive(recvd)
|
|
@ -54,7 +54,6 @@ class KISS():
|
|||||||
CMD_STAT_SNR = 0x24
|
CMD_STAT_SNR = 0x24
|
||||||
CMD_STAT_CHTM = 0x25
|
CMD_STAT_CHTM = 0x25
|
||||||
CMD_STAT_PHYPRM = 0x26
|
CMD_STAT_PHYPRM = 0x26
|
||||||
CMD_STAT_BAT = 0x27
|
|
||||||
CMD_BLINK = 0x30
|
CMD_BLINK = 0x30
|
||||||
CMD_RANDOM = 0x40
|
CMD_RANDOM = 0x40
|
||||||
CMD_FB_EXT = 0x41
|
CMD_FB_EXT = 0x41
|
||||||
@ -108,12 +107,7 @@ class RNodeInterface(Interface):
|
|||||||
Q_SNR_MAX = 6
|
Q_SNR_MAX = 6
|
||||||
Q_SNR_STEP = 2
|
Q_SNR_STEP = 2
|
||||||
|
|
||||||
BATTERY_STATE_UNKNOWN = 0x00
|
def __init__(self, owner, name, port, frequency = None, bandwidth = None, txpower = None, sf = None, cr = None, flow_control = False, id_interval = None, id_callsign = None, st_alock = None, lt_alock = None):
|
||||||
BATTERY_STATE_DISCHARGING = 0x01
|
|
||||||
BATTERY_STATE_CHARGING = 0x02
|
|
||||||
BATTERY_STATE_CHARGED = 0x03
|
|
||||||
|
|
||||||
def __init__(self, owner, name, port, frequency = None, bandwidth = None, txpower = None, sf = None, cr = None, flow_control = False, id_interval = None, id_callsign = None, st_alock = None, lt_alock = None, ble_addr = None, ble_name = None, force_ble=False):
|
|
||||||
if RNS.vendor.platformutils.is_android():
|
if RNS.vendor.platformutils.is_android():
|
||||||
raise SystemError("Invalid interface type. The Android-specific RNode interface must be used on Android")
|
raise SystemError("Invalid interface type. The Android-specific RNode interface must be used on Android")
|
||||||
|
|
||||||
@ -142,15 +136,6 @@ class RNodeInterface(Interface):
|
|||||||
self.detached = False
|
self.detached = False
|
||||||
self.reconnecting= False
|
self.reconnecting= False
|
||||||
|
|
||||||
self.use_ble = False
|
|
||||||
self.ble_name = ble_name
|
|
||||||
self.ble_addr = ble_addr
|
|
||||||
self.ble = None
|
|
||||||
self.ble_rx_lock = threading.Lock()
|
|
||||||
self.ble_tx_lock = threading.Lock()
|
|
||||||
self.ble_rx_queue= b""
|
|
||||||
self.ble_tx_queue= b""
|
|
||||||
|
|
||||||
self.frequency = frequency
|
self.frequency = frequency
|
||||||
self.bandwidth = bandwidth
|
self.bandwidth = bandwidth
|
||||||
self.txpower = txpower
|
self.txpower = txpower
|
||||||
@ -194,17 +179,12 @@ class RNodeInterface(Interface):
|
|||||||
self.r_symbol_rate = None
|
self.r_symbol_rate = None
|
||||||
self.r_preamble_symbols = None
|
self.r_preamble_symbols = None
|
||||||
self.r_premable_time_ms = None
|
self.r_premable_time_ms = None
|
||||||
self.r_battery_state = RNodeInterface.BATTERY_STATE_UNKNOWN
|
|
||||||
self.r_battery_percent = 0
|
|
||||||
|
|
||||||
self.packet_queue = []
|
self.packet_queue = []
|
||||||
self.flow_control = flow_control
|
self.flow_control = flow_control
|
||||||
self.interface_ready = False
|
self.interface_ready = False
|
||||||
self.announce_rate_target = None
|
self.announce_rate_target = None
|
||||||
|
|
||||||
if force_ble or self.ble_addr != None or self.ble_name != None:
|
|
||||||
self.use_ble = True
|
|
||||||
|
|
||||||
self.validcfg = True
|
self.validcfg = True
|
||||||
if (self.frequency < RNodeInterface.FREQ_MIN or self.frequency > RNodeInterface.FREQ_MAX):
|
if (self.frequency < RNodeInterface.FREQ_MIN or self.frequency > RNodeInterface.FREQ_MAX):
|
||||||
RNS.log("Invalid frequency configured for "+str(self), RNS.LOG_ERROR)
|
RNS.log("Invalid frequency configured for "+str(self), RNS.LOG_ERROR)
|
||||||
@ -268,31 +248,20 @@ class RNodeInterface(Interface):
|
|||||||
|
|
||||||
|
|
||||||
def open_port(self):
|
def open_port(self):
|
||||||
if not self.use_ble:
|
RNS.log("Opening serial port "+self.port+"...")
|
||||||
RNS.log("Opening serial port "+self.port+"...")
|
self.serial = self.pyserial.Serial(
|
||||||
self.serial = self.pyserial.Serial(
|
port = self.port,
|
||||||
port = self.port,
|
baudrate = self.speed,
|
||||||
baudrate = self.speed,
|
bytesize = self.databits,
|
||||||
bytesize = self.databits,
|
parity = self.pyserial.PARITY_NONE,
|
||||||
parity = self.pyserial.PARITY_NONE,
|
stopbits = self.stopbits,
|
||||||
stopbits = self.stopbits,
|
xonxoff = False,
|
||||||
xonxoff = False,
|
rtscts = False,
|
||||||
rtscts = False,
|
timeout = 0,
|
||||||
timeout = 0,
|
inter_byte_timeout = None,
|
||||||
inter_byte_timeout = None,
|
write_timeout = None,
|
||||||
write_timeout = None,
|
dsrdtr = False,
|
||||||
dsrdtr = False,
|
)
|
||||||
)
|
|
||||||
|
|
||||||
else:
|
|
||||||
RNS.log(f"Opening BLE connection for {self}...")
|
|
||||||
if self.ble == None:
|
|
||||||
self.ble = BLEConnection(owner=self, target_name=self.ble_name, target_bt_addr=self.ble_addr)
|
|
||||||
self.serial = self.ble
|
|
||||||
|
|
||||||
open_time = time.time()
|
|
||||||
while not self.ble.connected and time.time() < open_time + self.ble.CONNECT_TIMEOUT:
|
|
||||||
time.sleep(1)
|
|
||||||
|
|
||||||
|
|
||||||
def configure_device(self):
|
def configure_device(self):
|
||||||
@ -310,17 +279,7 @@ class RNodeInterface(Interface):
|
|||||||
thread.start()
|
thread.start()
|
||||||
|
|
||||||
self.detect()
|
self.detect()
|
||||||
if not self.use_ble:
|
sleep(0.2)
|
||||||
sleep(0.2)
|
|
||||||
else:
|
|
||||||
ble_detect_timeout = 5
|
|
||||||
detect_time = time.time()
|
|
||||||
while not self.detected and time.time() < detect_time + ble_detect_timeout:
|
|
||||||
time.sleep(0.1)
|
|
||||||
if self.detected:
|
|
||||||
detect_time = RNS.prettytime(time.time()-detect_time)
|
|
||||||
else:
|
|
||||||
RNS.log(f"RNode detect timed out over {self.port}", RNS.LOG_ERROR)
|
|
||||||
|
|
||||||
if not self.detected:
|
if not self.detected:
|
||||||
RNS.log("Could not detect device for "+str(self), RNS.LOG_ERROR)
|
RNS.log("Could not detect device for "+str(self), RNS.LOG_ERROR)
|
||||||
@ -354,9 +313,6 @@ class RNodeInterface(Interface):
|
|||||||
self.setLTALock()
|
self.setLTALock()
|
||||||
self.setRadioState(KISS.RADIO_STATE_ON)
|
self.setRadioState(KISS.RADIO_STATE_ON)
|
||||||
|
|
||||||
if self.use_ble:
|
|
||||||
time.sleep(2)
|
|
||||||
|
|
||||||
def detect(self):
|
def detect(self):
|
||||||
kiss_command = bytes([KISS.FEND, KISS.CMD_DETECT, KISS.DETECT_REQ, KISS.FEND, KISS.CMD_FW_VERSION, 0x00, KISS.FEND, KISS.CMD_PLATFORM, 0x00, KISS.FEND, KISS.CMD_MCU, 0x00, KISS.FEND])
|
kiss_command = bytes([KISS.FEND, KISS.CMD_DETECT, KISS.DETECT_REQ, KISS.FEND, KISS.CMD_FW_VERSION, 0x00, KISS.FEND, KISS.CMD_PLATFORM, 0x00, KISS.FEND, KISS.CMD_MCU, 0x00, KISS.FEND])
|
||||||
written = self.serial.write(kiss_command)
|
written = self.serial.write(kiss_command)
|
||||||
@ -809,25 +765,6 @@ class RNodeInterface(Interface):
|
|||||||
RNS.log(str(self)+" Radio reporting symbol time is "+str(round(self.r_symbol_time_ms,2))+"ms (at "+str(self.r_symbol_rate)+" baud)", RNS.LOG_DEBUG)
|
RNS.log(str(self)+" Radio reporting symbol time is "+str(round(self.r_symbol_time_ms,2))+"ms (at "+str(self.r_symbol_rate)+" baud)", RNS.LOG_DEBUG)
|
||||||
RNS.log(str(self)+" Radio reporting preamble is "+str(self.r_preamble_symbols)+" symbols ("+str(self.r_premable_time_ms)+"ms)", RNS.LOG_DEBUG)
|
RNS.log(str(self)+" Radio reporting preamble is "+str(self.r_preamble_symbols)+" symbols ("+str(self.r_premable_time_ms)+"ms)", RNS.LOG_DEBUG)
|
||||||
RNS.log(str(self)+" Radio reporting CSMA slot time is "+str(self.r_csma_slot_time_ms)+"ms", RNS.LOG_DEBUG)
|
RNS.log(str(self)+" Radio reporting CSMA slot time is "+str(self.r_csma_slot_time_ms)+"ms", RNS.LOG_DEBUG)
|
||||||
elif (command == KISS.CMD_STAT_BAT):
|
|
||||||
if (byte == KISS.FESC):
|
|
||||||
escape = True
|
|
||||||
else:
|
|
||||||
if (escape):
|
|
||||||
if (byte == KISS.TFEND):
|
|
||||||
byte = KISS.FEND
|
|
||||||
if (byte == KISS.TFESC):
|
|
||||||
byte = KISS.FESC
|
|
||||||
escape = False
|
|
||||||
command_buffer = command_buffer+bytes([byte])
|
|
||||||
if (len(command_buffer) == 2):
|
|
||||||
bat_percent = command_buffer[1]
|
|
||||||
if bat_percent > 100:
|
|
||||||
bat_percent = 100
|
|
||||||
if bat_percent < 0:
|
|
||||||
bat_percent = 0
|
|
||||||
self.r_battery_state = command_buffer[0]
|
|
||||||
self.r_battery_percent = bat_percent
|
|
||||||
elif (command == KISS.CMD_RANDOM):
|
elif (command == KISS.CMD_RANDOM):
|
||||||
self.r_random = byte
|
self.r_random = byte
|
||||||
elif (command == KISS.CMD_PLATFORM):
|
elif (command == KISS.CMD_PLATFORM):
|
||||||
@ -915,195 +852,9 @@ class RNodeInterface(Interface):
|
|||||||
self.disable_external_framebuffer()
|
self.disable_external_framebuffer()
|
||||||
self.setRadioState(KISS.RADIO_STATE_OFF)
|
self.setRadioState(KISS.RADIO_STATE_OFF)
|
||||||
self.leave()
|
self.leave()
|
||||||
|
|
||||||
if self.use_ble:
|
|
||||||
self.ble.close()
|
|
||||||
|
|
||||||
def should_ingress_limit(self):
|
def should_ingress_limit(self):
|
||||||
return False
|
return False
|
||||||
|
|
||||||
def get_battery_state(self):
|
|
||||||
return self.r_battery_state
|
|
||||||
|
|
||||||
def get_battery_state_string(self):
|
|
||||||
if self.r_battery_state == RNodeInterface.BATTERY_STATE_CHARGED:
|
|
||||||
return "charged"
|
|
||||||
elif self.r_battery_state == RNodeInterface.BATTERY_STATE_CHARGING:
|
|
||||||
return "charging"
|
|
||||||
elif self.r_battery_state == RNodeInterface.BATTERY_STATE_DISCHARGING:
|
|
||||||
return "discharging"
|
|
||||||
else:
|
|
||||||
return "unknown"
|
|
||||||
|
|
||||||
def get_battery_percent(self):
|
|
||||||
return self.r_battery_percent
|
|
||||||
|
|
||||||
def ble_receive(self, data):
|
|
||||||
with self.ble_rx_lock:
|
|
||||||
self.ble_rx_queue += data
|
|
||||||
|
|
||||||
def ble_waiting(self):
|
|
||||||
return len(self.ble_tx_queue) > 0
|
|
||||||
|
|
||||||
def get_ble_waiting(self, n):
|
|
||||||
with self.ble_tx_lock:
|
|
||||||
data = self.ble_tx_queue[:n]
|
|
||||||
self.ble_tx_queue = self.ble_tx_queue[n:]
|
|
||||||
return data
|
|
||||||
|
|
||||||
def __str__(self):
|
def __str__(self):
|
||||||
return "RNodeInterface["+str(self.name)+"]"
|
return "RNodeInterface["+str(self.name)+"]"
|
||||||
|
|
||||||
class BLEConnection():
|
|
||||||
UART_SERVICE_UUID = "6E400001-B5A3-F393-E0A9-E50E24DCCA9E"
|
|
||||||
UART_RX_CHAR_UUID = "6E400002-B5A3-F393-E0A9-E50E24DCCA9E"
|
|
||||||
UART_TX_CHAR_UUID = "6E400003-B5A3-F393-E0A9-E50E24DCCA9E"
|
|
||||||
bleak = None
|
|
||||||
|
|
||||||
SCAN_TIMEOUT = 2.0
|
|
||||||
CONNECT_TIMEOUT = 5.0
|
|
||||||
|
|
||||||
@property
|
|
||||||
def is_open(self):
|
|
||||||
return self.connected
|
|
||||||
|
|
||||||
@property
|
|
||||||
def in_waiting(self):
|
|
||||||
buflen = len(self.owner.ble_rx_queue)
|
|
||||||
return buflen > 0
|
|
||||||
|
|
||||||
def write(self, data_bytes):
|
|
||||||
with self.owner.ble_tx_lock:
|
|
||||||
self.owner.ble_tx_queue += data_bytes
|
|
||||||
return len(data_bytes)
|
|
||||||
|
|
||||||
def read(self, n):
|
|
||||||
with self.owner.ble_rx_lock:
|
|
||||||
data = self.owner.ble_rx_queue[:n]
|
|
||||||
self.owner.ble_rx_queue = self.owner.ble_rx_queue[n:]
|
|
||||||
return data
|
|
||||||
|
|
||||||
def close(self):
|
|
||||||
if self.connected and self.ble_device:
|
|
||||||
RNS.log(f"Disconnecting BLE device from {self.owner}", RNS.LOG_DEBUG)
|
|
||||||
self.must_disconnect = True
|
|
||||||
|
|
||||||
while self.connect_job_running:
|
|
||||||
time.sleep(0.1)
|
|
||||||
|
|
||||||
def __init__(self, owner=None, target_name=None, target_bt_addr=None):
|
|
||||||
self.owner = owner
|
|
||||||
self.target_name = target_name
|
|
||||||
self.target_bt_addr = target_bt_addr
|
|
||||||
self.scan_timeout = BLEConnection.SCAN_TIMEOUT
|
|
||||||
self.ble_device = None
|
|
||||||
self.connected = False
|
|
||||||
self.running = False
|
|
||||||
self.should_run = False
|
|
||||||
self.must_disconnect = False
|
|
||||||
self.connect_job_running = False
|
|
||||||
|
|
||||||
import importlib
|
|
||||||
if BLEConnection.bleak == None:
|
|
||||||
if importlib.util.find_spec("bleak") != None:
|
|
||||||
import bleak
|
|
||||||
BLEConnection.bleak = bleak
|
|
||||||
|
|
||||||
import asyncio
|
|
||||||
BLEConnection.asyncio = asyncio
|
|
||||||
else:
|
|
||||||
RNS.log("Using the RNode interface over BLE requires a the \"bleak\" module to be installed.", RNS.LOG_CRITICAL)
|
|
||||||
RNS.log("You can install one with the command: python3 -m pip install bleak", RNS.LOG_CRITICAL)
|
|
||||||
RNS.panic()
|
|
||||||
|
|
||||||
self.should_run = True
|
|
||||||
self.connection_thread = threading.Thread(target=self.connection_job, daemon=True).start()
|
|
||||||
|
|
||||||
def connection_job(self):
|
|
||||||
while (self.should_run):
|
|
||||||
if self.ble_device == None:
|
|
||||||
self.ble_device = self.find_target_device()
|
|
||||||
|
|
||||||
if type(self.ble_device) == self.bleak.backends.device.BLEDevice:
|
|
||||||
if not self.connected:
|
|
||||||
self.connect_device()
|
|
||||||
|
|
||||||
time.sleep(1)
|
|
||||||
|
|
||||||
def connect_device(self):
|
|
||||||
if self.ble_device != None and type(self.ble_device) == self.bleak.backends.device.BLEDevice:
|
|
||||||
RNS.log(f"Connecting BLE device {self.ble_device} for {self.owner}...", RNS.LOG_DEBUG)
|
|
||||||
|
|
||||||
async def connect_job():
|
|
||||||
self.connect_job_running = True
|
|
||||||
async with self.bleak.BleakClient(self.ble_device, disconnected_callback=self.device_disconnected) as ble_client:
|
|
||||||
def handle_rx(device, data):
|
|
||||||
if self.owner != None:
|
|
||||||
self.owner.ble_receive(data)
|
|
||||||
|
|
||||||
self.connected = True
|
|
||||||
self.ble_device = ble_client
|
|
||||||
self.owner.port = str(f"ble://{ble_client.address}")
|
|
||||||
|
|
||||||
loop = self.asyncio.get_running_loop()
|
|
||||||
uart_service = ble_client.services.get_service(BLEConnection.UART_SERVICE_UUID)
|
|
||||||
rx_characteristic = uart_service.get_characteristic(BLEConnection.UART_RX_CHAR_UUID)
|
|
||||||
await ble_client.start_notify(BLEConnection.UART_TX_CHAR_UUID, handle_rx)
|
|
||||||
|
|
||||||
while self.connected:
|
|
||||||
if self.owner != None and self.owner.ble_waiting():
|
|
||||||
outbound_data = self.owner.get_ble_waiting(rx_characteristic.max_write_without_response_size)
|
|
||||||
await ble_client.write_gatt_char(rx_characteristic, outbound_data, response=False)
|
|
||||||
elif self.must_disconnect:
|
|
||||||
await ble_client.disconnect()
|
|
||||||
else:
|
|
||||||
await self.asyncio.sleep(0.1)
|
|
||||||
|
|
||||||
|
|
||||||
try:
|
|
||||||
self.asyncio.run(connect_job())
|
|
||||||
except Exception as e:
|
|
||||||
RNS.log(f"Could not connect BLE device {self.ble_device} for {self.owner}. Possibly missing authentication.", RNS.LOG_ERROR)
|
|
||||||
self.connect_job_running = False
|
|
||||||
|
|
||||||
def device_disconnected(self, device):
|
|
||||||
RNS.log(f"BLE device for {self.owner} disconnected", RNS.LOG_NOTICE)
|
|
||||||
self.connected = False
|
|
||||||
self.ble_device = None
|
|
||||||
|
|
||||||
def find_target_device(self):
|
|
||||||
RNS.log(f"Searching for attachable BLE device for {self.owner}...", RNS.LOG_EXTREME)
|
|
||||||
def device_filter(device: self.bleak.backends.device.BLEDevice, adv: self.bleak.backends.scanner.AdvertisementData):
|
|
||||||
if BLEConnection.UART_SERVICE_UUID.lower() in adv.service_uuids:
|
|
||||||
if self.device_bonded(device):
|
|
||||||
if self.target_bt_addr == None and self.target_name == None:
|
|
||||||
if device.name.startswith("RNode "):
|
|
||||||
return True
|
|
||||||
|
|
||||||
if self.target_bt_addr == None or (device.address != None and device.address == self.target_bt_addr):
|
|
||||||
if self.target_name == None or (device.name != None and device.name == self.target_name):
|
|
||||||
return True
|
|
||||||
|
|
||||||
else:
|
|
||||||
if self.target_bt_addr != None and device.address == self.target_bt_addr:
|
|
||||||
RNS.log(f"Can't connect to target device {self.target_bt_addr} over BLE, device is not bonded", RNS.LOG_ERROR)
|
|
||||||
|
|
||||||
elif self.target_name != None and device.name == self.target_name:
|
|
||||||
RNS.log(f"Can't connect to target device {self.target_name} over BLE, device is not bonded", RNS.LOG_ERROR)
|
|
||||||
|
|
||||||
return False
|
|
||||||
|
|
||||||
device = self.asyncio.run(self.bleak.BleakScanner.find_device_by_filter(device_filter, timeout=self.scan_timeout))
|
|
||||||
return device
|
|
||||||
|
|
||||||
def device_bonded(self, device):
|
|
||||||
try:
|
|
||||||
if hasattr(device, "details"):
|
|
||||||
if "props" in device.details and "Bonded" in device.details["props"]:
|
|
||||||
if device.details["props"]["Bonded"] == True:
|
|
||||||
return True
|
|
||||||
|
|
||||||
except Exception as e:
|
|
||||||
RNS.log(f"Error while determining device bond status for {device}, the contained exception was: {e}", RNS.LOG_ERROR)
|
|
||||||
|
|
||||||
return False
|
|
||||||
|
@ -916,28 +916,11 @@ class Reticulum:
|
|||||||
st_alock = float(c["airtime_limit_short"]) if "airtime_limit_short" in c else None
|
st_alock = float(c["airtime_limit_short"]) if "airtime_limit_short" in c else None
|
||||||
lt_alock = float(c["airtime_limit_long"]) if "airtime_limit_long" in c else None
|
lt_alock = float(c["airtime_limit_long"]) if "airtime_limit_long" in c else None
|
||||||
|
|
||||||
force_ble = False
|
|
||||||
ble_name = None
|
|
||||||
ble_addr = None
|
|
||||||
|
|
||||||
port = c["port"] if "port" in c else None
|
port = c["port"] if "port" in c else None
|
||||||
|
|
||||||
if port == None:
|
if port == None:
|
||||||
raise ValueError("No port specified for RNode interface")
|
raise ValueError("No port specified for RNode interface")
|
||||||
|
|
||||||
if port != None:
|
|
||||||
ble_uri_scheme = "ble://"
|
|
||||||
if port.lower().startswith(ble_uri_scheme):
|
|
||||||
force_ble = True
|
|
||||||
ble_string = port[len(ble_uri_scheme):]
|
|
||||||
port = None
|
|
||||||
if len(ble_string) == 0:
|
|
||||||
pass
|
|
||||||
elif len(ble_string.split(":")) == 6 and len(ble_string) == 17:
|
|
||||||
ble_addr = ble_string
|
|
||||||
else:
|
|
||||||
ble_name = ble_string
|
|
||||||
|
|
||||||
interface = RNodeInterface.RNodeInterface(
|
interface = RNodeInterface.RNodeInterface(
|
||||||
RNS.Transport,
|
RNS.Transport,
|
||||||
name,
|
name,
|
||||||
@ -951,10 +934,7 @@ class Reticulum:
|
|||||||
id_interval = id_interval,
|
id_interval = id_interval,
|
||||||
id_callsign = id_callsign,
|
id_callsign = id_callsign,
|
||||||
st_alock = st_alock,
|
st_alock = st_alock,
|
||||||
lt_alock = lt_alock,
|
lt_alock = lt_alock
|
||||||
ble_addr = ble_addr,
|
|
||||||
ble_name = ble_name,
|
|
||||||
force_ble = force_ble,
|
|
||||||
)
|
)
|
||||||
|
|
||||||
if "outgoing" in c and c.as_bool("outgoing") == False:
|
if "outgoing" in c and c.as_bool("outgoing") == False:
|
||||||
@ -1325,13 +1305,6 @@ class Reticulum:
|
|||||||
if hasattr(interface, "r_channel_load_long"):
|
if hasattr(interface, "r_channel_load_long"):
|
||||||
ifstats["channel_load_long"] = interface.r_channel_load_long
|
ifstats["channel_load_long"] = interface.r_channel_load_long
|
||||||
|
|
||||||
if hasattr(interface, "r_battery_state"):
|
|
||||||
if interface.r_battery_state != 0x00:
|
|
||||||
ifstats["battery_state"] = interface.r_battery_state
|
|
||||||
|
|
||||||
if hasattr(interface, "r_battery_percent"):
|
|
||||||
ifstats["battery_percent"] = interface.r_battery_percent
|
|
||||||
|
|
||||||
if hasattr(interface, "bitrate"):
|
if hasattr(interface, "bitrate"):
|
||||||
if interface.bitrate != None:
|
if interface.bitrate != None:
|
||||||
ifstats["bitrate"] = interface.bitrate
|
ifstats["bitrate"] = interface.bitrate
|
||||||
|
@ -294,23 +294,6 @@ loglevel = 4
|
|||||||
# Serial port for the device
|
# Serial port for the device
|
||||||
port = /dev/ttyUSB0
|
port = /dev/ttyUSB0
|
||||||
|
|
||||||
# It is also possible to use BLE devices
|
|
||||||
# instead of wired serial ports. The
|
|
||||||
# target RNode must be paired with the
|
|
||||||
# host device before connecting. BLE
|
|
||||||
# devices can be connected by name,
|
|
||||||
# BLE MAC address or by any available.
|
|
||||||
|
|
||||||
# Connect to specific device by name
|
|
||||||
# port = ble://RNode 3B87
|
|
||||||
|
|
||||||
# Or by BLE MAC address
|
|
||||||
# port = ble://F4:12:73:29:4E:89
|
|
||||||
|
|
||||||
# Or connect to the first available,
|
|
||||||
# paired device
|
|
||||||
# port = ble://
|
|
||||||
|
|
||||||
# Set frequency to 867.2 MHz
|
# Set frequency to 867.2 MHz
|
||||||
frequency = 867200000
|
frequency = 867200000
|
||||||
|
|
||||||
|
@ -292,13 +292,6 @@ def program_setup(configdir, dispall=False, verbosity=0, name_filter=None, json=
|
|||||||
if "bitrate" in ifstat and ifstat["bitrate"] != None:
|
if "bitrate" in ifstat and ifstat["bitrate"] != None:
|
||||||
print(" Rate : {ss}".format(ss=speed_str(ifstat["bitrate"])))
|
print(" Rate : {ss}".format(ss=speed_str(ifstat["bitrate"])))
|
||||||
|
|
||||||
if "battery_percent" in ifstat and ifstat["battery_percent"] != None:
|
|
||||||
try:
|
|
||||||
bpi = int(ifstat["battery_percent"])
|
|
||||||
print(" Battery : {bp}%".format(bp=bpi))
|
|
||||||
except:
|
|
||||||
pass
|
|
||||||
|
|
||||||
if "airtime_short" in ifstat and "airtime_long" in ifstat:
|
if "airtime_short" in ifstat and "airtime_long" in ifstat:
|
||||||
print(" Airtime : {ats}% (15s), {atl}% (1h)".format(ats=str(ifstat["airtime_short"]),atl=str(ifstat["airtime_long"])))
|
print(" Airtime : {ats}% (15s), {atl}% (1h)".format(ats=str(ifstat["airtime_short"]),atl=str(ifstat["airtime_long"])))
|
||||||
|
|
||||||
|
@ -1 +1 @@
|
|||||||
__version__ = "0.8.1"
|
__version__ = "0.8.0"
|
||||||
|
Binary file not shown.
Binary file not shown.
@ -1,4 +1,4 @@
|
|||||||
# Sphinx build info version 1
|
# Sphinx build info version 1
|
||||||
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
|
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
|
||||||
config: 1447e58e81cf4037238271210a352494
|
config: 94939fd3ce633867445ef29897b42133
|
||||||
tags: 645f666f9bcd5a90fca523b33c5a78b7
|
tags: 645f666f9bcd5a90fca523b33c5a78b7
|
||||||
|
@ -358,23 +358,6 @@ can be used, and offers full control over LoRa parameters.
|
|||||||
# Serial port for the device
|
# Serial port for the device
|
||||||
port = /dev/ttyUSB0
|
port = /dev/ttyUSB0
|
||||||
|
|
||||||
# It is also possible to use BLE devices
|
|
||||||
# instead of wired serial ports. The
|
|
||||||
# target RNode must be paired with the
|
|
||||||
# host device before connecting. BLE
|
|
||||||
# devices can be connected by name,
|
|
||||||
# BLE MAC address or by any available.
|
|
||||||
|
|
||||||
# Connect to specific device by name
|
|
||||||
# port = ble://RNode 3B87
|
|
||||||
|
|
||||||
# Or by BLE MAC address
|
|
||||||
# port = ble://F4:12:73:29:4E:89
|
|
||||||
|
|
||||||
# Or connect to the first available,
|
|
||||||
# paired device
|
|
||||||
# port = ble://
|
|
||||||
|
|
||||||
# Set frequency to 867.2 MHz
|
# Set frequency to 867.2 MHz
|
||||||
frequency = 867200000
|
frequency = 867200000
|
||||||
|
|
||||||
|
@ -1,6 +1,6 @@
|
|||||||
var DOCUMENTATION_OPTIONS = {
|
var DOCUMENTATION_OPTIONS = {
|
||||||
URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'),
|
URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'),
|
||||||
VERSION: '0.8.1 beta',
|
VERSION: '0.8.0 beta',
|
||||||
LANGUAGE: 'en',
|
LANGUAGE: 'en',
|
||||||
COLLAPSE_INDEX: false,
|
COLLAPSE_INDEX: false,
|
||||||
BUILDER: 'html',
|
BUILDER: 'html',
|
||||||
|
@ -6,7 +6,7 @@
|
|||||||
<link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="Support Reticulum" href="support.html" /><link rel="prev" title="Building Networks" href="networks.html" />
|
<link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="Support Reticulum" href="support.html" /><link rel="prev" title="Building Networks" href="networks.html" />
|
||||||
|
|
||||||
<meta name="generator" content="sphinx-5.3.0, furo 2022.09.29.dev1"/>
|
<meta name="generator" content="sphinx-5.3.0, furo 2022.09.29.dev1"/>
|
||||||
<title>Code Examples - Reticulum Network Stack 0.8.1 beta documentation</title>
|
<title>Code Examples - Reticulum Network Stack 0.8.0 beta documentation</title>
|
||||||
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
|
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
|
||||||
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?digest=189ec851f9bb375a2509b67be1f64f0cf212b702" />
|
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?digest=189ec851f9bb375a2509b67be1f64f0cf212b702" />
|
||||||
<link rel="stylesheet" type="text/css" href="_static/copybutton.css" />
|
<link rel="stylesheet" type="text/css" href="_static/copybutton.css" />
|
||||||
@ -141,7 +141,7 @@
|
|||||||
</label>
|
</label>
|
||||||
</div>
|
</div>
|
||||||
<div class="header-center">
|
<div class="header-center">
|
||||||
<a href="index.html"><div class="brand">Reticulum Network Stack 0.8.1 beta documentation</div></a>
|
<a href="index.html"><div class="brand">Reticulum Network Stack 0.8.0 beta documentation</div></a>
|
||||||
</div>
|
</div>
|
||||||
<div class="header-right">
|
<div class="header-right">
|
||||||
<div class="theme-toggle-container theme-toggle-header">
|
<div class="theme-toggle-container theme-toggle-header">
|
||||||
@ -167,7 +167,7 @@
|
|||||||
<img class="sidebar-logo" src="_static/rns_logo_512.png" alt="Logo"/>
|
<img class="sidebar-logo" src="_static/rns_logo_512.png" alt="Logo"/>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<span class="sidebar-brand-text">Reticulum Network Stack 0.8.1 beta documentation</span>
|
<span class="sidebar-brand-text">Reticulum Network Stack 0.8.0 beta documentation</span>
|
||||||
|
|
||||||
</a><form class="sidebar-search-container" method="get" action="search.html" role="search">
|
</a><form class="sidebar-search-container" method="get" action="search.html" role="search">
|
||||||
<input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
|
<input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
|
||||||
|
@ -6,7 +6,7 @@
|
|||||||
<link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" />
|
<link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" />
|
||||||
|
|
||||||
<meta name="generator" content="sphinx-5.3.0, furo 2022.09.29.dev1"/>
|
<meta name="generator" content="sphinx-5.3.0, furo 2022.09.29.dev1"/>
|
||||||
<title>An Explanation of Reticulum for Human Beings - Reticulum Network Stack 0.8.1 beta documentation</title>
|
<title>An Explanation of Reticulum for Human Beings - Reticulum Network Stack 0.8.0 beta documentation</title>
|
||||||
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
|
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
|
||||||
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?digest=189ec851f9bb375a2509b67be1f64f0cf212b702" />
|
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?digest=189ec851f9bb375a2509b67be1f64f0cf212b702" />
|
||||||
<link rel="stylesheet" type="text/css" href="_static/copybutton.css" />
|
<link rel="stylesheet" type="text/css" href="_static/copybutton.css" />
|
||||||
@ -141,7 +141,7 @@
|
|||||||
</label>
|
</label>
|
||||||
</div>
|
</div>
|
||||||
<div class="header-center">
|
<div class="header-center">
|
||||||
<a href="index.html"><div class="brand">Reticulum Network Stack 0.8.1 beta documentation</div></a>
|
<a href="index.html"><div class="brand">Reticulum Network Stack 0.8.0 beta documentation</div></a>
|
||||||
</div>
|
</div>
|
||||||
<div class="header-right">
|
<div class="header-right">
|
||||||
<div class="theme-toggle-container theme-toggle-header">
|
<div class="theme-toggle-container theme-toggle-header">
|
||||||
@ -167,7 +167,7 @@
|
|||||||
<img class="sidebar-logo" src="_static/rns_logo_512.png" alt="Logo"/>
|
<img class="sidebar-logo" src="_static/rns_logo_512.png" alt="Logo"/>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<span class="sidebar-brand-text">Reticulum Network Stack 0.8.1 beta documentation</span>
|
<span class="sidebar-brand-text">Reticulum Network Stack 0.8.0 beta documentation</span>
|
||||||
|
|
||||||
</a><form class="sidebar-search-container" method="get" action="search.html" role="search">
|
</a><form class="sidebar-search-container" method="get" action="search.html" role="search">
|
||||||
<input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
|
<input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
|
||||||
|
@ -4,7 +4,7 @@
|
|||||||
<meta name="viewport" content="width=device-width,initial-scale=1"/>
|
<meta name="viewport" content="width=device-width,initial-scale=1"/>
|
||||||
<meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="#" /><link rel="search" title="Search" href="search.html" />
|
<meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="#" /><link rel="search" title="Search" href="search.html" />
|
||||||
|
|
||||||
<meta name="generator" content="sphinx-5.3.0, furo 2022.09.29.dev1"/><title>Index - Reticulum Network Stack 0.8.1 beta documentation</title>
|
<meta name="generator" content="sphinx-5.3.0, furo 2022.09.29.dev1"/><title>Index - Reticulum Network Stack 0.8.0 beta documentation</title>
|
||||||
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
|
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
|
||||||
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?digest=189ec851f9bb375a2509b67be1f64f0cf212b702" />
|
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?digest=189ec851f9bb375a2509b67be1f64f0cf212b702" />
|
||||||
<link rel="stylesheet" type="text/css" href="_static/copybutton.css" />
|
<link rel="stylesheet" type="text/css" href="_static/copybutton.css" />
|
||||||
@ -139,7 +139,7 @@
|
|||||||
</label>
|
</label>
|
||||||
</div>
|
</div>
|
||||||
<div class="header-center">
|
<div class="header-center">
|
||||||
<a href="index.html"><div class="brand">Reticulum Network Stack 0.8.1 beta documentation</div></a>
|
<a href="index.html"><div class="brand">Reticulum Network Stack 0.8.0 beta documentation</div></a>
|
||||||
</div>
|
</div>
|
||||||
<div class="header-right">
|
<div class="header-right">
|
||||||
<div class="theme-toggle-container theme-toggle-header">
|
<div class="theme-toggle-container theme-toggle-header">
|
||||||
@ -165,7 +165,7 @@
|
|||||||
<img class="sidebar-logo" src="_static/rns_logo_512.png" alt="Logo"/>
|
<img class="sidebar-logo" src="_static/rns_logo_512.png" alt="Logo"/>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<span class="sidebar-brand-text">Reticulum Network Stack 0.8.1 beta documentation</span>
|
<span class="sidebar-brand-text">Reticulum Network Stack 0.8.0 beta documentation</span>
|
||||||
|
|
||||||
</a><form class="sidebar-search-container" method="get" action="search.html" role="search">
|
</a><form class="sidebar-search-container" method="get" action="search.html" role="search">
|
||||||
<input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
|
<input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
|
||||||
|
@ -6,7 +6,7 @@
|
|||||||
<link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="Using Reticulum on Your System" href="using.html" /><link rel="prev" title="What is Reticulum?" href="whatis.html" />
|
<link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="Using Reticulum on Your System" href="using.html" /><link rel="prev" title="What is Reticulum?" href="whatis.html" />
|
||||||
|
|
||||||
<meta name="generator" content="sphinx-5.3.0, furo 2022.09.29.dev1"/>
|
<meta name="generator" content="sphinx-5.3.0, furo 2022.09.29.dev1"/>
|
||||||
<title>Getting Started Fast - Reticulum Network Stack 0.8.1 beta documentation</title>
|
<title>Getting Started Fast - Reticulum Network Stack 0.8.0 beta documentation</title>
|
||||||
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
|
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
|
||||||
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?digest=189ec851f9bb375a2509b67be1f64f0cf212b702" />
|
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?digest=189ec851f9bb375a2509b67be1f64f0cf212b702" />
|
||||||
<link rel="stylesheet" type="text/css" href="_static/copybutton.css" />
|
<link rel="stylesheet" type="text/css" href="_static/copybutton.css" />
|
||||||
@ -141,7 +141,7 @@
|
|||||||
</label>
|
</label>
|
||||||
</div>
|
</div>
|
||||||
<div class="header-center">
|
<div class="header-center">
|
||||||
<a href="index.html"><div class="brand">Reticulum Network Stack 0.8.1 beta documentation</div></a>
|
<a href="index.html"><div class="brand">Reticulum Network Stack 0.8.0 beta documentation</div></a>
|
||||||
</div>
|
</div>
|
||||||
<div class="header-right">
|
<div class="header-right">
|
||||||
<div class="theme-toggle-container theme-toggle-header">
|
<div class="theme-toggle-container theme-toggle-header">
|
||||||
@ -167,7 +167,7 @@
|
|||||||
<img class="sidebar-logo" src="_static/rns_logo_512.png" alt="Logo"/>
|
<img class="sidebar-logo" src="_static/rns_logo_512.png" alt="Logo"/>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<span class="sidebar-brand-text">Reticulum Network Stack 0.8.1 beta documentation</span>
|
<span class="sidebar-brand-text">Reticulum Network Stack 0.8.0 beta documentation</span>
|
||||||
|
|
||||||
</a><form class="sidebar-search-container" method="get" action="search.html" role="search">
|
</a><form class="sidebar-search-container" method="get" action="search.html" role="search">
|
||||||
<input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
|
<input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
|
||||||
|
@ -6,7 +6,7 @@
|
|||||||
<link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="Configuring Interfaces" href="interfaces.html" /><link rel="prev" title="Understanding Reticulum" href="understanding.html" />
|
<link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="Configuring Interfaces" href="interfaces.html" /><link rel="prev" title="Understanding Reticulum" href="understanding.html" />
|
||||||
|
|
||||||
<meta name="generator" content="sphinx-5.3.0, furo 2022.09.29.dev1"/>
|
<meta name="generator" content="sphinx-5.3.0, furo 2022.09.29.dev1"/>
|
||||||
<title>Communications Hardware - Reticulum Network Stack 0.8.1 beta documentation</title>
|
<title>Communications Hardware - Reticulum Network Stack 0.8.0 beta documentation</title>
|
||||||
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
|
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
|
||||||
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?digest=189ec851f9bb375a2509b67be1f64f0cf212b702" />
|
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?digest=189ec851f9bb375a2509b67be1f64f0cf212b702" />
|
||||||
<link rel="stylesheet" type="text/css" href="_static/copybutton.css" />
|
<link rel="stylesheet" type="text/css" href="_static/copybutton.css" />
|
||||||
@ -141,7 +141,7 @@
|
|||||||
</label>
|
</label>
|
||||||
</div>
|
</div>
|
||||||
<div class="header-center">
|
<div class="header-center">
|
||||||
<a href="index.html"><div class="brand">Reticulum Network Stack 0.8.1 beta documentation</div></a>
|
<a href="index.html"><div class="brand">Reticulum Network Stack 0.8.0 beta documentation</div></a>
|
||||||
</div>
|
</div>
|
||||||
<div class="header-right">
|
<div class="header-right">
|
||||||
<div class="theme-toggle-container theme-toggle-header">
|
<div class="theme-toggle-container theme-toggle-header">
|
||||||
@ -167,7 +167,7 @@
|
|||||||
<img class="sidebar-logo" src="_static/rns_logo_512.png" alt="Logo"/>
|
<img class="sidebar-logo" src="_static/rns_logo_512.png" alt="Logo"/>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<span class="sidebar-brand-text">Reticulum Network Stack 0.8.1 beta documentation</span>
|
<span class="sidebar-brand-text">Reticulum Network Stack 0.8.0 beta documentation</span>
|
||||||
|
|
||||||
</a><form class="sidebar-search-container" method="get" action="search.html" role="search">
|
</a><form class="sidebar-search-container" method="get" action="search.html" role="search">
|
||||||
<input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
|
<input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
|
||||||
|
@ -6,7 +6,7 @@
|
|||||||
<link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="What is Reticulum?" href="whatis.html" />
|
<link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="What is Reticulum?" href="whatis.html" />
|
||||||
|
|
||||||
<meta name="generator" content="sphinx-5.3.0, furo 2022.09.29.dev1"/>
|
<meta name="generator" content="sphinx-5.3.0, furo 2022.09.29.dev1"/>
|
||||||
<title>Reticulum Network Stack 0.8.1 beta documentation</title>
|
<title>Reticulum Network Stack 0.8.0 beta documentation</title>
|
||||||
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
|
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
|
||||||
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?digest=189ec851f9bb375a2509b67be1f64f0cf212b702" />
|
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?digest=189ec851f9bb375a2509b67be1f64f0cf212b702" />
|
||||||
<link rel="stylesheet" type="text/css" href="_static/copybutton.css" />
|
<link rel="stylesheet" type="text/css" href="_static/copybutton.css" />
|
||||||
@ -141,7 +141,7 @@
|
|||||||
</label>
|
</label>
|
||||||
</div>
|
</div>
|
||||||
<div class="header-center">
|
<div class="header-center">
|
||||||
<a href="#"><div class="brand">Reticulum Network Stack 0.8.1 beta documentation</div></a>
|
<a href="#"><div class="brand">Reticulum Network Stack 0.8.0 beta documentation</div></a>
|
||||||
</div>
|
</div>
|
||||||
<div class="header-right">
|
<div class="header-right">
|
||||||
<div class="theme-toggle-container theme-toggle-header">
|
<div class="theme-toggle-container theme-toggle-header">
|
||||||
@ -167,7 +167,7 @@
|
|||||||
<img class="sidebar-logo" src="_static/rns_logo_512.png" alt="Logo"/>
|
<img class="sidebar-logo" src="_static/rns_logo_512.png" alt="Logo"/>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<span class="sidebar-brand-text">Reticulum Network Stack 0.8.1 beta documentation</span>
|
<span class="sidebar-brand-text">Reticulum Network Stack 0.8.0 beta documentation</span>
|
||||||
|
|
||||||
</a><form class="sidebar-search-container" method="get" action="search.html" role="search">
|
</a><form class="sidebar-search-container" method="get" action="search.html" role="search">
|
||||||
<input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
|
<input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
|
||||||
|
@ -6,7 +6,7 @@
|
|||||||
<link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="Building Networks" href="networks.html" /><link rel="prev" title="Communications Hardware" href="hardware.html" />
|
<link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="Building Networks" href="networks.html" /><link rel="prev" title="Communications Hardware" href="hardware.html" />
|
||||||
|
|
||||||
<meta name="generator" content="sphinx-5.3.0, furo 2022.09.29.dev1"/>
|
<meta name="generator" content="sphinx-5.3.0, furo 2022.09.29.dev1"/>
|
||||||
<title>Configuring Interfaces - Reticulum Network Stack 0.8.1 beta documentation</title>
|
<title>Configuring Interfaces - Reticulum Network Stack 0.8.0 beta documentation</title>
|
||||||
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
|
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
|
||||||
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?digest=189ec851f9bb375a2509b67be1f64f0cf212b702" />
|
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?digest=189ec851f9bb375a2509b67be1f64f0cf212b702" />
|
||||||
<link rel="stylesheet" type="text/css" href="_static/copybutton.css" />
|
<link rel="stylesheet" type="text/css" href="_static/copybutton.css" />
|
||||||
@ -141,7 +141,7 @@
|
|||||||
</label>
|
</label>
|
||||||
</div>
|
</div>
|
||||||
<div class="header-center">
|
<div class="header-center">
|
||||||
<a href="index.html"><div class="brand">Reticulum Network Stack 0.8.1 beta documentation</div></a>
|
<a href="index.html"><div class="brand">Reticulum Network Stack 0.8.0 beta documentation</div></a>
|
||||||
</div>
|
</div>
|
||||||
<div class="header-right">
|
<div class="header-right">
|
||||||
<div class="theme-toggle-container theme-toggle-header">
|
<div class="theme-toggle-container theme-toggle-header">
|
||||||
@ -167,7 +167,7 @@
|
|||||||
<img class="sidebar-logo" src="_static/rns_logo_512.png" alt="Logo"/>
|
<img class="sidebar-logo" src="_static/rns_logo_512.png" alt="Logo"/>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<span class="sidebar-brand-text">Reticulum Network Stack 0.8.1 beta documentation</span>
|
<span class="sidebar-brand-text">Reticulum Network Stack 0.8.0 beta documentation</span>
|
||||||
|
|
||||||
</a><form class="sidebar-search-container" method="get" action="search.html" role="search">
|
</a><form class="sidebar-search-container" method="get" action="search.html" role="search">
|
||||||
<input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
|
<input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
|
||||||
@ -520,23 +520,6 @@ can be used, and offers full control over LoRa parameters.</p>
|
|||||||
<span class="c1"># Serial port for the device</span>
|
<span class="c1"># Serial port for the device</span>
|
||||||
<span class="n">port</span> <span class="o">=</span> <span class="o">/</span><span class="n">dev</span><span class="o">/</span><span class="n">ttyUSB0</span>
|
<span class="n">port</span> <span class="o">=</span> <span class="o">/</span><span class="n">dev</span><span class="o">/</span><span class="n">ttyUSB0</span>
|
||||||
|
|
||||||
<span class="c1"># It is also possible to use BLE devices</span>
|
|
||||||
<span class="c1"># instead of wired serial ports. The</span>
|
|
||||||
<span class="c1"># target RNode must be paired with the</span>
|
|
||||||
<span class="c1"># host device before connecting. BLE</span>
|
|
||||||
<span class="c1"># devices can be connected by name,</span>
|
|
||||||
<span class="c1"># BLE MAC address or by any available.</span>
|
|
||||||
|
|
||||||
<span class="c1"># Connect to specific device by name</span>
|
|
||||||
<span class="c1"># port = ble://RNode 3B87</span>
|
|
||||||
|
|
||||||
<span class="c1"># Or by BLE MAC address</span>
|
|
||||||
<span class="c1"># port = ble://F4:12:73:29:4E:89</span>
|
|
||||||
|
|
||||||
<span class="c1"># Or connect to the first available,</span>
|
|
||||||
<span class="c1"># paired device</span>
|
|
||||||
<span class="c1"># port = ble://</span>
|
|
||||||
|
|
||||||
<span class="c1"># Set frequency to 867.2 MHz</span>
|
<span class="c1"># Set frequency to 867.2 MHz</span>
|
||||||
<span class="n">frequency</span> <span class="o">=</span> <span class="mi">867200000</span>
|
<span class="n">frequency</span> <span class="o">=</span> <span class="mi">867200000</span>
|
||||||
|
|
||||||
|
@ -6,7 +6,7 @@
|
|||||||
<link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="Code Examples" href="examples.html" /><link rel="prev" title="Configuring Interfaces" href="interfaces.html" />
|
<link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="Code Examples" href="examples.html" /><link rel="prev" title="Configuring Interfaces" href="interfaces.html" />
|
||||||
|
|
||||||
<meta name="generator" content="sphinx-5.3.0, furo 2022.09.29.dev1"/>
|
<meta name="generator" content="sphinx-5.3.0, furo 2022.09.29.dev1"/>
|
||||||
<title>Building Networks - Reticulum Network Stack 0.8.1 beta documentation</title>
|
<title>Building Networks - Reticulum Network Stack 0.8.0 beta documentation</title>
|
||||||
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
|
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
|
||||||
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?digest=189ec851f9bb375a2509b67be1f64f0cf212b702" />
|
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?digest=189ec851f9bb375a2509b67be1f64f0cf212b702" />
|
||||||
<link rel="stylesheet" type="text/css" href="_static/copybutton.css" />
|
<link rel="stylesheet" type="text/css" href="_static/copybutton.css" />
|
||||||
@ -141,7 +141,7 @@
|
|||||||
</label>
|
</label>
|
||||||
</div>
|
</div>
|
||||||
<div class="header-center">
|
<div class="header-center">
|
||||||
<a href="index.html"><div class="brand">Reticulum Network Stack 0.8.1 beta documentation</div></a>
|
<a href="index.html"><div class="brand">Reticulum Network Stack 0.8.0 beta documentation</div></a>
|
||||||
</div>
|
</div>
|
||||||
<div class="header-right">
|
<div class="header-right">
|
||||||
<div class="theme-toggle-container theme-toggle-header">
|
<div class="theme-toggle-container theme-toggle-header">
|
||||||
@ -167,7 +167,7 @@
|
|||||||
<img class="sidebar-logo" src="_static/rns_logo_512.png" alt="Logo"/>
|
<img class="sidebar-logo" src="_static/rns_logo_512.png" alt="Logo"/>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<span class="sidebar-brand-text">Reticulum Network Stack 0.8.1 beta documentation</span>
|
<span class="sidebar-brand-text">Reticulum Network Stack 0.8.0 beta documentation</span>
|
||||||
|
|
||||||
</a><form class="sidebar-search-container" method="get" action="search.html" role="search">
|
</a><form class="sidebar-search-container" method="get" action="search.html" role="search">
|
||||||
<input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
|
<input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
|
||||||
|
Binary file not shown.
@ -6,7 +6,7 @@
|
|||||||
<link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="prev" title="Support Reticulum" href="support.html" />
|
<link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="prev" title="Support Reticulum" href="support.html" />
|
||||||
|
|
||||||
<meta name="generator" content="sphinx-5.3.0, furo 2022.09.29.dev1"/>
|
<meta name="generator" content="sphinx-5.3.0, furo 2022.09.29.dev1"/>
|
||||||
<title>API Reference - Reticulum Network Stack 0.8.1 beta documentation</title>
|
<title>API Reference - Reticulum Network Stack 0.8.0 beta documentation</title>
|
||||||
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
|
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
|
||||||
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?digest=189ec851f9bb375a2509b67be1f64f0cf212b702" />
|
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?digest=189ec851f9bb375a2509b67be1f64f0cf212b702" />
|
||||||
<link rel="stylesheet" type="text/css" href="_static/copybutton.css" />
|
<link rel="stylesheet" type="text/css" href="_static/copybutton.css" />
|
||||||
@ -141,7 +141,7 @@
|
|||||||
</label>
|
</label>
|
||||||
</div>
|
</div>
|
||||||
<div class="header-center">
|
<div class="header-center">
|
||||||
<a href="index.html"><div class="brand">Reticulum Network Stack 0.8.1 beta documentation</div></a>
|
<a href="index.html"><div class="brand">Reticulum Network Stack 0.8.0 beta documentation</div></a>
|
||||||
</div>
|
</div>
|
||||||
<div class="header-right">
|
<div class="header-right">
|
||||||
<div class="theme-toggle-container theme-toggle-header">
|
<div class="theme-toggle-container theme-toggle-header">
|
||||||
@ -167,7 +167,7 @@
|
|||||||
<img class="sidebar-logo" src="_static/rns_logo_512.png" alt="Logo"/>
|
<img class="sidebar-logo" src="_static/rns_logo_512.png" alt="Logo"/>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<span class="sidebar-brand-text">Reticulum Network Stack 0.8.1 beta documentation</span>
|
<span class="sidebar-brand-text">Reticulum Network Stack 0.8.0 beta documentation</span>
|
||||||
|
|
||||||
</a><form class="sidebar-search-container" method="get" action="search.html" role="search">
|
</a><form class="sidebar-search-container" method="get" action="search.html" role="search">
|
||||||
<input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
|
<input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
|
||||||
|
@ -4,7 +4,7 @@
|
|||||||
<meta name="viewport" content="width=device-width,initial-scale=1"/>
|
<meta name="viewport" content="width=device-width,initial-scale=1"/>
|
||||||
<meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="#" />
|
<meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="#" />
|
||||||
|
|
||||||
<meta name="generator" content="sphinx-5.3.0, furo 2022.09.29.dev1"/><title>Search - Reticulum Network Stack 0.8.1 beta documentation</title><link rel="stylesheet" type="text/css" href="_static/pygments.css" />
|
<meta name="generator" content="sphinx-5.3.0, furo 2022.09.29.dev1"/><title>Search - Reticulum Network Stack 0.8.0 beta documentation</title><link rel="stylesheet" type="text/css" href="_static/pygments.css" />
|
||||||
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?digest=189ec851f9bb375a2509b67be1f64f0cf212b702" />
|
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?digest=189ec851f9bb375a2509b67be1f64f0cf212b702" />
|
||||||
<link rel="stylesheet" type="text/css" href="_static/copybutton.css" />
|
<link rel="stylesheet" type="text/css" href="_static/copybutton.css" />
|
||||||
<link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?digest=30d1aed668e5c3a91c3e3bf6a60b675221979f0e" />
|
<link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?digest=30d1aed668e5c3a91c3e3bf6a60b675221979f0e" />
|
||||||
@ -138,7 +138,7 @@
|
|||||||
</label>
|
</label>
|
||||||
</div>
|
</div>
|
||||||
<div class="header-center">
|
<div class="header-center">
|
||||||
<a href="index.html"><div class="brand">Reticulum Network Stack 0.8.1 beta documentation</div></a>
|
<a href="index.html"><div class="brand">Reticulum Network Stack 0.8.0 beta documentation</div></a>
|
||||||
</div>
|
</div>
|
||||||
<div class="header-right">
|
<div class="header-right">
|
||||||
<div class="theme-toggle-container theme-toggle-header">
|
<div class="theme-toggle-container theme-toggle-header">
|
||||||
@ -164,7 +164,7 @@
|
|||||||
<img class="sidebar-logo" src="_static/rns_logo_512.png" alt="Logo"/>
|
<img class="sidebar-logo" src="_static/rns_logo_512.png" alt="Logo"/>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<span class="sidebar-brand-text">Reticulum Network Stack 0.8.1 beta documentation</span>
|
<span class="sidebar-brand-text">Reticulum Network Stack 0.8.0 beta documentation</span>
|
||||||
|
|
||||||
</a><form class="sidebar-search-container" method="get" action="#" role="search">
|
</a><form class="sidebar-search-container" method="get" action="#" role="search">
|
||||||
<input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
|
<input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
|
||||||
|
File diff suppressed because one or more lines are too long
@ -6,7 +6,7 @@
|
|||||||
<link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="API Reference" href="reference.html" /><link rel="prev" title="Code Examples" href="examples.html" />
|
<link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="API Reference" href="reference.html" /><link rel="prev" title="Code Examples" href="examples.html" />
|
||||||
|
|
||||||
<meta name="generator" content="sphinx-5.3.0, furo 2022.09.29.dev1"/>
|
<meta name="generator" content="sphinx-5.3.0, furo 2022.09.29.dev1"/>
|
||||||
<title>Support Reticulum - Reticulum Network Stack 0.8.1 beta documentation</title>
|
<title>Support Reticulum - Reticulum Network Stack 0.8.0 beta documentation</title>
|
||||||
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
|
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
|
||||||
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?digest=189ec851f9bb375a2509b67be1f64f0cf212b702" />
|
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?digest=189ec851f9bb375a2509b67be1f64f0cf212b702" />
|
||||||
<link rel="stylesheet" type="text/css" href="_static/copybutton.css" />
|
<link rel="stylesheet" type="text/css" href="_static/copybutton.css" />
|
||||||
@ -141,7 +141,7 @@
|
|||||||
</label>
|
</label>
|
||||||
</div>
|
</div>
|
||||||
<div class="header-center">
|
<div class="header-center">
|
||||||
<a href="index.html"><div class="brand">Reticulum Network Stack 0.8.1 beta documentation</div></a>
|
<a href="index.html"><div class="brand">Reticulum Network Stack 0.8.0 beta documentation</div></a>
|
||||||
</div>
|
</div>
|
||||||
<div class="header-right">
|
<div class="header-right">
|
||||||
<div class="theme-toggle-container theme-toggle-header">
|
<div class="theme-toggle-container theme-toggle-header">
|
||||||
@ -167,7 +167,7 @@
|
|||||||
<img class="sidebar-logo" src="_static/rns_logo_512.png" alt="Logo"/>
|
<img class="sidebar-logo" src="_static/rns_logo_512.png" alt="Logo"/>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<span class="sidebar-brand-text">Reticulum Network Stack 0.8.1 beta documentation</span>
|
<span class="sidebar-brand-text">Reticulum Network Stack 0.8.0 beta documentation</span>
|
||||||
|
|
||||||
</a><form class="sidebar-search-container" method="get" action="search.html" role="search">
|
</a><form class="sidebar-search-container" method="get" action="search.html" role="search">
|
||||||
<input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
|
<input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
|
||||||
|
@ -6,7 +6,7 @@
|
|||||||
<link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="Communications Hardware" href="hardware.html" /><link rel="prev" title="Using Reticulum on Your System" href="using.html" />
|
<link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="Communications Hardware" href="hardware.html" /><link rel="prev" title="Using Reticulum on Your System" href="using.html" />
|
||||||
|
|
||||||
<meta name="generator" content="sphinx-5.3.0, furo 2022.09.29.dev1"/>
|
<meta name="generator" content="sphinx-5.3.0, furo 2022.09.29.dev1"/>
|
||||||
<title>Understanding Reticulum - Reticulum Network Stack 0.8.1 beta documentation</title>
|
<title>Understanding Reticulum - Reticulum Network Stack 0.8.0 beta documentation</title>
|
||||||
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
|
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
|
||||||
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?digest=189ec851f9bb375a2509b67be1f64f0cf212b702" />
|
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?digest=189ec851f9bb375a2509b67be1f64f0cf212b702" />
|
||||||
<link rel="stylesheet" type="text/css" href="_static/copybutton.css" />
|
<link rel="stylesheet" type="text/css" href="_static/copybutton.css" />
|
||||||
@ -141,7 +141,7 @@
|
|||||||
</label>
|
</label>
|
||||||
</div>
|
</div>
|
||||||
<div class="header-center">
|
<div class="header-center">
|
||||||
<a href="index.html"><div class="brand">Reticulum Network Stack 0.8.1 beta documentation</div></a>
|
<a href="index.html"><div class="brand">Reticulum Network Stack 0.8.0 beta documentation</div></a>
|
||||||
</div>
|
</div>
|
||||||
<div class="header-right">
|
<div class="header-right">
|
||||||
<div class="theme-toggle-container theme-toggle-header">
|
<div class="theme-toggle-container theme-toggle-header">
|
||||||
@ -167,7 +167,7 @@
|
|||||||
<img class="sidebar-logo" src="_static/rns_logo_512.png" alt="Logo"/>
|
<img class="sidebar-logo" src="_static/rns_logo_512.png" alt="Logo"/>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<span class="sidebar-brand-text">Reticulum Network Stack 0.8.1 beta documentation</span>
|
<span class="sidebar-brand-text">Reticulum Network Stack 0.8.0 beta documentation</span>
|
||||||
|
|
||||||
</a><form class="sidebar-search-container" method="get" action="search.html" role="search">
|
</a><form class="sidebar-search-container" method="get" action="search.html" role="search">
|
||||||
<input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
|
<input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
|
||||||
|
@ -6,7 +6,7 @@
|
|||||||
<link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="Understanding Reticulum" href="understanding.html" /><link rel="prev" title="Getting Started Fast" href="gettingstartedfast.html" />
|
<link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="Understanding Reticulum" href="understanding.html" /><link rel="prev" title="Getting Started Fast" href="gettingstartedfast.html" />
|
||||||
|
|
||||||
<meta name="generator" content="sphinx-5.3.0, furo 2022.09.29.dev1"/>
|
<meta name="generator" content="sphinx-5.3.0, furo 2022.09.29.dev1"/>
|
||||||
<title>Using Reticulum on Your System - Reticulum Network Stack 0.8.1 beta documentation</title>
|
<title>Using Reticulum on Your System - Reticulum Network Stack 0.8.0 beta documentation</title>
|
||||||
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
|
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
|
||||||
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?digest=189ec851f9bb375a2509b67be1f64f0cf212b702" />
|
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?digest=189ec851f9bb375a2509b67be1f64f0cf212b702" />
|
||||||
<link rel="stylesheet" type="text/css" href="_static/copybutton.css" />
|
<link rel="stylesheet" type="text/css" href="_static/copybutton.css" />
|
||||||
@ -141,7 +141,7 @@
|
|||||||
</label>
|
</label>
|
||||||
</div>
|
</div>
|
||||||
<div class="header-center">
|
<div class="header-center">
|
||||||
<a href="index.html"><div class="brand">Reticulum Network Stack 0.8.1 beta documentation</div></a>
|
<a href="index.html"><div class="brand">Reticulum Network Stack 0.8.0 beta documentation</div></a>
|
||||||
</div>
|
</div>
|
||||||
<div class="header-right">
|
<div class="header-right">
|
||||||
<div class="theme-toggle-container theme-toggle-header">
|
<div class="theme-toggle-container theme-toggle-header">
|
||||||
@ -167,7 +167,7 @@
|
|||||||
<img class="sidebar-logo" src="_static/rns_logo_512.png" alt="Logo"/>
|
<img class="sidebar-logo" src="_static/rns_logo_512.png" alt="Logo"/>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<span class="sidebar-brand-text">Reticulum Network Stack 0.8.1 beta documentation</span>
|
<span class="sidebar-brand-text">Reticulum Network Stack 0.8.0 beta documentation</span>
|
||||||
|
|
||||||
</a><form class="sidebar-search-container" method="get" action="search.html" role="search">
|
</a><form class="sidebar-search-container" method="get" action="search.html" role="search">
|
||||||
<input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
|
<input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
|
||||||
|
@ -6,7 +6,7 @@
|
|||||||
<link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="Getting Started Fast" href="gettingstartedfast.html" /><link rel="prev" title="Reticulum Network Stack Manual" href="index.html" />
|
<link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="Getting Started Fast" href="gettingstartedfast.html" /><link rel="prev" title="Reticulum Network Stack Manual" href="index.html" />
|
||||||
|
|
||||||
<meta name="generator" content="sphinx-5.3.0, furo 2022.09.29.dev1"/>
|
<meta name="generator" content="sphinx-5.3.0, furo 2022.09.29.dev1"/>
|
||||||
<title>What is Reticulum? - Reticulum Network Stack 0.8.1 beta documentation</title>
|
<title>What is Reticulum? - Reticulum Network Stack 0.8.0 beta documentation</title>
|
||||||
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
|
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
|
||||||
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?digest=189ec851f9bb375a2509b67be1f64f0cf212b702" />
|
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?digest=189ec851f9bb375a2509b67be1f64f0cf212b702" />
|
||||||
<link rel="stylesheet" type="text/css" href="_static/copybutton.css" />
|
<link rel="stylesheet" type="text/css" href="_static/copybutton.css" />
|
||||||
@ -141,7 +141,7 @@
|
|||||||
</label>
|
</label>
|
||||||
</div>
|
</div>
|
||||||
<div class="header-center">
|
<div class="header-center">
|
||||||
<a href="index.html"><div class="brand">Reticulum Network Stack 0.8.1 beta documentation</div></a>
|
<a href="index.html"><div class="brand">Reticulum Network Stack 0.8.0 beta documentation</div></a>
|
||||||
</div>
|
</div>
|
||||||
<div class="header-right">
|
<div class="header-right">
|
||||||
<div class="theme-toggle-container theme-toggle-header">
|
<div class="theme-toggle-container theme-toggle-header">
|
||||||
@ -167,7 +167,7 @@
|
|||||||
<img class="sidebar-logo" src="_static/rns_logo_512.png" alt="Logo"/>
|
<img class="sidebar-logo" src="_static/rns_logo_512.png" alt="Logo"/>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<span class="sidebar-brand-text">Reticulum Network Stack 0.8.1 beta documentation</span>
|
<span class="sidebar-brand-text">Reticulum Network Stack 0.8.0 beta documentation</span>
|
||||||
|
|
||||||
</a><form class="sidebar-search-container" method="get" action="search.html" role="search">
|
</a><form class="sidebar-search-container" method="get" action="search.html" role="search">
|
||||||
<input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
|
<input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
|
||||||
|
@ -358,23 +358,6 @@ can be used, and offers full control over LoRa parameters.
|
|||||||
# Serial port for the device
|
# Serial port for the device
|
||||||
port = /dev/ttyUSB0
|
port = /dev/ttyUSB0
|
||||||
|
|
||||||
# It is also possible to use BLE devices
|
|
||||||
# instead of wired serial ports. The
|
|
||||||
# target RNode must be paired with the
|
|
||||||
# host device before connecting. BLE
|
|
||||||
# devices can be connected by name,
|
|
||||||
# BLE MAC address or by any available.
|
|
||||||
|
|
||||||
# Connect to specific device by name
|
|
||||||
# port = ble://RNode 3B87
|
|
||||||
|
|
||||||
# Or by BLE MAC address
|
|
||||||
# port = ble://F4:12:73:29:4E:89
|
|
||||||
|
|
||||||
# Or connect to the first available,
|
|
||||||
# paired device
|
|
||||||
# port = ble://
|
|
||||||
|
|
||||||
# Set frequency to 867.2 MHz
|
# Set frequency to 867.2 MHz
|
||||||
frequency = 867200000
|
frequency = 867200000
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user