background image

  

 

 

API-FDX

 

 

Linux 

Getting Started 

Manual 

 

ARINC664 Interface Module 

 

API-FDX-2 V2 (PCI Version) 

April 2007 

V14.3x  Rev. A

 

AIM GmbH 

Sasbacher Str. 2 

79111 Freiburg, Germany 

 

Tel:  +49-761-45229-0 

Fax:  +49-761-45229-33 

 

[email protected] 

www.aim-online.com

 

 

Summary of Contents for API-FDX-2 V2

Page 1: ...ng Started Manual ARINC664 Interface Module API FDX 2 V2 PCI Version April 2007 V14 3x Rev A AIM GmbH Sasbacher Str 2 79111 Freiburg Germany Tel 49 761 45229 0 Fax 49 761 45229 33 sales aim online com...

Page 2: ......

Page 3: ...GmbH API FDX Linux Getting Started Manual ARINC664 Interface Module API FDX 2 V2 PCI Version V14 3x Rev A April 2007 60 15920 35 143X A...

Page 4: ...khorn NE 68022 866 AIM 1553 866 AIM A429 salesusa aim online com AIM UK Lincoln Rd Cressex Business Park Bucks HP12 3RB England 44 1494 44 68 44 salesuk aim online com Notice The information that is p...

Page 5: ...sion Cover Date Created by Description V14 33 April 2007 M Melcher General Updates Adaptations to Kernel Versions 2 6 17 V13 11 May 2006 M Pietrek Cross compilation added V13 10 April 2006 M Pietrek S...

Page 6: ...iv GmbH THIS PAGE IS INTENTIONALLY LEFT BLANK...

Page 7: ...NSTALLATION OF THE DRIVER 19 8 PROGRAMMING THE API FDX MODULE 21 8 1 Sample API FDX 2 4 Source Code 21 8 1 1 Include the AyI FDX Header File 21 8 1 2 Basic Library Functions and AIM Resource Login 21...

Page 8: ...vi GmbH A DOWNLOADING THE BSP FROM AIM ONLINE 37...

Page 9: ...SP provides users with current documentation board drivers and sample development projects The current version of all BSPs is available from the DOWNLOAD AREA of the AIM website at http www aim online...

Page 10: ...FDX BSP installed Section 4 BSP UPGRADE PROCEDURE describes the procedure used to upgrade the BSP software and the API FDX onboard flash firmware on a system that has a previous API FDX BSP installed...

Page 11: ...tween the words indicates that you should enter the key simultaneously for example Ctrl Alt Del Bold text a parameter menu item return value function panel item or dialog box button or option Bold Blu...

Page 12: ...erface Library provides the AFDX application developer with the detailed API ACI AMC FDX library function calls This guide is to be used in conjunction with the API ACI AMC FDX Programmer s Guide for...

Page 13: ...ion 2 Requirements 2 REQUIREMENTS To install the BSP your system must meet the following requirements A linux 2 4 or 2 6 kernel configured to provide module support make 3 80 gcc 3 x or gcc 4 x a free...

Page 14: ...6 API FDX Linux Getting Started Manual GmbH Section 2 Requirements THIS PAGE IS INTENTIONALLY LEFT BLANK...

Page 15: ...d drivers sample development projects These files are automatically loaded onto the system by installing the BSP software package The firmware upgrade utility files are not installed on the system The...

Page 16: ...efore installation The hardware installation is completed by performing the steps as described below To install the API1 FDX board ESD Warning The API FDX boards are typical electronic devices that ar...

Page 17: ...eruser with su 4 Run sh install sh to install the BSP and then compile and install the kernel driver 5 The script will ask you for your default Runlevel The AFDX kernel module will be automatically st...

Page 18: ...stallation successful have fun home melcher apifdx linux bsp 14 33 The installation will create these files on your system etc init d aim_fdx The startup script that loads the driver and sets system p...

