Differences

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

--- docs:guide-developer:helloworld:chapter1 [2018/06/01 08:34] – LEDE -> OpenWrt tmomas
+++ docs: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 ======
-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 =====
@@ 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.
-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%>
+''/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 April, 2024, that is ''openwrt-23.05.3''
+</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:
 <code>
 cd /home/buildbot/source
-git checkout v17.01.2
+git checkout v23.05.3
 make distclean
 </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:
 <code>