| Both sides previous revision Previous revision Next revision | Previous revision Next revisionBoth sides next revision |
| ru:docs:guide-user:additional-software:beginners-build-guide [2021/07/31 16:42] – [2.1 Initial check out of the code] update links vgaetera | ru:docs:guide-user:additional-software:beginners-build-guide [2021/10/15 08:29] – ↷ Links adapted because of a move operation bobafetthotmail |
|---|
| |
| Alternative guides to achieving the same goal: | Alternative guides to achieving the same goal: |
| [[docs:guide-user:additional-software:beginners-build-guide|Beginners guide to building your own firmware]], [[docs:guide-user:additional-software:imagebuilder|Using the Image Builder]]. | [[docs:guide-developer:toolchain:beginners-build-guide|Beginners guide to building your own firmware]], [[docs:guide-user:additional-software:imagebuilder|Using the Image Builder]]. |
| |
| ===== 1 - Getting a Linux server (for Windows user)===== | ===== 1 - Getting a Linux server (for Windows user)===== |
| If you already have a Debian/Ubuntu server you can skip to [[docs:guide-user:additional-software:beginners-build-guide#compiling_openwrt|part 2]]. | If you already have a Debian/Ubuntu server you can skip to [[docs:guide-developer:toolchain:beginners-build-guide#compiling_openwrt|part 2]]. |
| |
| As an alternative to setting up a virtual machine, Windows 10 users can install Ubuntu from Microsoft Store and skip to part 2. Make sure to run these commands after installation: | As an alternative to setting up a virtual machine, Windows 10 users can install Ubuntu from Microsoft Store and skip to part 2. Make sure to run these commands after installation: |
| |
| ==== 2.1 Initial check out of the code ==== | ==== 2.1 Initial check out of the code ==== |
| Use the [[docs:guide-user:additional-software:beginners-build-guide|Beginners guide to building your own firmware]] for the initial checkout, but to get the stable version you need to do this after you run "cd openwrt": | Use the [[docs:guide-developer:toolchain:beginners-build-guide|Beginners guide to building your own firmware]] for the initial checkout, but to get the stable version you need to do this after you run "cd openwrt": |
| <code> | <code> |
| git tag | git tag |
| </code> | </code> |
| |
| Then continue following the [[docs:guide-user:additional-software:beginners-build-guide|Beginners guide to building your own firmware]]. | Then continue following the [[docs:guide-developer:toolchain:beginners-build-guide|Beginners guide to building your own firmware]]. |
| |
| ==== 2.2 General tips on using the config system ==== | ==== 2.2 General tips on using the config system ==== |
| Except for choosing the target I suggest that you don't mess with the options above Base system. Also, in general, don't uncheck anything that is selected by default unless you really know what you're doing. If something is selected with "-*-" (so you can't uncheck it) it is because something else depends on it. | Except for choosing the target I suggest that you don't mess with the options above Base system. Also, in general, don't uncheck anything that is selected by default unless you really know what you're doing. If something is selected with "-*-" (so you can't uncheck it) it is because something else depends on it. |
| |
| Instructions on how to include config files in the image (for instance from the backup you can download from the router): [[docs:guide-developer:build-system:use-buildsystem#custom_files|Custom files]] | Instructions on how to include config files in the image (for instance from the backup you can download from the router): [[docs:guide-developer:toolchain:use-buildsystem#custom_files|Custom files]] |
| ==== 2.3 Determining Target (Selecting the router model) ==== | ==== 2.3 Determining Target (Selecting the router model) ==== |
| - Do a web search for <your router model> wikidevi. For instance, if you have an Asus RT-N56U then search for RT-N56U wikidevi. This would give https://wikidevi.com/wiki/ASUS_RT-N56U as the first response on most search engines. Find CPU on the page. In the case of RT-N56U it says Ralink RT3662F. If you type / in the builder you can search for RT-N56U. This will give a bunch of hits, which among other things says Symbol: TARGET_DEVICE_PACKAGES_ramips_rt3883_DEVICE_rt-n56u. Notice the ramips part. Now select Target System. In the list you will find "Mediatek Ralink ARM" and "Mediatek Ralink MIPS". Given the information we have you can probably guess that the correct choice is "Mediatek Ralink MIPS". | - Do a web search for <your router model> wikidevi. For instance, if you have an Asus RT-N56U then search for RT-N56U wikidevi. This would give https://wikidevi.com/wiki/ASUS_RT-N56U as the first response on most search engines. Find CPU on the page. In the case of RT-N56U it says Ralink RT3662F. If you type / in the builder you can search for RT-N56U. This will give a bunch of hits, which among other things says Symbol: TARGET_DEVICE_PACKAGES_ramips_rt3883_DEVICE_rt-n56u. Notice the ramips part. Now select Target System. In the list you will find "Mediatek Ralink ARM" and "Mediatek Ralink MIPS". Given the information we have you can probably guess that the correct choice is "Mediatek Ralink MIPS". |
| |
| Mostly for developers: | Mostly for developers: |
| * [[docs:guide-developer:build-system:use-buildsystem|Build system – Usage]] | * [[docs:guide-developer:toolchain:use-buildsystem|Build system – Usage]] |
| * [[docs:guide-developer:env|Using Build Environments]] | * [[docs:guide-developer:toolchain:env|Using Build Environments]] |
| * [[docs:guide-developer:build-system:start|The build system – About]] | * [[docs:guide-developer:build-system:start|The build system – About]] |
| * [[docs:guide-developer:using_the_sdk|Using the SDK]] | * [[docs:guide-developer:using_the_sdk|Using the SDK]] |
| |
| Don't hesitate to ask in [[https://forum.openwrt.org/t/beginners-step-by-step-guide-to-building-your-own-firmware/8141|this forum thread]] if anything in this guide is unclear. | Don't hesitate to ask in [[https://forum.openwrt.org/t/beginners-step-by-step-guide-to-building-your-own-firmware/8141|this forum thread]] if anything in this guide is unclear. |