TECHNICAL BLOG

Deep Dives for Engineers

Detailed technical articles covering the real problems we solve in embedded systems, AI, and robotics engineering.

RDK-B Architecture: Building Open-Source Broadband Gateways at Scale
RDK and Broadband

RDK-B Architecture: Building Open-Source Broadband Gateways at Scale

Worksprout Team Jul 30, 2024 12 min read

A technical deep-dive into the RDK-B software stack — its layered architecture, key components, and how service providers use it to build carrier-grade, field-upgradeable gateways.

What RDK-B Is and Why It Exists

RDK-B (Reference Design Kit for Broadband) is an open-source software stack, governed by the RDK Management LLC consortium, that gives cable, DSL, and fibre operators a standardised, carrier-grade platform for residential and commercial gateways. Before RDK-B, every operator maintained bespoke firmware stacks — often sourced from device manufacturers — that were expensive to update, difficult to debug remotely, and impossible to deploy across heterogeneous hardware. RDK-B changes this by defining a common abstraction layer between the operator's services and the underlying hardware.

The Layered Architecture

RDK-B is best understood as three horizontal layers stacked on top of a Linux base:

  • Platform Abstraction Layer (PAL / HAL) — hardware-specific implementations of standardised APIs. The Wi-Fi HAL, Ethernet HAL, and Voice HAL allow RDK-B's middleware to run unchanged across different chipsets (Broadcom, Qualcomm, Intel, MediaTek).
  • Middleware (CCSP) — the Cisco Connected Services Platform, now open-sourced as the RDK-B middleware. It implements the TR-069 agent, TR-181 data model, diagnostic framework, and inter-component messaging via DBUS.
  • Application Layer — cloud-hosted management portals, subscriber self-service apps, and operator-specific feature sets that sit above the standardised middleware.

CCSP Component Model

The middleware follows a microservice-like component model. Each functional domain — Wi-Fi management, WAN management, security, parental controls, diagnostics — runs as a separate process called a CCSP component. Components expose a data model over DBUS using the TR-181 schema and communicate asynchronously through a central message bus daemon (CcspCrSsp).

This architecture has significant operational benefits: a crashing Wi-Fi component does not take down WAN connectivity, components can be updated independently, and new features are added by deploying new components rather than reflashing the entire firmware.

The TR-181 Data Model

TR-181 (Device:2) is the CWMP data model that describes every configurable and observable aspect of a CPE device — from Wi-Fi SSID to WAN IP lease to VoIP codec negotiation. In RDK-B, every parameter exposed by CCSP components maps to a TR-181 path. An ACS (Auto Configuration Server) communicating via TR-069 reads and writes these parameters to configure the device remotely.

A typical TR-181 parameter path looks like:

Device.WiFi.AccessPoint.1.Security.ModeEnabled
Device.IP.Interface.1.IPv4Address.1.IPAddress
Device.DSL.Line.1.Stats.CurrentDay.Errored Seconds

Build System Integration

RDK-B ships as a set of Yocto layers. The primary layers are meta-rdk (core RDK), meta-rdk-broadband (broadband-specific middleware), and a board-specific BSP layer from your silicon vendor. A reference build for a Broadcom-based gateway target:

git clone https://code.rdkcentral.com/r/rdk/yocto_oe/layers/meta-rdk -b dunfell
git clone https://code.rdkcentral.com/r/rdk/yocto_oe/layers/meta-rdk-broadband -b dunfell
MACHINE = "raspberrypi-rdk-broadband"
IMAGE = "rdk-generic-broadband-image"

Remote Management and RDKM

RDK Central (RDKM) is the reference cloud management platform for RDK devices. It provides a device registry, firmware management, telemetry collection, and the ACS endpoint. Operators typically deploy RDKM or integrate RDK-B devices with their existing ACS (e.g., ACS deployed via GenieACS or CommScope's RDK Cloud).

Telemetry in RDK-B is handled by the T2 (Telemetry 2.0) component, which collects structured log markers from all CCSP components and ships them to a cloud endpoint as JSON batches. This gives operators visibility into Wi-Fi interference, WAN stability, and application errors across millions of deployed devices without SSH access.

Practical Considerations for Product Teams

RDK-B is not a drop-in solution. A production-quality deployment requires:

  • A complete, tested HAL implementation for your chipset
  • A working Yocto BSP layer with the RDK layers integrated
  • ACS infrastructure for firmware delivery and configuration management
  • Telemetry pipeline for operational visibility
  • Regression test suites against the TR-181 data model

Plan for six to twelve months of integration work for a first production-quality RDK-B platform, with ongoing investment for HAL maintenance as upstream RDK-B evolves.

Conclusion

RDK-B is the most capable open-source platform available for carrier-grade gateway development. Its component architecture, standardised data model, and operator-grade management tooling make it the right foundation for any serious broadband gateway product. The investment in HAL development and build system integration is substantial but non-recurring — subsequent product variants on the same chipset family reuse the HAL and concentrate development effort on differentiating features.

Share

Worksprout Team

The Worksprout engineering team specialises in embedded Linux, RDK-B broadband platforms, edge AI, and robotics systems. Based in Rajshahi, Bangladesh, we design and deploy production embedded intelligence for clients across South Asia and beyond.

Related Posts

Continue reading — handpicked articles you might enjoy