{"id":2456,"date":"2021-07-12T17:22:08","date_gmt":"2021-07-13T01:22:08","guid":{"rendered":"http:\/\/wonghoi.humgar.com\/blog\/?p=2456"},"modified":"2021-07-12T17:22:53","modified_gmt":"2021-07-13T01:22:53","slug":"asus-wrt-merlin-firmware-ddns-update-interval-hack","status":"publish","type":"post","link":"https:\/\/wonghoi.humgar.com\/blog\/2021\/07\/12\/asus-wrt-merlin-firmware-ddns-update-interval-hack\/","title":{"rendered":"Asus-wrt Merlin Firmware DDNS update interval hack"},"content":{"rendered":"\n

The “WAN – DDNS” page only allows users to set the DDNS updater to check as frequently as every 30 minutes. My DDNS provider does not have an update frequency limit, so I’d like to have the update client check for every 1 minute. The setting is called “Verify every”:<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Attempting to set it to every 1 minute gives this error message:<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

I searched for the “WAN-DDNS” config webpage file (Advanced_ASUSDDNS_Content.asp<\/code>) in the firmware source code, and found that it’s under \/www<\/code> folder in the router’s linux root.<\/p>\n\n\n\n

Since “Verify every” is such generic words, and Github does not support exact phrase match in search (I use “in:file<\/code>” specifier in the search box), I pick “WAN IP and hostname verification” (the closest setting which I expect the code to be in the proximity of the one corresponding to “Verify every”) so it has more unique keywords. The first jump:<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Since it’s just a dictionary files, we search for the associated internal variable name
“DDNS_verification_enable<\/code>” which points to the this line in Advanced_ASUSDDNS_Content.asp<\/code>:<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Since this name appeared nowhere else, I traced the “id<\/code>” attribute above, which is “check_ddns_field<\/code>” and I see a Javascript (.js) file<\/a> that process the data from the web page forms:<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

The variable check_ddns_field<\/code> appears in the if-else-if branches of change_ddns_settings(), so one of the few next few variables after it is likely to correspond to “Verify with”. <\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

The variable name showed up in 4 branches of if-elseif-else<\/code> switches (switching DDNS service providers), which ddns_regular_period<\/code> comes right after<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Searching for the class member (or struct field) <\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Bingo. Here’s the entry value range check code. I’ll change the “30” minutes to “1” minute to enable checking at 1 minute intervals (which I think it’s reasonably responsive for testing and general use).<\/p>\n\n\n\n

\n\n\n\n

I’d prefer to check if the input range check is there out of feasibility (i.e. what is the smallest increment) or it’s just set to prevent people from getting banned by the DDNS provider for checking too frequently. I looked into the last occurrence of ddns_regular_period<\/code> and found this:<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Which means the web forms is updating NVRAM (environmental) variable of the same name ddns_regular_period<\/code>, which appears to be called only in watchdog.c<\/a>:<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

And Dang! The code enforces if the ddns_regular_period (on NVRAM) is set to be less than the original 30 minute minimum (invalid condition), it’d be set to the default 60 minutes (1 hr). <\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

It’s actually sloppy coding because the defaults are specified in struct fields in defaults.c<\/code>:<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

yet that 60 minutes is hard-coded in watchdog.c<\/code>. That means if I don’t catch it and only changed the default in one place, the behavior will not be what I expected given the right conditions. This is an example of why software feature expansion are likely to break things. If you have solid code, bugs on updates are likely to happen.<\/p>\n\n\n\n

I was curious why it says (period*2)<\/code><\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

and suspected the ddns_check_count<\/code> is incremented in 30 second (half-minute) interval. Since it’s watchdog.c<\/code>, my natural guess is that the watchdog checks every 30 seconds for these event hooks. Turns out the notes (comments) in the code has “30 seconds periods” noted everywhere.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

I searched a little bit more about linux watchdogs and found this useful webpage<\/a> which explained how it works. I didn’t see \/dev\/watchdog<\/code> in my router’s rootfs<\/code> (root file system) so I assumed it’s a hardware watchdog (embedded linux, so duh). <\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

I was about to dig up the hardware manual for the chipset for my router, but I search for they string HW_RTC_WATCHDOG <\/em> first and it showed up in linux kernel code (duh):<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Note that the HW_RTC_WATCHDOG <\/code>is a register in this code base, not the number of seconds from Christian’s Blog<\/a>. i.e. they are completely different things, but it provided a good keyword lead for me to start digging.<\/p>\n\n\n\n

The code seems to be the same for various kernel version so I picked any one of them to understand the behavior. First occurrence is in wdt_enable()<\/code>:<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

The other places are suspend\/resume, so I’ll ignore those for now. Note that wdt_enable()<\/code> is a static function, so only need to search within the same file. The only active place that calls it is wdt_ping()<\/code>:<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

So there are only 2 things I’ll need to find out: heartbeat <\/code>and WDOG_COUNTER_RATE<\/code>:<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

…. unfinished<\/p>\n\n\n\n

https:\/\/bitsum.com\/firmware_mod_kit.htm<\/a><\/p>\n\n\n\n

\n\n\n\n

While it’s a lot of useful learning about Embedded Linux and hunting down source code, for the meantime, given that namecheap does not care if you blindly update every minute, it’s easier to just set up a cron job that runs at every N minutes using curl\/wget.<\/p>\n\n\n\n

dd-wrt has a place for you to enter the cron scripts with the web interface, but you might need to log into the router using SSH and register the cron job yourself<\/a>:<\/p>\n\n\n\n

The core command is called ‘cru<\/code>‘, which typing it in the command prompt will show you the very simple usage:<\/p>\n\n\n\n

\nadmin@Router:\/tmp\/home\/root# cru\n\nCron Utility\nadd:    cru a <unique id> <\"min hour day month week command\">\ndelete: cru d <unique id>\nlist:   cru l<\/code><\/pre>\n\n\n\n
<unique id><\/code> is just a tag that you make up to name your task. Again the one-liner command needs to be direct absolute path. My ‘curl<\/code>‘ program is located in \/usr\/sbin<\/code>, so the command is:<\/p>\n\n\n\n
cru a ncddns * * * * * \/usr\/sbin\/curl \"https:\/\/dynamicdns.park-your-domain.com\/update?host={subdomain or @ for root}&domain={registered domain name}&password={DDNS-specific password generated by namecheap's domain administration page under Advanced DNS}\"<\/code><\/pre>\n\n\n\n
The “* * * * *<\/code>” refers to run at every “minute, hour, date of month, month, date of week”, in other words, run at every minute in every waking moment. The wild card * means ALL-OF.<\/p>\n\n\n\n
Cron job registration through CRU is not persistent, so to make it survive reboots, add the above cru command as a line to \/jffs\/scripts\/services-start<\/code> script. It should be executable by default, if not, make sure you set it to be executable or it won’t run.<\/p>\n
<\/div>
<\/path><\/svg><\/i> \"Loading\"<\/p>
<\/div>","protected":false},"excerpt":{"rendered":"
The “WAN – DDNS” page only allows users to set the DDNS updater to check as frequently as every 30 minutes. My DDNS provider does not have an update frequency limit, so I’d like to have the update client check … Continue reading →<\/span><\/a><\/p>\n
<\/div>\n
<\/path><\/svg><\/i> \"Loading\"<\/p>\n
<\/div>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"inline_featured_image":false,"footnotes":""},"categories":[44,39],"tags":[],"class_list":["post-2456","post","type-post","status-publish","format-standard","hentry","category-hardware","category-linux"],"_links":{"self":[{"href":"https:\/\/wonghoi.humgar.com\/blog\/wp-json\/wp\/v2\/posts\/2456","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wonghoi.humgar.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wonghoi.humgar.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wonghoi.humgar.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wonghoi.humgar.com\/blog\/wp-json\/wp\/v2\/comments?post=2456"}],"version-history":[{"count":4,"href":"https:\/\/wonghoi.humgar.com\/blog\/wp-json\/wp\/v2\/posts\/2456\/revisions"}],"predecessor-version":[{"id":2636,"href":"https:\/\/wonghoi.humgar.com\/blog\/wp-json\/wp\/v2\/posts\/2456\/revisions\/2636"}],"wp:attachment":[{"href":"https:\/\/wonghoi.humgar.com\/blog\/wp-json\/wp\/v2\/media?parent=2456"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wonghoi.humgar.com\/blog\/wp-json\/wp\/v2\/categories?post=2456"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wonghoi.humgar.com\/blog\/wp-json\/wp\/v2\/tags?post=2456"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}