2024-01-18: TR-106 Amendment 13 and TR-181 Issue 2 Amendment 17

BroadbandForum · Jan 18, 2024 · 174e4e3 · 174e4e3
1 parent 99bc3f7
commit 174e4e3
Show file tree

Hide file tree

Showing 250 changed files with 932,721 additions and 501,921 deletions.
diff --git a/404.html b/404.html
@@ -16,8 +16,11 @@
     div.columns{display: flex; gap: min(4vw, 1.5em);}
     div.column{flex: auto; overflow-x: auto;}
     div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
-    ul.task-list{list-style: none;}
+    /* The extra [class] is a hack that increases specificity enough to
+       override a similar rule in reveal.js */
+    ul.task-list[class]{list-style: none;}
     ul.task-list li input[type="checkbox"] {
+      font-size: inherit;
       width: 0.8em;
       margin: 0 0.8em 0.2em -1.6em;
       vertical-align: middle;
@@ -79,6 +82,7 @@
   <!-- Automatic hover links styles -->
   <style>
   :root {
+      --hoverlink-gap: 0.2em;
       --hoverlink-size: 0.9em;
   }
 
@@ -90,6 +94,7 @@
       position: absolute;
       display: inline-block;
       content: "";
+      margin-left: var(--hoverlink-gap);
       width: var(--hoverlink-size);
       height: var(--hoverlink-size);
       background-size: var(--hoverlink-size) var(--hoverlink-size);
@@ -291,7 +296,7 @@ <h1 class="cover-page unnumbered">Introduction</h1>
       <span class="site-footer-owner">
         USP is developed and maintained
         by <a href="https://www.broadband-forum.org">The Broadband Forum</a>.
-        &copy; The Broadband Forum 2023</a>. All Rights Reserved.
+        &copy; The Broadband Forum 2024</a>. All Rights Reserved.
       </span>
       <span class="site-footer-credits">
         This page was generated by <a href="https://pandoc.org">pandoc</a>

diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -7,6 +7,55 @@ can be found at <https://cwmp-data-models.broadband-forum.org>.
 
 [CWMP]: https://www.broadband-forum.org/technical/download/TR-069.pdf
 
+## 2024-01-18: [TR-106 Amendment 13] and [TR-181 Issue 2 Amendment 17]
+
+*Tags: [v1.6.8] (data models), 
+       [v2.17.0][TR-181-v2.17.0] (TR-181), 
+       [v1.13.0][TR-106-v1.13.0] (TR-106)*
+
+### TR-181
+* Added new parameters for Multi-flow and Multi-server testing
+  capability as defined in TR-471 Issue 4
+* Updated MoCA data model with MoCA Alliance 2.5 specification
+* Added Device.DNS.SD.Advertise object to to allow the configuration of
+  DNS-SD services that need to be advertised by the device
+* Added RDNSS and DNSSL options to the Device.RouterAdvertisement.InterfaceSetting.{i}. object
+* Added missing parameters from the Data Elements R2.1 specification
+* Added the Zone file concept to the Device.DNS. object
+* Added DNS caching configurability to the Device.DNS.Relay. object, allowing for control
+  over the cache settings, added a mechanism to allow the specification of the ingress (LAN side) interface(s)
+  to be used by the DNS forwarders
+* Added new InterfaceSetting object to Device.Firewall.
+* Added ModuleVersion parameter to InstallDU() and Update() commands
+* Added Origin parameter to PinHole, PortMapping and AccesssControl
+* Added PhysAddresMask parameter to AccessControl
+* Added LeaseDuration and RemainLeaseTime parameters to the DMZ and Pinhole objects
+* Added Device.Firewall.ConnectionTracking. object tree to configure ALGs
+* Added missing DSL xTU-C and xTU-R parameters to DSL objects
+* Added Device.Syslog. object tree to configure a syslog service
+* Added Support for password authentication in xPON
+* Added MaxNumberOfPortMappings and MaxNumberOfPortTriggers parameters to indicate system limits
+* Fixed the access of some UserInterface parameters and objects: Demoted Session and User to read-only, promoted Protocol to read-write
+* Fixed the access of a SSH parameter: Promoted AutoDisableDuration to read-write
+* Fixed the access of a USPServices parameter: Demoted Protocol to read-only
+* Added UDSAgent:1 and UDSController:1 profiles
+* Added Device.DeviceInfo.LogRotate.{i}. to setup a log rotation mechanism
+* Clarified descriptions of parameters in Device.SoftwareModules.ExecutionUnit.{i}.AutoRestart.
+* Added initial support for the 802.11be Wi-Fi 7 standard/mode in various places
+* Added OnBoardingComplete parameter to Device.LocalAgent.Controller.{i}.
+* Clarified suggested implementation of Device.PeriodicStatistics. concept
+* Added support for passing environment variables to software modules
+* Removed reference to an incorrect default port requirement from TR-471
+* Added EEEStatus parameter to Device.Ethernet.Interface.{i}.
+* Extended the key of Device.LocalAgent.Monitor.{i}.OnChange! ChangeSet.{i}.Parameter.{i}. output argument to include ChangeTime
+* Added objects and parameters to align with the work-in-progress DataElements R3 specification
+* Refactored scheduling related parameters into component for easier reuse and added Active and TimeLeft parameters
+* Added Device.SoftwareModules.ExecutionUnit.{i}.NetworkConfig. object and parameters
+* Added MaxSupportedDataDownlinkRate, MaxSupportedDataUplinkRate, SNR, and MaxSupportedBandwidth parameters to Device.WiFi.AccessPoint.{i}.AssociatedDevice.{i}.
+* Replaced custom coded Order parameter type and descriptions with the new Order datatype and text template
+* Changed the default WebSocket port from 5683 to 8443
+* Added support for checksum reporting to TransferComplete! event
+
 ## 2023-06-14: [TR-106 Amendment 12] and [TR-181 Issue 2 Amendment 16]
 
 *Tags: [v1.6.7] (data models), 
@@ -232,22 +281,26 @@ version of the BBF report tool
 [TR-106 Amendment 10]: https://www.broadband-forum.org/download/TR-106_Amendment-10.pdf
 [TR-106 Amendment 11]: https://www.broadband-forum.org/download/TR-106_Amendment-11.pdf
 [TR-106 Amendment 12]: https://www.broadband-forum.org/download/TR-106_Amendment-12.pdf
+[TR-106 Amendment 13]: https://www.broadband-forum.org/download/TR-106_Amendment-13.pdf
 [TR-106-v1.7.0+]: https://github.com/BroadbandForum/data-model-template/releases/tag/v1.7.0+
 [TR-106-v1.10.0]: https://github.com/BroadbandForum/data-model-template/releases/tag/v1.10.0
 [TR-106-v1.11.0]: https://github.com/BroadbandForum/data-model-template/releases/tag/v1.11.0
 [TR-106-v1.12.0]: https://github.com/BroadbandForum/data-model-template/releases/tag/v1.12.0
+[TR-106-v1.13.0]: https://github.com/BroadbandForum/data-model-template/releases/tag/v1.13.0
 [TR-181 Issue 2 Amendment 12]: https://www.broadband-forum.org/download/TR-181_Issue-2_Amendment-12.pdf
 [TR-181 Issue 2 Amendment 13]: https://www.broadband-forum.org/download/TR-181_Issue-2_Amendment-13.pdf
 [TR-181 Issue 2 Amendment 14]: https://www.broadband-forum.org/download/TR-181_Issue-2_Amendment-14.pdf
 [TR-181 Issue 2 Amendment 15]: https://www.broadband-forum.org/download/TR-181_Issue-2_Amendment-15.pdf
 [TR-181 Issue 2 Amendment 16]: https://www.broadband-forum.org/download/TR-181_Issue-2_Amendment-16.pdf
+[TR-181 Issue 2 Amendment 17]: https://www.broadband-forum.org/download/TR-181_Issue-2_Amendment-17.pdf
 [TR-181-v2.12.0]: https://github.com/BroadbandForum/device-data-model/releases/tag/v2.12.0
 [TR-181-v2.13.0]: https://github.com/BroadbandForum/device-data-model/releases/tag/v2.13.0
 [TR-181-v2.14.0]: https://github.com/BroadbandForum/device-data-model/releases/tag/v2.14.0
 [TR-181-v2.14.1]: https://github.com/BroadbandForum/device-data-model/releases/tag/v2.14.1
 [TR-181-v2.15.0]: https://github.com/BroadbandForum/device-data-model/releases/tag/v2.15.0
 [TR-181-v2.15.1]: https://github.com/BroadbandForum/device-data-model/releases/tag/v2.15.1
 [TR-181-v2.16.0]: https://github.com/BroadbandForum/device-data-model/releases/tag/v2.16.0
+[TR-181-v2.17.0]: https://github.com/BroadbandForum/device-data-model/releases/tag/v2.17.0
 [v1.6.0]: https://github.com/BroadbandForum/cwmp-data-models/releases/tag/v1.6.0
 [v1.6.0+]: https://github.com/BroadbandForum/cwmp-data-models/releases/tag/v1.6.0+
 [v1.6.0c1]: https://github.com/BroadbandForum/cwmp-data-models/releases/tag/v1.6.0c1
@@ -258,3 +311,4 @@ version of the BBF report tool
 [v1.6.5]: https://github.com/BroadbandForum/cwmp-data-models/releases/tag/v1.6.5
 [v1.6.6]: https://github.com/BroadbandForum/cwmp-data-models/releases/tag/v1.6.6
 [v1.6.7]: https://github.com/BroadbandForum/cwmp-data-models/releases/tag/v1.6.7
+[v1.6.8]: https://github.com/BroadbandForum/cwmp-data-models/releases/tag/v1.6.8
diff --git a/bbf-metadata.yaml b/bbf-metadata.yaml
@@ -94,8 +94,7 @@ reference-section-title: References
 citation-style: bbf.csl
 
 # BBF expand-div (lua filter) specs
-# XXX would prefer to define these in boilerplate.md but the include
-#     filter loses formatting, so define them here for now
+# XXX should be able to delete all these now
 bbfRevisionHistorySpec:
   optional: true
   before: |

diff --git a/extra.css b/extra.css
@@ -21,34 +21,72 @@ h4.hidden-header, h5.hidden-header, h6.hidden-header {
     margin-top: 1rem;
 }
 
-/* "note" div style */
+/* various "box" div styles */
+
+div.bug,
+div.note,
+div.see-also,
+div.tip {
+    margin-top: 10px;
+    margin-bottom: 10px;
+    margin-left: 0px;
+    margin-right: 0px;
+    background-size: 12px;
+    background-position: 10px 10px;
+    background-repeat: no-repeat;
+    border-radius: 5px;
+    line-height: 1.2;
+    overflow: hidden;
+    padding-top: 5px;
+    padding-bottom: 5px;
+    padding-left: 35px;
+    padding-right: 5px;
+    opacity: 0.8;
+}
+
+div.bug p,
+div.note p,
+div.see-also p,
+div.tip p {
+    margin-top: 5px;
+    margin-bottom: 5px;
+}
+
+div.bug {
+    background-size: 24px;
+    background-position: 2px 10px;
+    background-color: #ffe;
+    background-image: url(bee.png);
+    border: solid 1px #ff8;
+}
 
 div.note {
-     margin-top: 10px;
-     margin-bottom: 10px;
-     margin-left: 10px;
-     margin-right: 10px;
-     background-color: #f1f8fc;
-     background-image: url(pencil.png);
-     background-size: 16px;
-     background-position: 10px 10px;
-     background-repeat: no-repeat;
-     border: solid 1px #3498db;
-     border-radius: 5px;
-     -moz-border-radius: 5px;
-     -webkit-border-radius: 5px;
-     line-height: 18px;
-     overflow: hidden;
-     padding-top: 5px;
-     padding-bottom: 5px;
-     padding-left: 35px;
-     padding-right: 5px;
-     opacity: 0.8;
-}
-
-div.note p {
-     margin-top: 10px;
-     margin-bottom: 10px;
+    background-color: #f1f8fc;
+    background-image: url(pencil.png);
+    border: solid 1px #3498db;
+}
+
+div.see-also::before {
+    content: "See also:";
+    font-weight: bold;
+}
+
+div.see-also {
+    background-color: #efe;
+    background-image: url(right.png);
+    border: solid 1px #8f8;
+}
+
+div.see-also ul {
+    margin-left: 10px;
+    margin-bottom: 0px;
+    padding-left: 10px;
+}
+
+div.tip {
+    background-color: #fee;
+    background-image: url(tick.png);
+    border: solid 1px #f88;
 }
 
 /* "subheading" div / span style (some Word docs use a Subheading style) */
@@ -100,10 +138,26 @@ div.code, span.code {
     font-size: 0.98em;
 }
 
-/* "borderless" div style (intended only for tables) */
+/* "borderless" table style */
+
+table.borderless, table.borderless th, table.borderless td {
+    padding-left: 0em;
+    border-style: none;
+}
+
+/* "boldfirst" (column) table style */
 
-div.borderless table, div.borderless td {
-    border-style: none ;
+table.boldfirst td:first-child {
+    font-weight: bold;
+}
+
+/* "codefirst" etc. (column) table style */
+
+table.codefirst td:nth-child(1),
+table.codesecond td:nth-child(2),
+table.codethird td:nth-child(3)
+{
+    font-family: 'Courier New', Courier, 'Liberation Mono', monospace;
 }
 
 /* "left" and "right" styles */
@@ -145,29 +199,67 @@ figcaption:hover > a.headerlink {
     display: inline;
 }
 
-/* experimental definition list support based on ideas from
-   https://www.the-art-of-web.com/css/format-dl */
-
-dl {
-    border: 3px double #ccc;
-    margin-bottom: 1em;
-}
+/* description lists */
 
 dt {
-    float: left;
-    clear: left;
-    width: 15%;
     font-weight: bold;
-    margin-bottom: .8em;
 }
 
-/* XXX need to work out how to handle multi-paragraph dd elements */
-dd {
-    margin: 0 0 .8em 2em;
+/* table-like description lists, modified from a comment at
+   https://clicknathan.com/web-design/styling-html-5-description-lists-
+     formerly-known-as-definition-lists-properly */
+
+/* XXX not the default; enabled by the dltable class
+
+/* XXX should so something similar for Typst? */
+
+.dltable dl {
+    --dl-width: 95%;
+    --dt-width: 15%;
+    --dd-width: calc(var(--dl-width) - var(--dt-width));
+}
+
+.dltable.narrow dl {
+    --dt-width: 10%;
+}
+
+.dltable.wide dl {
+    --dt-width: 25%;
+}
+
+.dltable dl {
+    display: flex;
+    flex-wrap: wrap;
+    width: var(--dl-width);
+}
+
+.dltable dl > * {
+    padding-top: 0.5em;
+}
+
+.dltable dt {
+    width: var(--dt-width);
+    text-align: left;
+}
+
+.dltable dd {
+    width: var(--dd-width);
+    padding-left: 1em;
+    margin-left: 0px;
+}
+
+.dltable dd + dd {
+    width: var(--dl-width);
+    padding-left: calc(var(--dt-width) + 1em);
+}
+
+.dltable dt + dt {
+    padding-right: var(--dd-width);
 }
 
-dd:last-child {
-    margin-bottom: 0;
+.dltable dt + dt + dd {
+    margin-top: -1.625em; /* own height including padding */
+    padding-left: calc(var(--dt-width) + 1em);
 }
 
 /* this makes elements invisible */