sbgECom.h File Reference

Contains main sbgECom methods. More...

#include <sbgCommon.h>
#include "sbgEComIds.h"
#include "protocol/sbgEComProtocol.h"
#include "binaryLogs/sbgEComBinaryLogs.h"

Include dependency graph for sbgECom.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
struct	_SbgEComHandle

Typedefs
typedef struct _SbgEComHandle	SbgEComHandle
typedef SbgErrorCode(*	SbgEComReceiveLogFunc) (SbgEComHandle *pHandle, SbgEComClass msgClass, SbgEComMsgId msg, const SbgBinaryLogData *pLogData, void *pUserArg)

Functions
SbgErrorCode	sbgEComClose (SbgEComHandle *pHandle)
void	sbgEComErrorToString (SbgErrorCode errorCode, char errorMsg[256])
SbgErrorCode	sbgEComHandle (SbgEComHandle *pHandle)
SbgErrorCode	sbgEComHandleOneLog (SbgEComHandle *pHandle)
SbgErrorCode	sbgEComInit (SbgEComHandle *pHandle, SbgInterface *pInterface)
void	sbgEComSetCmdTrialsAndTimeOut (SbgEComHandle *pHandle, uint32_t numTrials, uint32_t cmdDefaultTimeOut)
SbgErrorCode	sbgEComSetReceiveLogCallback (SbgEComHandle *pHandle, SbgEComReceiveLogFunc pReceiveLogCallback, void *pUserArg)

Detailed Description

Contains main sbgECom methods.

Author

SBG Systems (Raphael Siryani)

Date

05 February 2013

Copyright Notice

Copyright (C) 2007-2013, SBG Systems SAS. All rights reserved.

This source code is intended for use only by SBG Systems SAS and those that have explicit written permission to use it from SBG Systems SAS.

THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE.

Definition in file sbgECom.h.

Typedef Documentation

SbgEComHandle

typedef struct _SbgEComHandle SbgEComHandle

Interface structure pre-definition.

Definition at line 46 of file sbgECom.h.

SbgEComReceiveLogFunc

typedef SbgErrorCode(* SbgEComReceiveLogFunc) (SbgEComHandle *pHandle, SbgEComClass msgClass, SbgEComMsgId msg, const SbgBinaryLogData *pLogData, void *pUserArg)

Callback definition called each time a new log is received.

Parameters

[in]	pHandle	Valid handle on the sbgECom instance that has called this callback.
[in]	msgClass	Class of the message we have received
[in]	msg	Message ID of the log received.
[in]	pLogData	Contains the received log data as an union.
[in]	pUserArg	Optional user supplied argument.

Returns

SBG_NO_ERROR if the received log has been used successfully.

Definition at line 61 of file sbgECom.h.

Function Documentation

sbgEComClose()

SbgErrorCode sbgEComClose

(

SbgEComHandle *

pHandle

)

Close the protocol system and release associated memory.

Parameters

[in]

pHandle

A valid sbgECom handle to close.

Returns

SBG_NO_ERROR if we have closed and released the sbgECom system.

Definition at line 58 of file sbgECom.c.

sbgEComErrorToString()

void sbgEComErrorToString	(	SbgErrorCode	errorCode,
		char	errorMsg[256]
	)

Convert an error code into a human readable string.

Parameters

[in]	errorCode	The errorCode to convert into a string.
[out]	errorMsg	String buffer used to hold the error string.

Definition at line 245 of file sbgECom.c.

sbgEComHandle()

SbgErrorCode sbgEComHandle

(

SbgEComHandle *

pHandle

)

Handle all incoming logs until no more log are available in the input interface.

Parameters

[in]

pHandle

A valid sbgECom handle.

Returns

SBG_NO_ERROR if no error occurs during incoming logs parsing.

Definition at line 165 of file sbgECom.c.

sbgEComHandleOneLog()

SbgErrorCode sbgEComHandleOneLog

(

SbgEComHandle *

pHandle

)

Try to parse one log from the input interface and then return.

Parameters

[in]

pHandle

A valid sbgECom handle.

Returns

SBG_NO_ERROR if no error occurs during incoming log parsing.

Definition at line 85 of file sbgECom.c.

sbgEComInit()

SbgErrorCode sbgEComInit	(	SbgEComHandle *	pHandle,
		SbgInterface *	pInterface
	)

Initialize the protocol system used to communicate with the product and return the created handle.

Parameters

[out]	pHandle	Pointer used to store the allocated and initialized sbgECom handle.
[in]	pInterface	Interface to use for read/write operations.

Returns

SBG_NO_ERROR if we have initialized the protocol system.

Initialize the protocol system used to communicate with the product and return the created handle.

Parameters

[out]	pHandle	Pointer used to store the allocated and initialized sbgECom handle.
[in]	pInterface	Interface to use for read/write operations.

Returns

SBG_NO_ERROR if we have initialised the protocol system.

Definition at line 19 of file sbgECom.c.

sbgEComSetCmdTrialsAndTimeOut()

void sbgEComSetCmdTrialsAndTimeOut	(	SbgEComHandle *	pHandle,
		uint32_t	numTrials,
		uint32_t	cmdDefaultTimeOut
	)

Define the default number of trials that should be done when a command is send to the device as well as the time out.

Parameters

[in]	pHandle	A valid sbgECom handle. [in] numTrials Number of trials when a command is sent (starting at 1).
[in]	cmdDefaultTimeOut	Default time out in milliseconds to wait to receive an answer from the device.

Definition at line 224 of file sbgECom.c.

sbgEComSetReceiveLogCallback()

SbgErrorCode sbgEComSetReceiveLogCallback	(	SbgEComHandle *	pHandle,
		SbgEComReceiveLogFunc	pReceiveLogCallback,
		void *	pUserArg
	)

Define the callback that should be called each time a new binary log is received.

Parameters

[in]	pHandle	A valid sbgECom handle.
[in]	pReceiveLogCallback	Pointer on the callback to call when a new log is received.
[in]	pUserArg	Optional user argument that will be passed to the callback method.

Returns

SBG_NO_ERROR if the callback and user argument have been defined successfully.

Definition at line 195 of file sbgECom.c.