manualshive.com logo in svg

SMH Technologies FlashRunner Cube Series, User Manual, Page: 46 / 68

Share
Download
SMH Technologies FlashRunner Cube Series User Manual Download Page 46

FR CUBE API

5

44

The typical program flow for interfacing with FR CUBE is the following:

1. Open communication (

FR_OpenCommPort()

function)

2. Execute commands(

FR_ExeCommand()

function)

3. Transfer files to/from the instrument’s internal memory

(

FR_SendFile()andFR_ReceiveFile()

functions)

4. Close communication(

FR_CloseCommPort()

function)

Function Reference

API functions are listed and explained alphabetically in the following pages.

http://smh-tech.com.cn  [email protected]  +86-15250087885

Summary of Contents for FlashRunner Cube Series

Page 1: ...FlashRunner Cube Series User s Manual http smh tech com cn sales smh tech com cn 86 15250087885...

Page 2: ...http smh tech com cn sales smh tech com cn 86 15250087885...

Page 3: ...DC10476 FlashRunner Cube Series User s Manual Revision 1 3 April 2012 True parallel panel target standalone in system programmer http smh tech com cn sales smh tech com cn 86 15250087885...

Page 4: ...this document or of any information contained herein Should Systein and the user have a separate written agreement with warranty terms covering the material in this document that conflict with these t...

Page 5: ...ations This warranty shall not apply to any defect failure or damage caused by improper use or improper or inadequate maintenance and care Systein shall not be obligated to furnish service under this...

Page 6: ...14 2 Getting Started 15 Guided Tutorial 15 1 Install Software 15 2 Launch the Project Generator 15 3 Create a New Project 16 4 Create a New Project Step 1 of 3 16 5 Create a New Project Step 2 of 3 17...

Page 7: ...Commands 32 Programming Commands 33 Status Commands 34 System Commands 36 Time Commands 37 Volatile Memory Commands 38 4 Standalone Mode 39 Overview 39 Signals 39 Project Assignment 41 5 FR CUBE API...

Page 8: ...ile System Structure 54 7 Variable Data Programming 55 Overview 55 Usage 55 8 Power and Relay Options 57 Power Supply Options 57 Relays 57 9 Connectors 59 ISP Connectors 59 Low Level Interface Connect...

Page 9: ...g 40 FRC_GP_02 ISP Connectors 59 FRC_GP_04 ISP Connectors 59 FRC_GP_08 ISP Connectors 59 Index of Tables FR CUBE Model Comparison 11 ISP Signal Definitions 60 Low Level Interface Signals 61 ATE and Ta...

Page 10: ...http smh tech com cn sales smh tech com cn 86 15250087885...

Page 11: ...industry The programmers support a large number of devices microcontrollers memories CPLDs and other programmable devices from various manufacturers and have a compact size for easy ATE fixture integr...

Page 12: ...ilt in internal memory for projects images etc Programmable power supply output 1 5 13V Programmable I O voltage 1 6 5 5V High speed I O USB LAN isolated RS 232 isolated and low level interface isolat...

Page 13: ...BDM SWD etc UART SPI JTAG I2 C BDM SWD etc Relay Barrier No No No ISP Lines Adj Voltage Range 1 6 5 5V 1 6 5 5V 1 6 5 5V Adj Voltage Resolution 100mV 100mV 100mV Bidirectional Lines 12 24 48 Prog Clo...

Page 14: ...llowing pictures show where depending on the model the various connectors are located FR CUBE GP 02 04 FR CUBE GP 08 1 The POWER connector accepts a DC voltage between 12V and 25V 2 The USB connector...

Page 15: ...SY turns on when programming when a programming project is being executed 4 PASS FAULT result of programming Each programming site has an PASS FAULT LED which turns green if programming on that site h...

Page 16: ...new driver file wnd and an updated license file wnl The license file enables the use of all of your purchased drivers on your specific FR CUBE unit You must copy these files to the unit s internal me...

Page 17: ...FR CUBE programmer and create your first programming project 1 Install Software Insert the Setup CD into your PC and install the FR CUBE software 2 Launch the Project Generator Launch the Project Gene...

Page 18: ...ct Creation Wizard steps 4 Create a New Project Step 1 of 3 In the first Wizard step specify the target device by clicking the Edit button Next specify the file to be programmed image file To create a...

Page 19: ...mage file Use the button to specify the name of the Image file When done click OK to return to the Wizard and proceed to Step 2 5 Create a New Project Step 2 of 3 In this step specify target parameter...

