Changes

'''Unified Configuration Interface''' ('''UCI''') is a small utility written in C (a shell script-wrapper is available as well) and is intended to centralize the whole configuration of a device running on OpenWrt.

'''Unified Configuration Interface''' ('''UCI''') is a small utility written in C (a shell script-wrapper is available as well) and is intended to centralize the whole configuration of a device running on OpenWrt.

__TOC__

__TOC__

This example will provide instructions on how configure Mobile Data Limit and SMS Warning on RUT routers' using only UCI commands. For the sake of the example lets say that you want to set up a data limit of 1 GB with the limit counter restarting everyday at 10 a.m. and an SMS Warning that sends out a message when the 800 MB threshold is reached that also restarts everyday at 10 a.m.  

This example will provide instructions on how configure Mobile Data Limit and SMS Warning on RUT routers' using only UCI commands. For the sake of the example lets say that you want to set up a data limit of 1 GB with the limit counter restarting everyday at 10 a.m. and an SMS Warning that sends out a message when the 800 MB threshold is reached that also restarts everyday at 10 a.m.  

To achieve such a task, the first relevant piece of required information is the config name, '''data_limit''', where all the necessary configuration settings are stored. This task will require the knowledge of many mandatory option so lets begin the step-by-step part (comments will be provided along with each step and a short summary afterwards):

To achieve such a task, the first relevant piece of required information is the config name, '''quota_limit''', where all the necessary configuration settings are stored:

Enabling Mobile Data Limit and SMS Warning:

Enabling Mobile Data Limit and SMS Warning:

  # uci set quota_limit.mob1s1a1=interface

  # uci set quota_limit.mob1s1a1=interface

  # uci set quota_limit.mob1s1a1.enabled='1'

  # uci set quota_limit.mob1s1a1.enabled='1'

Setting the Mobile Data and SMS Warning limits:

Commit changes and restart the daemon

  # uci commit quota_limit

  # uci set data_limit.limit.prim_conn_period=day

  # /etc/init.d/quota_limit restart

  # uci set data_limit.limit.prim_conn_hour=10

The first enables both SMS Warning and Mobile Data Limit services by setting the options ''prim_enb_conn'' and ''prim_enb_wrn'' to ''1''. The second step sets up the to limits by setting the options ''prim_conn_limit'' and ''prim_wrn_limit'' to ''1000'' and ''800'' respectively. The third step specifies the frequency at which Mobile Data Limit will be reset. The option ''prim_conn_period'' can take values ''month'', ''week'' or in this case, ''day'', and ''prim_conn_hour'' indicates the hour of the day (in this case, ''10''). The fourth step sets up the SMS Warning period in the same manner and also adds the phone number ''+37012345678'' to the option ''prim_wrn_number''

'''Disabling / Deleting configuration'''

Let us take the above example and disable the data limit using '''uci'''. For this, we simply need to change the "enabled" value to '0':

# uci set quota_limit.mob1s1a1.enabled='0'

# /etc/init.d/quota_limit restart

 

If you wish to delete the whole configuration, '''uci delete''' can be used. Let us delete the entire block of configuration of mob1s1a1 interface:

# /etc/init.d/quota_limit restart

==External links==

==External links==

* https://wiki.openwrt.org/doc/uci?do= - OpenWRT wiki page on the UCI system

* https://wiki.openwrt.org/doc/uci?do= - OpenWRT wiki page on the UCI system

* https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html - PuTTY downloads page

* https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html - PuTTY downloads page