[dev]reorder and add comments to nodenames

nodenames.js

@@ -21,89 +21,19 @@
 */
 
 var nodenames ={
+res: 159,       // pads: reset
+rw: 1156,       // pads: read not write
+db0: 1005,      // pads: databus
 db1: 82,
-db0: 1005,
 db3: 650,
 db2: 945,
 db5: 175,
 db4: 1393,
 db7: 1349,
 db6: 1591,
-idl0: 116,
-idl1: 576,
-idl2: 1485,
-idl3: 1284,
-idl4: 1516,
-idl5: 498,
-idl6: 1537,
-idl7: 529,
-a1: 1234,
+ab0: 268,       // pads: address bus
 ab1: 451,
 ab2: 1340,
-a2: 978,
-s2: 81,
-a5: 858,
-a4: 727,
-a7: 1653,
-a6: 1136,
-so: 1672,
-sync: 539,
-vcc: 657,
-clk1out: 1163,
-p2: 1421,
-p3: 439,
-p0: 687,
-p1: 1444,
-p6: 77,
-p7: 1370,
-p4: 1119,
-p5: 0,
-pcl3: 1359,
-pcl2: 655,
-pcl1: 1022,
-pcl0: 1139,
-pcl7: 1611,
-pcl6: 377,
-pcl5: 622,
-pcl4: 900,
-clk0: 1171,
-s3: 1532,
-res: 159,
-s1: 183,
-s0: 1403,
-s7: 1435,
-s6: 1212,
-s5: 1098,
-s4: 1702,
-nots0: 418,
-nots1: 1064,
-nots2: 752,
-nots3: 828,
-nots4: 1603,
-nots5: 601,
-nots6: 1029,
-nots7: 181,
-rw: 1156,
-x2: 1,
-x3: 1648,
-x0: 1216,
-x1: 98,
-x6: 448,
-x7: 777,
-x4: 85,
-x5: 589,
-rdy: 89,
-clk2out: 421,
-nmi: 1297,
-ab12: 1237,
-ab13: 349,
-ab10: 1443,
-ab11: 399,
-ab14: 672,
-ab15: 195,
-ab0: 268,
-a0: 737,
-a3: 162,
 ab3: 211,
 ab4: 435,
 ab5: 736,
@@ -111,7 +41,56 @@ ab6: 887,
 ab7: 1493,
 ab8: 230,
 ab9: 148,
-pch7: 205,
+ab12: 1237,
+ab13: 349,
+ab10: 1443,
+ab11: 399,
+ab14: 672,
+ab15: 195,
+sync: 539,      // pads
+so: 1672,       // pads: set overflow
+clk0: 1171,     // pads
+clk1out: 1163,  // pads
+clk2out: 421,   // pads
+rdy: 89,        // pads: ready
+nmi: 1297,      // pads: non maskable interrupt
+irq: 103,       // pads
+vcc: 657,       // pads
+vss: 558,       // pads
+
+a0: 737,        // machine state: accumulator
+a1: 1234,
+a2: 978,
+a3: 162,
+a4: 727,
+a5: 858,
+a6: 1136,
+a7: 1653,
+y0: 64,         // machine state: y index register
+y1: 1148,
+y2: 573,
+y3: 305,
+y4: 989,
+y5: 615,
+y6: 115,
+y7: 843,
+x0: 1216,       // machine state: x index register
+x1: 98,
+x2: 1,
+x3: 1648,
+x4: 85,
+x5: 589,
+x6: 448,
+x7: 777,
+pcl0: 1139,     // machine state: program counter low
+pcl1: 1022,
+pcl2: 655,
+pcl3: 1359,
+pcl4: 900,
+pcl5: 622,
+pcl6: 377,
+pcl7: 1611,
+pch7: 205,      // machine state: program counter high
 pch6: 1551,
 pch5: 49,
 pch4: 948,
@@ -119,61 +98,53 @@ pch3: 584,
 pch2: 502,
 pch1: 292,
 pch0: 1670,
-irq: 103,
-vss: 558,
-y1: 1148,
-y0: 64,
-y3: 305,
-y2: 573,
-y5: 615,
-y4: 989,
-y7: 843,
-y6: 115,
-cclk: 943,   // aka cp2
-clock1: 156,
-clock2: 1536,
-notir7: 1320,
-notir6: 895,   // OK
-notir5: 1394,  // OK
-notir4: 26,
-notir3: 1125,  
-notir2: 1182,  
+p0: 687,        // machine state: status register
+p1: 1444,
+p2: 1421,
+p3: 439,
+p4: 1119,
+p5: 0,
+p6: 77,
+p7: 1370,
+s0: 1403,       // machine state: stack pointer
+s1: 183,
+s2: 81,
+s3: 1532,
+s4: 1702,
+s5: 1098,
+s6: 1212,
+s7: 1435,
+notir0: 194,    // internal state: instruction register
 notir1: 702,
-notir0: 194,
-t2: 971,
+notir2: 1182,  
+notir3: 1125,  
+notir4: 26,
+notir5: 1394,
+notir6: 895,
+notir7: 1320,
+clock1: 156,    // internal state: timing control
+clock2: 1536,   // internal state: timing control
+t2: 971,        // internal state: timing control
 t3: 1567,
 t4: 690,
 t5: 909,
-cp1: 710,
-fetch: 879,
-clearIR: 1077,
-D1x1: 827,
-notRdy0: 248,
-alu0: 394,
-alu1: 697,
-alu2: 276,
-alu3: 495,
-alu4: 1490,
-alu5: 893,
-alu6: 68,
-alu7: 1123,
-adl0: 413,
-adl1: 1282,
-adl2: 1242,
-adl3: 684,
-adl4: 1437,
-adl5: 1630,
-adl6: 121,
-adl7: 1299,
-adh0: 407,
-adh1: 52,
-adh2: 1651,
-adh3: 315,
-adh4: 1160,
-adh5: 483,
-adh6: 13,
-adh7: 1539,
-sb0: 54,
+nots0: 418,     // datapath state: not stack pointer
+nots1: 1064,
+nots2: 752,
+nots3: 828,
+nots4: 1603,
+nots5: 601,
+nots6: 1029,
+nots7: 181,
+idl0: 116,      // datapath state: internal data latch
+idl1: 576,
+idl2: 1485,
+idl3: 1284,
+idl4: 1516,
+idl5: 498,
+idl6: 1537,
+idl7: 529,
+sb0: 54,        // datapath bus: special bus
 sb1: 1150,
 sb2: 1287,
 sb3: 1188,
@@ -181,7 +152,31 @@ sb4: 1405,
 sb5: 166,
 sb6: 1336,
 sb7: 1001,
-idb0: 1108,
+alu0: 394,      // datapath state: ALU output
+alu1: 697,
+alu2: 276,
+alu3: 495,
+alu4: 1490,
+alu5: 893,
+alu6: 68,
+alu7: 1123,
+adl0: 413,      // internal state: address latch low
+adl1: 1282,
+adl2: 1242,
+adl3: 684,
+adl4: 1437,
+adl5: 1630,
+adl6: 121,
+adl7: 1299,
+adh0: 407,      // internal state: address latch high
+adh1: 52,
+adh2: 1651,
+adh3: 315,
+adh4: 1160,
+adh5: 483,
+adh6: 13,
+adh7: 1539,
+idb0: 1108,     // internal state: data buffer
 idb1: 991,
 idb2: 1473,
 idb3: 1302,
@@ -189,7 +184,7 @@ idb4: 892,
 idb5: 1503,
 idb6: 833,
 idb7: 493,
-dor0: 222,
+dor0: 222,      // internal state: data output register
 dor1: 527,
 dor2: 1288,
 dor3: 823,
@@ -197,7 +192,7 @@ dor4: 873,
 dor5: 1266,
 dor6: 1418,
 dor7: 158,
-pd0: 758,
+pd0: 758,       // internal state: predecode register
 pd1: 361,
 pd2: 955,
 pd3: 894,
@@ -205,5 +200,11 @@ pd4: 369,
 pd5: 829,
 pd6: 1669,
 pd7: 1690,
-h1x1: 1042, // drive status byte onto databus
+notRdy0: 248,   // internal signal: global pipeline control
+cp1: 710,       // internal signal: clock phase 1
+cclk: 943,      // internal signal: clock phase 2
+fetch: 879,     // internal signal
+clearIR: 1077,  // internal signal
+D1x1: 827,      // internal signal: interrupt handler related
+H1x1: 1042,     // internal signal: drive status byte onto databus
 }