Page 19: ...Started Manual 11 GmbH Section 3 New BSP and Hardware Installation Procedure 3 3 Update the Onboard Flash Firmware The installation script updates all boards to the correct firmware version A manual u...

Page 20: ...ation To deinstall the BSP cd into apifdx linux bsp 13 00 and run sh install sh uninstall This will remove all the files created during the installation home melcher apifdx linux bsp 14 33 sh install...

Page 21: ...led This procedure describes the steps which must be taken to upgrade both the host PC driver software and the onboard target driver software The BSP is available on CD from AIM or via a download from...

Page 22: ...14 API FDX Linux Getting Started Manual GmbH Section 2 Requirements THIS PAGE IS INTENTIONALLY LEFT BLANK...

Page 23: ...subdirectory samples and run make s The binaries will be located then in obj In order to debug the applications run make s inside obj_dbg melcher cd apifdx linux bsp 14 33 samples obj melcher apifdx...

Page 24: ...16 API FDX Linux Getting Started Manual GmbH Section 6 Recompilation and Reinstallation of the driver THIS PAGE INTENTIONALLY LEFT BLANK...

Page 25: ...quire that both ports of the FDX Board are connected by a crossover cable They should be run if there are any bogus problems with the BSP The tests include displaying and checking the BSP individual c...

Page 26: ...18 API FDX Linux Getting Started Manual GmbH Section 6 Recompilation and Reinstallation of the driver THIS PAGE INTENTIONALLY LEFT BLANK...

Page 27: ...module may be necessary if the kernel configuration has changed fundamentally e g either a different kernel version is used or the kernel is switched from uniprocessor to SMP To rebuild the driver go...

Page 28: ...20 API FDX Linux Getting Started Manual GmbH Section 7 Recompilation and Reinstallation of the driver THIS PAGE INTENTIONALLY LEFT BLANK...

Page 29: ...AyI FDX resources and login to local board and ports bool MyFdxInit DWORD dwTmp bool bRetSuccess false bool bFoundLocalServer false TY_SERVER_LIST px_ServerNames NULL TY_SERVER_LIST px_TmpServer TY_RE...

Page 30: ...rts if bFoundLocalServer if FdxQueryServerConfig local pRLEHead FDX_OK pRLE pRLEHead while pRLE NULL login to resources switch pRLE ul_ResourceType case RESOURCETYPE_BOARD if g_ulBoardHandle 0 if FdxL...

Page 31: ...Head NULL FdxCmdFreeMemory pRLEHead pRLEHead ul_StructId free the server list if px_ServerNames NULL FdxCmdFreeMemory px_ServerNames px_ServerNames ul_StructId define it as success if we have valid ha...

Page 32: ...X_MAX_BOARD_PORTS i x_BoardCtrlIn aul_PortConfig i FDX_SINGLE x_BoardCtrlIn aul_ExpertMode i FDX_DISA_GHOST reset board initialize ports to Single ports FdxCmdBoardControl g_ulBoardHandle FDX_WRITE x_...

Page 33: ...FDX Ports void MyFdxResetPort TY_FDX_PORT_INIT_IN x_PortInitIn TY_FDX_PORT_INIT_OUT x_PortInitOut if g_ulPort1Handle 0 x_PortInitIn ul_PortMap 1 FdxCmdTxPortInit g_ulPort1Handle x_PortInitIn x_PortIn...

Page 34: ...101 Src IP 10 129 33 1 x_UdpDesc x_Quint ul_UdpDst 23 UDP Dest 23 x_UdpDesc x_Quint ul_UdpSrc 24 UDP Src 24 x_UdpDesc x_Quint ul_VlId 60 VL 60 x_UdpDesc ul_SubVlId 1 Sub VL 1 x_UdpDesc ul_UdpNumBufMes...

Page 35: ...ogramming the API FDX Module Write message to UDP Port on Sub VL 2 if g_Udp2Port1Handle NULL sprintf pBuf Testing UDP Port on Sub VL 60 Sub VL 2 uiBufLen strlen pBuf FdxCmdTxUDPWrite g_ulPort1Handle g...

