From 65f2d8576f81c186b0847f0de8f5c8f81485225e Mon Sep 17 00:00:00 2001
From: Patrick Huesmann <patrick.huesmann@desy.de>
Date: Mon, 26 Sep 2022 14:57:17 +0200
Subject: [PATCH] Update doc & examples

---
 docs/picmg.md                         | 32 +++++++++++++++++++++
 docs/records.md                       |  3 ++
 examples/ADRV9375-N.yml               |  2 +-
 examples/DWC8VM1.yml                  |  2 +-
 examples/DWC8VM1_HF.yml               |  2 +-
 examples/caen-fmc-pico-1m4.yml        |  2 +-
 examples/damc-fmc1z7io.yml            |  2 +-
 examples/damc-fmc20.yml               |  2 +-
 examples/damc-fmc25.yml               |  2 +-
 examples/damc-fmc2zup.yml             |  2 +-
 examples/desy-dfmc-ad16.yml           |  2 +-
 examples/desy-dfmc-uniio.yml          |  2 +-
 examples/dfmc-md22.yml                |  2 +-
 examples/dmmc-stamp.yml               |  2 +-
 examples/drtm-ad84_revD.yml           |  2 +-
 examples/drtm-ad84_revE.yml           |  2 +-
 examples/drtm-clkft.yml               | 40 +++++++++++++++++++++++++++
 examples/drtm-mxc.yml                 |  2 +-
 examples/drtm-rtm-evalkit.yml         |  2 +-
 examples/fmc+_loopback.yml            |  2 +-
 examples/fmc-dac-600m-12b-1ch-dds.yml |  2 +-
 examples/mmc-breakout.yml             |  2 +-
 examples/opalkelly_default.yml        |  2 +-
 examples/opalkelly_default_2k.yml     |  2 +-
 examples/uLOG_FRU.yml                 |  2 +-
 25 files changed, 97 insertions(+), 22 deletions(-)
 create mode 100644 examples/drtm-clkft.yml

diff --git a/docs/picmg.md b/docs/picmg.md
index b57f028..085fc0e 100644
--- a/docs/picmg.md
+++ b/docs/picmg.md
@@ -130,6 +130,16 @@ PICMG AMC.0 Specification R2.0, Table 3-29
 <br>
 
 
+## CarrierBusedConnectivity
+PICMG MicroTCA.4 Enhancements for Rear I/O and Timing R1.0, Table 3-12
+
+|Name                                    |Type                |Opt                           
+|----------------------------------------|--------------------|------------------------------|
+|`bused_connection_descriptors`          |array (BusedConnectionDescriptor)|                              |
+
+<br>
+
+
 ## Zone3InterfaceDocumentation
 PICMG MicroTCA.4 Enhancements for Rear I/O and Timing R1.0, Table 3-15
 
@@ -307,3 +317,25 @@ PICMG AMC.0 Specification R2.0, Table 3-30
 
 <br>
 
+
+## BusedDeviceDescriptor
+PICMG MicroTCA.4 Enhancements for Rear I/O and Timing R1.0, Table 3-14
+
+|Name                                    |Type                |Opt                           
+|----------------------------------------|--------------------|------------------------------|
+|`resource_id`                           |int (u1)            |`on_carrier`, `AMC`           |
+|`amc_site`                              |int (u4)            |                              |
+|`port`                                  |int (u8)            |                              |
+
+<br>
+
+
+## BusedConnectionDescriptor
+PICMG MicroTCA.4 Enhancements for Rear I/O and Timing R1.0, Table 3-13
+
+|Name                                    |Type                |Opt                           
+|----------------------------------------|--------------------|------------------------------|
+|`bused_device_descriptor`               |array (BusedDeviceDescriptor)|                              |
+
+<br>
+
diff --git a/docs/records.md b/docs/records.md
index b99d353..69a8321 100644
--- a/docs/records.md
+++ b/docs/records.md
@@ -41,6 +41,7 @@
 |MtcaCarrierActivationPm             |PICMG Specification MTCA.0 R1.0, Table 3-25                                     |
 |CarrierP2pConnectivity              |PICMG AMC.0 Specification R2.0, Table 3-13                                      |
 |CarrierClkP2pConnectivity           |PICMG AMC.0 Specification R2.0, Table 3-29                                      |
+|CarrierBusedConnectivity            |PICMG MicroTCA.4 Enhancements for Rear I/O and Timing R1.0, Table 3-12          |
 |Zone3InterfaceDocumentation         |PICMG MicroTCA.4 Enhancements for Rear I/O and Timing R1.0, Table 3-15          |
 
 <br>
