mirror of https://github.com/Telecominfraproject/wlan-ap.git synced 2025-12-16 17:01:37 +00:00

Go to file

alex18_huang 4b31e481ec Some checks failed Build OpenWrt/uCentral images / build (cig_wf186h) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (cig_wf186w) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (cig_wf188n) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (cig_wf189) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (cig_wf196) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (cybertan_eww631-a1) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (cybertan_eww631-b1) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (edgecore_eap101) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (edgecore_eap102) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (edgecore_eap104) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (edgecore_eap105) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (edgecore_eap111) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (edgecore_eap112) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (edgecore_oap101) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (edgecore_oap101-6e) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (edgecore_oap101e) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (edgecore_oap101e-6e) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (edgecore_oap103) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (hfcl_ion4x) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (hfcl_ion4x_2) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (hfcl_ion4x_3) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (hfcl_ion4x_w) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (hfcl_ion4xe) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (hfcl_ion4xi) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (hfcl_ion4xi_w) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (indio_um-305ax) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (senao_iap2300m) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (senao_iap4300m) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (senao_jeap6500) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (sonicfi_rap630c-311g) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (sonicfi_rap630w-211g) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (sonicfi_rap630w-311g) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (sonicfi_rap630w-312g) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (sonicfi_rap63xc-211g) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (sonicfi_rap7110c-341x) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (sonicfi_rap750w-311a) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (udaya_a6-id2) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (udaya_a6-od2) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (yuncore_ax820) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (yuncore_ax840) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (yuncore_fap640) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (yuncore_fap650) (push) Has been cancelled Details Build OpenWrt/uCentral images / build (yuncore_fap655) (push) Has been cancelled Details Build OpenWrt/uCentral images / trigger-testing (push) Has been cancelled Details Build OpenWrt/uCentral images / create-x64_vm-ami (push) Has been cancelled Details udhcpinject: qdisk didn't create successfully for some interfaces while using dhcpinject Program sometimes did not setup tc qdisc on some interfaces when creating SSID with dhcpinject enabled initially. Added delayed startup. Fixes: WIFI-14522 Signed-off-by: alex18_huang <alex18_huang@accton.com>		2025-04-10 16:17:34 +02:00
.github
docker
feeds	udhcpinject: qdisk didn't create successfully for some interfaces while using dhcpinject	2025-04-10 16:17:34 +02:00
patches
profiles
.gitignore
build.sh
config.yml
dock-run.sh
LICENSE
Makefile
README.md
setup.py

README.md

OpenWiFi AP NOS

OpenWrt-based access point network operating system (AP NOS) for TIP OpenWiFi. Read more at openwifi.tip.build.

Building

Setting up your build machine

Building requires a recent Linux installation. Older systems without Python 3.7 will have trouble. See this guide for details: https://openwrt.org/docs/guide-developer/toolchain/beginners-build-guide

Install build packages on Debian/Ubuntu (or see above guide for other systems):

sudo apt install build-essential libncurses5-dev gawk git libssl-dev gettext zlib1g-dev swig unzip time rsync python3 python3-setuptools python3-yaml

Doing a native build on Linux

Use ./build.sh <target>, or follow the manual steps below:

Clone and set up the tree. This will create an openwrt/ directory.

./setup.py --setup    # for subsequent builds, use --rebase instead

Select the profile and base package selection. This setup will install the feeds and packages and generate the .config file.

cd openwrt
./scripts/gen_config.py linksys_ea8300

Build the tree (replace -j 8 with the number of cores to use).

make -j 8 V=s

Build output

The build results are located in the openwrt/bin/ directory:

Type	Path
Firmware images	`openwrt/bin/targets/<target>/<subtarget>/`
Kernel modules	`openwrt/bin/targets/<target>/<subtarget>/packages/`
Package binaries	`openwrt/bin/packages/<platform>/<feed>/`

Developer Notes

Branching model

main - Stable dev branch
next - Integration branch
staging-* - Feature/bug branches
release/v#.#.# - Release branches (major.minor.patch)

Repository structure

Build files:

Makefile - Calls Docker environment per target
dock-run.sh - Dockerized build environment
docker/Dockerfile - Dockerfile for build image
build.sh - Build script
setup.py - Clone and set up the tree
config.yml - Specifies OpenWrt version and patches to apply

Directories:

feeds/ - OpenWiFi feeds
patches/ - OpenWiFi patches applied during builds
profiles/ - Per-target kernel configs, packages, and feeds
- wifi-ax: Wi-Fi AX packages
- ucentral-ap: uCentral packages
- x64_vm: x86-64 VM image

uCentral packages

AP-NOS packages implementing the uCentral protocol include the following repositories (refer to the ucentral feed for a full list):

ucentral-client: https://github.com/Telecominfraproject/wlan-ucentral-client
ucentral-schema: https://github.com/Telecominfraproject/wlan-ucentral-schema
ucentral-wifi: https://github.com/blogic/ucentral-wifi