Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Introduction

The term "Provisioning" describes the ability to configure a Gateway with "information" that will be sent to its assets when those assets register with the Platform. The information is intended to help set up the asset for connections and communications with its managing Gateway.

...

The primary function of the eRouter device is to allow subscribers to connect multiple CPE devices to the operator provided DOCSIS high-speed Internet service. DOCSIS specifications allow subscribers to directly connect multiple CPE devices to the cable modem; however, that requires operators to provide IP provisioning to each of the CPE devices. Depending on which IP Protocols are enabled, the eRouter allows provisioning of IPv4 CPEs, IPv6 CPEs, or Dual Stack (IPv4 and IPv6) CPEs simultaneously.

...

Architecture

The GW Provisioning Abstraction defines the abstracted APIs which are called by the gateway provisioning application during initialisation. It provides interfaces to be used for handshaking during DOCSIS initialisation.

...

When upstream ipv4-status notification is received, the eRouter operation mode is set to both IPv4, IPv6 or only IPv4 for IPv4 routing.
When upstream ipv6-status notification is received, the eRouter operation mode is set to both IPv4, IPv6 or only IPv6 for IPv6 routing.
This state is updated in eSafe device database to indicate that the eSAFE completed its provisioning process.

Code Flow

  • GW provisioning is the first RDKB process to be invoked during boot-up after DOCSIS initialization
  • As each GW is provisioned during boot up, GW provisioning application will be executed during every boot up
  • GW provisioning is a generic provisioning module which provides necessary interfaces for OEMs to initialize DOCSIS give necessary callbacks based on the state
  • Registers and listens to RDKB events and takes necessary action
  • Initialized through PCD/systemd daemons depending on platform
  • GW provisioning app initializes the provisioning DB and the necessary path configurations needed
  • Provides file pointers for callback functions to OEMs which can be called based on certain events
  • Calls utopia_init.sh script which initializes RDKB DBs and other services
  • Takes action on TLVs coming through boot config file
  • Handles creation and configuration of WAN interface
  • Monitors link status and RDKB events in background

draw.io Diagram
diagramNamecode flow 1.drawio
revision1