567
edits
Changes
Monitoring via JSON-RPC windows RutOS (view source)
Revision as of 14:41, 2 August 2023
, 14:41, 2 August 2023no edit summary
<li> The second one is used to commit the changes from RAM to flash memory </li>
<li> The second one is used to commit the changes from RAM to flash memory </li>
<li> The third one is used to the changes take effect</li>
<li> The third one is used to the changes take effect</li>
</ul><br>
</ul>
We'll not go into detail on UCI commands in this article, but you can check out our '''[[UCI command usage]]''' guide for detailed examples.
We'll not go into detail on UCI commands in this article, but you can check out our '''[[UCI command usage]]''' guide for detailed examples.
====UCI SET====
====UCI SET====
----
----
The '''uci set''' command is used to set router parameters. <br>
The '''uci set''' command is used to set router parameters.
As an example, let's try to change the router's WiFi SSID. The command to do so looks like this:
As an example, let's try to change the router's WiFi SSID. The command to do so looks like this:
<li>Finally, highlighted in green is the value that will replace the old value. '''''(In this case, it change the router's SSID to <span style=color:green>9999</span>.)'''''</li>
<li>Finally, highlighted in green is the value that will replace the old value. '''''(In this case, it change the router's SSID to <span style=color:green>9999</span>.)'''''</li>
</ul>
</ul>
If the issued command was a success, you should see a Response like this:<br>
If the issued command was a success, you should see a Response like this:
[[File:Postman uci set wireless.png|border|center|class=tlt-border|724x689px]]
[[File:Postman uci set wireless.png|border|center|class=tlt-border|724x689px]]
]
]
}
}
'''Note''': when committing changes, you will need to specify the name of the file where the changes took place (In this case, <span style=color:orange>wireless</span> config, which is highlighted in orange).
If the commit was successful, you should see the same message as before:
If the commit was successful, you should see the same message as before:
[[File:Postman uci reload.png|border|center|class=tlt-border|730x586px]]
[[File:Postman uci reload.png|border|center|class=tlt-border|730x586px]]
Navigate to the router's WebUI → Network → Wireless and see if the SSID has changed.
Navigate to the router's '''WebUI → Network → Wireless''' and see if the SSID has changed.
<div style="display: flex; justify-content: center; align-items: center;"> <p>'''Before'''</p></div>
[[File:Postmna ssid before.png|border|center|class=tlt-border|768x157px]]
<div style="display: flex; justify-content: center; align-items: center;"> <p>'''After'''</p></div>
[[File:Webui ssid changed.png|border|center|class=tlt-border|778x156px]]
[[File:Webui ssid changed.png|border|center|class=tlt-border|778x156px]]
The command above will change the router's DHCP Server's current Start address, Address limit and Lease time values '''''(highlighted in orange)''''' to custom values provided in the '''"values"''' section of the command '''''(highlighted in green)'''''.
The command above will change the router's DHCP Server's current Start address, Address limit and Lease time values '''''(highlighted in orange)''''' to custom values provided in the '''"values"''' section of the command '''''(highlighted in green)'''''.
<div style="display: flex; justify-content: center; align-items: center;"> <p>'''Before'''</p></div>
[[File:Networking rutxxx configuration examples dhcp server v2.jpg|border|class=tlt-border|530px]]<br>
[[File:Postman dhcp before.png|border|center|class=tlt-border|792x263px]]
'''Note: Remember always to use the commands in the order (set, commit, reload_config)'''
<div style="display: flex; justify-content: center; align-items: center;"> <p>'''After'''</p></div>
[[File:Postman dhcp after.png|border|center|class=tlt-border|799x264px]]
'''Note''': Remember always to use the commands in the order (set, commit, reload_config)
==Some Additional Commands==
==Some Additional Commands==
If the commands found in the guide above did not suffice your needs, this section provides a list of additional ones. The commands presented in this section will be for both Linux and Windows operating systems. They should be used as syntax examples for your own purposes.
If the commands found in the guide above did not suffice your needs, this section provides a list of additional ones. The commands presented in this section will be for both Linux and Windows operating systems. They should be used as syntax examples for your own purposes.
===WiFi clients list===
===WiFi clients list===
----
----
'''The response''' should look something like this:
'''The response''' should look something like this:
{"jsonrpc":"2.0","id":1,"result":[0,{"results":
{"jsonrpc":"2.0","id":1,"result":[0,{"results":
[{"mac":"<span style=color:green>E4:02:9B:88:09:AA</span>","signal":<span style=color:blue>-32</span>,"noise":<span style=color:blue>-88</span>,"inactive":<span style=color:blue>10</span>,"rx":
[{"mac":"<span style=color:green>E4:02:9B:XX:XX:XX</span>","signal":<span style=color:blue>-32</span>,"noise":<span style=color:blue>-88</span>,"inactive":<span style=color:blue>10</span>,"rx":
{"rate":<span style=color:blue>1000</span>,"mcs":<span style=color:blue>0</span>,"40mhz":<span style=color:blue>false</span>,"short_gi":<span style=color:blue>false</span>},"tx":
{"rate":<span style=color:blue>1000</span>,"mcs":<span style=color:blue>0</span>,"40mhz":<span style=color:blue>false</span>,"short_gi":<span style=color:blue>false</span>},"tx":
{"rate":<span style=color:blue>72200</span>,"mcs":<span style=color:blue>7</span>,"40mhz":<span style=color:blue>false</span>,"short_gi":<span style=color:blue>true</span>}},
{"rate":<span style=color:blue>72200</span>,"mcs":<span style=color:blue>7</span>,"40mhz":<span style=color:blue>false</span>,"short_gi":<span style=color:blue>true</span>}},
{"mac":"<span style=color:green>D8:C7:71:47:90:E1</span>","signal":<span style=color:blue>-12</span>,"noise":<span style=color:blue>-88</span>,"inactive":<span style=color:blue>400</span>,"rx":
{"mac":"<span style=color:green>D8:C7:71:XX:XX:XX</span>","signal":<span style=color:blue>-12</span>,"noise":<span style=color:blue>-88</span>,"inactive":<span style=color:blue>400</span>,"rx":
{"rate":<span style=color:blue>1000</span>,"mcs":<span style=color:blue>0</span>,"40mhz":<span style=color:blue>false</span>,"short_gi":<span style=color:blue>false</span>},"tx":
{"rate":<span style=color:blue>1000</span>,"mcs":<span style=color:blue>0</span>,"40mhz":<span style=color:blue>false</span>,"short_gi":<span style=color:blue>false</span>},"tx":
{"rate":<span style=color:blue>72200</span>,"mcs":<span style=color:blue>7</span>,"40mhz":<span style=color:blue>false</span>,"short_gi":<span style=color:blue>true</span>}}]}]}
{"rate":<span style=color:blue>72200</span>,"mcs":<span style=color:blue>7</span>,"40mhz":<span style=color:blue>false</span>,"short_gi":<span style=color:blue>true</span>}}]}]}
To obtain these values, the Linux '''iwinfo''' command and '''assoclist''' parameter (red) are used. Highlighted in green are the devices connected to the router via WiFi as identified by their MAC addresses. The response information about the connection with the device, such as signal strength, noise, time of inactivity (idle time), rx, tx rate, etc., is highlighted in blue.
To obtain these values, the Linux '''iwinfo''' command and '''assoclist''' parameter (red) are used. Highlighted in green are the devices connected to the router via WiFi as identified by their MAC addresses. The response information about the connection with the device, such as signal strength, noise, time of inactivity (idle time), rx, tx rate, etc., is highlighted in blue.
===WiFi information===
===WiFi information===
----
----
{"jsonrpc":"2.0","id":1,"result":[0,
{"jsonrpc":"2.0","id":1,"result":[0,
{"phy":"<span style=color:blue>phy0</span>","ssid":"<span style=color:blue>HAL9000</span>","bssid":"<span style=color:blue>00:1E:42:16:D6:68</span>","country":"<span style=color:blue>00</span>","mode":"<span style=color:blue>Master</span>","channel":<span style=color:blue>6</span>,"frequency":<span style=color:blue>2437</span>,"txpower":<span style=color:blue>20</span>,
{"phy":"<span style=color:blue>phy0</span>","ssid":"<span style=color:blue>HAL9000</span>","bssid":"<span style=color:blue>00:1E:42:XX:XX:XX</span>","country":"<span style=color:blue>00</span>","mode":"<span style=color:blue>Master</span>","channel":<span style=color:blue>6</span>,"frequency":<span style=color:blue>2437</span>,"txpower":<span style=color:blue>20</span>,
"quality":<span style=color:blue>22</span>,"quality_max":<span style=color:blue>70</span>,"signal":<span style=color:blue>22</span>,"noise":<span style=color:blue>-61</span>,"bitrate":<span style=color:blue>72200</span>,"encryption":
"quality":<span style=color:blue>22</span>,"quality_max":<span style=color:blue>70</span>,"signal":<span style=color:blue>22</span>,"noise":<span style=color:blue>-61</span>,"bitrate":<span style=color:blue>72200</span>,"encryption":
{"enabled":<span style=color:blue>false</span>},"hwmodes":["<span style=color:blue>b</span>","<span style=color:blue>g</span>","<span style=color:blue>n</span>"],"hardware":{"name":"<span style=color:blue>Generic MAC80211</span>"}}]}
{"enabled":<span style=color:blue>false</span>},"hwmodes":["<span style=color:blue>b</span>","<span style=color:blue>g</span>","<span style=color:blue>n</span>"],"hardware":{"name":"<span style=color:blue>Generic MAC80211</span>"}}]}
As with the clients list command described above, to obtain this information the Linux '''iwinfo''' command is used, but this time with the '''info''' parameter (red). The relevant information, such as WiFi SSID, WiFi MAC address, WiFi channel, Encryption type, etc., is highlighted in blue
As with the clients list command described above, to obtain this information the Linux '''iwinfo''' command is used, but this time with the '''info''' parameter (red). The relevant information, such as WiFi SSID, WiFi MAC address, WiFi channel, Encryption type, etc., is highlighted in blue
===Manufacturing information===
===Manufacturing information===
----
----
"805725a19ab0fba6c2b44ecf2f952fb9","file", "exec",
"805725a19ab0fba6c2b44ecf2f952fb9","file", "exec",
{
{
"command":"<span style=color:red>mnf_info</span>", "params":["<span style=color:red>name</span>", "<span style=color:red>sn</span>", "<span style=color:red>mac</span>"]
"command":"<span style=color:red>mnf_info</span>", "params":["<span style=color:red>--name</span>", "<span style=color:red>--batch</span>"]
}
}
]
]
'''Linux:'''
'''Linux:'''
curl -d "{ \"jsonrpc\": \"2.0\", \"id\": 1, \"method\": \"call\", \"params\": [ \"805725a19ab0fba6c2b44ecf2f952fb9\",\"file\", \"exec\",{ \"command\":\"<span style=color:red>mnf_info</span>\", \"params\":[\"<span style=color:red>name</span>\", \"<span style=color:red>sn</span>\", \"<span style=color:red>mac</span>\"] } ] }" http://<span style=color:black>192.168.1.1</span>/ubus
curl -d "{ \"jsonrpc\": \"2.0\", \"id\": 1, \"method\": \"call\", \"params\": [ \"805725a19ab0fba6c2b44ecf2f952fb9\",\"file\", \"exec\",{ \"command\":\"<span style=color:red>mnf_info</span>\", \"params\":[\"<span style=color:red>--name</span>\", \"<span style=color:red>--batch</span>\"] } ] }" http://<span style=color:black>192.168.1.1</span>/ubus
'''Response:'''
'''Response:'''
{"jsonrpc":"2.0","id":1,"result":[0,{"code":0,"stdout":"<span style=color:blue>RUT950HG12C0</span>\n<span style=color:blue>1367435694</span>\n<span style=color:blue>001e4216d666</span>\n"}]}
{"jsonrpc":"2.0","id":1,"result":[0,{"code":0,"stdout":"<span style=color:blue>"RUT955003XXX</span>\n<span style=color:blue>0105</span>\n<span style=color:blue>001e4216d666</span>\n"}]}
To obtain the manufacturing information the '''mnf_info''' (highlighted in red) command is used. In this case a query was sent asking for the device's Product Code (name), Serial Number (sn) and MAC Address (mac) (highlighted in red in the query; returned values highlighted in blue). Using ''mnf_info'', you can "ask" the router for any type of manufacturing information. Here is the list of possible ''mnf_info'' parameters:
To obtain the manufacturing information the '''mnf_info''' (highlighted in red) command is used. In this case a query was sent asking for the device's Product Code (name), Serial Number (sn) and MAC Address (mac) (highlighted in red in the query; returned values highlighted in blue). Using ''mnf_info'', you can "ask" the router for any type of manufacturing information. Here is the list of possible ''mnf_info'' parameters:
* '''mac''' - returns the router's LAN MAC address
* '''--mac''' - returns the router's LAN MAC address
* '''maceth''' - returns the router's WAN MAC address
* '''--maceth''' - returns the router's WAN MAC address
* '''name''' - returns the router's Product Code
* '''--name''' - returns the router's Product Code
* '''wps''' - returns the router's WPS PIN number
* '''--wps''' - returns the router's WPS PIN number
* '''sn''' - returns the router's Serial number
* '''--sn''' - returns the router's Serial number
* '''batch''' - returns the router's Batch number
* '''--batch''' - returns the router's Batch number
* '''hwver''' - returns the router's Hardware Revision number
* '''--hwver''' - returns the router's Hardware Revision number
* '''simpin''' - returns the router's SIM card's PIN (as it is specified in the '''[[RUT955 Mobile|Mobile]]''' section)
* '''--simpin''' - returns the router's SIM card's PIN (as it is specified in the '''[[RUT955 Mobile|Mobile]]''' section)
* '''blver''' - returns the router's Bootloader version
* '''--blver''' - returns the router's Bootloader version
===GPS Data===
===GPS Data===
----
----
{"jsonrpc":"2.0","id":1,"result":[0,{"code":0,"stdout":"<span style=color:blue>-23.612625\n-46.626355\</span>n"}]}
{"jsonrpc":"2.0","id":1,"result":[0,{"code":0,"stdout":"<span style=color:blue>-23.612625\n-46.626355\</span>n"}]}
The blue part in the code are the Latitude and Longitude.
The blue part in the code are the Latitude and Longitude.
===Firmware number===
===Firmware number===
----
----
This command ('''file''', '''read''', highlighted in red) is an alternative to the Linux '''cat''' command. All you need is to specify the path (in this case '''/etc/version''', highlighted in red) to the file that you wish to read.
This command ('''file''', '''read''', highlighted in red) is an alternative to the Linux '''cat''' command. All you need is to specify the path (in this case '''/etc/version''', highlighted in red) to the file that you wish to read.
<br>
===Reboot===
===Reboot===
----
----
The success response for this command is an empty message. If the response contains no data, the command was executed successfully.
The success response for this command is an empty message. If the response contains no data, the command was executed successfully.
===Set SIM card information===
===Set SIM card information===
----
----
The command used is ''uci set'' (highlighted in red). The config file name is '''simcard''', section '''sim1''', options '''mtu''' and '''service''' (configs, sections and options highlighted in orange). The response shown above is a positive response, but don't forget to execute ''uci commit'' and ''reload_config'' afterwards or else your changes will not take effect.
The command used is ''uci set'' (highlighted in red). The config file name is '''simcard''', section '''sim1''', options '''mtu''' and '''service''' (configs, sections and options highlighted in orange). The response shown above is a positive response, but don't forget to execute ''uci commit'' and ''reload_config'' afterwards or else your changes will not take effect.
[[Category: RutOS Configuration Examples]]
==See Also==
You may learn more about UCI commands [[UCI_command_usage|here]].
==External links==
https://www.postman.com/ - API software.
[[Category:Router control and monitoring]]
