Go to file
John Crispin cd0bbfb9c3 cloud_discovery: use .local TLD for standard FQDN discovery
Change standard FQDN from 'openwifi.network' to 'openwifi.wlan.local'
to prevent DNS hijacking attacks. The .local TLD is reserved for local
network use (mDNS) and cannot be registered in public DNS, ensuring
that discovery traffic cannot be redirected to attacker-controlled
infrastructure.

Signed-off-by: John Crispin <john@phrozen.org>
2025-12-04 12:31:17 +01:00
.github .github/workflows/build-dev.yml: add cig_wf660a 2025-06-26 11:38:08 +02:00
docker Docker: do not install llvm 2022-01-31 07:01:31 +01:00
feeds cloud_discovery: use .local TLD for standard FQDN discovery 2025-12-04 12:31:17 +01:00
patches mediatek: Add emplus,wap588m to support kernel 6.6 at staging-upstream-mediatek 2025-11-03 09:48:00 +01:00
patches-24.10 patches: update MT7981 WiFi firmware to optimize scanning time (0062) 2025-11-24 06:28:34 +01:00
profiles qca-wifi-7: Add Zyxel NWA210BE model 2025-12-04 12:30:45 +01:00
.gitignore open-converged-wireless: Import 21.02 based uCentral tree 2021-03-25 12:19:47 +01:00
build.sh ucentral: development update 2021-05-04 13:51:23 +02:00
config.yml 23.05: rebase on 23.05-rc4 2023-10-03 07:22:31 +02:00
dock-run.sh open-converged-wireless: Import 21.02 based uCentral tree 2021-03-25 12:19:47 +01:00
LICENSE Create LICENSE 2024-02-29 08:48:14 -08:00
Makefile open-converged-wireless: Import 21.02 based uCentral tree 2021-03-25 12:19:47 +01:00
README.md Update README.md 2022-10-19 17:04:14 -07:00
setup.py update setup.py: make the profiles symlink relative instead of absolute 2025-10-01 07:44:35 +02:00

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:

  1. Clone and set up the tree. This will create an openwrt/ directory.
./setup.py --setup    # for subsequent builds, use --rebase instead
  1. 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
  1. 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

uCentral packages

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