summaryrefslogtreecommitdiffstatshomepage
diff options
context:
space:
mode:
author couriersud <couriersud@gmx.org>2020-08-02 14:46:17 +0200
committer couriersud <couriersud@gmx.org>2020-08-02 14:47:12 +0200
commita68287d6a613754736c37839679e897ad113f8c7 (patch)
treee5d6090f44713a24abc11c754eb43817dc237705
parent2e5e0a46165a2f0c10ab571252874c66a188b842 (diff)
netlist: Move documentation from header to cpp file. Batch 3.
* Header files will disappear and only nld_devinc.h which is can be created by nltool will stay. * These commits ensure that the documentation is preserved when the header files are deleted at some point in the future
-rw-r--r--src/lib/netlist/devices/nld_9316.cpp76
-rw-r--r--src/lib/netlist/devices/nld_9316.h80
-rw-r--r--src/lib/netlist/devices/nld_9322.cpp13
-rw-r--r--src/lib/netlist/devices/nld_9322.h17
-rw-r--r--src/lib/netlist/devices/nld_am2847.cpp13
-rw-r--r--src/lib/netlist/devices/nld_am2847.h17
-rw-r--r--src/lib/netlist/devices/nld_dm9314.cpp13
-rw-r--r--src/lib/netlist/devices/nld_dm9314.h17
-rw-r--r--src/lib/netlist/devices/nld_dm9334.cpp57
-rw-r--r--src/lib/netlist/devices/nld_dm9334.h61
-rw-r--r--src/lib/netlist/devices/nld_log.cpp12
-rw-r--r--src/lib/netlist/devices/nld_log.h14
-rw-r--r--src/lib/netlist/devices/nld_mm5837.cpp13
-rw-r--r--src/lib/netlist/devices/nld_mm5837.h15
-rw-r--r--src/lib/netlist/devices/nld_r2r_dac.cpp40
-rw-r--r--src/lib/netlist/devices/nld_r2r_dac.h42
-rw-r--r--src/lib/netlist/devices/nld_tms4800.cpp20
-rw-r--r--src/lib/netlist/devices/nld_tms4800.h24
-rw-r--r--src/lib/netlist/devices/nld_tristate.cpp2
-rw-r--r--src/lib/netlist/devices/nld_tristate.h6
20 files changed, 256 insertions, 296 deletions
diff --git a/src/lib/netlist/devices/nld_9316.cpp b/src/lib/netlist/devices/nld_9316.cpp
index 130b1103f36..1444eab368e 100644
--- a/src/lib/netlist/devices/nld_9316.cpp
+++ b/src/lib/netlist/devices/nld_9316.cpp
@@ -3,6 +3,82 @@
/*
* nld_9316.cpp
*
+ * DM9316: Synchronous 4-Bit Counters
+ *
+ * +--------------+
+ * /CLEAR |1 ++ 16| VCC
+ * CLOCK |2 15| RC (Ripple Carry)
+ * A |3 14| QA
+ * B |4 9316 13| QB
+ * C |5 12| QC
+ * D |6 11| QD
+ * Enable P |7 10| Enable T
+ * GND |8 9| /LOAD
+ * +--------------+
+ *
+ * Counter Sequence
+ *
+ * +-------++----+----+----+----+----+
+ * | COUNT || QD | QC | QB | QA | RC |
+ * +=======++====+====+====+====+====+
+ * | 0 || 0 | 0 | 0 | 0 | 0 |
+ * | 1 || 0 | 0 | 0 | 1 | 0 |
+ * | 2 || 0 | 0 | 1 | 0 | 0 |
+ * | 3 || 0 | 0 | 1 | 1 | 0 |
+ * | 4 || 0 | 1 | 0 | 0 | 0 |
+ * | 5 || 0 | 1 | 0 | 1 | 0 |
+ * | 6 || 0 | 1 | 1 | 0 | 0 |
+ * | 7 || 0 | 1 | 1 | 1 | 0 |
+ * | 8 || 1 | 0 | 0 | 0 | 0 |
+ * | 9 || 1 | 0 | 0 | 1 | 0 |
+ * | 10 || 1 | 0 | 1 | 0 | 0 |
+ * | 11 || 1 | 0 | 1 | 1 | 0 |
+ * | 12 || 1 | 1 | 0 | 0 | 0 |
+ * | 13 || 1 | 1 | 0 | 1 | 0 |
+ * | 14 || 1 | 1 | 1 | 0 | 0 |
+ * | 15 || 1 | 1 | 1 | 1 | 1 |
+ * +-------++----+----+----+----+----+
+ *
+ * Reset count function: Please refer to
+ * National Semiconductor datasheet (timing diagram)
+ *
+ * Naming conventions follow National Semiconductor datasheet
+ *
+ * DM9310: Synchronous 4-Bit Counters
+ *
+ * +--------------+
+ * CLEAR |1 ++ 16| VCC
+ * CLOCK |2 15| RC (Ripple Carry)
+ * A |3 14| QA
+ * B |4 9310 13| QB
+ * C |5 12| QC
+ * D |6 11| QD
+ * Enable P |7 10| Enable T
+ * GND |8 9| LOAD
+ * +--------------+
+ *
+ * Counter Sequence
+ *
+ * +-------++----+----+----+----+----+
+ * | COUNT || QD | QC | QB | QA | RC |
+ * +=======++====+====+====+====+====+
+ * | 0 || 0 | 0 | 0 | 0 | 0 |
+ * | 1 || 0 | 0 | 0 | 1 | 0 |
+ * | 2 || 0 | 0 | 1 | 0 | 0 |
+ * | 3 || 0 | 0 | 1 | 1 | 0 |
+ * | 4 || 0 | 1 | 0 | 0 | 0 |
+ * | 5 || 0 | 1 | 0 | 1 | 0 |
+ * | 6 || 0 | 1 | 1 | 0 | 0 |
+ * | 7 || 0 | 1 | 1 | 1 | 0 |
+ * | 8 || 1 | 0 | 0 | 0 | 0 |
+ * | 9 || 1 | 0 | 0 | 1 | 0 |
+ * +-------++----+----+----+----+----+
+ *
+ * Reset count function: Please refer to
+ * National Semiconductor datasheet (timing diagram)
+ *
+ * Naming conventions follow National Semiconductor datasheet
+ *
*/
#include "nl_base.h"
diff --git a/src/lib/netlist/devices/nld_9316.h b/src/lib/netlist/devices/nld_9316.h
index 97820f735e4..008104888ef 100644
--- a/src/lib/netlist/devices/nld_9316.h
+++ b/src/lib/netlist/devices/nld_9316.h
@@ -1,85 +1,5 @@
// license:GPL-2.0+
// copyright-holders:Couriersud
-/*
- * nld_9316.h
- *
- * DM9316: Synchronous 4-Bit Counters
- *
- * +--------------+
- * /CLEAR |1 ++ 16| VCC
- * CLOCK |2 15| RC (Ripple Carry)
- * A |3 14| QA
- * B |4 9316 13| QB
- * C |5 12| QC
- * D |6 11| QD
- * Enable P |7 10| Enable T
- * GND |8 9| /LOAD
- * +--------------+
- *
- * Counter Sequence
- *
- * +-------++----+----+----+----+----+
- * | COUNT || QD | QC | QB | QA | RC |
- * +=======++====+====+====+====+====+
- * | 0 || 0 | 0 | 0 | 0 | 0 |
- * | 1 || 0 | 0 | 0 | 1 | 0 |
- * | 2 || 0 | 0 | 1 | 0 | 0 |
- * | 3 || 0 | 0 | 1 | 1 | 0 |
- * | 4 || 0 | 1 | 0 | 0 | 0 |
- * | 5 || 0 | 1 | 0 | 1 | 0 |
- * | 6 || 0 | 1 | 1 | 0 | 0 |
- * | 7 || 0 | 1 | 1 | 1 | 0 |
- * | 8 || 1 | 0 | 0 | 0 | 0 |
- * | 9 || 1 | 0 | 0 | 1 | 0 |
- * | 10 || 1 | 0 | 1 | 0 | 0 |
- * | 11 || 1 | 0 | 1 | 1 | 0 |
- * | 12 || 1 | 1 | 0 | 0 | 0 |
- * | 13 || 1 | 1 | 0 | 1 | 0 |
- * | 14 || 1 | 1 | 1 | 0 | 0 |
- * | 15 || 1 | 1 | 1 | 1 | 1 |
- * +-------++----+----+----+----+----+
- *
- * Reset count function: Please refer to
- * National Semiconductor datasheet (timing diagram)
- *
- * Naming conventions follow National Semiconductor datasheet
- *
- * DM9310: Synchronous 4-Bit Counters
- *
- * +--------------+
- * CLEAR |1 ++ 16| VCC
- * CLOCK |2 15| RC (Ripple Carry)
- * A |3 14| QA
- * B |4 9310 13| QB
- * C |5 12| QC
- * D |6 11| QD
- * Enable P |7 10| Enable T
- * GND |8 9| LOAD
- * +--------------+
- *
- * Counter Sequence
- *
- * +-------++----+----+----+----+----+
- * | COUNT || QD | QC | QB | QA | RC |
- * +=======++====+====+====+====+====+
- * | 0 || 0 | 0 | 0 | 0 | 0 |
- * | 1 || 0 | 0 | 0 | 1 | 0 |
- * | 2 || 0 | 0 | 1 | 0 | 0 |
- * | 3 || 0 | 0 | 1 | 1 | 0 |
- * | 4 || 0 | 1 | 0 | 0 | 0 |
- * | 5 || 0 | 1 | 0 | 1 | 0 |
- * | 6 || 0 | 1 | 1 | 0 | 0 |
- * | 7 || 0 | 1 | 1 | 1 | 0 |
- * | 8 || 1 | 0 | 0 | 0 | 0 |
- * | 9 || 1 | 0 | 0 | 1 | 0 |
- * +-------++----+----+----+----+----+
- *
- * Reset count function: Please refer to
- * National Semiconductor datasheet (timing diagram)
- *
- * Naming conventions follow National Semiconductor datasheet
- *
- */
#ifndef NLD_9316_H_
#define NLD_9316_H_
diff --git a/src/lib/netlist/devices/nld_9322.cpp b/src/lib/netlist/devices/nld_9322.cpp
index 3b963111bb3..11b7659b581 100644
--- a/src/lib/netlist/devices/nld_9322.cpp
+++ b/src/lib/netlist/devices/nld_9322.cpp
@@ -3,6 +3,19 @@
/*
* nld_9322.cpp
*
+ * 9322: Quad 2-Line to 1-Line Data Selectors/Multiplexers
+ *
+ * +------------+
+ * SELECT |1 ++ 16| VCC
+ * A1 |2 15| STROBE
+ * B1 |3 14| A4
+ * Y1 |4 9322 13| B4
+ * A2 |5 12| Y4
+ * B2 |6 11| A3
+ * Y2 |7 10| B3
+ * GND |8 9| Y3
+ * +------------+
+ *
*/
#include "nld_9322.h"
diff --git a/src/lib/netlist/devices/nld_9322.h b/src/lib/netlist/devices/nld_9322.h
index 9a20f4ca2ac..d53d0c210e5 100644
--- a/src/lib/netlist/devices/nld_9322.h
+++ b/src/lib/netlist/devices/nld_9322.h
@@ -1,22 +1,5 @@
// license:BSD-3-Clause
// copyright-holders:Ryan Holtz
-/*
- * nld_9322.h
- *
- * 9322: Quad 2-Line to 1-Line Data Selectors/Multiplexers
- *
- * +------------+
- * SELECT |1 ++ 16| VCC
- * A1 |2 15| STROBE
- * B1 |3 14| A4
- * Y1 |4 9322 13| B4
- * A2 |5 12| Y4
- * B2 |6 11| A3
- * Y2 |7 10| B3
- * GND |8 9| Y3
- * +------------+
- *
- */
#ifndef NLD_9322_H_
#define NLD_9322_H_
diff --git a/src/lib/netlist/devices/nld_am2847.cpp b/src/lib/netlist/devices/nld_am2847.cpp
index 7dff2cdb07e..0b0b321efa4 100644
--- a/src/lib/netlist/devices/nld_am2847.cpp
+++ b/src/lib/netlist/devices/nld_am2847.cpp
@@ -3,6 +3,19 @@
/*
* nld_am2847.cpp
*
+ * Am2847: Quad 80-Bit Static Shift Register
+ *
+ * +--------------+
+ * OUTA |1 ++ 16| VSS
+ * RCA |2 15| IND
+ * INA |3 14| RCD
+ * OUTB |4 Am2847 13| OUTD
+ * RCB |5 12| VGG
+ * INB |6 11| CP
+ * OUTC |7 10| INC
+ * VDD |8 9| RCC
+ * +--------------+
+ *
*/
#include "nld_am2847.h"
diff --git a/src/lib/netlist/devices/nld_am2847.h b/src/lib/netlist/devices/nld_am2847.h
index f1347545984..bad7331e8f6 100644
--- a/src/lib/netlist/devices/nld_am2847.h
+++ b/src/lib/netlist/devices/nld_am2847.h
@@ -1,22 +1,5 @@
// license:BSD-3-Clause
// copyright-holders:Ryan Holtz
-/*
- * nld_am2847.h
- *
- * Am2847: Quad 80-Bit Static Shift Register
- *
- * +--------------+
- * OUTA |1 ++ 16| VSS
- * RCA |2 15| IND
- * INA |3 14| RCD
- * OUTB |4 Am2847 13| OUTD
- * RCB |5 12| VGG
- * INB |6 11| CP
- * OUTC |7 10| INC
- * VDD |8 9| RCC
- * +--------------+
- *
- */
#ifndef NLD_AM2847_H_
#define NLD_AM2847_H_
diff --git a/src/lib/netlist/devices/nld_dm9314.cpp b/src/lib/netlist/devices/nld_dm9314.cpp
index 2ded51abbd4..c941aadc0cf 100644
--- a/src/lib/netlist/devices/nld_dm9314.cpp
+++ b/src/lib/netlist/devices/nld_dm9314.cpp
@@ -3,6 +3,19 @@
/*
* nld_dm9314.cpp
*
+ * DM9314: 4-Bit Latches
+ *
+ * +--------------+
+ * /E |1 ++ 16| VCC
+ * /S0 |2 15| Q0
+ * D0 |3 14| /S1
+ * D1 |4 DM9314 13| Q1
+ * /S2 |5 12| Q2
+ * D2 |6 11| /S3
+ * D3 |7 10| Q3
+ * GND |8 9| /MR
+ * +--------------+
+ *
*/
#include "nld_dm9314.h"
diff --git a/src/lib/netlist/devices/nld_dm9314.h b/src/lib/netlist/devices/nld_dm9314.h
index 73edfaa1205..4fc855c40b2 100644
--- a/src/lib/netlist/devices/nld_dm9314.h
+++ b/src/lib/netlist/devices/nld_dm9314.h
@@ -1,22 +1,5 @@
// license:BSD-3-Clause
// copyright-holders:Felipe Sanches
-/*
- * nld_DM9314.h
- *
- * DM9314: 4-Bit Latches
- *
- * +--------------+
- * /E |1 ++ 16| VCC
- * /S0 |2 15| Q0
- * D0 |3 14| /S1
- * D1 |4 DM9314 13| Q1
- * /S2 |5 12| Q2
- * D2 |6 11| /S3
- * D3 |7 10| Q3
- * GND |8 9| /MR
- * +--------------+
- *
- */
#ifndef NLD_DM9314_H_
#define NLD_DM9314_H_
diff --git a/src/lib/netlist/devices/nld_dm9334.cpp b/src/lib/netlist/devices/nld_dm9334.cpp
index cdc38827755..0755c4532f1 100644
--- a/src/lib/netlist/devices/nld_dm9334.cpp
+++ b/src/lib/netlist/devices/nld_dm9334.cpp
@@ -3,6 +3,63 @@
/*
* nld_dm9334.cpp
*
+ * DM9334: 8-Bit Addressable Latch
+ *
+ * +--------------+
+ * A0 |1 ++ 16| VCC
+ * A1 |2 15| /C
+ * A2 |3 14| /E
+ * Q0 |4 DM9334 13| D
+ * Q1 |5 12| Q7
+ * Q2 |6 11| Q6
+ * Q3 |7 10| Q5
+ * GND |8 9| Q4
+ * +--------------+
+ *
+ * +---+---++---++---+---+---++---+---+---+---+---+---+---+---+
+ * | C | E || D || A0| A1| A2|| Q0| Q1| Q2| Q3| Q4| Q5| Q6| Q7|
+ * +===+===++===++===+===+===++===+===+===+===+===+===+===+===+
+ * | 1 | 0 || X || X | X | X || 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
+ * +---+---++---++---+---+---++---+---+---+---+---+---+---+---+
+ * | 1 | 1 || 0 || 0 | 0 | 0 || 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
+ * | 1 | 1 || 1 || 0 | 0 | 0 || 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
+ * | 1 | 1 || 0 || 0 | 0 | 1 || 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
+ * | 1 | 1 || 1 || 0 | 0 | 1 || 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 |
+ * | 1 | 1 || 0 || 0 | 1 | 0 || 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
+ * | 1 | 1 || 1 || 0 | 1 | 0 || 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 |
+ * | 1 | 1 || 0 || 0 | 1 | 1 || 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
+ * | 1 | 1 || 1 || 0 | 1 | 1 || 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 |
+ * | 1 | 1 || 0 || 1 | 0 | 0 || 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
+ * | 1 | 1 || 1 || 1 | 0 | 0 || 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 |
+ * | 1 | 1 || 0 || 1 | 0 | 1 || 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
+ * | 1 | 1 || 1 || 1 | 0 | 1 || 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 |
+ * | 1 | 1 || 0 || 1 | 1 | 0 || 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
+ * | 1 | 1 || 1 || 1 | 1 | 0 || 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 |
+ * | 1 | 1 || 0 || 1 | 1 | 1 || 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
+ * | 1 | 1 || 1 || 1 | 1 | 1 || 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 |
+ * +---+---++---++---+---+---++---+---+---+---+---+---+---+---+
+ * | 0 | 0 || X || X | X | X || P | P | P | P | P | P | P | P |
+ * +---+---++---++---+---+---++---+---+---+---+---+---+---+---+
+ * | 0 | 1 || 0 || 0 | 0 | 0 || 0 | P | P | P | P | P | P | P |
+ * | 0 | 1 || 1 || 0 | 0 | 0 || 1 | P | P | P | P | P | P | P |
+ * | 0 | 1 || 0 || 0 | 0 | 1 || P | 0 | P | P | P | P | P | P |
+ * | 0 | 1 || 1 || 0 | 0 | 1 || P | 1 | P | P | P | P | P | P |
+ * | 0 | 1 || 0 || 0 | 1 | 0 || P | P | 0 | P | P | P | P | P |
+ * | 0 | 1 || 1 || 0 | 1 | 0 || P | P | 1 | P | P | P | P | P |
+ * | 0 | 1 || 0 || 0 | 1 | 1 || P | P | P | 0 | P | P | P | P |
+ * | 0 | 1 || 1 || 0 | 1 | 1 || P | P | P | 1 | P | P | P | P |
+ * | 0 | 1 || 0 || 1 | 0 | 0 || P | P | P | P | 0 | P | P | P |
+ * | 0 | 1 || 1 || 1 | 0 | 0 || P | P | P | P | 1 | P | P | P |
+ * | 0 | 1 || 0 || 1 | 0 | 1 || P | P | P | P | P | 0 | P | P |
+ * | 0 | 1 || 1 || 1 | 0 | 1 || P | P | P | P | P | 1 | P | P |
+ * | 0 | 1 || 0 || 1 | 1 | 0 || P | P | P | P | P | P | 0 | P |
+ * | 0 | 1 || 1 || 1 | 1 | 0 || P | P | P | P | P | P | 1 | P |
+ * | 0 | 1 || 0 || 1 | 1 | 1 || P | P | P | P | P | P | P | 0 |
+ * | 0 | 1 || 1 || 1 | 1 | 1 || P | P | P | P | P | P | P | 1 |
+ * +---+---++---++---+---+---++---+---+---+---+---+---+---+---+
+ *
+ * Naming convention attempts to follow Texas Instruments / National Semiconductor datasheet Literature Number SNOS382A
+ *
*/
#include "nld_dm9334.h"
diff --git a/src/lib/netlist/devices/nld_dm9334.h b/src/lib/netlist/devices/nld_dm9334.h
index 2f4ab1f18c1..f4edeb97306 100644
--- a/src/lib/netlist/devices/nld_dm9334.h
+++ b/src/lib/netlist/devices/nld_dm9334.h
@@ -1,66 +1,5 @@
// license:BSD-3-Clause
// copyright-holders:Ryan Holtz
-/*
- * nld_DM9334.h
- *
- * DM9334: 8-Bit Addressable Latch
- *
- * +--------------+
- * A0 |1 ++ 16| VCC
- * A1 |2 15| /C
- * A2 |3 14| /E
- * Q0 |4 DM9334 13| D
- * Q1 |5 12| Q7
- * Q2 |6 11| Q6
- * Q3 |7 10| Q5
- * GND |8 9| Q4
- * +--------------+
- *
- * +---+---++---++---+---+---++---+---+---+---+---+---+---+---+
- * | C | E || D || A0| A1| A2|| Q0| Q1| Q2| Q3| Q4| Q5| Q6| Q7|
- * +===+===++===++===+===+===++===+===+===+===+===+===+===+===+
- * | 1 | 0 || X || X | X | X || 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
- * +---+---++---++---+---+---++---+---+---+---+---+---+---+---+
- * | 1 | 1 || 0 || 0 | 0 | 0 || 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
- * | 1 | 1 || 1 || 0 | 0 | 0 || 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
- * | 1 | 1 || 0 || 0 | 0 | 1 || 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
- * | 1 | 1 || 1 || 0 | 0 | 1 || 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 |
- * | 1 | 1 || 0 || 0 | 1 | 0 || 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
- * | 1 | 1 || 1 || 0 | 1 | 0 || 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 |
- * | 1 | 1 || 0 || 0 | 1 | 1 || 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
- * | 1 | 1 || 1 || 0 | 1 | 1 || 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 |
- * | 1 | 1 || 0 || 1 | 0 | 0 || 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
- * | 1 | 1 || 1 || 1 | 0 | 0 || 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 |
- * | 1 | 1 || 0 || 1 | 0 | 1 || 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
- * | 1 | 1 || 1 || 1 | 0 | 1 || 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 |
- * | 1 | 1 || 0 || 1 | 1 | 0 || 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
- * | 1 | 1 || 1 || 1 | 1 | 0 || 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 |
- * | 1 | 1 || 0 || 1 | 1 | 1 || 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
- * | 1 | 1 || 1 || 1 | 1 | 1 || 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 |
- * +---+---++---++---+---+---++---+---+---+---+---+---+---+---+
- * | 0 | 0 || X || X | X | X || P | P | P | P | P | P | P | P |
- * +---+---++---++---+---+---++---+---+---+---+---+---+---+---+
- * | 0 | 1 || 0 || 0 | 0 | 0 || 0 | P | P | P | P | P | P | P |
- * | 0 | 1 || 1 || 0 | 0 | 0 || 1 | P | P | P | P | P | P | P |
- * | 0 | 1 || 0 || 0 | 0 | 1 || P | 0 | P | P | P | P | P | P |
- * | 0 | 1 || 1 || 0 | 0 | 1 || P | 1 | P | P | P | P | P | P |
- * | 0 | 1 || 0 || 0 | 1 | 0 || P | P | 0 | P | P | P | P | P |
- * | 0 | 1 || 1 || 0 | 1 | 0 || P | P | 1 | P | P | P | P | P |
- * | 0 | 1 || 0 || 0 | 1 | 1 || P | P | P | 0 | P | P | P | P |
- * | 0 | 1 || 1 || 0 | 1 | 1 || P | P | P | 1 | P | P | P | P |
- * | 0 | 1 || 0 || 1 | 0 | 0 || P | P | P | P | 0 | P | P | P |
- * | 0 | 1 || 1 || 1 | 0 | 0 || P | P | P | P | 1 | P | P | P |
- * | 0 | 1 || 0 || 1 | 0 | 1 || P | P | P | P | P | 0 | P | P |
- * | 0 | 1 || 1 || 1 | 0 | 1 || P | P | P | P | P | 1 | P | P |
- * | 0 | 1 || 0 || 1 | 1 | 0 || P | P | P | P | P | P | 0 | P |
- * | 0 | 1 || 1 || 1 | 1 | 0 || P | P | P | P | P | P | 1 | P |
- * | 0 | 1 || 0 || 1 | 1 | 1 || P | P | P | P | P | P | P | 0 |
- * | 0 | 1 || 1 || 1 | 1 | 1 || P | P | P | P | P | P | P | 1 |
- * +---+---++---++---+---+---++---+---+---+---+---+---+---+---+
- *
- * Naming convention attempts to follow Texas Instruments / National Semiconductor datasheet Literature Number SNOS382A
- *
- */
#ifndef NLD_DM9334_H_
#define NLD_DM9334_H_
diff --git a/src/lib/netlist/devices/nld_log.cpp b/src/lib/netlist/devices/nld_log.cpp
index 5c0c550e11c..dacc208f5a0 100644
--- a/src/lib/netlist/devices/nld_log.cpp
+++ b/src/lib/netlist/devices/nld_log.cpp
@@ -1,7 +1,17 @@
// license:GPL-2.0+
// copyright-holders:Couriersud
/*
- * nld_log.c
+ * nld_log.cpp
+ *
+ * Devices supporting analysis and logging
+ *
+ * nld_log:
+ *
+ * +---------+
+ * | ++ |
+ * I | | ==> Log to file "netlist_" + name() + ".log"
+ * | |
+ * +---------+
*
*/
diff --git a/src/lib/netlist/devices/nld_log.h b/src/lib/netlist/devices/nld_log.h
index 13c71ea7257..470506a430e 100644
--- a/src/lib/netlist/devices/nld_log.h
+++ b/src/lib/netlist/devices/nld_log.h
@@ -1,19 +1,5 @@
// license:GPL-2.0+
// copyright-holders:Couriersud
-/*
- * nld_log.h
- *
- * Devices supporting analysis and logging
- *
- * nld_log:
- *
- * +---------+
- * | ++ |
- * I | | ==> Log to file "netlist_" + name() + ".log"
- * | |
- * +---------+
- *
- */
#ifndef NLD_LOG_H_
#define NLD_LOG_H_
diff --git a/src/lib/netlist/devices/nld_mm5837.cpp b/src/lib/netlist/devices/nld_mm5837.cpp
index aac0d38fe82..c43509fac7d 100644
--- a/src/lib/netlist/devices/nld_mm5837.cpp
+++ b/src/lib/netlist/devices/nld_mm5837.cpp
@@ -1,7 +1,18 @@
// license:GPL-2.0+
// copyright-holders:Couriersud
/*
- * nld_MM5837.c
+ * nld_MM5837.cpp
+ *
+ * MM5837: Digital noise source
+ *
+ * +--------+
+ * VDD |1 ++ 8| NC
+ * VGG |2 7| NC
+ * OUT |3 6| NC
+ * VSS |4 5| NC
+ * +--------+
+ *
+ * Naming conventions follow National Semiconductor datasheet
*
*/
diff --git a/src/lib/netlist/devices/nld_mm5837.h b/src/lib/netlist/devices/nld_mm5837.h
index 8f764aa651f..0fe862f964e 100644
--- a/src/lib/netlist/devices/nld_mm5837.h
+++ b/src/lib/netlist/devices/nld_mm5837.h
@@ -1,20 +1,5 @@
// license:GPL-2.0+
// copyright-holders:Couriersud
-/*
- * nld_MM5837.h
- *
- * MM5837: Digital noise source
- *
- * +--------+
- * VDD |1 ++ 8| NC
- * VGG |2 7| NC
- * OUT |3 6| NC
- * VSS |4 5| NC
- * +--------+
- *
- * Naming conventions follow National Semiconductor datasheet
- *
- */
#ifndef NLD_MM5837_H_
#define NLD_MM5837_H_
diff --git a/src/lib/netlist/devices/nld_r2r_dac.cpp b/src/lib/netlist/devices/nld_r2r_dac.cpp
index 2ea95ca4996..703ba3a536e 100644
--- a/src/lib/netlist/devices/nld_r2r_dac.cpp
+++ b/src/lib/netlist/devices/nld_r2r_dac.cpp
@@ -1,7 +1,45 @@
// license:GPL-2.0+
// copyright-holders:Couriersud
/*
- * nld_R2R_dac.c
+ * nld_r2r_dac.cpp
+ *
+ * DMR2R_DAC: R-2R DAC
+ *
+ * Generic R-2R DAC ... This is fast.
+ * 2R
+ * Bit n >----RRR----+---------> Vout
+ * |
+ * R
+ * R R
+ * R
+ * |
+ * .
+ * .
+ * 2R |
+ * Bit 2 >----RRR----+
+ * |
+ * R
+ * R R
+ * R
+ * |
+ * 2R |
+ * Bit 1 >----RRR----+
+ * |
+ * R
+ * R 2R
+ * R
+ * |
+ * V0
+ *
+ * Using Thevenin's Theorem, this can be written as
+ *
+ * +---RRR-----------> Vout
+ * |
+ * V
+ * V V = VAL / 2^n * Vin
+ * V
+ * |
+ * V0
*
*/
diff --git a/src/lib/netlist/devices/nld_r2r_dac.h b/src/lib/netlist/devices/nld_r2r_dac.h
index d440f999d67..85af880bddb 100644
--- a/src/lib/netlist/devices/nld_r2r_dac.h
+++ b/src/lib/netlist/devices/nld_r2r_dac.h
@@ -1,47 +1,5 @@
// license:GPL-2.0+
// copyright-holders:Couriersud
-/*
- * nld_R2R_DAC.h
- *
- * DMR2R_DAC: R-2R DAC
- *
- * Generic R-2R DAC ... This is fast.
- * 2R
- * Bit n >----RRR----+---------> Vout
- * |
- * R
- * R R
- * R
- * |
- * .
- * .
- * 2R |
- * Bit 2 >----RRR----+
- * |
- * R
- * R R
- * R
- * |
- * 2R |
- * Bit 1 >----RRR----+
- * |
- * R
- * R 2R
- * R
- * |
- * V0
- *
- * Using Thevenin's Theorem, this can be written as
- *
- * +---RRR-----------> Vout
- * |
- * V
- * V V = VAL / 2^n * Vin
- * V
- * |
- * V0
- *
- */
#ifndef NLD_R2R_DAC_H_
#define NLD_R2R_DAC_H_
diff --git a/src/lib/netlist/devices/nld_tms4800.cpp b/src/lib/netlist/devices/nld_tms4800.cpp
index 3f9de696ea8..d55827c2416 100644
--- a/src/lib/netlist/devices/nld_tms4800.cpp
+++ b/src/lib/netlist/devices/nld_tms4800.cpp
@@ -3,6 +3,26 @@
/*
* nld_tms4800.cpp
*
+ * TMS-4800: 16 Kbit (2Kb x 8) READ ONLY MEMORY
+ *
+ * +----------------+
+ * VSS |1 ++ 24| OE1
+ * A1 |2 23| O1
+ * A2 |3 22| O2
+ * A3 |4 TMS-4800 21| O3
+ * A4 |5 20| O4
+ * A5 |6 19| O5
+ * A6 |7 18| O6
+ * A10 |8 17| O7
+ * VGG |9 16| O8
+ * A9 |10 15| A11
+ * A8 |11 14| OE2
+ * A7 |12 13| AR
+ * +----------------+
+ *
+ *
+ * Naming conventions follow Texas Instruments datasheet:
+ * http://bitsavers.trailing-edge.com/components/ti/_dataBooks/1975_TI_The_Semiconductor_Memory_Data_Book.pdf
*/
#include "nld_tms4800.h"
diff --git a/src/lib/netlist/devices/nld_tms4800.h b/src/lib/netlist/devices/nld_tms4800.h
index 14d7d40dc64..63bcff9e7e9 100644
--- a/src/lib/netlist/devices/nld_tms4800.h
+++ b/src/lib/netlist/devices/nld_tms4800.h
@@ -1,29 +1,5 @@
// license:BSD-3-Clause
// copyright-holders:Felipe Sanches
-/*
- * nld_tms4800.h
- *
- * TMS-4800: 16 Kbit (2Kb x 8) READ ONLY MEMORY
- *
- * +----------------+
- * VSS |1 ++ 24| OE1
- * A1 |2 23| O1
- * A2 |3 22| O2
- * A3 |4 TMS-4800 21| O3
- * A4 |5 20| O4
- * A5 |6 19| O5
- * A6 |7 18| O6
- * A10 |8 17| O7
- * VGG |9 16| O8
- * A9 |10 15| A11
- * A8 |11 14| OE2
- * A7 |12 13| AR
- * +----------------+
- *
- *
- * Naming conventions follow Texas Instruments datasheet:
- * http://bitsavers.trailing-edge.com/components/ti/_dataBooks/1975_TI_The_Semiconductor_Memory_Data_Book.pdf
- */
#ifndef NLD_TMS4800_H_
#define NLD_TMS4800_H_
diff --git a/src/lib/netlist/devices/nld_tristate.cpp b/src/lib/netlist/devices/nld_tristate.cpp
index 93dcbb4913d..013a0514420 100644
--- a/src/lib/netlist/devices/nld_tristate.cpp
+++ b/src/lib/netlist/devices/nld_tristate.cpp
@@ -3,6 +3,8 @@
/*
* nld_tristate.cpp
*
+ * tristate: Hack to merge two tri-stated outputs together
+ *
*/
#include "nld_tristate.h"
diff --git a/src/lib/netlist/devices/nld_tristate.h b/src/lib/netlist/devices/nld_tristate.h
index 71f97d9812d..0cb32c73d12 100644
--- a/src/lib/netlist/devices/nld_tristate.h
+++ b/src/lib/netlist/devices/nld_tristate.h
@@ -1,11 +1,5 @@
// license:BSD-3-Clause
// copyright-holders:Ryan Holtz
-/*
- * nld_tristate.h
- *
- * tristate: Hack to merge two tri-stated outputs together
- *
- */
#ifndef NLD_TRISTATE_H_
#define NLD_TRISTATE_H_