Gryphon C/C++ Libraries Release Notes

Release ID: 4.2
Release Date: September 14, 2005

Changes Since Prior Release

This document discusses changes made since Release 4.1.1.

C++ Library:

  1. Enhancement. in dgGryphon::RecvFrame(), now allows access to oldest frame in buffer, with the exception of FT_RESP frames. If dgGryphon::RecvFrame() is called with a dgFrame*, it will NOT return a FT_RESP frame; it will only return the FT_RESP frame if called with a dgRespFrame*.
  2. Enhancement: in dgUSDT::SetIdBlock(), prior limitation of 2 Id block specifications removed; limit is now 64 Id block specifications. Includes ability to change or delete previously added Id block specifications.

C (& VB) Library:

  1. Enhancement. in dgRecvFrame(), as per changes to C++ library noted above.
  2. Enhancement: in dgSetIdBlock(), as per changes to C++ library noted above.

VB specifics:

None.

C++ Library User's Manual:

  1. Modifed  "Remarks" section of dgGryphon::RecvFrame().
  2. Modifed  "Remarks" section of dgUSDT::SetIdBlock().

C Library User's Manual:

    1. Modifed "Remarks" section of dgRecvFrame().
    2. Modifed "Remarks" section of dgSetIdBlock().

    Unix Support:

    Test build of libraries and sample application performed on:
    Gryphon-embedded test execution on "GRYPHON_20041216" firmware, with patches A, B, & C.

    Known Issues in this Release

    1. The Win32 installer program does not always completely uninstall:
      1. Windows XP Home Edition Version 2002 SP1: dlls not removed from the system folder.
    2. When running a program in the MS Visual BASIC 6 IDE, any session that is started by successfully calling dgBeginSession must be ended by calling dgEndSession before exiting the program.  Failure to do so may crash the Visual BASIC IDE.
    3. In Visual BASIC 6, the callback mechanism (dgSetOnRx) works when application runs in IDE, but crashes when application runs as an 'exe'. An alternative to using callbacks is to use polling (dgRecvFrame()) driven by timer events.
    4. For Visual BASIC programs running in the VB 6 IDE: when using the callback mechanism (dgSetOnRx), the IDE may crash when a larger number of callbacks occur.

    Build Notes

    1. The C library uses RTTI. If you use the C library you may need to enable RTTI for your application for "debug" builds.
    2. When using the C library in a C++ program, and building with a non-Microsoft compiler, be sure the "__cplusplus" preprocessor macro is defined to ensure the proper linkage.
    3. The current version of the Gryphon C library is dependent on the current version of the Gryphon C++ Library; it is not compatible with any prior version of the Gryphon C++ Library.
    4. In order to eliminate memory management problems in the run-time libraries, we recommend the following choices in the Visual Studio "Project Settings" (MSVC 6.0):
    J O'Callaghan