@@ -63,6 +64,8 @@
 |P2pAmcResourceDescriptor            |PICMG AMC.0 Specification R2.0, Table 3-14                                      |
 |P2pClockConnectionDescriptor        |PICMG AMC.0 Specification R2.0, Table 3-32                                      |
 |ClockP2pResourceDescriptor          |PICMG AMC.0 Specification R2.0, Table 3-30                                      |
+|BusedDeviceDescriptor               |PICMG MicroTCA.4 Enhancements for Rear I/O and Timing R1.0, Table 3-14          |
+|BusedConnectionDescriptor           |PICMG MicroTCA.4 Enhancements for Rear I/O and Timing R1.0, Table 3-13          |
 
 <br>
 
diff --git a/examples/ADRV9375-N.yml b/examples/ADRV9375-N.yml
index 1940678..6f84b68 100644
--- a/examples/ADRV9375-N.yml
+++ b/examples/ADRV9375-N.yml
@@ -1,4 +1,4 @@
-# created with frugy 0.3.0 from "ADRV9375-N.bin"
+# created with frugy 0.4.0 from "ADRV9375-N.bin"
 
 BoardInfo:
   language_code: 25
diff --git a/examples/DWC8VM1.yml b/examples/DWC8VM1.yml
index 9376ff0..03951b0 100644
--- a/examples/DWC8VM1.yml
+++ b/examples/DWC8VM1.yml
@@ -1,4 +1,4 @@
-# created with frugy 0.3.0 from "DWC8VM1.bin"
+# created with frugy 0.4.0 from "DWC8VM1.bin"
 
 BoardInfo:
   mfg_date_time: 2014-06-09 14:51:00
diff --git a/examples/DWC8VM1_HF.yml b/examples/DWC8VM1_HF.yml
index 824e907..ec8c332 100644
--- a/examples/DWC8VM1_HF.yml
+++ b/examples/DWC8VM1_HF.yml
@@ -1,4 +1,4 @@
-# created with frugy 0.3.0 from "DWC8VM1_HF.bin"
+# created with frugy 0.4.0 from "DWC8VM1_HF.bin"
 
 BoardInfo:
   mfg_date_time: 2016-06-03 10:00:00
diff --git a/examples/caen-fmc-pico-1m4.yml b/examples/caen-fmc-pico-1m4.yml
index 17275e0..d3119c7 100644
--- a/examples/caen-fmc-pico-1m4.yml
+++ b/examples/caen-fmc-pico-1m4.yml
@@ -1,4 +1,4 @@
-# created with frugy 0.3.0 from "caen-fmc-pico-1m4.bin"
+# created with frugy 0.4.0 from "caen-fmc-pico-1m4.bin"
 
 BoardInfo:
   mfg_date_time: 2015-06-10 00:00:00
diff --git a/examples/damc-fmc1z7io.yml b/examples/damc-fmc1z7io.yml
index f5e383c..d9fc399 100644
--- a/examples/damc-fmc1z7io.yml
+++ b/examples/damc-fmc1z7io.yml
@@ -1,4 +1,4 @@
-# created with frugy 0.3.0 from "damc-fmc1z7io.bin"
+# created with frugy 0.4.0 from "damc-fmc1z7io.bin"
 
 BoardInfo:
   manufacturer: DESY
diff --git a/examples/damc-fmc20.yml b/examples/damc-fmc20.yml
index 2903245..222e413 100644
--- a/examples/damc-fmc20.yml
+++ b/examples/damc-fmc20.yml
@@ -1,4 +1,4 @@
-# created with frugy 0.3.0 from "damc-fmc20.bin"
+# created with frugy 0.4.0 from "damc-fmc20.bin"
 
 BoardInfo:
   manufacturer: DESY
diff --git a/examples/damc-fmc25.yml b/examples/damc-fmc25.yml
index 5bfe30e..cdc58cd 100644
--- a/examples/damc-fmc25.yml
+++ b/examples/damc-fmc25.yml
@@ -1,4 +1,4 @@
-# created with frugy 0.3.0 from "damc-fmc25.bin"
+# created with frugy 0.4.0 from "damc-fmc25.bin"
 
 BoardInfo:
   manufacturer: DESY
