165
edits
Changes
RUTOS Software Development Kit (SDK) Instruction (view source)
Revision as of 09:56, 16 January 2024
, 16 January→Changing Device brand
A <b>Software Development Kit</b> (<b>SDK</b>) is a set of software development tools that provides the possibility to create applications for a certain software package, software framework, computer system or similar development platform.
A <b>Software Development Kit</b> (<b>SDK</b>) is a set of software development tools that provides the possibility to create applications for a certain software package, software framework, computer system or similar development platform.
<b>Note:</b> The information in this page is in accordance to using SDK version <b>R_00.07.05</b>. The included Readme file in SDK archive file contains information for each separate SDK version and might differ from the older version or information provided in this wiki page. Please always follow the instruction provided in Readme file.
<b>Note:</b> The information in this page is in accordance to using SDK version <b>R_00.07.06</b>. The included Readme file in SDK archive file contains information for each separate SDK version and might differ from the older version or information provided in this wiki page. Please always follow the instruction provided in Readme file.
__TOC__
__TOC__
<li>Teltonika Router running RutOS</li>
<li>Teltonika Router running RutOS</li>
<li>[https://ubuntu.com/download/desktop/ Ubuntu 22.04.3 LTS OS]</li>
<li>[https://ubuntu.com/download/desktop/ Ubuntu 22.04.3 LTS OS]</li>
<li>SDK version <b>R_00.07.05.x</b></li>
<li>SDK version <b>R_00.07.06.x</b></li>
</ul>
</ul>
The examples apply to various RUTOS routers, SDK versions and operating systems. The key concepts should apply regardless of the device, version, or system. The availability of SDK Firmware branding begins from version 7.05, although some of these modifications may be accessible on earlier firmware versions.
The examples apply to various RUTOS routers, SDK versions and operating systems. The key concepts should apply regardless of the device, version, or system. The availability of SDK Firmware branding begins from version 7.06, although some of these modifications may be accessible on earlier firmware versions.
Most examples provided in this page are independent from each other. But it is highly recommended to acquaint yourself with the basics by reading the "[[#Prerequisites|Prerequisites]]" and "[[#Compiling_a_standard_firmware|Compiling a standard firmware]]" sections first as they contain information that will be necessary in order to understand some aspects of the other examples.
Most examples provided in this page are independent from each other. But it is highly recommended to acquaint yourself with the basics by reading the "[[#Prerequisites|Prerequisites]]" and "[[#Compiling_a_standard_firmware|Compiling a standard firmware]]" sections first as they contain information that will be necessary in order to understand some aspects of the other examples.
[[File:Ubuntu4.jpg|border|class=tlt-border]]
[[File:Ubuntu4.jpg|border|class=tlt-border]]
5. Select '''Customize Hardware'''. Allow for 4GB or more of memory and 2 or more processors *more is preferable* depending on your machine. Finally, click '''Finish'''.
5. Select '''Customize Hardware'''. Allow for 4GB or more of memory and 2 or more processors, depending on your machine. Finally, click '''Finish'''.
[[File:Ubuntu5.jpg|border|class=tlt-border]]
[[File:Ubuntu5.jpg|border|class=tlt-border]]
sudo apt install npm
sudo apt install npm
sudo apt install build-essential ccache ecj fastjar file flex g++ gawk \ gettext git java-propose-classpath java-wrappers jq libelf-dev \ libffi-dev libncurses5-dev libncursesw5-dev libssl-dev libtool \ python python2.7-dev python3 python3-dev python3-distutils \ python3-setuptools rsync subversion swig time u-boot-tools \ unzip wget xsltproc zlib1g-dev bison
sudo apt install binutils binutils-gold bison build-essential bzip2 \ ca-certificates curl default-jdk device-tree-compiler devscripts \ ecj file flex fuse g++ gawk gcc gcc-multilib gengetopt gettext \ git gnupg groff help2man java-wrappers java-propose-classpath jq \ libc6-dev libffi-dev libncurses5-dev libpcre3-dev libsqlite3-dev \ libssl-dev libxml-parser-perl lz4 make ocaml ocaml-findlib \ ocaml-nox patch pkg-config python3 python3-dev python3-distutils \ python3-yaml rsync ruby sharutils subversion swig u-boot-tools \ unzip uuid-dev vim-common wget zip zlib1g-dev
'''Note''': It is suggested to install '''NodeJS v12 (or newer)''' and '''NPM v6.9 (or newer)'''. You can check NodeJS and NPM version by running these commands respectively:
'''Note''': It is suggested to install '''NodeJS v12 (or newer)''' and '''NPM v6.9 (or newer)'''. You can check NodeJS and NPM version by running these commands respectively:
Create a new folder (for this example I'll be using a directory called <i>RUTX_R</i> found at my <b>home</b> directory) and extract the SDK archive inside it.
Create a new folder (for this example I'll be using a directory called <i>RUTX_R</i> found at my <b>home</b> directory) and extract the SDK archive inside it.
[[File:SDK_EXTRACT.jpg|border|class=tlt-border]]
[[File:DL.png|border|class=tlt-border]]
You can achieve this with drag and drop or by executing this command via '''Terminal''':
You can achieve this with drag and drop or by executing this command via '''Terminal''':
cd ~/Downloads
cd ~/Downloads
Extract the '''tar.gz''' file:
Extract the '''tar.gz''' file:
tar -xzvf RUTX_R_GPL_00.07.05.X.tar.gz
tar -xzvf RUTX_R_GPL_00.07.06.X.tar.gz
This command will extract the contents of the RUTX_R_GPL_00.07.05.X.tar.gz file into the current directory, After running this command, you should find the extracted files in the same directory where you ran the command.
This command will extract the contents of the RUTX_R_GPL_00.07.06.X.tar.gz file into the current directory, After running this command, you should find the extracted files in the same directory where you ran the command.
<b>Note</b>: don't forget to replace the file name and path in accordance with your own circumstances
<b>Note</b>: don't forget to replace the file name and path in accordance with your own circumstances
To change the default device password, changes need to be made inside:
To change the default device password, changes need to be made inside:
"RUTX_R_GPL_00.07.05/package/base-files/files/lib/preinit/84_set_password"
"RUTX_R_GPL_00.07.06/package/base-files/files/lib/preinit/84_set_password"
Change "'''admin01'''" to your password on line '''[ -z "$passwd" ] && passwd="$(mkpasswd
Change "'''admin01'''" to your password on line '''[ -z "$passwd" ] && passwd="$(mkpasswd
admin01)"'''
admin01)"'''
Additionally, devices on newer batch are having unique passwords from MNF info. The new password should also be added under '''passwd''' in '''push_password''' list
[[File:Mkpswd.png|border|class=tlt-border]]
To disable the option to change the '''default password for the first time''', kindly follow the professional instructions outlined below.
To disable the option to change the '''default password for the first time''', kindly follow the professional instructions outlined below.
The exact path to the firmware depends on the target. In this example, the firmware can be found in the following directory:
The exact path to the firmware depends on the target. In this example, the firmware can be found in the following directory:
rutos-ath79-rut9-gpl>bin>targets>ath79>generic>tltFws>RUTX_R_GPL_00.07.05.3_WEBUI
rutos-ath79-rut9-gpl>bin>targets>ath79>generic>tltFws>RUTX_R_GPL_00.07.06.1_WEBUI
'''file name''': RUTX_R_GPL_00.07.05.X_WEBUI
'''file name''': RUTX_R_GPL_00.07.06.X_WEBUI
==Changing Default IP Address==
==Changing Default IP Address==
The exact path to the firmware depends on the target. In this example, the firmware can be found in the following directory:
The exact path to the firmware depends on the target. In this example, the firmware can be found in the following directory:
rutos-ath79-rut9-gpl>bin>targets>ath79>generic>tltFws>RUTX_R_GPL_00.07.05.3_WEBUI
rutos-ath79-rut9-gpl>bin>targets>ath79>generic>tltFws>RUTX_R_GPL_00.07.06.1_WEBUI
'''file name''': RUTX_R_GPL_00.07.05.X_WEBUI
'''file name''': RUTX_R_GPL_00.07.06.X_WEBUI
==Changing SSH Banner==
==Changing SSH Banner==
To modify the '''SSH banner''', you can make use of the file search tool in the extracted GPL. To access this, follow these steps from the root directory of your project, '''you can find the file from route below''':
To modify the '''SSH banner''', you can make use of the file search tool in the extracted GPL. To access this, follow these steps from the root directory of your project, '''you can find the file from route below''':
~/Downloads/RUTX_R_GPL_00.07.05/rutos-ipq40xx-rutx-gpl/package/base-files/files/etc
~/Downloads/RUTX_R_GPL_00.07.06/rutos-ipq40xx-rutx-gpl/package/base-files/files/etc
[[File:Blogo.png|border|class=tlt-border]]
[[File:Blogo.png|border|class=tlt-border]]
Make sure that the file that we want to edit is in the similar file path as above.
Make sure that the file that we want to edit is in the similar file path as above.
[[File:Image (16).png|border|class=tlt-border]]
[[File:Bannernew.png|border|class=tlt-border]]
The contents of the file should look similar to the image above. after making the desired changes to the banner, you can then save those modifications.
The contents of the file should look similar to the image above. after making the desired changes to the banner, you can then save those modifications.
The exact path to the firmware depends on the target. In this example, the firmware can be found in the following directory:
The exact path to the firmware depends on the target. In this example, the firmware can be found in the following directory:
rutos-ath79-rut9-gpl>bin>targets>ath79>generic>tltFws>RUTX_R_GPL_00.07.05.3_WEBUI
rutos-ath79-rut9-gpl>bin>targets>ath79>generic>tltFws>RUTX_R_GPL_00.07.06.1_WEBUI
'''file name''': RUTX_R_GPL_00.07.05.X_WEBUI
'''file name''': RUTX_R_GPL_00.07.06.X_WEBUI
'''RESULTS:'''
'''RESULTS:'''
[[File:BANNERRESULTS.png|border|class=tlt-border]]
[[File:Sshnew.png|border|class=tlt-border]]
==Changing Firmware Version==
==Changing Firmware Version==
To modify the firmware version like Prefix, go to the directory where '''gpl_version''' file is located (''/Downloads/RUTX_R_GPL_00.07.05.3/rutos-ipq40xx-rutx-gpl''). Then run this command to edit file content.
To modify the firmware version like Prefix, go to the directory where '''gpl_version''' file is located (''/Downloads/RUTX_R_GPL_00.07.06.1/rutos-ipq40xx-rutx-gpl''). Then run this command to edit file content.
nano gpl_version
nano gpl_version
To modify the '''Company Links''', you can make use of the file search tool in the extracted GPL. To access this, follow these steps from the root directory of your project, '''you can find the file from route below:'''
To modify the '''Company Links''', you can make use of the file search tool in the extracted GPL. To access this, follow these steps from the root directory of your project, '''you can find the file from route below:'''
~/Downloads/RUTX_R_GPL_00.07.05.4/rutos-ipq40xx-rutx-gpl/package/feeds/vuci/vuci-ui-core/bin/dist/brand
~/Downloads/RUTX_R_GPL_00.07.06.1/rutos-ipq40xx-rutx-gpl/package/feeds/vuci/vuci-ui-core/bin/dist/brand
[[File:Brandjson.png|1100px|border|class=tlt-border]]
[[File:Brandjson.png|1100px|border|class=tlt-border]]
Make sure that the file that we want to edit is in the similar file path as above.
Make sure that the file that we want to edit is in the similar file path as above.
[[File:Notepad.png|border|class=tlt-border]]
[[File:Brandnew.png|border|class=tlt-border]]
The contents of the file should look similar to the image above. After making the desired changes to the banner, you can then save those modifications.
The contents of the file should look similar to the image above. After making the desired changes to the banner, you can then save those modifications.
The exact path to the firmware depends on the target. In this example, the firmware can be found in the following directory:
The exact path to the firmware depends on the target. In this example, the firmware can be found in the following directory:
rutos-ath79-rut9-gpl>bin>targets>ath79>generic>tltFws>RUTX_R_GPL_00.07.05.4_WEBUI
rutos-ath79-rut9-gpl>bin>targets>ath79>generic>tltFws>RUTX_R_GPL_00.07.06.1_WEBUI
'''file name''': RUTX_R_GPL_00.07.05.X_WEBUI
'''file name''': RUTX_R_GPL_00.07.06.X_WEBUI
'''RESULTS:'''
'''RESULTS:'''
[[File:Blurred.png|1100px|border|class=tlt-border]]
[[File:Companylink.png|1100px|border|class=tlt-border]]
==Changing Device brand==
==Changing Device brand==
'''First File:'''
'''First File:'''
~/Downloads/RUTX_R_GPL_00.07.05/rutos-ipq40xx-rutx-gpl/package/feeds/vuci/vuci-ui-core/bin/dist
~/Downloads/RUTX_R_GPL_00.07.06/rutos-ipq40xx-rutx-gpl/package/feeds/vuci/vuci-ui-core/bin/dist
[[File:BRANDTELT.png|1100px|border|class=tlt-border]]
[[File:BRANDTELT.png|1100px|border|class=tlt-border]]
'''Second File:'''
'''Second File:'''
~/Downloads/RUTX_R_GPL_00.07.05/rutos-ipq40xx-rutx-gpl/package/feeds/vuci/vuci-ui-core/bin/dist/ tlt-icons
~/Downloads/RUTX_R_GPL_00.07.06/rutos-ipq40xx-rutx-gpl/package/feeds/vuci/vuci-ui-core/bin/dist/ tlt-icons
[[File:BRANDTELT2.png|1100px|border|class=tlt-border]]
[[File:BRANDTELT2.png|1100px|border|class=tlt-border]]
The exact path to the firmware depends on the target. In this example, the firmware can be found in the following directory:
The exact path to the firmware depends on the target. In this example, the firmware can be found in the following directory:
rutos-ath79-rut9-gpl>bin>targets>ath79>generic>tltFws>RUTX_R_GPL_00.07.05.3_WEBUI
rutos-ath79-rut9-gpl>bin>targets>ath79>generic>tltFws>RUTX_R_GPL_00.07.06.1_WEBUI
'''file name''': RUTX_R_GPL_00.07.05.X_WEBUI
'''file name''': RUTX_R_GPL_00.07.06.X_WEBUI
[[File:brand_transparent.png|border|1100px|class=tlt-border]]
[[File:brand_transparent.png|border|1100px|class=tlt-border]]
[[File:BRANDRESULTS1.png|1100px|border|class=tlt-border]]
[[File:Companybrand.png|1100px|border|class=tlt-border]]
==Changing Favicon==
==Changing Favicon==
'''First File:'''
'''First File:'''
~/Downloads/RUTX_R_GPL_00.07.05.3/rutos-ipq40xx-rutx-gpl/package/feeds/vuci/vuci-ui-core/bin
~/Downloads/RUTX_R_GPL_00.07.06.1/rutos-ipq40xx-rutx-gpl/package/feeds/vuci/vuci-ui-core/bin
[[File:Favicon.png|1100px|border|class=tlt-border]]
[[File:Favicon.png|1100px|border|class=tlt-border]]
'''Second File:'''
'''Second File:'''
~/Downloads/RUTX_R_GPL_00.07.05.3/rutos-ipq40xx-rutx-gpl/package/feeds/vuci/vuci-ui-core/bin/dist/assests
~/Downloads/RUTX_R_GPL_00.07.06.1/rutos-ipq40xx-rutx-gpl/package/feeds/vuci/vuci-ui-core/bin/dist/assests
[[File:Logo2.png|border|class=tlt-border]]
[[File:Logo2.png|border|class=tlt-border]]
The exact path to the firmware depends on the target. In this example, the firmware can be found in the following directory:
The exact path to the firmware depends on the target. In this example, the firmware can be found in the following directory:
rutos-ath79-rut9-gpl>bin>targets>ath79>generic>tltFws>RUTX_R_GPL_00.07.05.3_WEBUI
rutos-ath79-rut9-gpl>bin>targets>ath79>generic>tltFws>RUTX_R_GPL_00.07.06.1_WEBUI
'''file name''': RUTX_R_GPL_00.07.05.X_WEBUI
'''file name''': RUTX_R_GPL_00.07.06.X_WEBUI
==Changing WebUI Color==
==Changing WebUI Color==
To modify color designs for the WebUI, locate '''brand.css''' file. In this configuration, it is in ''/RUTX_R_GPL_00.07.05/rutos-ipq40xx-rutx-gpl/package/feeds/vuci/vuci-ui-core/bin/dist/brand'' directory. Run '''ls''' command to see the contents of the directory. It should have a zip file entitled '''brand.css.gz'''. To extract brand.css.gz, run:
To modify color designs for the WebUI, locate '''brand.css''' file. In this configuration, it is in ''/RUTX_R_GPL_00.07.06/rutos-ipq40xx-rutx-gpl/package/feeds/vuci/vuci-ui-core/bin/dist/brand'' directory. Run '''ls''' command to see the contents of the directory. It should have a zip file entitled '''brand.css.gz'''. To extract brand.css.gz, run:
gzip -d brand.css.gzip
gzip -d brand.css.gzip
The exact path to the firmware depends on the target. In this example, the firmware can be found in the following directory:
The exact path to the firmware depends on the target. In this example, the firmware can be found in the following directory:
rutos-ath79-rut9-gpl>bin>targets>ath79>generic>tltFws>RUTX_R_GPL_00.07.05.3_WEBUI
rutos-ath79-rut9-gpl>bin>targets>ath79>generic>tltFws>RUTX_R_GPL_00.07.06.1_WEBUI
'''file name''': RUTX_R_GPL_00.07.05.X_WEBUI
'''file name''': RUTX_R_GPL_00.07.06.X_WEBUI
'''RESULTS:'''
'''RESULTS:'''