Introduction
RDK WAN Manager is a component that interfaces directly with the RDK Bus.
It is responsible for:
- Storing the WAN configuration of the CPE (e.g. which physical interfaces can be used for WAN),
- Determining which physical interfaces should be used for WAN during runtime
- Triggering Layer 2 configuration for chosen WAN interfaces,
- Triggering Layer 3 protocols (e.g. DHCP, PPP) to establish IP addresses for configured WAN interfaces.
Architecture
The RDK WAN Manager component consists of 3 separate modules:
- An Event Handler for the RDK Bus
- A Data Model,
- Policy State Machines (only 1 will be running at any time),
- WAN Interface State Machines (with 0 or more instances running in parallel).
eyJleHRTcnZJbnRlZ1R5cGUiOiIiLCJnQ2xpZW50SWQiOiIiLCJjcmVhdG9yTmFtZSI6IlVua25vd24gVXNlciAocmVzaG1pa3IpIiwib3V0cHV0VHlwZSI6ImJsb2NrIiwibGFzdE1vZGlmaWVyTmFtZSI6IlVua25vd24gVXNlciAocmVzaG1pa3IpIiwibGFuZ3VhZ2UiOiJlbiIsInVpQ29uZmlnIjoie30iLCJkaWFncmFtRGlzcGxheU5hbWUiOiIiLCJzRmlsZUlkIjoiIiwiYXR0SWQiOiIxNjk0NTI2MDYiLCJkaWFncmFtTmFtZSI6IlJESyBXQU4gTWFuYWdlciAtIE1vZHVsZSBEaWFncmFtIiwiYXNwZWN0IjoiIiwibGlua3MiOiJhdXRvIiwiY2VvTmFtZSI6IlJESyBXQU4gTWFuYWdlciIsInRic3R5bGUiOiJ0b3AiLCJjYW5Db21tZW50IjpmYWxzZSwiZGlhZ3JhbVVybCI6IiIsImNzdkZpbGVVcmwiOiIiLCJib3JkZXIiOnRydWUsIm1heFNjYWxlIjoiMSIsIm93bmluZ1BhZ2VJZCI6MTY5NDUxMTM5LCJlZGl0YWJsZSI6ZmFsc2UsImNlb0lkIjoxNjk0NTExMzksInBhZ2VJZCI6IiIsImxib3giOnRydWUsInNlcnZlckNvbmZpZyI6eyJlbWFpbHByZXZpZXciOiIxIn0sIm9kcml2ZUlkIjoiIiwicmV2aXNpb24iOjQsIm1hY3JvSWQiOiI0YTRjMmE3Zi02ODE3LTRhYjAtYTFiMC1kNjVjOTRkZmYzMmQiLCJwcmV2aWV3TmFtZSI6IlJESyBXQU4gTWFuYWdlciAtIE1vZHVsZSBEaWFncmFtLnBuZyIsImxpY2Vuc2VTdGF0dXMiOiJPSyIsInNlcnZpY2UiOiIiLCJpc1RlbXBsYXRlIjoiIiwid2lkdGgiOiI0MTQiLCJzaW1wbGVWaWV3ZXIiOmZhbHNlLCJsYXN0TW9kaWZpZWQiOjE2MzMwMDQxODIwMDAsImV4Y2VlZFBhZ2VXaWR0aCI6ZmFsc2UsIm9DbGllbnRJZCI6IiJ9
The WAN Controller process will handle non-Interface specific activities, such as initialising data models from persistent storage and handling data model changes during runtime.
The WAN Controller will also spawn one Policy State Machine based on the WAN Policy configured in the data models. The appropriate State Machine will be launched for the configured Policy in order to manage WAN interfaces.
The Policy State Machine will determine which physical interfaces to use for WAN, and will run instances of the WAN Interface State Machine in order to configure WAN links and obtain IP addresses for each WAN interface. By default, there will initially be 0 instances of the WAN Interface State Machine running on startup, and a new instance will be started for every physical interface being used for WAN.
Data Model
RDK WAN Manager will own standard Layer 3 TR-181 data objects (with additional custom RDK parameters),as well as a custom data model to store data related to configuring WAN interfaces.
The following diagram shows the data model objects that will be owned by RDKWANManager:
eyJleHRTcnZJbnRlZ1R5cGUiOiIiLCJnQ2xpZW50SWQiOiIiLCJjcmVhdG9yTmFtZSI6IlVua25vd24gVXNlciAocmVzaG1pa3IpIiwib3V0cHV0VHlwZSI6ImJsb2NrIiwibGFzdE1vZGlmaWVyTmFtZSI6IlVua25vd24gVXNlciAocmVzaG1pa3IpIiwibGFuZ3VhZ2UiOiJlbiIsInVpQ29uZmlnIjoie30iLCJkaWFncmFtRGlzcGxheU5hbWUiOiIiLCJzRmlsZUlkIjoiIiwiYXR0SWQiOiIxNjk0NTI3MDAiLCJkaWFncmFtTmFtZSI6IldBTiBNYW5hZ2VyIGRhdGEgbW9kZWwiLCJhc3BlY3QiOiIiLCJsaW5rcyI6ImF1dG8iLCJjZW9OYW1lIjoiUkRLIFdBTiBNYW5hZ2VyIiwidGJzdHlsZSI6InRvcCIsImNhbkNvbW1lbnQiOmZhbHNlLCJkaWFncmFtVXJsIjoiIiwiY3N2RmlsZVVybCI6IiIsImJvcmRlciI6dHJ1ZSwibWF4U2NhbGUiOiIxIiwib3duaW5nUGFnZUlkIjoxNjk0NTExMzksImVkaXRhYmxlIjpmYWxzZSwiY2VvSWQiOjE2OTQ1MTEzOSwicGFnZUlkIjoiIiwibGJveCI6dHJ1ZSwic2VydmVyQ29uZmlnIjp7ImVtYWlscHJldmlldyI6IjEifSwib2RyaXZlSWQiOiIiLCJyZXZpc2lvbiI6NiwibWFjcm9JZCI6IjllY2MxOGMwLWYwM2ItNGEzMy1iOWE1LWRjY2YzZmI1ZjVlMCIsInByZXZpZXdOYW1lIjoiV0FOIE1hbmFnZXIgZGF0YSBtb2RlbC5wbmciLCJsaWNlbnNlU3RhdHVzIjoiT0siLCJzZXJ2aWNlIjoiIiwiaXNUZW1wbGF0ZSI6IiIsIndpZHRoIjoiMjgxIiwic2ltcGxlVmlld2VyIjpmYWxzZSwibGFzdE1vZGlmaWVkIjoxNjMzMDA0MzM0MDAwLCJleGNlZWRQYWdlV2lkdGgiOmZhbHNlLCJvQ2xpZW50SWQiOiIifQ==
The following diagram shows the TR-181 data objects that will need to be populated byRDKWANManager and how they should be stacked on top of other data objects owned by other RDK Managers using the LowerLayers parameter:
eyJleHRTcnZJbnRlZ1R5cGUiOiIiLCJnQ2xpZW50SWQiOiIiLCJjcmVhdG9yTmFtZSI6IlVua25vd24gVXNlciAocmVzaG1pa3IpIiwib3V0cHV0VHlwZSI6ImJsb2NrIiwibGFzdE1vZGlmaWVyTmFtZSI6IlVua25vd24gVXNlciAocmVzaG1pa3IpIiwibGFuZ3VhZ2UiOiJlbiIsInVpQ29uZmlnIjoie30iLCJkaWFncmFtRGlzcGxheU5hbWUiOiIiLCJzRmlsZUlkIjoiIiwiYXR0SWQiOiIxNjk0NTI3MTciLCJkaWFncmFtTmFtZSI6IiBUUi0xODEgZGF0YSBvYmplY3RzIiwiYXNwZWN0IjoiIiwibGlua3MiOiJhdXRvIiwiY2VvTmFtZSI6IlJESyBXQU4gTWFuYWdlciIsInRic3R5bGUiOiJ0b3AiLCJjYW5Db21tZW50IjpmYWxzZSwiZGlhZ3JhbVVybCI6IiIsImNzdkZpbGVVcmwiOiIiLCJib3JkZXIiOnRydWUsIm1heFNjYWxlIjoiMSIsIm93bmluZ1BhZ2VJZCI6MTY5NDUxMTM5LCJlZGl0YWJsZSI6ZmFsc2UsImNlb0lkIjoxNjk0NTExMzksInBhZ2VJZCI6IiIsImxib3giOnRydWUsInNlcnZlckNvbmZpZyI6eyJlbWFpbHByZXZpZXciOiIxIn0sIm9kcml2ZUlkIjoiIiwicmV2aXNpb24iOjMsIm1hY3JvSWQiOiIwZTQ2YmUwMC1hODk5LTQxOGEtYmU2Ni1mZWQ1Y2IxNzkyMWMiLCJwcmV2aWV3TmFtZSI6IiBUUi0xODEgZGF0YSBvYmplY3RzLnBuZyIsImxpY2Vuc2VTdGF0dXMiOiJPSyIsInNlcnZpY2UiOiIiLCJpc1RlbXBsYXRlIjoiIiwid2lkdGgiOiI4MTgiLCJzaW1wbGVWaWV3ZXIiOmZhbHNlLCJsYXN0TW9kaWZpZWQiOjE2MzMwMDQ0NzUwMDAsImV4Y2VlZFBhZ2VXaWR0aCI6ZmFsc2UsIm9DbGllbnRJZCI6IiJ9
