{"type":"doc","content":[{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"41e7b2e3-8a97-4101-a3df-bbe0c3d30d54"},"schemaVersion":{"value":"1"},"title":"Excerpt"}},"localId":"8e6650db-4035-4595-9c99-df80563d2ee3"},"content":[{"type":"paragraph","content":[{"text":"This code example performs a simple initialization and AutoProgram based on ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://elprotronic.atlassian.net/wiki/spaces/FPGPM/pages/96732779"}},{"text":" and follows it with an infinite loop that prints Voltage and Current samples from the adapter. For this example code to work properly, the user must be programming with the XStream-Iso, or XStreamPro-Iso (black) adapters.","type":"text"}]},{"type":"paragraph","content":[{"text":"This code sequence is taken from the LinuxCommandLineDemo installation directory for Linux, however, the same sequence of calls will work in other environments:","type":"text"}]},{"type":"paragraph","content":[{"text":"The code sequence is as follows:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Find adapters and perform initialization using ","type":"text"},{"text":"F_OpenInstancesAndFPAs((char *)input.c_str())","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"F_Initialization()","type":"text","marks":[{"type":"code"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In this example, ","type":"text"},{"text":"F_Set_FPA_index (0)","type":"text","marks":[{"type":"code"}]},{"text":" is called, which means that all adapters will be initialized.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select one adapter ","type":"text"},{"text":"F_Set_FPA_index (1)","type":"text","marks":[{"type":"code"}]},{"text":", in this case FPA-1, since the measurement function cannot be called on all adapters.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Read configuration and code files using input parameters, these are paths to local files, ","type":"text"},{"text":"F_ConfigFileLoad( argv[1] )","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"F_ReadCodeFile( argv[2] )","type":"text","marks":[{"type":"code"}]},{"text":" respectively. If the config file already has code paths included, then the latter is not required.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Standard Auto Program and print report message sequence, ","type":"text"},{"text":"F_AutoProgram()","type":"text","marks":[{"type":"code"}]},{"text":" followed by ","type":"text"},{"text":"F_Report_Message()","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The crux of this example is in the last loop. First clear sample history using ","type":"text"},{"text":"F_XS_Clr_ADC_av_history","type":"text","marks":[{"type":"code"}]},{"text":" and repeatedly call ","type":"text"},{"text":"F_Get_Power_Results(xs_adc.members)","type":"text","marks":[{"type":"code"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"xs_adc","type":"text","marks":[{"type":"code"}]},{"text":" will contain the details of the last sample taken.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Some optional code can be added before the loop depending on settings to improve monitoring:","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"c++"},"content":[{"text":"//turn on target if config file did not select \"Start Application Program\"\nF_Power_Target(1); \n\n//tri-state pins to minimize leakage\nF_Set_fpa_io_state( DEFAULT_JTAG_3ST, DEFAULT_RESET_3ST, 1 ); \n\n//XStreamPro-Iso only\n//disable pull-up to minimize leakage\n//max. 10nA leakage\nF_XS_Update_HW_State(MODE_XS_IO_CLR_FLAGS, IO_PULLUP_EN);","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Demo code:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"c++"},"content":[{"text":"#include \n#include \n#include \n\n#ifdef FLASHPROM\n#include \"../FlashProM-Dll.h\"\n#endif\n\n#ifdef GANGPROM\n#include \"../GangProM-Dll.h\"\n#endif\n\nusing namespace std;\n\nunion XS_ADC\n{\n double\tmembers[ XS_ADC_NUM_MEMBERS ];\n struct\n {\n double ExtVcc;\t\t\t\t//actual external Vcc value in V\n double Vcc;\t\t\t\t\t//actual Vcc from programmer value in V\n double Vpp;\t\t\t\t\t//actual Vpp for fuse blown from programmer value in V\n double ExtVccMin;\t\t\t//external Vcc value in V - min value from the last read up to now\n double ExtVccMax;\t\t\t//external Vcc value in V - max value from the last read up to now\n double VccMin;\t\t\t\t//Vcc value in V - min value from the last read up to now\n double VccMax;\t\t\t\t//Vcc value in V - max value from the last read up to now\n double Icc_mA;\t\t\t\t//Icc value in mA - current value\n double Icc_mA_av4;\t\t\t//Icc value in mA - average for last 4 read (interval ~ 10ms)\n double Icc_mA_av16;\t\t\t//Icc value in mA - average for last 16 read (interval ~ 10ms)\n double Icc_mA_min;\t\t\t//Icc value in mA - min value from the last read up to now\n double Icc_mA_max;\t\t\t//Icc value in mA - max value from the last read up to now\n double Temperature;\t\t\t//Temperature inside XStream in C deg\n double Icc_mA_av64;\t\t\t//Icc value in mA - average for alpha 1/64\n double Icc_mA_av;\t\t\t//Icc value in mA - average for defined alpha 1/N\n } data;\n};\n\nint main(int argc, char* argv[])\n{\n int st;\n\n string input = \"*# *\";\n if(argc < 3)\n {\n cout<< \"Usage:

\" << endl;\n    return 1;\n  }\n\n  F_Trace_ON();\n  cout << \"F_OpenInstancesAndFPAs : \" << dec <<   F_OpenInstancesAndFPAs((char *)input.c_str()) << endl;\n  cout << \"F_Get_FPA_SN : \" << F_Get_FPA_SN(1) << endl;\n  cout << \"F_Set_FPA_index : \" << dec << F_Set_FPA_index (0) << endl;\n  cout << \"F_Initialization : \" << dec << F_Initialization() << endl;\n  cout << \"API Version \" << hex << (0xFFF & F_DLLTypeVer()) << endl;\n  cout << \"Multi Version \" << hex << (0xFFF & F_Multi_DLLTypeVer()) << endl;\n  F_Set_FPA_index(1);\n  cout << \"F_ConfigFileLoad : \" << dec << F_ConfigFileLoad( argv[1] ) << endl;\n  cout << \"F_ReadCodeFile : \" << dec << F_ReadCodeFile( argv[2] ) << endl;\n  cout << \"F_Clear_Locked_Device : \" << dec << F_Clear_Locked_Device() << endl;\n  cout << \"F_AutoProgram : \" << dec << F_AutoProgram() << endl;\n  F_Trace_OFF();\n  cout << F_Report_Message() << endl;\n  cout << \"Press any key to continue power measurement in infinite loop\" << endl;\n  char c = getchar();\n\t\n  F_XS_Clr_ADC_av_history();  \n  \n  F_Set_fpa_io_state( DEFAULT_JTAG_3ST, DEFAULT_RESET_3ST, 1 ); \n  F_XS_Update_HW_State(MODE_XS_IO_CLR_FLAGS, IO_PULLUP_EN);\n  \n  XS_ADC xs_adc;\n  while(1)\n  {\n    F_Get_Power_Results(xs_adc.members);\n    cout << \"ExtVcc= \" << xs_adc.data.ExtVcc;\n    cout << \" Vcc= \" << xs_adc.data.Vcc;\n    cout << \" Vpp= \" << xs_adc.data.Vpp;\n    cout << \" ExtVccMin= \" << xs_adc.data.ExtVccMin;\n    cout << \" ExtVccMax= \" << xs_adc.data.ExtVccMax;\n    cout << \" VccMin= \" << xs_adc.data.VccMin;\n    cout << \" VccMax= \" << xs_adc.data.VccMax;\n    cout << \" Icc_mA= \" << xs_adc.data.Icc_mA;\n    cout << \" Icc_mA_av4= \" << xs_adc.data.Icc_mA_av4;\n    cout << \" Icc_mA_av16= \" << xs_adc.data.Icc_mA_av16;\n    cout << \" Icc_mA_min= \" << xs_adc.data.Icc_mA_min;\n    cout << \" Icc_mA_max= \" << xs_adc.data.Icc_mA_max;\n    cout << \" Temperature= \" << xs_adc.data.Temperature;\n    cout << \" Icc_mA_av64= \" << xs_adc.data.Icc_mA_av64;\n    cout << \" Icc_mA_av= \" << xs_adc.data.Icc_mA_av;\n    cout << endl;\n    cout.flush();\n  }\n  return 0;\n}\n","type":"text"}]}]}],"version":1}