模型可视化>> dd-wrt-tools>> 返回
项目作者： blue-sky-r

项目描述 ：
CLI tools related to DD-WRT
高级语言： Shell
项目地址: git://github.com/blue-sky-r/dd-wrt-tools.git
创建时间： 2020-04-04T07:57:56Z
项目社区：https://github.com/blue-sky-r/dd-wrt-tools
开源协议：GNU General Public License v2.0
下载


dd-wrt-tools

Various command line CLI tools related to DD-WRT but intended for use on linux desktop (console).

scripts:

  • smantun - Smart Antenna Tuning tool for linux CLI
  • aaping - ASUS audible ping for linux CLI
  • colog - colorize and enrich dd-wrt remote log file

smantun = sma-ant-tun = smart antenna tuning

CLI (console) script to display client wifi parameters (Signal dBm, Noise floor dBm, SNR ratio, Quality) and semi-graphical
signal quality bar plot as well as audible beeping (with pitch related to signal Quality). Many
configurable options (with sensible default values) are useful for adjusting the antenna / router / client
position to maximize wireless signal quality (coverage).

To get usage help simply run the script without any parameter:

  1. $ bin/smantun.sh
  3. = DD-WRT = Smart Antenna Tuning = (c) 2020.06.01 by Robert =
  5. usage: smantun.sh [-v] [-a mac] [-s 'c1,c2'] [-b 'xX'] [-l ms] [-o Hz] [-m k] [-r sec] [-d] ['q10,q10']] [-t sec] [router]
  7. -v             ... verbose (debug) mode
  8. -a|mac mac     ... filter only MAc address (case insensitive, partial match supported, watch out for masking MAC addr.)
  9. -s[tats] c1,c2 ... display statistics (comma separated 3-char column names, default: mac,sig,noi,snr,q10)
  10.                    mac = MAC address
  11.                    sig = Signal dBm
  12.                    noi = Noise dBm
  13.                    snr = Signal to Noise Ratio
  14.                    q10 = Quality percent * 10
  15. -b[ar]         ... bar plot characters (default '#_', set to '' to disable plot)
  16. -l[en]         ... beep length in ms (default 50, set to 0 to disable beeping)
  17. -o[ffset]      ... the lowest beep (offset) in Hz (default 100)
  18. -m[ult]        ... beep frequency multiplication (sensitivity) factor (default 2)
  19. -r[efresh]     ... update frequency in seconds, float accepted (default 3)
  20. -d[emo]        ... demonstration mode (comma separated Q10 values, default '0,250,500,750,1000')
  21. -t[imeout]     ... router connection timeout in sec (default 3)
  22. router         ... router/host as target client running DD-WRT with accessible info page (hostname or ip address)
  24. Note: the beep freq. formula (Q is the signal quality between 0..100): frequency = mult x Q*10 + offset [Hz]
  26. This script will display statistics, plot signal level (text-mode) and trigger audible beep reflecting signal quality.
  27. This is very useful for router antenna adjustment as you don't need to watch the screen, just listen to the beeps.
  28. The sound is generated by PC-SPEAKER. Make sure it is connected and functional.
  30. Use demo mode to verify you can hear the beeping sound from your PC-SPEAKER clearly:
  32. > smantun.sh -d
  34. > smantun.sh -d '500,1000'
  36. To supress bar plot just assign empty string to -b[ar] parameter:
  38. > smantun.sh -b '' router
  40. To execute demo and real signal plot:
  42. > smantun.sh -d router
  44. Quick (low precision) adjustment (refresh 0.5 sec):
  46. > smantun.sh -r 0.5 router
  48. To suppress audible beeps (silent execution) just set beep length to 0:
  50. > smantun.sh -l 0 router
  52. Display only Q10 and SNR statistics columns:
  54. > smantun.sh -s q10,snr 0 router
  56. Filter only MAC XX:XX:XX:XX:56:78
  58. > smantun.sh -mac xx:56:78 router
  60. This script executes infinite loop so use standard CTRL-C to stop and return to the command prompt.
  62. REQUIRES:
  63. - kernel module [ pcspkr ] (usually blackisted and not loaded so script will load module at the startup if required)
  64. - connected and functional PC-SPEAKER
  65. - beep executable
  66. - wget, grep, awk
  67. - dd-wrt running on the target router (connected to the access point)
  69. The script does not make any changes to your system configuration. It loads kernel module [ pcspkr ] temporarily till the next reboot.
  70. The kernel module stays loaded after the script has been ended so if you experience any [ pcspkr ] related problems
  71. you might try to remove kernel module [ pcspkr ] manually by:
  73. > sudo rmmod pcspkr
  75. Tips:
  76. - for quick antenna adjustment use fast refresh, but be aware that you are affecting the signal by your presence
  77. - for high precision adjustment use slower refresh and always distance yourself from antenna after manipulation
  78. - you can adjust multiplication factor for increased sensitivity, higher value will trigger bigger pitch change
  79. - wifi card in your router needs some time to settle down so be smart with refresh speed

smantun - dd-wrt