diff --git a/examples/damc-fmc2zup.yml b/examples/damc-fmc2zup.yml
index 6733e19..4fbc02e 100644
--- a/examples/damc-fmc2zup.yml
+++ b/examples/damc-fmc2zup.yml
@@ -1,4 +1,4 @@
-# created with frugy 0.3.0 from "damc-fmc2zup.bin"
+# created with frugy 0.4.0 from "damc-fmc2zup.bin"
 
 BoardInfo:
   manufacturer: DESY/CAEN ELS
diff --git a/examples/desy-dfmc-ad16.yml b/examples/desy-dfmc-ad16.yml
index ec80f2f..35eaec0 100644
--- a/examples/desy-dfmc-ad16.yml
+++ b/examples/desy-dfmc-ad16.yml
@@ -1,4 +1,4 @@
-# created with frugy 0.3.0 from "desy-dfmc-ad16.bin"
+# created with frugy 0.4.0 from "desy-dfmc-ad16.bin"
 
 BoardInfo:
   mfg_date_time: 2022-01-25 00:00:00
diff --git a/examples/desy-dfmc-uniio.yml b/examples/desy-dfmc-uniio.yml
index a050abb..4b9fc21 100644
--- a/examples/desy-dfmc-uniio.yml
+++ b/examples/desy-dfmc-uniio.yml
@@ -1,4 +1,4 @@
-# created with frugy 0.3.0 from "desy-dfmc-uniio.bin"
+# created with frugy 0.4.0 from "desy-dfmc-uniio.bin"
 
 BoardInfo:
   mfg_date_time: 2021-03-18 00:00:00
diff --git a/examples/dfmc-md22.yml b/examples/dfmc-md22.yml
index 6551686..a99f607 100644
--- a/examples/dfmc-md22.yml
+++ b/examples/dfmc-md22.yml
@@ -1,4 +1,4 @@
-# created with frugy 0.3.0 from "dfmc-md22.bin"
+# created with frugy 0.4.0 from "dfmc-md22.bin"
 
 BoardInfo:
   mfg_date_time: 2021-07-26 17:00:00
diff --git a/examples/dmmc-stamp.yml b/examples/dmmc-stamp.yml
index eb5c6c5..0649207 100644
--- a/examples/dmmc-stamp.yml
+++ b/examples/dmmc-stamp.yml
@@ -1,4 +1,4 @@
-# created with frugy 0.3.0 from "dmmc-stamp.bin"
+# created with frugy 0.4.0 from "dmmc-stamp.bin"
 
 BoardInfo:
   manufacturer: DESY
diff --git a/examples/drtm-ad84_revD.yml b/examples/drtm-ad84_revD.yml
index 51a9568..0a9f0a2 100644
--- a/examples/drtm-ad84_revD.yml
+++ b/examples/drtm-ad84_revD.yml
@@ -1,4 +1,4 @@
-# created with frugy 0.3.0 from "drtm-ad84_revD.bin"
+# created with frugy 0.4.0 from "drtm-ad84_revD.bin"
 
 BoardInfo:
   mfg_date_time: 2018-05-24 15:00:00
diff --git a/examples/drtm-ad84_revE.yml b/examples/drtm-ad84_revE.yml
index 5cb7696..98f9b67 100644
--- a/examples/drtm-ad84_revE.yml
+++ b/examples/drtm-ad84_revE.yml
@@ -1,4 +1,4 @@
-# created with frugy 0.3.0 from "drtm-ad84_revE.bin"
+# created with frugy 0.4.0 from "drtm-ad84_revE.bin"
 
 BoardInfo:
   mfg_date_time: 2018-05-24 15:00:00
diff --git a/examples/drtm-clkft.yml b/examples/drtm-clkft.yml
new file mode 100644
index 0000000..026542a
--- /dev/null
+++ b/examples/drtm-clkft.yml
@@ -0,0 +1,40 @@
+# created with frugy 0.4.0 from "drtm-clkft.bin"
+
+BoardInfo:
+  language_code: 25
+  mfg_date_time: 2019-01-29 00:00:00
+  manufacturer: Deutsches Elektronen-Synchrotron
+  product_name: DRTM-CLKFT
+  serial_number: N/A
+
+ProductInfo:
+  language_code: 25
+  manufacturer: Deutsches Elektronen-Synchrotron
+  product_name: DRTM-CLKFT
+  version: Rev. B1
+  serial_number: N/A
+  asset_tag: N/A
+
+MultirecordArea:
+- type: ModuleCurrentRequirements
+  current_draw: 2.0
+
+- type: Zone3InterfaceCompatibility
+  identifier_type: CLASS_ID
+  identifier_body:
+  - D1.0
+
+- type: Zone3InterfaceCompatibility
+  identifier_type: CLASS_ID
+  identifier_body:
+  - D1.1
+
+- type: Zone3InterfaceCompatibility
+  identifier_type: CLASS_ID
+  identifier_body:
+  - D1.2
+
+- type: Zone3InterfaceCompatibility
+  identifier_type: CLASS_ID
+  identifier_body:
+  - D1.3
diff --git a/examples/drtm-mxc.yml b/examples/drtm-mxc.yml
index 975d8dd..1c459ce 100644
--- a/examples/drtm-mxc.yml
+++ b/examples/drtm-mxc.yml
@@ -1,4 +1,4 @@
-# created with frugy 0.3.0 from "drtm-mxc.bin"
+# created with frugy 0.4.0 from "drtm-mxc.bin"
 
 BoardInfo:
   manufacturer: DESY
