ProSoft Technology MVI69-ADM User 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