The wireless parameters are from DD-WRT info page - section Wireless - Clients or Access Point.
This script will help to adjust antenna and position of the wireless AP and clients.
You can connect remotely to the router to monitor Q (quality) of the client to AP wifi connection.
To monitor AP to client Quality you can setup temporary auxiliary router with dd-wrt as a client
and position it at the client location. In this case you connect to auxiliary router to monitor
AP to client wireless signal quality and perform antenna adjustments. You get the idea … 

  1. Note: DD-WRT is using Q!0 as parameter for quality, which is just 10 * Q. 
  2. So when quality is 0..100% the 10x multiplication Q10 is 0..1000.

The Signal Quality Q is internally processed by DD-WRT and it is build version dependent.
So the same SNR (signal-to-noise-ratio) value will display different quality Q in different
dd-wrt build. This might be caused by various factors like different wifi
drivers so don’t get obsessed with absolute number, just look for relative changes (Q dropping vs Q rising).

dd-wrt info page

smantun - implementation

The simplified workflow:

  • the required kernel module is loaded if needed
  • the html page is retrieved by wget and java script function call setWirelessTable() is filtered out
  • numerical parameter Signal [dBm], Noise [dBm], SNR, Q10 [%] are extracted from JS setWirelessTable() call
  • values are diplayed as numbers in columns: MAC address, Signal, Noise, SNR, Q10
  • optional signal plot bar is displayed with fixed width 100 chars (1 char = 1 %)
  • optional audible beep is generated through PC speaker
  • loop forever (until CTRL+C)

click on the screenshot image to play the screenrecording video

click to play video

click on the screenshot image to play the screenrecording video

smantun - ideas for possible future improvements

  • ANSI colors
  • console auto-scaling (columns, width)
  • PyQt graphical GUI
  • sound generated by sound system (and not PC speaker, then kernel module will not be required)
  • optional history
  • systray icon

aaping = audible asus ping

ASUS audible ping provides audible feedback of target router. It is well know that ASUS returns different TTL
in normal operating mode (TTL=64) or in recovery / tftp mode (TTL=100). By using this aaping you can easily
hear distinct audible beep for each mode and immediatly know the state of target router.

I found this usefull in case of manually resetting or entering recovery mode for router by pressing reset / wds
buttons and power cycling. This helps when flashing experimental / beta versions of dd-wrt / tomato usb etc.

To get usage help simply run the script without any parameter:

  1. $ bin/aaping.sh
  3. = Audible-Asus-PING = (c) 2020.06.27 by Robert =
  5. usage: aaping.sh [-v][-aa 'ttL:mode:hz:ms ttl2:mode2:hz2:m2 *:mode3:hz3:ms3'][-scroll mode][-timestamp frm][-silent][-c count][-i interval][ping_opt] target
  7. -v               ... verbose (debug) mode
  8. -aa ttl=xx:mode:hz:ms ... audible settings where xx is the ttl to match to generate beep with frequency of hz Hz and
  9.                           length of ms ms to pc speaker. Mode is descriptive information about mode (do not use spaces,
  10.                           use _ in text, all undescores will be displayed as spaces). Multiple entries are separated by space,
  11.                           the last entry should match all (* this will beep in case of any error). To make specific entry silent
  12.                           use empty Hz and ms like ttl=123:no_sound_for_this_ttl:::
  13.                           Default lookup table is:
  14.                           ttl=64:Normal:1000:50 ttl=100:TFTP_Recovery:500:100 ttl=63:Normal/L-1:900:50 ttl=99:TFTP_Recovery/L-1:400:100 *:no_response_?:200:100
  15. -scroll mode     ... activate scroll mode (default err, useful to see error distribution history), mode is:
  16.                      all = always scroll with each ping
  17.                      no  = never scroll, keep output limited to one-line
  18.                      err = only scroll errors
  19.                      anything else will keep default value (err) unchanged
  20. -timestamp frm   ... timestamping output, frm is date format or yes or no:
  21.                      yes = use default format (%x %X), use if you want to be explicit
  22.                      no  = no timestamps
  23.                      frm = valid date format string, see man date for details
  24.                      invalid string (without %) is treated as no timestamping
  25. -silent          ... activate globally silent mode despite lookup table, only display output, no audible sound (default audible mode)
  26. -c count         ... limit to count, stop after executing count pings (default 0 = infinite loop)
  27. -i interval      ... wait interval between sending the packets (default each 1s)
  28. ping_opt         ... other ping options pass-through to ping
  29. target           ... target (hostname or ip address)
  31. > aaping.sh target
  33. This will execute infinite loop so use standard CTRL-C to stop and return to the command prompt.
  35. > aaping.sh -silent -scroll all -count 100 -s 12345 target
  37. This will execute only 100 pings with packet size of 12345 in silent mode and scrolling everything output.
  39. REQUIRES (only in audible mode):
  40. - kernel module [ pcspkr ] (usually blackisted and not loaded so script will load module at the startup if required)
  41. - connected and functional PC-SPEAKER
  42. - beep executable
  44. The script does not make any changes to your system configuration. It loads kernel module [ pcspkr ] temporarily till the next reboot.
  45. The kernel module stays loaded after the script has been ended so if you experience any [ pcspkr ] related problems
  46. you might try to remove kernel module [ pcspkr ] manually by:
  48. > sudo rmmod pcspkr
  50. NOTE:  default lookuo table TTL_MODE_HZ_MS is very ASUS centric. For diffenet manufacturer you have to find out
  51. proper TTL responses and build your lookup table. My entire network runs exclusively on ASUS routers only ...