diff --git a/examples/drtm-rtm-evalkit.yml b/examples/drtm-rtm-evalkit.yml
index 6106ca9..f99f0c0 100644
--- a/examples/drtm-rtm-evalkit.yml
+++ b/examples/drtm-rtm-evalkit.yml
@@ -1,4 +1,4 @@
-# created with frugy 0.3.0 from "drtm-rtm-evalkit.bin"
+# created with frugy 0.4.0 from "drtm-rtm-evalkit.bin"
 
 ProductInfo:
   language_code: 25
diff --git a/examples/fmc+_loopback.yml b/examples/fmc+_loopback.yml
index b65cd89..69e54d5 100644
--- a/examples/fmc+_loopback.yml
+++ b/examples/fmc+_loopback.yml
@@ -1,4 +1,4 @@
-# created with frugy 0.3.0 from "fmc+_loopback.bin"
+# created with frugy 0.4.0 from "fmc+_loopback.bin"
 
 BoardInfo:
   mfg_date_time: 2019-11-07 13:10:00
diff --git a/examples/fmc-dac-600m-12b-1ch-dds.yml b/examples/fmc-dac-600m-12b-1ch-dds.yml
index 68b4a1f..5407ba9 100644
--- a/examples/fmc-dac-600m-12b-1ch-dds.yml
+++ b/examples/fmc-dac-600m-12b-1ch-dds.yml
@@ -1,4 +1,4 @@
-# created with frugy 0.3.0 from "fmc-dac-600m-12b-1ch-dds.bin"
+# created with frugy 0.4.0 from "fmc-dac-600m-12b-1ch-dds.bin"
 
 BoardInfo:
   mfg_date_time: 2020-08-27 13:36:00
diff --git a/examples/mmc-breakout.yml b/examples/mmc-breakout.yml
index aeb6cb1..5a283d1 100644
--- a/examples/mmc-breakout.yml
+++ b/examples/mmc-breakout.yml
@@ -1,4 +1,4 @@
-# created with frugy 0.3.0 from "mmc-breakout.bin"
+# created with frugy 0.4.0 from "mmc-breakout.bin"
 
 BoardInfo:
   manufacturer: DESY
diff --git a/examples/opalkelly_default.yml b/examples/opalkelly_default.yml
index 4c33210..c7a216b 100644
--- a/examples/opalkelly_default.yml
+++ b/examples/opalkelly_default.yml
@@ -1,4 +1,4 @@
-# created with frugy 0.3.0 from "opalkelly_default.bin"
+# created with frugy 0.4.0 from "opalkelly_default.bin"
 
 BoardInfo:
   manufacturer: Opal Kelly Incorporated
diff --git a/examples/opalkelly_default_2k.yml b/examples/opalkelly_default_2k.yml
index 62651c5..4ce06be 100644
--- a/examples/opalkelly_default_2k.yml
+++ b/examples/opalkelly_default_2k.yml
@@ -1,4 +1,4 @@
-# created with frugy 0.3.0 from "opalkelly_default_2k.bin"
+# created with frugy 0.4.0 from "opalkelly_default_2k.bin"
 
 BoardInfo:
   manufacturer: Opal Kelly Incorporated
diff --git a/examples/uLOG_FRU.yml b/examples/uLOG_FRU.yml
index ba4895d..34d2fd9 100644
--- a/examples/uLOG_FRU.yml
+++ b/examples/uLOG_FRU.yml
@@ -1,4 +1,4 @@
-# created with frugy 0.3.0 from "uLOG_FRU.bin"
+# created with frugy 0.4.0 from "uLOG_FRU.bin"
 
 BoardInfo:
   language_code: 25