genieACS Projects

A collection of extensions and provisioning scripts for genieACS — an open-source TR-069/TR-369 ACS (Auto Configuration Server) for managing CPE devices at scale.

Overview

This repository contains scripts that automate device configuration through the genieACS platform, targeting TP-Link ONU (Optical Network Unit) hardware. The scripts are structured around the two main genieACS script types: extensions (server-side helper functions) and provisions (device-lifecycle automation).

Repository Structure

genieACS-projects/
├── extensions/
│   └── TPLink-ONU-VOIP-mapping.js      # API helper: resolves VOIP VLAN name by device ID
└── provisions/
    └── TPLink-ONU-VOIP-binding-fix.js  # Provision: binds VOIP VLAN interface on TP-Link ONUs

Scripts

`extensions/TPLink-ONU-VOIP-mapping.js`

A genieACS extension that exposes a helper callable from any provision script.

What it does:

Queries the genieACS NBI (Northbound Interface) REST API for a given device ID
Retrieves all Device.Ethernet.VLANTermination.* instances from the device's parameter tree
Finds the VLAN termination entry where VLANID = 20 (the designated VOIP VLAN)
Returns the Name of that termination (e.g. "veip0.20") for use downstream

Key config:

Variable	Default	Description
`GENIEACS_URL`	`http://10.5.2.111:7557`	Base URL of the genieACS NBI

`provisions/TPLink-ONU-VOIP-binding-fix.js`

A genieACS provision script that runs during the inform cycle of TP-Link XX230v ONU devices.

What it does:

Declares and caches the device's VLAN termination data (VLANID + Name properties)
Calls the TPLink-ONU-VOIP-mapping extension to resolve the correct VOIP interface name
Writes the resolved name to both VOIP binding parameters on the device:
- Device.Services.VoiceService.1.X_TP_BoundIfName
- Device.X_TP_Services.X_TP_VoiceService.1.BoundIfName

This ensures VOIP traffic is always bound to the correct VLAN interface, even after resets or re-provisioning.

Protocol Background

Term	Meaning
TR-069	Broadband Forum standard for CPE remote management over CWMP
genieACS	Open-source ACS implementing TR-069; manages device parameters via provisions and extensions
ONU	Optical Network Unit — the customer-side fiber termination device
VLAN	Virtual LAN; used here to segment VOIP traffic onto a dedicated logical interface
NBI	genieACS Northbound Interface — the REST API used by extensions to query device data

Requirements

A running genieACS instance
Axios available in the genieACS extension environment
TP-Link XX230v ONU devices managed by the ACS

2.8 KiB Raw Blame History