User's Manual
Table Of Contents
- Table of Contents
- Table of Figures
- 1. System Description
- 1.1. IS-900 Configuration
- 1.2. IS-900 SimTracker & VETracker Processor
- 1.3. SoniStrips, SoniFrame, SoniWing & SoniPod acoustic pulse transmitters
- 1.4. Acoustic Constellation Mounting Considerations
- 1.5. Tracking Station Description
- 1.6. IS-900 Cables, Connectors, Adaptors, Power Boosters and Wireless Radios
- 1.7. IS-900 Support CD
- 2. Specifications
- 3. Installation and Set-up
- 4. Interface Communication Protocol
- 5. LCD Status & Settings Screen
- 6. Appendix A – Frequently Asked Questions
- 7. Appendix B – Troubleshooting & Tips
- 8. Appendix C – Health & Safety Warnings with Tracker Use Guidelines
- 9. Appendix D – Care & Maintenance
- 10. Appendix E – ISDEMO Reference
- 11. Appendix F – GENLOCK Synchronization
- 12. Appendix G – Developers Instructions
- 13. Appendix H – Interface Protocol Commands – Quick Reference
InterSense Doc. No. 072-00105-0I07 Rev. 4.2
IS-900 User Guide Page 149 of 177
12. Appendix G – Developers Instructions
For InterSense SDK Version 4.23 or higher.
12.1. Introduction
This document describes the interface to be used by the application software to initialize
and retrieve data from the InterSense devices using the InterSense library (isense.dll /
libisense.so / libisense.dylib). This library and API is provided to simplify communications
with all models of InterSense tracking devices. It can detect, configure, and get data
from up to 32 trackers, which may have multiple (up to 8) stations in some cases, such
as the IS-900 processor. The library maintains compatibility with existing devices, and
also makes the applications forward compatible with all future InterSense products. The
library is intended to be backwards compatible, in the sense that software written for
older versions of the DLL should generally run without recompilation using the current
version.
12.2. Sample Program
The library is distributed with sample programs written in C (all platforms), C# (Windows
only), and Visual Basic (Windows only) to demonstrate usage. It includes a header file
(isense.h) with data structure definitions and function prototypes. Most of the API
description below can also be obtained from the header file. The header file is heavily
commented and contains detailed information about the structures and function calls.
main.c Main loop of the program. All API calls are made from here.
isense.h Header file containing function prototypes and definitions, some of which
are only applicable to InterSense Professional Series devices and are not
used with InterTrax. This file should not be modified.
isense.c DLL import procedures. This file is included instead of an import library to
provide compatibility with all compilers.
isense.dll
libisense.so
libisense.dylib
The InterSense DLL and shared libraries. These files should be placed in
the Windows system directory, system library directory, or in the working
directory of the application (additional configuration may be required on
UNIX platforms).
dlcompat.c
dlcompat.h
Shared object import procedures for Mac OS X, not used on other
operating systems.