include $(TOPDIR)/rules.mk
PKG_NAME:=travelmate
-PKG_VERSION:=0.6.0
+PKG_VERSION:=0.7.0
PKG_RELEASE:=1
PKG_LICENSE:=GPL-3.0+
PKG_MAINTAINER:=Dirk Brenken <dev@brenken.org>
* manual / automatic mode support, the latter one checks the existing uplink connection regardless of ifdown event trigger every n seconds
* support of devices with multiple radios
* procd init and hotplug support
-* runtime information accessible via ubus service call
+* runtime information available via LuCI & via 'status' init command
* status & debug logging to syslog
## Prerequisites
-* [OpenWrt](https://openwrt.org) or [LEDE](https://www.lede-project.org) trunk
+* [LEDE](https://www.lede-project.org) 17.01 or latest snapshot
* iw (default) or iwinfo for wlan scanning
-## OpenWrt / LEDE trunk Installation & Usage
+## LEDE trunk Installation & Usage
* download the package [here](https://downloads.lede-project.org/snapshots/packages/x86_64/packages)
* install 'travelmate' (_opkg install travelmate_)
* configure your network to support (multiple) wlan uplinks and set travelmate config options (see below)
* download the package [here](https://downloads.lede-project.org/snapshots/packages/x86_64/luci)
* install 'luci-app-travelmate' (_opkg install luci-app-travelmate_)
* the application is located in LuCI under 'Services' menu
-* _Thanks to Hannu Nyman for this great LuCI frontend!_
## Travelmate config options
* travelmate config options:
* trm\_timeout => timeout in seconds for "automatic mode" (default: '60')
* trm\_iw => set this option to '0' to use iwinfo for wlan scanning (default: '1', use iw)
* trm\_radio => limit travelmate to a dedicated radio, e.g. 'radio0' (default: not set, use all radios)
- * trm\_iface => restrict the procd interface trigger to a (list of) certain wan interface(s) or disable it at all (default: wan wwan)
-
+ * trm\_iface => restrict the procd interface trigger to a (list of) certain wan interface(s) or disable it at all (default: wwan)
+ * trm\_triggerdelay => additional trigger delay in seconds before travelmate processing starts (default: '2')
## Runtime information
-**receive travelmate information via ubus:**
+**receive travelmate runtime information:**
<pre><code>
-ubus call service get_data '{"name":"travelmate"}'
-This will output the current connection status, e.g.:
-{
- "travelmate": {
- "travelmate": {
- "last_rundate": "02.04.2017 07:22:03",
- "online_status": "true",
- "station_interface": "wwan",
- "station_radio": "radio1",
- "station_ssid": "blackhole",
- "system": "LEDE Reboot SNAPSHOT r3888-8fb39f1682",
- "travelmate_version": "0.6.0"
- }
- }
-}
+root@adb2go:/tmp# /etc/init.d/travelmate status
+::: travelmate runtime information
+ travelmate_version : 0.7.0
+ station_connection : true
+ station_ssid : blackhole
+ station_interface : wwan
+ station_radio : radio1
+ last_rundate : 20.04.2017 08:54:48
+ system : LEDE Reboot SNAPSHOT r3974-56457dbcb7
</code></pre>
## Setup
option trm_enabled '0'
option trm_debug '0'
option trm_iface 'wwan'
+ option trm_triggerdelay '2'
option trm_automatic '1'
option trm_maxwait '30'
option trm_maxretry '3'
option trm_timeout '60'
option trm_iw '1'
+ option trm_rtfile '/tmp/trm_runtime.json'
#!/bin/sh /etc/rc.common
-START=85
+START=35
USE_PROCD=1
+EXTRA_COMMANDS="status"
+EXTRA_HELP=" status Print runtime information"
+
trm_init="/etc/init.d/travelmate"
trm_script="/usr/bin/travelmate.sh"
boot()
{
- ubus -t 30 wait_for network.interface
+ trm_boot=1
+ ubus -t 30 wait_for network.interface 2>/dev/null
rc_procd start_service
}
start_service()
{
- if [ $(/etc/init.d/travelmate enabled; printf ${?}) -eq 0 ]
+ if [ $("${trm_init}" enabled; printf ${?}) -eq 0 ]
then
+ if [ -n "${trm_boot}" ]
+ then
+ return 0
+ fi
procd_open_instance "travelmate"
procd_set_param command "${trm_script}" "${@}"
procd_set_param stdout 1
fi
}
+status()
+{
+ rc_procd "${trm_script}" status
+}
+
service_triggers()
{
local iface="$(uci -q get travelmate.global.trm_iface)"
+ local delay="$(uci -q get travelmate.global.trm_triggerdelay)"
+ PROCD_RELOAD_DELAY=$((${delay:=2} * 1000))
for name in ${iface}
do
procd_add_interface_trigger "interface.*.down" "${name}" "${trm_init}" start
done
+ PROCD_RELOAD_DELAY=1000
procd_add_config_trigger "config.change" "travelmate" "${trm_init}" start
}
#
LC_ALL=C
PATH="/usr/sbin:/usr/bin:/sbin:/bin"
-trm_ver="0.6.0"
+trm_ver="0.7.0"
trm_sysver="$(ubus -S call system board | jsonfilter -e '@.release.description')"
trm_enabled=0
trm_debug=0
-trm_automatic=0
-trm_maxwait=30
+trm_automatic=1
trm_maxretry=3
+trm_maxwait=30
trm_timeout=60
trm_iw=1
+trm_rtfile="/tmp/trm_runtime.json"
# source required system library
#
-if [ -r "/lib/functions.sh" ]
+if [ -r "/lib/functions.sh" ] && [ -r "/usr/share/libubox/jshn.sh" ]
then
. "/lib/functions.sh"
+ . "/usr/share/libubox/jshn.sh"
else
- f_log "error" "required system library not found"
+ f_log "error" "system libraries not found"
fi
# f_envload: load travelmate environment
f_log "debug" "mode: ${mode}, name: ${ifname}, status: ${trm_ifstatus}, count: ${cnt}, max-wait: ${trm_maxwait}, automatic: ${trm_automatic}"
}
-# f_ubus: update ubus service
+# f_jsnupdate: update runtime information
#
-f_ubus()
+f_jsnupdate()
{
- local active_triggers iface="${1}" radio="${2}" ssid="${3}"
+ local iface="${1}" radio="${2}" ssid="${3}"
- for name in ${trm_iface}
- do
- active_triggers="${active_triggers}[\"interface.*.down\",[\"if\",[\"eq\",\"interface\",\"${name}\"],[\"run_script\",\"/etc/init.d/travelmate\",\"start\"],1000]],"
- done
- active_triggers="${active_triggers}[\"config.change\",[\"if\",[\"eq\",\"package\",\"travelmate\"],[\"run_script\",\"/etc/init.d/travelmate\",\"start\"],1000]]"
+ json_init
+ json_add_object "data"
+ json_add_string "travelmate_version" "${trm_ver}"
+ json_add_string "station_connection" "${trm_ifstatus}"
+ json_add_string "station_ssid" "${ssid}"
+ json_add_string "station_interface" "${iface}"
+ json_add_string "station_radio" "${radio}"
+ json_add_string "last_rundate" "$(/bin/date "+%d.%m.%Y %H:%M:%S")"
+ json_add_string "system" "${trm_sysver}"
+ json_close_object
+ json_dump > "${trm_rtfile}"
+}
+
+# f_status: output runtime information
+#
+f_status()
+{
+ local key keylist value
- ubus call service add "{\"name\":\"travelmate\",
- \"instances\":{\"travelmate\":{\"command\":[\"/usr/bin/travelmate.sh\"],
- \"data\":{\"travelmate_version\":\"${trm_ver}\",
- \"station_interface\":\"${iface}\",
- \"station_radio\":\"${radio}\",
- \"station_ssid\":\"${ssid}\",
- \"last_rundate\":\"$(/bin/date "+%d.%m.%Y %H:%M:%S")\",
- \"online_status\":\"${trm_ifstatus}\",
- \"system\":\"${trm_sysver}\"}}},
- \"triggers\":[${active_triggers}]}"
+ if [ -s "${trm_rtfile}" ]
+ then
+ printf "%s\n" "::: travelmate runtime information"
+ json_load "$(cat "${trm_rtfile}" 2>/dev/null)"
+ json_select data
+ json_get_keys keylist
+ for key in ${keylist}
+ do
+ json_get_var value ${key}
+ printf " %-18s : %s\n" "${key}" "${value}"
+ done
+ fi
}
# f_log: write to syslog, exit on error
then
uci -q commit wireless
ubus call network reload
- sleep 5
fi
f_check "ap"
f_log "debug" "ap-list: ${trm_aplist}, sta-list: ${trm_stalist}"
then
uci -q commit wireless
f_log "info " "interface '${sta_iface}' on '${sta_radio}' connected to uplink '${sta_ssid}' (${trm_sysver})"
- sleep 5
- f_ubus "${sta_iface}" "${sta_radio}" "${sta_ssid}"
+ f_jsnupdate "${sta_iface}" "${sta_radio}" "${sta_ssid}"
return 0
else
uci -q revert wireless
ubus call network reload
f_log "info " "interface '${sta_iface}' on '${sta_radio}' can't connect to uplink '${sta_ssid}' (${trm_sysver})"
- f_ubus "${sta_iface}" "${sta_radio}" "${sta_ssid}"
+ f_jsnupdate "${sta_iface}" "${sta_radio}" "${sta_ssid}"
fi
fi
done
fi
}
+# handle different travelmate actions
+#
f_envload
-f_main
-while [ ${trm_automatic} -eq 1 ]
-do
- sleep ${trm_timeout}
- f_envload
- f_main
-done
+case "${1}" in
+ status)
+ f_status
+ ;;
+ *)
+ f_main
+ while [ ${trm_automatic} -eq 1 ]
+ do
+ sleep ${trm_timeout}
+ f_envload
+ f_main
+ done
+ ;;
+esac
exit 0