User Guide for O-NET MOFA Sim Tools(ver 1.0 Aug 4,2008).doc

User Guide for O-NET MOFA Sim Tools (DLL, Win32 Console and GUI Application)Revision 1.0Bichang HuangAug 04, 2008O-Net Confidential2June 20, 2001Innovance Networks ConfidentialTable of Contents1Introduction32Win32 console application33GUI application33.1 Function control43.2GUI application operation step74DLL call75Appendix85.1 Appendix 185.2 Appendix 2105.3 Appendix 312Table of FiguresFigure 1 The main form of GUI4Figure 2 Input file path setting5Figure 3 Output file path setting5Figure 4 Gain and NF display6Figure 5 Resolution setting61IntroductionThe EDFA simulation tools are aim to facilitate system simulation and design, it is capable of accurately predicting the performance of EDFA, such as gain and noise figure. The tools are composed of three blocks: a Win32 console mode application, a dynamic link library link (DLL) and a graphical user interface (GUI) application. This document describes the function and user guide for these blocks. The tools include 5 types of files, they are:1) Win32 console application file: O-NET_MOFA_Sim.exe2) DLL files: oac3ont.dll3) GUI application files: mofa.mdb and O-NET MOFA Sim.exe4) Public files Please note that all the public files must be kept unchanged, or error results will be generated at running anyone of all the programs.:101.NET, 102.NET, 103.NET 104.NET 105.NET and WinOASIXdll.dll5) Sample input files: amp.in, BA.in, 25_9PA.in, and 31_9PA.in2Win32 console application Before running the Win32 console program, the Win32 console application file and all the public files must be put into the same directory path.This application reads data from standard input file (5.1 Appendix 1) and generates output data to another standard file (5.2 Appendix 2). The command line I/O re-direction command (using “”) will allow the input and output to be directed from or to the files, e.g.O-NET_MOFA_Sim amp.outDirectory path of input file and output file is changeable, just by adding the path before the file.O-NET_MOFA_Sim d:amp.out3GUI application Before running the GUI application, all the public files and all the DLL files with the mofa.mdb must be put in the same directory path.The first window appears upon starting is show in Figure 1, when running O-NET MOFA Sim. This window can be divided into three parts, the simulation result graphically displayed on left top, simulation result displayed in table format bellow, and the function control panel on the right top.Figure 1 the main window of GUI3.1Function controlThe function control panel provides some simple button and radio group accessible to most of the functions. The main function include：l File Path selectl Plotl Runl Exitl Resolution set File Path selectThe input file and output file directory path and file name is changeable. The default value for input file is current directory path appended by file name “amp.in”. If you want to change the input file path or file name, you can directly edit it or press “Open.” button to select one. Clicking the button will call out a new window shown as Figure 2.Select the right path and file, then click “OK”. Output file directory path and file name could be set in the same way, except that the output file name could only be filled by hand, as shown in Figure 3. Figure 2 Input file path settingFigure 3 Output file path setting PlotThere are three items in radio group:l Gain and NF, l Output Power Spectruml Input Power SpectrumThe default setting is to display the Output Power Spectrum. When the Output Power Spectrum radio checked, the chart will update to display output optical spectrum for signal and ASE. Bottom axis is wavelength in nm, with a range of 1510-1570nm. Left axis is power in dBm, integrated in resolution band width (RBW). When Input Power Spectrum radio checked, the chart will update to display input optical spectrum of signal and ASE. When Gain and NF radio checked, the chart will update to display gain and NF shown in Figure 4. Figure 4 Gain and NF display RunWhen click on the Run button, the GUI will read the input file and begin to simulate. ExitWhen click on the Exit, the GUI application will be closed. Resolution setThe resolution is changeable. The default value is 0.2nm, shown as Figure 5. If is necessary to change, the user is able to set the value by selecting the listed items.Figure 5 Resolution setting3.2 GUI application operation stepUseless data will be generated if you did not set parameters correctly. Instruction and operation steps are shown below.1. Set file path2. Run3. Choose plot radio4. Redo above step (1-3) if necessary5. Exit4DLL call Before calling the DLL function, all the public files and DLL file must be put on the same directory path.The DLL file is oac3ont.dll. Its DLL call function is oac3ont(), string “ont” is the abbreviation of O-NET. The function oac3ont has two parameters: input file (char * ch1), output file(char * ch2). These two parameters are composed of file path and file name, such as “c: simulation amp.in”. The data type is char *. If the DLL calling is successful, the function oac3ont will return 0; and if the calling fails, it will return -1. A sample program is provided in (5.3 Appendix 3), the program demonstrates the DLL call application.5Appendix5.1Appendix 1 Example input file:EDFA_TYPE=Pre_metro_25 There are only three kinds of EDFA type are provided; they are “25_9PA.in”, “31_9PA.in” and “BA.in”.PORT=INPUT_PORT151532.68 -10.22211534.25 -10.22211535.82 -10.22211537.4 -10.22211538.98 -10.22211540.56 -10.22211542.14 -10.22211543.73 -10.22211545.32 -10.22211546.92 -10.22211548.51 -10.22211550.12 -10.22211551.72 -10.22211553.33 -10.22211554.94 -10.2221 1510 1570 10.000010.000020.000030.000040.000050.000060.000070.000080.000090.00010.000110.000120.000130.000140.000150.000160.000170.000180.000190.00010.000210.000220.000230.00020.000250.000260.000270.000280.000290.00030.000310.000320.000330.000340.000350.000360.000370.000380.000390.00040.00020.000420.000430.000440.000450.00030.000470.000480.000490.00050.000510.000520.000530.000540.000550.000560.000570.000580.000590.00060.000610.000620.000630.000640.000650.000660.000670.000680.000690.0007PORT=PUMP_PORT1980 25.314785.2Appendix 2Example output file:PORT OUTPUT_PORT151532.6800549.1040101534.2500008.9447271535.8199468.7452981537.4000248.5971901538.9799808.5302141540.5600598.5340261542.1400158.5562911543.7299808.5695651545.3199468.5658711546.9200448.5499251548.5100108.5297511550.1199958.5116061551.7199718.5007211553.3299568.4961801554.9399418.492844 1510.0000001570.0000001.0000000.0000660.0000790.0000960.0001160.0001400.0001710.0002130.0002670.0003420.0004480.0006030.0008430.0012250.0018390.0028190.0043510.0066390.0098560.0140130.0111800.0225500.0232860.0236120.0213100.0244570.0241540.0245260.0247270.0251570.0258440.0266310.0274490.0283470.0292090.0301060.0307420.0314010.0321640.0327810.0334930.0184670.0348230.0355470.0363150.0370540.0259240.0386780.0394290.0399260.0406240.0408730.041