Page 20: ...ode setting allows you to decide how the SxL04 ISP line is driven the x index refers to the programming site see ISP Connectors on page 59 This line can be used as an auxiliary ISP line to provide a c...

Page 21: ...eatures an internal voltage limiter that cuts the voltage output in case of short circuits or overloads The current output is limited to about 400mA The Power up time setting specifies the delay betwe...

Page 22: ...gramming some target devices may provide more than one communication protocol and its related settings usually the communication speed and other parameters Usually the higher the communication speed t...

Page 23: ...elect which programming operation to perform on the target Click Finish to end the Wizard At this point a FR CUBE Programming Project will be created in the Projects directory relative to the Project...

Page 24: ...your FR CUBE model and communication settings with the PC Currently FR CUBE can be connected only through a serial port FR CUBE communicates at 115 200 bps by default LAN and USB connections will be...

Page 25: ...ice Connect FR CUBE to your target system through the ISP connector s To view the connections for your selected target device select Debug Show ISP Connections See the table on page 60 for more detail...

Page 26: ...e Select Debug Run Project The Project file wnp and Image file wni will be automatically uploaded to FR CUBE and the project will be executed Your target device s will be programmed In case of program...

Page 27: ...y the Project Generator but the Project Wizard will not be available Where to Go from Here In this chapter you have learnt how to use the Project Generator to create and execute a typical programming...

Page 28: ...http smh tech com cn sales smh tech com cn 86 15250087885...

Page 29: ...eturn character the programmer interprets and executes the received command depending on the execution of the received command the protocol will answers to the master in three different ways 1 If the...

Page 30: ...is an example of a FR CUBE ERR answer h40000103 n BUSY Answer A BUSY answer is sent by the programmer to the PC if a command take some time to execute A BUSY answer is sent at most every 3 seconds If...

Page 31: ...d using any terminal application For your convenience the Project Generator application includes a Terminal window that will simplify the communication with the instrument Just select Tools FR CUBE Te...

Page 32: ...rument s file system Description Specify the source and destination of the programming data Examples Sets the input image file to be programmed and subsequently programs it data o set c in t file f im...

Page 33: ...To retrieve error messages use the status o get p err v site l errlevel command where site is 1 to 8 to retrieve a specific programming site error or 0 to retrieve a system error errlevel is the erro...

Page 34: ...Full path of a directory filename Full path of a filename Description Allow to perform various operations on the programmer s file system Examples Shows the contents of the programmer s root director...

Page 35: ...tgt addr l len prog o cmd c verify v ver mode m mem type t tgt addr l len prog o cmd c read m mem type s dst addr t tgt addr l len Parameters driver Filename of the wnd driver manufacturer Target dev...

Page 36: ...32 bit code which codifies the following information Bit 31 Reserved Bit 30 If 1 an error message in text format is available Bit 29 If 1 the error is programming site specific Bit 28 If 1 the error...

Page 37: ...site 1 with different error levels status o get p err v 1 l 1 H50000023 status o get p err v 1 l 2 H50000023 71 Connection Error status o get p err v 1 l 3 H50000023 71 Connection Error algo_api 337...

Page 38: ...ect number as selected by the PRJ_SEL 5 0 lines on the Low Level Interface connector prj filename Project file associated to the prj sel setting Description Set or get instrument s internal parameters...

Page 39: ...hh mm ss Description Set or get the instrument s date and time Once set the date and time are maintained even when the instrument is powered off Examples Sets the date time to February 1st 2011 at noo...

Page 40: ...tart address Volatile memory starting address len Data length data A data array Description Read and write data from to the instrument s volatile memory Examples Uses the volatile memory on site 1 to...

Page 41: ...All lines are isolated referenced to GNDI PRJ_SELx lines input Define which project to execute see Project Assignment later on this chapter START_ENAx lines input Select which programming site s to en...

Page 42: ...TART_ENAx START BUSY OK ERRx PRJ_SELx and START_ENAx lines are sampled at the START falling edge and must remain stable until BUSYrising edge OK ERRx lines become valid at the BUSY falling edge Previo...

Page 43: ...roject filename to execute To do so in the FR CUBE Project Generator application select Project Hardware Settings In the window that will appear associate PRJ_SEL values to project names by clicking t...

Page 44: ...http smh tech com cn sales smh tech com cn 86 15250087885...

Page 45: ...the source code of sample applications in various programming languages that use the fr_comm DLL Additionally a command line application fr_cmds exe is provided which reads a programming command from...

Page 46: ...ecute commands FR_ExeCommand function 3 Transfer files to from the instrument s internal memory FR_SendFile andFR_ReceiveFile functions 4 Close communication FR_CloseCommPort function Function Referen...

