him411/wlan-ap-Telecominfraproject
1
0
Fork 0
mirror of https://github.com/Telecominfraproject/wlan-ap.git synced 2025-12-16 08:59:57 +00:00
Code Issues Packages Projects Releases Wiki Activity
2,101 Commits 198 Branches 115 Tags 227 MiB
C 85.8%
Shell 4.9%
Makefile 3.8%
Roff 2.8%
UnrealScript 1.3%
Other 1.2%
90e2f3452d
Go to file
John Crispin 90e2f3452d cloud_discovery: add standard FQDN fallback discovery 
Add discovery method that attempts to resolve a standard FQDN when DHCP
discovery fails. This enables zero-touch provisioning in environments
where administrators configure DNS without modifying DHCP infrastructure.

The standard FQDN is configurable via STANDARD_FQDN constant (defaults
to "openwifi.network"). Administrators can configure their local DNS to
resolve this FQDN to their controller, allowing APs to discover the
controller automatically.

Discovery priority order:
1. EST enrollment (blocking)
2. DHCP discovery (Option 224/138)
3. Flash-based configuration
4. Standard FQDN resolution (NEW)
5. Cloud redirector service (internet-connected only)

The implementation uses the resolv module for DNS queries, performing
A record lookups. If resolution fails, discovery continues to the next
method. The standard FQDN method integrates with the existing discovery
block list mechanism to prevent repeated failed attempts.

Note: The boguspriv dnsmasq option may prevent FQDNs from resolving to
private IPs. Administrators should either use CG NAT Safe IP addresses
(100.64.0.0/10) or configure dnsmasq with rebind-domain-ok exceptions.

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: add standard FQDN fallback 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

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:

  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):