Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
docs:guide-developer:helloworld:chapter1 [2018/12/05 17:28] – [Preparing, configuring and building the necessary tools] jeffdocs:guide-developer:helloworld:chapter1 [2024/04/06 02:36] (current) – updated reference to stable branch ingamedeo
Line 3: Line 3:
 ====== Preparing your OpenWrt build system for use ====== ====== Preparing your OpenWrt build system for use ======
  
-This is the first chapter in the "Hello, world!" for OpenWrt article series. Before starting this chapter, you should read through [[docs:guide-developer:build-system:install-buildsystem|Build system – Installation]], procure a suitable computing platform (virtualized or otherwise) of your choice, and clone the source code to a new directory. Instructions for performing these steps can be found on the Wiki page linked above.+This is the first chapter in the "Hello, world!" for OpenWrt article series. Before starting this chapter, you should read through [[docs:guide-developer:toolchain:install-buildsystem|Build system – Installation]], procure a suitable computing platform (virtualized or otherwise) of your choice, and clone the source code to a new directory. Instructions for performing these steps can be found on the Wiki page linked above.
  
-Although this guide will not provide detailed instructions for this approach, you can also use the [[docs:guide-developer:using_the_sdk|OpenWrt SDK]] for your target platform instead of cloning the source code and creating the build system from scratch. If you opt for this route, you can skip the source cloning steps listed in the "Build system - Installation" guide, and instead download & extract the SDK into a new folder on your otherwise-prepared development environment.+Although this guide will not provide detailed instructions for this approach, you can also use the [[docs:guide-developer:toolchain:using_the_sdk|OpenWrt SDK]] for your target platform instead of cloning the source code and creating the build system from scratch. If you opt for this route, you can skip the source cloning steps listed in the "Build system - Installation" guide, and instead download & extract the SDK into a new folder on your otherwise-prepared development environment.
  
 ===== Preparing, configuring and building the necessary tools ===== ===== Preparing, configuring and building the necessary tools =====
Line 11: Line 11:
 These steps are necessary only if you chose to clone the source code. If you chose to use the SDK, you can skip this section. These steps are necessary only if you chose to clone the source code. If you chose to use the SDK, you can skip this section.
  
-We first select a stable source code revision (v17.01.2), and ensure our source code directory is clean. The author of this article chose to clone the source code into a folder called 'source' under the home directory of the build user, called 'buildbot'.+We first select a stable source code revision (v23.05.3), and ensure our source code directory is clean. The author of this article chose to clone the source code into a folder called 'source' under the home directory of the build user, called 'buildbot'.
  
 <WRAP center round tip 80%> <WRAP center round tip 80%>
 ''/home/buildbot/'' is a representative path, you might choose, for example, ''~/devel/'' ''/home/buildbot/'' is a representative path, you might choose, for example, ''~/devel/''
  
-It is also suggested to use the most-current "stable" git branch. In November, 2018, that is ''openwrt-18.06''+It is also suggested to use the most-current "stable" git branch. In April, 2024, that is ''openwrt-23.05.3''
 </WRAP> </WRAP>
  
 +As of April, 2024, the OpenWrt git repository can be cloned using
 +<code>
 +git clone https://git.openwrt.org/openwrt/openwrt.git source
 +</code>
 +to place it into the ''./source/'' subdirectory of the current directory. As with the leading path, there is nothing special about the name ''source''. Some users may choose to omit the final argument and have it cloned into ''./openwrt/'' or supply a different directory on the clone command. ''source'' is shown above to be consistent with the remainder of this guide.
  
 To perform these steps, issue the following commands to change into the source code directory, checkout a stable code revision and clean any possible build artifacts: To perform these steps, issue the following commands to change into the source code directory, checkout a stable code revision and clean any possible build artifacts:
 <code> <code>
 cd /home/buildbot/source cd /home/buildbot/source
-git checkout v17.01.2+git checkout v23.05.3
 make distclean make distclean
 </code> </code>
 +
 +It is recommended that you update and install your 'feeds' packages to avoid future problems. You can do that using:
 +<code>
 +./scripts/feeds update -a
 +./scripts/feeds install -a
 +</code>
 +
 Now, we can configure the cross-compilation toolchain by invoking the graphical configuration menu: Now, we can configure the cross-compilation toolchain by invoking the graphical configuration menu:
 <code> <code>
  • Last modified: 2018/12/05 17:28
  • by jeff