Page 47: ...HANDLE handle Description Closes the communication channel with the instrument Return Value 0 The function call was successful 0 The function call was unsuccessful Call the FR_GetLastErrorMessage func...

Page 48: ...and FR_GetFrame function in a single call Return Value 0 The function call was successful 0 The function call was unsuccessful Call the FR_GetLastErrorMessage function to get error information Parame...

Page 49: ...and sent by the FR_SendFrame function Return Value 0 The function call was successful 0 The function call was unsuccessful Call the FR_GetLastErrorMessage function to get error information Parameters...

Page 50: ...WINAPI FR_GetLastErrorMessageW wchar_t error_msg unsigned long string_ len Description Returns a string containing the last FR CUBE error message Parameters error_msg The string that will receive the...

Page 51: ...e PC Return Value 0 The function call was successful 0 The function call was unsuccessful Call the FR_GetLastErrorMessage function to get error information Parameters handle Communication handle retur...

Page 52: ...call was successful 0 The function call was unsuccessful Call the FR_GetLastErrorMessage function to get error information Parameters handle Communication handle returned by the FR_OpenCommPort functi...

Page 53: ...ription Sends a command to the instrument Use the FR_GetFrame function to retrieve the answer Return Value 0 The function call was successful 0 The function call was unsuccessful Call the FR_GetLastEr...

Page 54: ...tion channel with the instrument Return Value 0 alid communication handle to use in subsequent functions NULL The function call was unsuccessful Call the FR_GetLastErrorMessage function to get error i...

Page 55: ...u can explore the FR CUBE files either by using a Terminal application and sending file system related commands or more simply by using the File Manager window of the Project Generator application The...

Page 56: ...cts prj files You create programming projects using the Project Generator application images folder contains FR CUBE image files to be programmed to the target wni files FR CUBE image files contain al...

Page 57: ...rogramming This is useful for serial numbering and for any other variable data that needs to be written to the target device at programming time Usage To implement variable data programming 1 Use the...

Page 58: ...ting the project you must supply the variable data to each of the programming sites To do so send the volatile o write command for more information see Volatile Memory Commands on page 38 Alternativel...

Page 59: ...connector see Low Level Interface Connector on page 60 Relays On all FR CUBE models a special signal SxRLY is present on the ISP connector on every programming site If the programming site is enabled...

Page 60: ...http smh tech com cn sales smh tech com cn 86 15250087885...

Page 61: ...ctors FR CUBE GP02 PASS and FR CUBE GP04 PASS models have one ISP connector the FR CUBE GP08 PASS model has two ISP connectors FRC_GP_02 ISP Connector FRC_GP_04 ISP Connector FRC_GP_08 ISP Connectors...

Page 62: ...A8 A12 A16 A4 A8 A12 A16 SxL04 CLOCKOUT Green B1 B5 B9 B13 B1 B5 B9 B13 SxL05 S Chip select Blue B2 B6 B10 B14 B2 B6 B10 B14 SxL06 DI IO0 Serial Data Input Purple B3 B7 B11 B15 B3 B7 B11 B15 SxL07 HO...

Page 63: ...oject Start Enable Input internal pull up B7 B7 B7 START_ENA2 Site 2 Project Start Enable Input internal pull up C7 C7 C7 START_ENA3 Site 3 Project Start Enable Input internal pull up A8 A8 START_ENA4...

Page 64: ...Domains The following diagram illustrates the two ground domains of the programmer ATE and Target Ground Domains In order to avoid undesired current paths between the programmer and the target board...

Page 65: ...0 7 6 0V Operating Ranges Power supply voltage 12 25V ISP SxL0 1 7 voltage 0 5 5V ISP SxPPS voltage 1 5 15V ISP SxPPS current 300mA ISP SxRLY voltage 0 28V Low level interface PRJ_SELx START START_ENA...

Page 66: ...IN41612 connector 3 rows 48 pins 180 female C style Manufacturer Conec Manufacturer Part Number 122A10619X Catalog Part Number Mouser 706 122A10619X For soldering DIN41612 connector 3 rows 48 pins fem...

Page 67: ...http smh tech com cn sales smh tech com cn 86 15250087885...

Page 68: ...N Italy Phone 39 0434 421111 Fax 39 0434 639021 info smh tech com www smh tech com Registered office sede legale V lo del Forno 9 Zip Cap 33170 Pordenone PN Italy Share Capital Capitale Sociale 10 000...

Reviews:

No comments