XSpice_SoftwareDesignDoc_Sep92.pdf

XSpice 设计文档Contents1 Scope1.1 Identification1.2 System Overview1.3 Document Overview1. 4 Acknowledgement2 Referenced documents3 Preliminary Design3.1 CSCl Overview11133577993. 1.1 CSCI Architecture3.1l1 SPiCe 3C1 Architecture3.1.1.1.1 Code Organization103. 1.1.1.2 Code structure113. 1.1.1.3 Data Struct123.1.1.1.4 Static Function pointer Structures133. 1.1.1.5 Static Device Data Structures143. 1.1.1.6 Dynamic Structures3.1.1.1.6.1 Deck structure63.1.1.1.6.2 Circuit Structure3.1.1.1.6.3 Plot Structure183.1.1.1.7 Entry Points183.1.1.1. 8 Make files⊥93.1.1.2 XSPICE Architecture193. 1.1.2. 1 Code Organization203. 1.1.2.2 Code Structure233.1.1.2. 3 Data Structures233. 1.1.2.3. 1 Static Function pointer Structures3.1.1.2.3.2 Static Device Data Structures233.1. 1.2.3.3 Dynamic Structures23CONTENTSXSPICE SimulatorSoftware Design Document3. 1.1.2.3.4 New Global Structures243. 1.1.2. 4 Entry Points243.1.1. 2.5 Make Files243.1.2 System States and Modes253. 1.2.1 Program Startup3. 1.2.2 Circuit Description Read-in283.1.2.3 Subcircuit Expansion283. 1.2.4 Circuit Description Parsing3. 1.2.5 Command Processing293. 1.2.6 Simulation Setup3.1.2.7 Simulation Execution3. 1.2.8 Results Output3. 1.2.9 Program Exit323. 1.3 Memory and Processing Time Allocation323.2 CSCI Design Description333.2.1 Model Interf333.2. 1 1 Example code mode353.2.1.2 Circuit Description Syntax363.2. 1.2.1 Use of Parentheses373.2.1.2.2 Node Names373.2.1.2.3 Instance Parameters::4····373.2.1.2, 4 Vector Ports373.2. 1.2.5 Connection Types373.2.1.2.5. 1 Basic Analog Types3.2. 1.2.5.2 Bidirectional Analog Types33.2. 1 2.5.3 Digital and User-Defined Types383.2.1.2.5.4 Overriding default Port Types3.2.1.2.5.5 Mixing Types393212.5.6 The NULL Type.,..,·,..,,403.2 1.2.6 Model Names403.2. 1.2.7 Parameter values403.2.1.3 Interface Specification413.2.1.3.1 Name Table423.2.1.3.2 Port Table...433.2.1.3.2.1 Port name......,433. 2.1.3.2.2 Direction433.2. 1.3.2.3 Default Type433.2. 1.3.2.4 Allowed Types443.2.1.3.25 Vector,,443. 2.6 Vector Bounds..,,,,,,443.2.1.3.2.7 Null allowed.,,453.2.1.3.2. 8 Description45XSPICE SimulatorCONTENTSSoftware Design Document3.21.3. 3 Parameter Table453.21.3.3. 1 Parameter Name453.2. 1.3.3.2 Description453.2. 1.3.3, 3 Data Type463.2.13.3Default value3.2.1.3.3.5 Limits..4632.1.3.3.6∨ecte463.2. 1.3.3. 7 Vector bounds473.2.1.3. 3.8 Null Allowed473.2.1.4 C Function and Accessor Macros3.2.1.4. 1 Design Approach .............. 473.2.1. 4.2 Access macros493.2.1.4.2.1 Circuit Data Macros32.1. 2,2 Parameter Data503, 2.14.2.3 Port Data Macros513.2.1.4.2.4 Input Data Macros513.2.1.4.2.5 Output Data Macros513.2.1. 4.2.6 Partial Derivative macros523.2.1.42.7 AC Gains523.2.1.4.2.8 Static Variable macros523.2. 1.5 Model Interface Implementation533.2.1.5.1 Device Models533.2.15.2 Data Structures and Functions533.2.1.5. 3 Syntax Parsing553.2.1.5.4 Matrix Load Equations563.2. 1.5.4.1 Newton-Raphson Iteration563.2.1.5.4.2 Modified Nodal Analysis Formulation563.2.1.5. 4.3 Matrix Load Functions573.2.1.5.4.4 Functions with Current Source Outputs ,. 583.2.1.5.4.5 Functions with Voltage Source Outputs3. 1.5.5 Analog Simulation States and Integration593.2.2 Code Model Suppor613. 2.2.1 Adding Breakpoints613.2.2.2 Output of messages613.2.2.3 Allocating Local Storage623.2.2. 4 Accessing Local Storage633.2.2.5 Truncation Error Timestep Control643.2.2.6 Integratio643.2.2.7 Complex Math Computation653.2.28 Automatic Partials653.2.3 Event-Driven simulation663.2.3.1 Circuit ParsingCONTENTSXSPICE SimulatorSoftware Design Document3. 2. 3.2 DC Convergence673.2.3.3 Transient Analysis algorithm683.2.3.4 AC Analysis693.2 3.5 Sources.693.2.3.6 Display of results693.2.3.7 Digital States and Strengths703.2.3. 8 Access macros703.2.3.8.1 Input and Output Macros703.2. 3.8.2 Output Delay Macro713.2.3.8.3 Loading Macros3.2.3.8.4 Output Message Macro3.2.3.9 Support Functions3.2.3. 10 Use of NUll in Vectors723. 2. 4 Enhancements.,.,.......723.2.4.1 Adding new options3.2.4.2 Arbitrary Phase Sources743.2.4.2.1 Parsing Modifications743.2. 4.2.2 Device Function Modifications743.2.4.3 Supply Ramping753.2.4.4 Convergence Limiting763.2.4.5 Convergence Debug Reporting3.2.4.6 Resistors to ground3.2.5 Internal Code Models.793.2.6 Internally Defined Nodes793. 2.7 Interprocess Communication803.2.7.1 SPICE 3C1 Program Modifications813.2.7.1.1 Modifications to inp-spsourceO Subtree823.2.7. 1.2 Modifications to ft_dotsaves( Subtree........ 823.2.7.1.3 Modifications to ft_dorun( Subtree823.2.7.1. 4 Modifications to ft-cktcoms Subtree........ 823.2.7.2 Sending Results Delimiters823.2. 7 3 Selecting Data to Return833. 2.7. 4 Returning Results833.2.7.5 Modifications to Begin Plot843.2.7.5. 1 Voltages and v Source currents843.2.7.5.2 Device Currents.,,,,.,,,,.,,,,,3.2.7.5.3 Parameter names for device types4 Detailed Design8了4.1 Model Interface4.1.1 Function MIF_NP2A894.1.1.1 Static Function MlFinit _inst92XSPICE SimulatorCONTENTSSoftware Design Document4.1.1.2 Static Function MIFget-port_type4.1.1.3 Static Function MIFget-port944. 1.2 Function MIFgetMod974.1.3 Function MIFget Value994.1.4 Function MIFgettok1014.1.5 Function MIFget-token1024. 1.6 Function MIFget-cntl-src_type1044.1.7 Function mifm Param1054.1.8 Function MiFmAsk1074.1.9 Function MIFask4.1.10 Function MIFsetup,,,,,,,,,,,,,,,,,,,,,1094.1.11 Function MIFI1124.1.11.1 Static Function MiFauto-partial ..........,.... 1174.1. 12 Function MIFconv Test1204.1.13 Function MIFtrunc1224.1.13. 1 Static Function MIFterr1234. 1.14 Function MiFmDelete1244.1.15 Function MIFdelete1251.16 Function MIFdestroy1264.2 Code Model Support4.2.1 Function cm_analog -alloc1284, 2.2 Function cm. analog-get-ptr1304.2.3 Function cm_ integrate1314.2.3. 1 Static Function cm_static_integrate1334.2.4 Function cm- -converge1344.2.5 Function cm____bkpt1364.2.6 Function cm analog-set-perm-bkpt1384.2.7 Function cm_ramp-factor1404.2.8 Function cm analog__converged1424.2.9 Function cm-analog-auto-partial1434.2.10 Function cm_message-get-errmsg1444. 2. 11 Function cm_message_send1454.2.12 Function cm_event_alloc◆命1464.2.13 Function cm_event-get-ptr1484.2.14 Function cm_event-queue···+······《1504.2.15 Function cm_netlist-getc.,1514.2.16 Function cm. netiist-get_I4.2.17 Function cm_smooth_corner4.2.18 Function cm_smooth_discontinuity1564.2.19 Function cm.climit- fcn1574.2.20 Function cm_smooth-pwh1584.2.21 Function cm_complex_set159CONTENTSXSPICE SimulatorSoftware Design Document4.2.22 Function cm_complex_add1604.2.23 Function cm_complex- subtract614.2.24 Function cm_complex_multiply1624.2.25 Function cm_complex_divide,,,,1634.3 Event- Driven Simulation·······鲁1644.3.1 Function EVTaccept1664.3.2 Function EVTbackup1694.3.2.1 Static Function EVTbackup-node_data1714.3.2.2 Static Function EVTbackup- state-data1734.3.2.3 Static Function EVTbackup-msg_data1744.3.2.4 Static Function EVTbackup_inst_queue1754.3.2.5 Static Function EVTbackup-output-queue1774.3.3 Function EVTcall-hybrids1794.3.4.1 Static Function EVT dequeue-output4.3.4 Function EVTdequeue.180...,,,..1814.3.4.2 Static Function EVTdequeue_inst1834.3.4.3 Static Function EVTprocessoutput ....,.........1854.3.5 Function EVTinit1874.3.5.1 Static Function EVTcheck_nodes1884.3.5, 2 Static Function EVT count -hybrids1894.3.5.3 Static Function EVTinit_info1904.3.5.4 Static Function EVTinit-queue1924.3.5.5 Static Function EVTinit_limits1934.3.6 Function EVTiter944.37 Function EVTload197437.1 Static Function evtcreate state4.3.7. 2 Static Function EVTadd-msg4.3.7. 3 Static Function EVTcreate_output_event2044.3.7.4 Static Function EVT process_output2064.3.8 Function EVTnext-time普甲寺2084.3.9 Function EVTnode- copy2094.3.10 Function EVTop..,...2114.3. 11 Function EVTop_save2134.3. 11.1 Static Function EVTnode-compare2154.3.12 Function EVTprint2164.3. 12.1 Static Function get_index2184.3.12.2 Static Function print_data21g4.3.13 Function EVTdump2204.3.13.1 Static Function EV send_ line2234.3. 14 Function EVTqueue_output2244.3.15 Function EVT queue_inst,,2264.3.16 Function EVTsetup228XSPICE SimulatorCONTENTSSoftware Design Document4.3.16.1 Static FuEVTssetup-queue2304.3.16. 2 Static Function EVTsetup_data2314.3.16.3 Station EVTsetup」jol2334.3.16. 4 Static Function EVTsetup_ load-ptrs2344.3.17 Function EvTterminsert,,.,,,·,,,,,,,2354.3.17. 1 Static Function EVTinst_ insert2364.3.17.2 Static Function EVTnode _insert2374.3.17. 3 Static Function EVTport_insert2394.3.17. 4 Static Function EVToutput-insert2404. 4 Enhancements2414.4.1 Function ENHreport-canv-Prob2424.. Function ENHtranslate-poly2434.4.2.1 Static Function needs_translating2444.4.2.2 Static Function count_ tokens2454.4.2.3 Static Function translate.......,,,,.,,...2464.4.2.4 Static Function get-poly-dimension2474.5 Internal Code models2484.5.1 Function icm_poly2494.5.1.1 Static Function evterm2514.5.1.2 Static Function nxtpwr2524.6 Internally Defined Nodes2544.6.1 Info Structure idn_digital_info2554.6.1.1 Function idn_digital_create2564.6. 1.2 Function idn-digital_dismantle2574.6. 1.3 Function idn -digital_initialize2584.6. 1.4 Function idn_digital_invert·2594.6.1.5Functian idn_digital_copy2604.6. 1.6 Function idn_digital_resolgve2614.6. 1.7 Function idn__compare2634.6. 1.8 Function idn-digital-plot_val2644.6.1.9 Function idn-digital-print -val4.6. 1.10 Function idn_digital_ipc-val2652674.7 Interprocess Communication2684.7. 1 Function ipc_initialize_server甲带鲁曾毒2694.7.2 Function ipc_terminate_server·······2704.7.3 Function ipc-get_ line2714.7. 4 Function ipc_send_line2734.7.5 Function ipc_send__binary,.,...........2744.7.6 Function ipc_ _send-data_prefix.2754.7.7 Function ipc_send-data__suffix2764.7.8 Function ipc_send_dcop-prefix2774.7.9 Function ipc_send_depf乐fx278CONTENTSXSPICE SimulateSoftware Design Document4.7.10 Function ipc_send_evtdict-prefix2794.7.11 Function ipc_send_evtdict-suffix和鲁2804.7.12 Function ipc_send_evtdata-prefix2814.7. 13 Function ipc_send_evtdata-suffix2824.7. 14 Function ipc send -errchk2834.7.15 Function ipc send_end2844.7. 16 Function ipc send -double2854.7.17 Function ipc__send_complex2864.7.18 Function ipc_send-event2874.7.19 Function ipc_flush2894.7.20 Function ipc -handle- stop2904.7.21 Function ipc_handle_returni2914.7.22 Function ipchandle_mintime2924.7.23 Function ipc_handle_vtrans34.7.2 Function ipc_send-std-files2944.7.24. 1 Static Function ipc_send-stdout2954.7.24.2 Static Function ipc_send_stderr2964.7.25 Function ipc_screen_name4.7.26 Function ipc-get_devices2994.7.27 Function ipc__devices .........,..........3014. 7.28 Function ipc_check_pause_stop47.29 BSD UNIX Sackets Transport Layer··.3023034.7. 29.1 Function ipctransport- initialize_server............. 3044.7.29.2 Function ipc-transport -get_line3064.7.29.3 Function ipc-transport send -line ...........,... 3084.7. 29 4 Function ipc___server.3094.7. 30 HP/Apollo Mailbox Transport layer3104.7. 30.1 Function ipc_- initialize_server3114.7. 30.2 Function ipc-transport-get_line3134.7.30. 3 Function ipc- transport__send -line3154.7.30.4 Function ipc_transport _terminate_server3165 CSCI Data3175.1 Interface to Code Modef Libraries3175.1.1 Interface Specification Data3185.1.2 C Function Data.3215.1.3 Linker Include data3245.2 Interface to User Defined Node libraries3245.2.1 C Function Data3245.2.2 Linker Include data3265.3 Model and Instance Data Structures3265.4 Event-Driven Simulation Data328v