Page 36: ...X_DIS My_Frame x_Frame x_FrameAttrib uc_FrameStartMode FDX_TX_FRAME_START_PGWT My_Frame x_Frame x_FrameAttrib uc_PayloadBufferMode FDX_TX_FRAME_PBM_STD My_Frame x_Frame x_FrameAttrib uc_PayloadGenerat...

Page 37: ...t 43 0x42 Dt 44 0x43 Dt 45 0x44 Dt 46 0x45 Dt 47 0x46 Dt 48 0x47 Dt 49 0x48 Dt 50 0x49 Dt 51 0x4a Dt 52 0x4b Dt 53 0x4c Dt 54 0x4d Dt 55 0x4e Dt 56 0x4f Dt 57 0x50 Dt 58 0x51 for i 0 i 58 i My_Frame u...

Page 38: ...35 0x22 UDP Dest Port 33 Dt 36 0x00 Dt 37 0x21 UDP Length 25 Dt 38 0x00 Dt 39 0x19 UDP Checksum Dt 40 0x00 Dt 41 0x00 Payload Dt 42 0x41 Dt 43 0x42 Dt 44 0x43 Dt 45 0x44 Dt 46 0x45 Dt 47 0x46 Dt 48 0...

Page 39: ...dle x_VLControl x_VLDesc Create a UDP sampling port to receive messages x_UdpDesc ul_PortType FDX_UDP_SAMPLING x_UdpDesc x_Quint ul_IpDst 0xe0e0003c Dest IP 224 224 0 60 x_UdpDesc x_Quint ul_IpSrc 0x0...

Page 40: ...rono Mode x_ModeCtrlIn ul_ReceiveMode FDX_RX_CHRONO x_ModeCtrlIn ul_DefaultPayloadMode FDX_PAYLOAD_FULL x_ModeCtrlIn ul_DefaultCronoMode FDX_RX_DEFAULT_MON_ENA_ALL x_ModeCtrlIn ul_GlbMonBufferSize 0 F...

Page 41: ...iver void MyFdxStop TY_FDX_TX_CTRL x_TxControl TY_FDX_RX_CTRL x_RxControl Stop the receiver x_RxControl ul_StartMode FDX_STOP x_RxControl ul_GlobalStatisticReset FDX_RX_GS_RES_ALL_CNT FdxCmdRxControl...

Page 42: ...arted Manual GmbH Section 8 Programming the API FDX Module FdxCmdRxUDPDestroyPort g_ulPort2Handle g_pUdp1Port2Handle if g_pUdp2Port2Handle NULL FdxCmdRxUDPDestroyPort g_ulPort2Handle g_pUdp2Port2Handl...

Page 43: ...Compact PCI CVI C Language Virtual Instrument DLL Dynamic Link Library ESD Electrostatic Discharge FDX Full Duplex Switched Ethernet MIL STD Military Standard NT New Technology Microsoft OS Operating...

Page 44: ...36 API FDX Linux Getting Started Manual GmbH Section 9 Notes THIS PAGE INTENTIONALLY LEFT BLANK...

Page 45: ...the API FDX BSP from AIM Online 1 Go to http www aim online com The aim online com main web page appears 2 Click the DOWNLOAD AREA selection The page shown below will appear 3 If you are already a re...

Page 46: ...from AIM Online To download the BSP 1 Select the BSP Software button with or without manuals This brings up a File Download dialog box 2 Select the Save this Program to Disk option 3 Choose the destin...

Page 47: ...KERNEL_DIR arch ppc export MAKEFLAGS LOCAL_LIBRARY y KERNEL_DIR tells what kernel to use instead for cross compilation EXTRA_CFLAGS DDONT_USE_HIGH_PERF_COUNTER is used in library and applications to...

Page 48: ...40 API FDX Linux Getting Started Manual GmbH Appendix B Cross Compilation THIS PAGE INTENTIONALLY LEFT BLANK...

Reviews: