BltTofApi Manual

From BlueWiki

(Difference between revisions)
Jump to: navigation, search
(BTAfreeFrame)
 
(26 intermediate revisions not shown)
Line 1: Line 1:
-
== BTAgetVersion ==
+
-delete me-
-
 
+
-
{|cellpadding="5"
+
-
|BTA_StatusOutOfMemory
+
-
|
+
-
* The given buildDateTime string is not long enough
+
-
* The given supportedDeviceTypes array is not long enough
+
-
|-
+
-
|BTA_StatusRuntimeError
+
-
|
+
-
* There was an error while copying the information into the given buffers.
+
-
|}
+
-
 
+
-
 
+
-
== BTAinitConfig ==
+
-
 
+
-
{|cellpadding="5"
+
-
|BTA_StatusInvalidParameter
+
-
|
+
-
* The given config structure is not valid
+
-
|}
+
-
 
+
-
 
+
-
== BTAopen ==
+
-
 
+
-
{|cellpadding="5"
+
-
|BTA_StatusOutOfMemory
+
-
|
+
-
* Not enough memory for the SDK instance
+
-
|-
+
-
|BTA_StatusRuntimeError
+
-
|
+
-
* A thread could not be started
+
-
* A mutex could not be initialized
+
-
|-
+
-
|BTA_StatusDeviceUnreachable
+
-
|
+
-
* The connection attempt was not successful
+
-
* The given serialNumer does not match any of the connected devices
+
-
|-
+
-
|BTA_StatusCommunicationError
+
-
|
+
-
* The connection was established, but communication failed
+
-
|-
+
-
|BTA_StatusInvalidParameter
+
-
|
+
-
* The non-default calibration file could not be found or is not a valid calibration file
+
-
|-
+
-
|BTA_StatusNotSupported
+
-
|
+
-
* The given frameMode is not supported by the device
+
-
|}
+
-
 
+
-
== BTAclose ==
+
-
 
+
-
{|cellpadding="5"
+
-
|BTA_StatusInvalidParameter
+
-
|
+
-
* The given handle is invalid
+
-
|-
+
-
|BTA_StatusRuntimeError
+
-
|
+
-
* A thread could not be stopped
+
-
* A mutex could not be closed
+
-
* A The resources are still under usage in another thread
+
-
|}
+
-
 
+
-
 
+
-
== BTAgetDeviceInfo ==
+
-
 
+
-
{|cellpadding="5"
+
-
|BTA_StatusInvalidParameter
+
-
|
+
-
* The given handle is not valid
+
-
|-
+
-
|BTA_StatusOutOfMemory
+
-
|
+
-
* The device info struct could not be allocated
+
-
|-
+
-
|BTA_StatusCommunicationError
+
-
|
+
-
* There was an error when reading information from the camera
+
-
|}
+
-
 
+
-
 
+
-
== BTAsetKeepAliveMsgInterval ==
+
-
 
+
-
{|cellpadding="5"
+
-
|BTA_StatusInvalidParameter
+
-
|
+
-
* The given handle is not valid
+
-
|-
+
-
|BTA_StatusIllegalOperation
+
-
|
+
-
* BTAclose was called from a different thread
+
-
|}
+
-
 
+
-
 
+
-
== BTAsetControlCrcEnabled ==
+
-
 
+
-
{|cellpadding="5"
+
-
|BTA_StatusInvalidParameter
+
-
|
+
-
* The given handle is not valid
+
-
|-
+
-
|BTA_StatusIllegalOperation
+
-
|
+
-
* BTAclose was called from a different thread
+
-
|}
+
-
 
+
-
 
+
-
== BTAsetFrameMode ==
+
-
 
+
-
{|cellpadding="5"
+
-
|BTA_StatusInvalidParameter
+
-
|
+
-
* The given handle is not valid
+
-
|-
+
-
|BTA_StatusIllegalOperation
+
-
|
+
-
* BTAclose was called from a different thread
+
-
|-
+
-
|BTA_StatusNotSupported
+
-
|
+
-
* The given frameMode is not supported by the device
+
-
|-
+
-
|BTA_StatusCommunicationError
+
-
|
+
-
* An error occured while accessing registers on the devide
+
-
|}
+
-
 
+
-
 
+
-
== BTAsendReset ==
+
-
 
+
-
{|cellpadding="5"
+
-
|BTA_StatusInvalidParameter
+
-
|
+
-
* The given handle is not valid
+
-
|-
+
-
|BTA_StatusIllegalOperation
+
-
|
+
-
* BTAclose was called from a different thread
+
-
|-
+
-
|BTA_StatusNotConnected
+
-
|
+
-
* The connection to the device has been lost
+
-
|-
+
-
|BTA_StatusDeviceUnreachable
+
-
|
+
-
* Reading from or writing to the device resulted in an error
+
-
|-
+
-
|BTA_StatusProtocolViolation
+
-
|
+
-
* Something went wrong internally, please contact Bluetechnix support
+
-
|-
+
-
|BTA_StatusInvalidAddress
+
-
|
+
-
* The given register address is not valid
+
-
|-
+
-
|BTA_StatusIllegalOperation
+
-
|
+
-
* Reading/writing the given register is not allowed
+
-
|}
+
-
 
+
-
 
+
-
== BTAgetFrame ==
+
-
 
+
-
{|cellpadding="5"
+
-
|BTA_StatusInvalidParameter
+
-
|
+
-
* The given handle is not valid
+
-
|-
+
-
|BTA_StatusIllegalOperation
+
-
|
+
-
* BTAclose was called from a different thread
+
-
|-
+
-
|BTA_StatusRuntimeError
+
-
|
+
-
* Queueing is not configured properly
+
-
* Device could not convert raw data
+
-
|-
+
-
|BTA_StatusNotSupported
+
-
|
+
-
* The data received from the device can not be used (with current frameMode)
+
-
|-
+
-
|BTA_StatusTimeOut
+
-
|
+
-
* No frame received from device within timeout
+
-
|-
+
-
|BTA_StatusOutOfMemory
+
-
|
+
-
* Could not allocate memory for internal use
+
-
|-
+
-
|BTA_StatusCommunicationError
+
-
|
+
-
* An error occured while accessing registers on the devide
+
-
|}
+
-
 
+
-
== BTAgetIntegrationTime ==
+
-
 
+
-
same as BTAreadRegister
+
-
 
+
-
== BTAsetIntegrationTime ==
+
-
 
+
-
same as BTAwriteRegister
+
-
{|cellpadding="5"
+
-
|BTA_StatusInvalidParameter
+
-
|
+
-
* The given integration time is not valid
+
-
|}
+
-
 
+
-
 
+
-
== BTAgetFrameRate ==
+
-
 
+
-
same as BTAreadRegister
+
-
 
+
-
 
+
-
== BTAsetFrameRate ==
+
-
 
+
-
same as BTAwriteRegister
+
-
{|cellpadding="5"
+
-
|BTA_StatusInvalidParameter
+
-
|
+
-
* The given frame rate time is not valid
+
-
|}
+
-
 
+
-
 
+
-
== BTAgetGlobalOffset ==
+
-
 
+
-
same as BTAreadRegister
+
-
{|cellpadding="5"
+
-
|BTA_StatusInvalidConfiguration
+
-
|
+
-
* For the current device configuration (e.g. modulation frequency) the operation can not be performed
+
-
|}
+
-
 
+
-
 
+
-
== BTAsetGlobalOffset ==
+
-
 
+
-
same as BTAreadRegister
+
-
same as BTAwriteRegister
+
-
{|cellpadding="5"
+
-
|BTA_StatusInvalidParameter
+
-
|
+
-
* The given offset is not valid
+
-
|}
+
-
 
+
-
 
+
-
== BTAreadRegister ==
+
-
 
+
-
{|cellpadding="5"
+
-
|BTA_StatusInvalidParameter
+
-
|
+
-
* The given handle is not valid
+
-
* The given registerCount is not valid
+
-
|-
+
-
|BTA_StatusIllegalOperation
+
-
|
+
-
* BTAclose was called from a different thread
+
-
|-
+
-
|BTA_StatusNotConnected
+
-
|
+
-
* The connection to the device has been lost
+
-
|-
+
-
|BTA_StatusDeviceUnreachable
+
-
|
+
-
* Reading from or writing to the device resulted in an error
+
-
|-
+
-
|BTA_StatusProtocolViolation
+
-
|
+
-
* Something went wrong internally, please contact Bluetechnix support
+
-
|-
+
-
|BTA_StatusInvalidAddress
+
-
|
+
-
* The given register address is not valid
+
-
|-
+
-
|BTA_StatusIllegalOperation
+
-
|
+
-
* Reading/writing the given register is not allowed
+
-
|-
+
-
|BTA_StatusOutOfMemory
+
-
|
+
-
* Could not allocate memory
+
-
|}
+
-
 
+
-
== BTAwriteRegister ==
+
-
 
+
-
{|cellpadding="5"
+
-
|BTA_StatusInvalidParameter
+
-
|
+
-
* The given handle is not valid
+
-
* The given registerCount is not valid
+
-
* The given register value is not valid
+
-
|-
+
-
|BTA_StatusIllegalOperation
+
-
|
+
-
* BTAclose was called from a different thread
+
-
|-
+
-
|BTA_StatusNotConnected
+
-
|
+
-
* The connection to the device has been lost
+
-
|-
+
-
|BTA_StatusDeviceUnreachable
+
-
|
+
-
* Reading from or writing to the device resulted in an error
+
-
|-
+
-
|BTA_StatusProtocolViolation
+
-
|
+
-
* Something went wrong internally, please contact Bluetechnix support
+
-
|-
+
-
|BTA_StatusInvalidAddress
+
-
|
+
-
* The given register address is not valid
+
-
|-
+
-
|BTA_StatusIllegalOperation
+
-
|
+
-
* Reading/writing the given register is not allowed
+
-
|}
+
-
 
+
-
== BTAflashUpdate ==
+
-
 
+
-
{|cellpadding="5"
+
-
|BTA_StatusInvalidParameter
+
-
|
+
-
* The given handle is not valid
+
-
* The given flash target is not valid
+
-
* The given flash ID is not valid
+
-
|-
+
-
|BTA_StatusIllegalOperation
+
-
|
+
-
* BTAclose was called from a different thread
+
-
|-
+
-
|BTA_StatusNotConnected
+
-
|
+
-
* The connection to the device has been lost
+
-
|-
+
-
|BTA_StatusDeviceUnreachable
+
-
|
+
-
* Reading from or writing to the device resulted in an error
+
-
|-
+
-
|BTA_StatusProtocolViolation
+
-
|
+
-
* Something went wrong internally, please contact Bluetechnix support
+
-
|-
+
-
|BTA_StatusInvalidAddress
+
-
|
+
-
* The given register address is not valid
+
-
|-
+
-
|BTA_StatusIllegalOperation
+
-
|
+
-
* Reading/writing the given register is not allowed
+
-
|-
+
-
|BTA_StatusRuntimeError
+
-
|
+
-
* The device did not respond as expected during the update process
+
-
|-
+
-
|BTA_StatusCommunicationError
+
-
|
+
-
* There was an error during the file transmission
+
-
|-
+
-
|BTA_StatusOutOfMemory
+
-
|
+
-
* Not enough memory for performing the update process
+
-
|-
+
-
|BTA_StatusFlashingFailed 
+
-
|
+
-
* Flash Update failed
+
-
|}
+
-
 
+
-
== BTAfirmwareUpdate ==
+
-
 
+
-
same as BTAflashUpdate
+
-
{|cellpadding="5"
+
-
|BTA_StatusInvalidParameter
+
-
|
+
-
* The given handle is not valid
+
-
* The given file name is not valid
+
-
|-
+
-
|BTA_StatusOutOfMemory
+
-
|
+
-
* Not enough memory for reading in the firmware file
+
-
|-
+
-
|BTA_StatusRuntimeError
+
-
|
+
-
* The file could not be (fully) read
+
-
|}
+
-
 
+
-
== BTAgetDistances ==
+
-
 
+
-
{|cellpadding="5"
+
-
|BTA_StatusInvalidParameter
+
-
|
+
-
* The given frame or a given buffer is not valid
+
-
|-
+
-
|BTA_StatusInvalidDataFormat
+
-
|
+
-
* The given frame does not contain distance data
+
-
|}
+
-
 
+
-
 
+
-
== BTAgetAmplitudes ==
+
-
 
+
-
{|cellpadding="5"
+
-
|BTA_StatusInvalidParameter
+
-
|
+
-
* The given frame or a given buffer is not valid
+
-
|-
+
-
|BTA_StatusInvalidDataFormat
+
-
|
+
-
* The given frame does not contain amplitude data
+
-
|}
+
-
 
+
-
 
+
-
== BTAgetFlags ==
+
-
 
+
-
{|cellpadding="5"
+
-
|BTA_StatusInvalidParameter
+
-
|
+
-
* The given frame or a given buffer is not valid
+
-
|-
+
-
|BTA_StatusInvalidDataFormat
+
-
|
+
-
* The given frame does not contain flag data
+
-
|}
+
-
 
+
-
 
+
-
== BTAgetXYZcoordinates ==
+
-
 
+
-
{|cellpadding="5"
+
-
|BTA_StatusInvalidParameter
+
-
|
+
-
* The given frame or a given buffer is not valid
+
-
|-
+
-
|BTA_StatusInvalidDataFormat
+
-
|
+
-
* The given frame does not contain x/y/z data
+
-
|}
+
-
 
+
-
 
+
-
== BTAfreeFrame ==
+
-
 
+
-
{|cellpadding="5"
+
-
|BTA_StatusInvalidParameter
+
-
|
+
-
* The given frame is not valid
+
-
|}
+
-
 
+
-
 
+
-
== BTAfreeDeviceInfo ==
+
-
 
+
-
{|cellpadding="5"
+
-
|BTA_StatusInvalidParameter
+
-
|
+
-
* The given deviceInfo is not valid
+
-
|}
+
-
 
+
-
 
+
-
== BTAwriteCurrentConfigToNvm ==
+
-
 
+
-
same as BTAwriteRegister
+
-
 
+
-
== BTAfreeDeviceInfo ==
+
-
 
+
-
{|cellpadding="5"
+
-
|BTA_StatusInvalidParameter
+
-
|
+
-
* The given handle is not valid
+
-
|}
+

Current revision as of 12:26, 16 September 2014

-delete me-

Personal tools