CLAllAdapter.h 6.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150
  1. //-----------------------------------------------------------------------------
  2. // (c) 2009 by DALSA
  3. // Section: Digital Imaging
  4. // Project: CLProtocol
  5. // Author: Eric Bourbonnais
  6. // $Header$
  7. //
  8. // License: This file is published under the license of the EMVA GenICam Standard Group.
  9. // A text file describing the legal terms is included in your installation as 'GenICam_license.pdf'.
  10. // If for some reason you are missing this file please contact the EMVA or visit the website
  11. // (http://www.genicam.org) for a full copy.
  12. //
  13. // THIS SOFTWARE IS PROVIDED BY THE EMVA GENICAM STANDARD GROUP "AS IS"
  14. // AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
  15. // THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  16. // PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE EMVA GENICAM STANDARD GROUP
  17. // OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
  18. // EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  19. // PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
  20. // OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
  21. // WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  22. // ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  23. // POSSIBILITY OF SUCH DAMAGE.
  24. //-----------------------------------------------------------------------------
  25. /*!
  26. \file
  27. \brief C++ class wrapping CLSerialAll
  28. */
  29. #ifndef CLPROTOCOL_CLALLADAPTER_H
  30. #define CLPROTOCOL_CLALLADAPTER_H
  31. #include <Base/GCBase.h>
  32. #include <CLProtocol/CLAllSerial.h>
  33. #include <CLProtocol/CLException.h>
  34. #include <CLProtocol/CLProtocol.h>
  35. #include <CLProtocol/ISerialAdapter.h>
  36. #include <map>
  37. namespace CLProtocol
  38. {
  39. //! A map holding the pointers to the serial adapters
  40. typedef std::map<GENICAM_NAMESPACE::gcstring, ISerialAdapter *> SerialPortMap;
  41. //! Wraps the CLAllSerial.dll
  42. class CLPROTOCOL_DECL CCLAllAdapter : public ISerialAdapter
  43. {
  44. public:
  45. //! Destroy the factory and all its objects
  46. static void Destroy( ISerialAdapter * pAdapter );
  47. //! \name ISerialAdapter interface
  48. //@{
  49. virtual CLINT32 CLPROTOCOL clSerialRead( CLINT8*,CLUINT32*, CLUINT32);
  50. virtual CLINT32 CLPROTOCOL clSerialWrite(CLINT8 *,CLUINT32 *,CLUINT32);
  51. virtual CLINT32 CLPROTOCOL clGetSupportedBaudRates(CLUINT32 *);
  52. virtual CLINT32 CLPROTOCOL clSetBaudRate(CLUINT32);
  53. virtual CLINT32 SerialInit( void);
  54. virtual void SerialClose( void);
  55. virtual void CheckError( CLINT32 ErrorCode );
  56. //@}
  57. //! used to copy the content of the SerialPort ma to a std::map
  58. static void GetPortIDs(GENICAM_NAMESPACE::gcstring_vector &TheVector);
  59. //! used to copy the content of the SerialPort ma to a std::map
  60. static ISerialAdapter *GetSerialAdapter(GENICAM_NAMESPACE::gcstring PortID);
  61. private:
  62. /*------------------------------------------------*/
  63. // functions of the CLAllSerial DLL
  64. /*------------------------------------------------*/
  65. struct CLAllProxy
  66. {
  67. //! Function pointer to clGetErrorText
  68. CLINT32 (CLALLSERIALCC *m_clGetErrorText)( const CLINT8*, CLINT32, CLINT8*, CLUINT32*);
  69. //! Function pointer to clGetNumPorts
  70. CLINT32 (CLALLSERIALCC *m_clGetNumPorts) ( CLUINT32* Ports);
  71. //! Function pointer to clGetPortInfo
  72. CLINT32 (CLALLSERIALCC *m_clGetPortInfo ) ( CLUINT32 serialIndex, CLINT8* manufacturerName, CLUINT32* nameBytes, CLINT8* portID, CLUINT32* IDBytes, CLUINT32* version);
  73. //! Function pointer to clGetSupportedBaudRates
  74. CLINT32 (CLALLSERIALCC *m_clGetSupportedBaudRates) ( hSerRef serialRef, CLUINT32* baudRates);
  75. //! Function pointer to clSerialClose
  76. void (CLALLSERIALCC *m_clSerialClose) ( hSerRef serialRef);
  77. //! Function pointer to clSerialInit
  78. CLINT32 (CLALLSERIALCC *m_clSerialInit) ( CLUINT32 serialIndex, hSerRef* serialRefPtr);
  79. //! Function pointer to clSerialRead
  80. CLINT32 (CLALLSERIALCC *m_clSerialRead) ( hSerRef serialRef, CLINT8* buffer, CLUINT32* bufferSize, CLUINT32 serialTimeout);
  81. //! Function pointer to clSerialWrite
  82. CLINT32 (CLALLSERIALCC *m_clSerialWrite) ( hSerRef serialRef, CLINT8* buffer, CLUINT32* bufferSize, CLUINT32 serialTimeout);
  83. //! Function pointer to clSetBaudRate
  84. CLINT32 (CLALLSERIALCC *m_clSetBaudRate) ( hSerRef serialRef, CLUINT32 baudRate);
  85. };
  86. static void CheckError( CLINT32 ErrorCode, CLUINT32 SerialIndex, CLAllProxy & );
  87. //! Object constructor
  88. CCLAllAdapter( CLUINT32, CLAllProxy &);
  89. //! Object destructor
  90. virtual ~CCLAllAdapter();
  91. //! handle of the serial port
  92. hSerRef m_SerialRef;
  93. #ifdef _DEBUG // Allow changing serial index to test error situations.
  94. public:
  95. #endif
  96. //! Index of the serial port
  97. CLUINT32 m_SerialIndex;
  98. private:
  99. //! retrieves the list of port mapped by PortID
  100. static void InternalGetPortMap(SerialPortMap &);
  101. static SerialPortMap *g_pSerialPortMap;
  102. //! handle to the loaded ClAllSerial DLL
  103. HMODULE m_ClAlldllHandle;
  104. //! CLALL functions pointers
  105. CLAllProxy m_clallproxy;
  106. //! the previous baud rate as set via SetBaudRate; zero otherwise
  107. CLUINT32 m_PreviousBaudRate;
  108. };
  109. //! retrieves the list of port mapped by PortID
  110. inline void GetPortMap(SerialPortMap &StdMap)
  111. {
  112. GENICAM_NAMESPACE::gcstring_vector PortIDs;
  113. CCLAllAdapter::GetPortIDs(PortIDs);
  114. for (GENICAM_NAMESPACE::gcstring_vector::iterator it = PortIDs.begin(); it != PortIDs.end(); it++)
  115. {
  116. StdMap[*it] = CCLAllAdapter::GetSerialAdapter(*it);
  117. }
  118. };
  119. inline void Destroy(SerialPortMap &portList)
  120. {
  121. for (SerialPortMap::iterator it = portList.begin(); it != portList.end(); it++)
  122. CCLAllAdapter::Destroy(it->second);
  123. }
  124. }
  125. #endif //CLPROTOCOL_CLALLADAPTER_H