From 5d0258fe801672e2ab2d83e333adacfa9884a252 Mon Sep 17 00:00:00 2001
From: rubo77 <github@r.z11.de>
Date: Sun, 4 Jun 2017 17:03:23 +0200
Subject: [PATCH] README: add example for site.conf variables
---
README.md | 53 +++++++++++++++++++++++++++++++++++++++++++++--------
1 file changed, 45 insertions(+), 8 deletions(-)
diff --git a/README.md b/README.md
index 227cb71..5e0e1eb 100644
--- a/README.md
+++ b/README.md
@@ -5,19 +5,56 @@ This script changes the SSID when there is no connection to the selected Gateway
Once a minute it checks if there's still a gateway reachable with
+site.conf
+=========
+
+Adapt and add this block to your site.conf:
+
+```
+ssid_changer = {
+ switch_timeframe = 1, -- only once every timeframe (in minutes) the SSID will change to OFFLINE
+ -- set to 1440 to change once a day
+ -- set to 1 minute to change every time the router gets offline
+ first = 5, -- the first few minutes directly after reboot within which an Offline-SSID always may be activated
+ prefix = 'FF_OFFLINE_', -- use something short to leave space for the nodename (no '~' allowed!)
+ suffix = 'nodename', -- generate the SSID with either 'nodename', 'mac' or to use only the prefix: 'none'
+
+ tq_limit_enabled = 0, -- if false, the offline SSID will only be set if there is no gateway reacheable
+ -- upper and lower limit to turn the offline_ssid on and off
+ -- in-between these two values the SSID will never be changed to prevent it from toggeling every minute.
+ -- TODO: enabled=1 still has to be implemented
+ tq_limit_max = '55', -- upper limit, above that the online SSID will be used
+ tq_limit_min = '45' -- lower limit, below that the offline SSID will be used
+},
+```
+
+if tq_limit is disabled, then it will be only checked, if the gateway is reachable with
+
batctl gwl -H
-and then decides if a change of the SSID is necessary: There is a variable
-MINUTES (default 1440 = 24h) at the top of the script `files/lib/gluon/ssid-changer/ssid-changer.sh`
-that defines a time interval in which a successful check that detects an offline
-state is allowed to change the SSID once to "FF_OFFLINE_$node_hostname". Only the
-first few (also definable in a variable FIRST) minutes the OFFLINE_SSID may also
-be set. All other minutes a checks will just be reported in the log and whenever
-an online state is detected the SSID will be set back immediately back to normal.
+
+Depending on the connectivity, it will be decided if a change of the SSID is
+necessary: There is a variable `switch_timeframe` (for ex. 1440 = 24h) that
+defines a time interval after which a successful check that detects an offline
+state will result in a single change of the SSID to "FF_OFFLINE_$node_hostname".
+Only the first few (also definable in a variable `first`) minutes the
+OFFLINE_SSID may also be set. All other minutes a checks will just be reported
+in the log and whenever an online state is detected the SSID will be set back
+immediately back to normal.
+
+Commandline options
+===================
+
+You can configure the ssid-changer on the commandline with `uci`, for example
+disable it with:
+
+ uci set ssid-changer.settings.enabled='0'
+
Gluon versions
==============
-This branch of the script contains the ssid-changer version for the gluon 2016.2.x.
+This branch of the script contains the ssid-changer version for the gluon
+2016.2.x.
Implement this package in your firmware
=======================================
--
GitLab