ProSoft Technology MVI69-ADM - Manual (Page 5)

MVI-ADM ♦ 'C' Programmable Contents
'C' Programmable Application Development Module Developer's Guide
ProSoft Technology, Inc. Page 5 of 342
February 20, 2013
Contents
Your Feedback Please ........................................................................................................................ 2
Content Disclaimer .............................................................................................................................. 2
Important Installation Instructions ....................................................................................................... 3
MVI (Multi Vendor Interface) Modules ................................................................................................ 3
Warnings ............................................................................................................................................. 3
Battery Life Advisory ........................................................................................................................... 4
1 Introduction 13
1.1 Operating System .................................................................................................... 13
2 Preparing the MVI-ADM Module 15
2.1 Package Contents ................................................................................................... 16
2.2 Recommended Compact Flash (CF) Cards ............................................................ 17
2.3 Jumper Locations and Settings ............................................................................... 18
2.3.1 Setup Jumper .......................................................................................................... 18
2.3.2 Port 1 and Port 2 Jumpers ...................................................................................... 18
2.4 Cable Connections .................................................................................................. 19
2.4.1 RS-232 Configuration/Debug Port .......................................................................... 19
2.4.2 RS-232 Application Port(s) ..................................................................................... 19
2.4.3 RS-422 .................................................................................................................... 22
2.4.4 RS-485 Application Port(s) ...................................................................................... 22
2.4.5 DB9 to RJ45 Adaptor (Cable 14) ............................................................................ 23
3 Understanding the MVI-ADM API 25
3.1 API Libraries ............................................................................................................ 26
3.1.1 Calling Convention .................................................................................................. 26
3.1.2 Header File .............................................................................................................. 26
3.1.3 Sample Code ........................................................................................................... 26
3.1.4 Multi-threading Considerations ............................................................................... 27
3.2 Development Tools ................................................................................................. 28
3.3 Theory of Operation ................................................................................................ 29
3.3.1 ADM API .................................................................................................................. 29
3.4 ADM Functional Blocks ........................................................................................... 30
3.4.1 Database ................................................................................................................. 30
3.4.2 Backplane Communications .................................................................................... 30
3.4.3 Serial Communications ........................................................................................... 53
3.4.4 Main_app.c .............................................................................................................. 53
3.4.5 Debugprt.c ............................................................................................................... 54
3.4.6 MVIcfg.c................................................................................................................... 54
3.4.7 Commdrv.c .............................................................................................................. 56
3.4.8 Using Compact Flash Disks .................................................................................... 58
3.5 ADM API Architecture ............................................................................................. 59
3.6 ADM API Files ......................................................................................................... 60
3.6.1 ADM Interface Structure .......................................................................................... 60
3.7 Backplane API Files ................................................................................................ 64
3.7.1 Backplane API Architecture..................................................................................... 64