Compare commits
23 Commits
openwrt-15
...
openwrt-21
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
4cdb130d62 | ||
|
|
2d4d07d2a1 | ||
|
|
41a0a93fde | ||
|
|
3d02057bb6 | ||
|
|
725caf2919 | ||
|
|
63806ccfe5 | ||
|
|
527bbf214c | ||
|
|
74b2a4d989 | ||
|
|
7a39ab9adc | ||
|
|
f9cdbd39ef | ||
|
|
75b8e35aa7 | ||
|
|
85e367523a | ||
|
|
38a96e37e0 | ||
|
|
0381c6f40b | ||
|
|
a761fb7630 | ||
|
|
e96f2d38cc | ||
|
|
4a1e765a85 | ||
|
|
31d0688c7c | ||
|
|
68a222edc6 | ||
|
|
8e64a64186 | ||
|
|
a02567b2fd | ||
|
|
6d0547b26b | ||
|
|
b8627f3eb3 |
2
.gitignore
vendored
2
.gitignore
vendored
@@ -1,2 +1,2 @@
|
||||
notes.txt
|
||||
authorized_keys
|
||||
build/
|
||||
|
||||
95
README.md
95
README.md
@@ -1,15 +1,19 @@
|
||||
# What
|
||||
|
||||
It's a script to build a customized OpenWRT firmware image on a Linux x86_64 host
|
||||
(basic familiarity with [OpenWRT](https://wiki.openwrt.org/doc/howto/user.beginner)
|
||||
is assumed).
|
||||
It's a script to build a customized
|
||||
[OpenWRT](https://openwrt.org/docs/guide-user/start)
|
||||
firmware image using
|
||||
[ImageBuilder](https://openwrt.org/docs/guide-user/additional-software/imagebuilder).
|
||||
|
||||
If the generated image is flashed on a device it will try to automatically
|
||||
set up [extroot](http://wiki.openwrt.org/doc/howto/extroot) on **any
|
||||
(!)** storage device plugged into the USB port (`/dev/sda`). Keep in
|
||||
mind that **this will erase any inserted storage device while the
|
||||
router is in the initial setup phase**! Unfortunately there's little
|
||||
that can be done at that point to ask the user for confirmation.
|
||||
If the generated image is flashed on a device it will try to
|
||||
automatically set up
|
||||
[extroot](https://openwrt.org/docs/guide-user/additional-software/extroot_configuration)
|
||||
on **any (!)** storage device plugged into the USB port (`/dev/sda`),
|
||||
including your working extroot pendrive if you plug it in only later
|
||||
in the boot process. Keep in mind that **this will erase any inserted
|
||||
storage device while the router is in the initial setup phase**!
|
||||
Unfortunately there's little that can be done at that point to ask the
|
||||
user for confirmation.
|
||||
|
||||
# Why
|
||||
|
||||
@@ -17,18 +21,37 @@ So that e.g. customers can buy a router on their own, flash our custom
|
||||
firmware, plug in a pendrive, and manage their SIP (telephony) node
|
||||
from our webapp.
|
||||
|
||||
I've extracted the generic parts from the above mentioned auto-provision
|
||||
project because I thought it's useful enough for making it public.
|
||||
|
||||
# How
|
||||
|
||||
You can read more about the underlying technology on the OpenWRT wiki: see e.g. the
|
||||
[ImageBuilder](https://openwrt.org/docs/guide-user/additional-software/imagebuilder)
|
||||
page, or the page that lists some other
|
||||
[ImageBuilder frontends](https://openwrt.org/docs/guide-developer/imagebuilder_frontends).
|
||||
|
||||
As for the actual mechanism: custom scripts are baked into the boot
|
||||
process of the flashed firmware. If the extroot overlay is properly
|
||||
set up, then these scripts get hidden by it; i.e. they will only run
|
||||
when the extroot has failed to mount early in the boot process.
|
||||
|
||||
### Building
|
||||
|
||||
To build issue the following command: `./build.sh architecture variant device-profile`, e.g.:
|
||||
* `./build.sh ar71xx generic TLWDR4300`
|
||||
* `./build.sh ramips mt7621 ZBT-WG3526`
|
||||
OpenWRT's ImageBuilder only works on Linux x86_64. To build a firmware, issue the following command:
|
||||
`./build.sh architecture variant device-profile`, e.g.:
|
||||
|
||||
Results will be under `build/OpenWrt-ImageBuilder-${architecture}_${variant}-for-linux-x86_64/bin/`.
|
||||
* `./build.sh ath79 generic tplink_tl-wr1043nd-v1`
|
||||
* `./build.sh ath79 generic tplink_archer-c6-v2`
|
||||
* `./build.sh ath79 generic tplink_tl-wdr4300-v1`
|
||||
* `./build.sh bcm53xx generic dlink_dir-885l`
|
||||
|
||||
To see a list of available targets, run this in the ImageBuilder dir: `make info`.
|
||||
Results will be under `build/openwrt-imagebuilder-${release}-${architecture}-${variant}.Linux-x86_64/bin/`.
|
||||
|
||||
If you want to change which OpenWRT version is used, then edit the relevant variables in `build.sh` (`RELEASE`, and `RELEASE_NAME`).
|
||||
To see a list of available targets, run `make info` in the ImageBuilder dir.
|
||||
|
||||
If you want to change which OpenWRT version is used, then edit the relevant variable(s)
|
||||
in `build.sh`.
|
||||
|
||||
### Setup stages
|
||||
|
||||
@@ -37,16 +60,21 @@ sources for details: [autoprovision-functions.sh](image-extras/common/root/autop
|
||||
|
||||
#### Stage 1: setup extroot
|
||||
|
||||
At the first boot after flashing the firmware the autoprovision script will
|
||||
When the custom firmware first boots, the autoprovision script will
|
||||
wait for anything (!) in `/dev/sda` to show up (that is >= 512M), then erase
|
||||
it and set up a `swap`, an `extroot`, and a `data`filesystem (for the remaining
|
||||
space), and then reboot.
|
||||
|
||||
#### Stage 2: download and install some packages from the internet
|
||||
|
||||
Once it booted into the new extroot, it will continuously attempt to install
|
||||
some OpenWRT packages until an internet connection is set up on the router
|
||||
(either by using ssh or LuCI if you could fit it into the firmware).
|
||||
Once it rebooted into the new extroot, it will continuously keep trying to install
|
||||
some OpenWRT packages until an internet connection is set up on the router. You
|
||||
need to do that manually either by using ssh or the web UI (LuCI).
|
||||
|
||||
#### Stage 3, optional
|
||||
|
||||
We also have a 3rd stage, written in Python, but it's commented out here.
|
||||
Search for `autoprovision-stage3.py` to see how it's done.
|
||||
|
||||
### Login
|
||||
|
||||
@@ -64,30 +92,27 @@ Once connected, you can read the log with `logread -f`.
|
||||
|
||||
# Status
|
||||
|
||||
This is more of a template than something standalone. You most
|
||||
This is more of a template than something standalone, but I use it for
|
||||
my home routers as is. You most
|
||||
probably want to customize this script here and there; search for
|
||||
`CUSTOMIZE` for places of interest.
|
||||
|
||||
Most importantly, **set up a password and maybe an ssh key**.
|
||||
|
||||
I've extracted this from a project of mine where OpenWRT nodes auto-provision
|
||||
themselves in 3 stages (stage 3 was a Python script for an app-level sync feature),
|
||||
but I thought it's useful enough for making it public.
|
||||
|
||||
At the time of writing it only supports a few `ar71xx` routers out of the box,
|
||||
but it's easy to extend it.
|
||||
|
||||
## Tested with
|
||||
|
||||
[OpenWRT Chaos Calmer 15.05 RC1](https://downloads.openwrt.org/chaos_calmer/15.05-rc1/)
|
||||
on a TP-Link WDR4300.
|
||||
At the time of writing it only supports a few `ath79` routers out of
|
||||
the box, but it's easy to extend it. Support for a new router entails
|
||||
looking up some led names for `setLedAttribute` so that there's
|
||||
feedback to the user through the blinking of the leds. It should work
|
||||
fine without that, but it will be less convenient to interact with
|
||||
your router in the initial setup phase.
|
||||
|
||||
# Troubleshooting
|
||||
|
||||
## Which file should I flash?
|
||||
|
||||
You should consult the [OpenWRT documentation](https://wiki.openwrt.org/doc/howto/user.beginner).
|
||||
The produced firmware files should be somewhere around ```build/OpenWrt-ImageBuilder-15.05-ar71xx-generic.Linux-x86_64/bin/ar71xx```.
|
||||
You should consult the [OpenWRT documentation](https://openwrt.org/docs/guide-user/start).
|
||||
The produced firmware files should be somewhere around
|
||||
```./build/openwrt-imagebuilder-21.02.0-ath79-generic.Linux-x86_64/bin/targets/ath79/generic/```.
|
||||
|
||||
In short:
|
||||
|
||||
@@ -96,8 +121,8 @@ In short:
|
||||
OpenWRT.
|
||||
|
||||
* You must carefully pick the proper firmware file for your **hardware version**! I advise you
|
||||
to look up the wiki page for your hardware on the [OpenWRT wiki](https://wiki.openwrt.org),
|
||||
because most of them have a table of the released hardawre versions with comments on their
|
||||
to look up the wiki page for your hardware on the [OpenWRT wiki](https://openwrt.org),
|
||||
because most of them have a table of the released hardware versions with comments on their
|
||||
status (sometimes new hardware revisions are only supported by the latest OpenWRT, which is
|
||||
not released yet).
|
||||
|
||||
|
||||
57
build.sh
57
build.sh
@@ -1,59 +1,44 @@
|
||||
#!/bin/bash
|
||||
#!/bin/sh
|
||||
|
||||
set -e
|
||||
|
||||
absolutize ()
|
||||
{
|
||||
if [ ! -d "$1" ]; then
|
||||
echo
|
||||
echo "ERROR: '$1' doesn't exist or not a directory!"
|
||||
kill -INT $$
|
||||
fi
|
||||
|
||||
pushd "$1" >/dev/null
|
||||
echo `pwd`
|
||||
popd >/dev/null
|
||||
}
|
||||
|
||||
TARGET_ARCHITECTURE=$1
|
||||
TARGET_VARIANT=$2
|
||||
TARGET_DEVICE=$3
|
||||
|
||||
BUILD=`dirname "$0"`"/build/"
|
||||
BUILD=`absolutize $BUILD`
|
||||
BUILD=`readlink -f $BUILD`
|
||||
|
||||
###
|
||||
### chose a release
|
||||
###
|
||||
RELEASE_NAME="chaos_calmer"
|
||||
RELEASE="15.05"
|
||||
RELEASE="21.02.7"
|
||||
|
||||
#RELEASE_NAME="snapshots"
|
||||
#RELEASE="trunk"
|
||||
|
||||
if [ $RELEASE = "trunk" ]; then
|
||||
IMGBUILDER_NAME="OpenWrt-ImageBuilder-${TARGET_ARCHITECTURE}-${TARGET_VARIANT}.Linux-x86_64"
|
||||
else
|
||||
IMGBUILDER_NAME="OpenWrt-ImageBuilder-${RELEASE}-${TARGET_ARCHITECTURE}-${TARGET_VARIANT}.Linux-x86_64"
|
||||
fi
|
||||
IMGBUILDER_NAME="openwrt-imagebuilder-${RELEASE}-${TARGET_ARCHITECTURE}-${TARGET_VARIANT}.Linux-x86_64"
|
||||
IMGBUILDER_DIR="${BUILD}/${IMGBUILDER_NAME}"
|
||||
IMGBUILDER_ARCHIVE="${IMGBUILDER_NAME}.tar.bz2"
|
||||
IMGBUILDER_ARCHIVE="${IMGBUILDER_NAME}.tar.xz"
|
||||
|
||||
IMGTEMPDIR="${BUILD}/openwrt-build-image-extras"
|
||||
IMGBUILDERURL="https://downloads.openwrt.org/${RELEASE_NAME}/${RELEASE}/${TARGET_ARCHITECTURE}/${TARGET_VARIANT}/${IMGBUILDER_ARCHIVE}"
|
||||
IMGTEMPDIR="${BUILD}/image-extras"
|
||||
# see this feature request:
|
||||
# FS#1670 - consistent naming convention for the imagebuilder.tar.xz URL
|
||||
# https://bugs.openwrt.org/index.php?do=details&task_id=1670
|
||||
IMGBUILDERURL="https://downloads.openwrt.org/releases/${RELEASE}/targets/${TARGET_ARCHITECTURE}/${TARGET_VARIANT}/${IMGBUILDER_ARCHIVE}"
|
||||
|
||||
if [ -z ${TARGET_DEVICE} ]; then
|
||||
echo "Usage: $0 architecture variant device-profile"
|
||||
echo " e.g.: $0 ar71xx generic TLWDR4300"
|
||||
echo " $0 ramips mt7621 ZBT-WG3526"
|
||||
echo " e.g.: $0 ath79 generic tplink_tl-wr1043nd-v1"
|
||||
echo " $0 ath79 generic tplink_archer-c6-v2"
|
||||
echo " $0 ath79 generic tplink_tl-wdr4300-v1"
|
||||
echo " $0 bcm53xx generic dlink_dir-885l"
|
||||
echo " (this last one will not work without editing build.sh, details: https://github.com/attila-lendvai/openwrt-auto-extroot/pull/15#issuecomment-405847440)"
|
||||
echo " to get a list of supported devices issue a 'make info' in the OpenWRT image builder directory:"
|
||||
echo " '${IMGBUILDER_DIR}'"
|
||||
kill -INT $$
|
||||
fi
|
||||
|
||||
# the absolute minimum for extroot to work at all (i.e. when the disk is already set up, for example by hand).
|
||||
# this list may be smaller and/or different for your router, but it works with my ar71xx.
|
||||
PREINSTALLED_PACKAGES="block-mount kmod-usb2 kmod-usb-storage kmod-fs-ext4"
|
||||
# this list may be smaller and/or different for your router, but it works with my ath79.
|
||||
PREINSTALLED_PACKAGES="block-mount kmod-fs-ext4 kmod-usb-storage"
|
||||
|
||||
# some kernel modules may also be needed for your hardware
|
||||
#PREINSTALLED_PACKAGES+=" kmod-usb-uhci kmod-usb-ohci"
|
||||
@@ -79,8 +64,8 @@ fi
|
||||
if [ ! -e ${IMGBUILDER_DIR} ]; then
|
||||
pushd ${BUILD}
|
||||
# --no-check-certificate if needed
|
||||
wget --continue ${IMGBUILDERURL}
|
||||
tar jvxf ${IMGBUILDER_ARCHIVE}
|
||||
wget --continue ${IMGBUILDERURL}
|
||||
xz -d <${IMGBUILDER_ARCHIVE} | tar vx
|
||||
popd
|
||||
fi
|
||||
|
||||
@@ -88,8 +73,8 @@ pushd ${IMGBUILDER_DIR}
|
||||
|
||||
make image PROFILE=${TARGET_DEVICE} PACKAGES="${PREINSTALLED_PACKAGES}" FILES=${IMGTEMPDIR}
|
||||
|
||||
pushd bin/${TARGET_ARCHITECTURE}/
|
||||
ln -s ../../packages .
|
||||
pushd bin/targets/${TARGET_ARCHITECTURE}/
|
||||
ln -s ../../../packages .
|
||||
popd
|
||||
|
||||
popd
|
||||
|
||||
4
build/.gitignore
vendored
4
build/.gitignore
vendored
@@ -1,4 +0,0 @@
|
||||
# Ignore everything in this directory
|
||||
*
|
||||
# Except this file
|
||||
!.gitignore
|
||||
19
default.nix
Normal file
19
default.nix
Normal file
@@ -0,0 +1,19 @@
|
||||
{ pkgs ? import <nixpkgs> {} }:
|
||||
|
||||
pkgs.mkShell {
|
||||
buildInputs = with pkgs; [
|
||||
coreutils posix_man_pages bash-completion less
|
||||
gitFull diffutils
|
||||
gnumake which
|
||||
ncurses perl python2 python3
|
||||
|
||||
# keep this line if you use bash
|
||||
bashInteractive
|
||||
];
|
||||
|
||||
shellHook =
|
||||
''
|
||||
alias ..='cd ..'
|
||||
alias ...='cd ../..'
|
||||
'';
|
||||
}
|
||||
3
image-extras/common/etc/dropbear/.gitignore
vendored
Normal file
3
image-extras/common/etc/dropbear/.gitignore
vendored
Normal file
@@ -0,0 +1,3 @@
|
||||
# you can put your ssh public key into authorized_keys,
|
||||
# but we don't ever want it to be committed to the repo
|
||||
authorized_keys
|
||||
@@ -1 +0,0 @@
|
||||
# this file may contain ssh public keys for passwordless ssh root login
|
||||
@@ -10,33 +10,34 @@ rootUUID=05d615b3-bef8-460c-9a23-52db8d09e000
|
||||
dataUUID=05d615b3-bef8-460c-9a23-52db8d09e001
|
||||
swapUUID=05d615b3-bef8-460c-9a23-52db8d09e002
|
||||
|
||||
if [ -f /lib/ar71xx.sh ]; then
|
||||
. /lib/ar71xx.sh
|
||||
. /lib/functions.sh
|
||||
|
||||
# let's attempt to define some defaults...
|
||||
autoprovisionUSBLed="tp-link:green:usb"
|
||||
autoprovisionStatusLed="tp-link:green:qss"
|
||||
# let's attempt to define some defaults...
|
||||
autoprovisionUSBLed="green:usb"
|
||||
autoprovisionStatusLed="green:qss"
|
||||
|
||||
echo Board name is [$(board_name)]
|
||||
|
||||
# CUSTOMIZE
|
||||
case $(board_name) in
|
||||
*tl-wr1043nd*)
|
||||
autoprovisionUSBLed="green:usb"
|
||||
autoprovisionStatusLed="green:qss"
|
||||
;;
|
||||
*tl-mr3020*)
|
||||
autoprovisionUSBLed="green:wps"
|
||||
autoprovisionStatusLed="green:wlan"
|
||||
;;
|
||||
*tl-wr2543n*)
|
||||
autoprovisionUSBLed="green:wps"
|
||||
autoprovisionStatusLed="green:wlan5g"
|
||||
;;
|
||||
*tl-wdr4300*)
|
||||
autoprovisionUSBLed="green:wlan2g"
|
||||
autoprovisionStatusLed="green:wlan5g"
|
||||
;;
|
||||
esac
|
||||
|
||||
# CUSTOMIZE
|
||||
case $(ar71xx_board_name) in
|
||||
"tl-wr1043nd")
|
||||
autoprovisionUSBLed="tp-link:green:usb"
|
||||
autoprovisionStatusLed="tp-link:green:qss"
|
||||
;;
|
||||
"tl-mr3020")
|
||||
autoprovisionUSBLed="tp-link:green:wps"
|
||||
autoprovisionStatusLed="tp-link:green:wlan"
|
||||
;;
|
||||
"tl-wr2543n")
|
||||
autoprovisionUSBLed="tp-link:green:wps"
|
||||
autoprovisionStatusLed="tp-link:green:wlan5g"
|
||||
;;
|
||||
"tl-wdr4300")
|
||||
autoprovisionUSBLed="tp-link:blue:wan"
|
||||
autoprovisionStatusLed="tp-link:blue:qss"
|
||||
;;
|
||||
esac
|
||||
fi
|
||||
|
||||
log()
|
||||
{
|
||||
|
||||
@@ -34,7 +34,7 @@ hasBigEnoughPendrive()
|
||||
setupPendrivePartitions()
|
||||
{
|
||||
# erase partition table
|
||||
dd if=/dev/zero of=/dev/sda bs=1M count=1
|
||||
dd if=/dev/zero of=/dev/sda bs=1k count=256
|
||||
|
||||
# sda1 is 'swap'
|
||||
# sda2 is 'root'
|
||||
@@ -73,8 +73,8 @@ EOF
|
||||
done
|
||||
|
||||
mkswap -L swap -U $swapUUID /dev/sda1
|
||||
mkfs.ext4 -L root -U $rootUUID /dev/sda2
|
||||
mkfs.ext4 -L data -U $dataUUID /dev/sda3
|
||||
mkfs.ext4 -F -L root -U $rootUUID /dev/sda2
|
||||
mkfs.ext4 -F -L data -U $dataUUID /dev/sda3
|
||||
|
||||
log "Finished setting up filesystems"
|
||||
}
|
||||
|
||||
@@ -9,7 +9,7 @@ installPackages()
|
||||
signalAutoprovisionWaitingForUser
|
||||
|
||||
until (opkg update)
|
||||
do
|
||||
do
|
||||
log "opkg update failed. No internet connection? Retrying in 15 seconds..."
|
||||
sleep 15
|
||||
done
|
||||
@@ -50,6 +50,9 @@ autoprovisionStage2()
|
||||
else
|
||||
signalAutoprovisionWorking
|
||||
|
||||
echo Updating system time using ntp; otherwise the openwrt.org certificates are rejected as not yet valid.
|
||||
ntpd -d -q -n -p 0.openwrt.pool.ntp.org
|
||||
|
||||
# CUSTOMIZE: with an empty argument it will set a random password and only ssh key based login will work.
|
||||
# please note that stage2 requires internet connection to install packages and you most probably want to log in
|
||||
# on the GUI to set up a WAN connection. but on the other hand you don't want to end up using a publically
|
||||
|
||||
Reference in New Issue
Block a user