BltTofApi Manual

From BlueWiki

(Difference between revisions)
Jump to: navigation, search
(BTA P100 Library)
(BTA ETH Library)
Line 25: Line 25:
! armel
! armel
|-
|-
-
! v1.0.0 || X || X || X || X || X
+
! v1.0.0
 +
| X || X || X || X || X
|}
|}

Revision as of 09:21, 16 September 2014

Contents

1 Versions

1.1 BTA P100 Library

Win32 Win64 Lin64 armhf armel
v1.0.0 X X X X X

1.2 BTA ETH Library

Win32 Win64 Lin64 armhf armel
v1.0.0 X X X X X

2 Environment

2.1 Windows

Please take a look at the example project for a reference on how to compile an application using a BTA library. Things to consider are:

  • Macro: #define PLAT_WINDOWS
  • Macro: #define PLAT_32BIT or #define PLAT_64_BIT

2.2 Linux

2.3 ARM (Linux)

3 Reference Manual

3.1 BTAgetVersion

BTA_StatusOutOfMemory -17
  • The given buildDateTime string is not long enough
  • The given supportedDeviceTypes array is not long enough
BTA_StatusRuntimeError -16
  • There was an error while copying the information into the given buffers.

3.2 BTAinitConfig

BTA_StatusInvalidParameter -1
  • The given config structure is not valid


3.3 BTAopen

BTA_StatusOutOfMemory -17
  • Not enough memory for the SDK instance
BTA_StatusRuntimeError -16
  • A thread could not be started
  • A mutex could not be initialized
BTA_StatusDeviceUnreachable -6
  • The connection attempt was not successful
  • The given serialNumer does not match any of the connected devices
BTA_StatusCommunicationError -24
  • The connection was established, but communication failed
BTA_StatusInvalidParameter -1
  • The given config struct pointer is not valid
  • The given handle pointer is not valid
  • The non-default calibration file could not be found or is not a valid calibration file
BTA_StatusNotSupported -21
  • The given frameMode is not supported by the device

3.4 BTAclose

BTA_StatusInvalidParameter -1
  • The given handle is invalid
BTA_StatusRuntimeError -16
  • A thread could not be stopped
  • A mutex could not be closed
  • A The resources are still under usage in another thread


3.5 BTAgetDeviceInfo

BTA_StatusInvalidParameter -1
  • The given handle is not valid
BTA_StatusOutOfMemory -17
  • The device info struct could not be allocated
BTA_StatusCommunicationError -24
  • There was an error when reading information from the camera


3.6 BTAsetKeepAliveMsgInterval

BTA_StatusInvalidParameter -1
  • The given handle is not valid
BTA_StatusIllegalOperation -2
  • BTAclose was called from a different thread
BTA_StatusInvalidProtocolVersion -14
  • The camera's protocol version is not supported

3.7 BTAsetControlCrcEnabled

BTA_StatusInvalidParameter -1
  • The given handle is not valid
BTA_StatusIllegalOperation -2
  • BTAclose was called from a different thread


3.8 BTAsetFrameMode

BTA_StatusInvalidParameter -1
  • The given handle is not valid
BTA_StatusIllegalOperation -2
  • BTAclose was called from a different thread
BTA_StatusNotSupported -21
  • The given frameMode is not supported by the device
BTA_StatusCommunicationError -24
  • An error occured while accessing registers on the devide


3.9 BTAsendReset

BTA_StatusInvalidParameter -1
  • The given handle is not valid
BTA_StatusIllegalOperation -2
  • BTAclose was called from a different thread
BTA_StatusNotConnected -12
  • The connection to the device has been lost
BTA_StatusDeviceUnreachable -6
  • Reading from or writing to the device resulted in an error
BTA_StatusProtocolViolation -4
  • Something went wrong internally, please contact Bluetechnix support
BTA_StatusInvalidAddress -10
  • The given register address is not valid
BTA_StatusIllegalOperation -2
  • Reading/writing the given register is not allowed
BTA_StatusInvalidProtocolVersion -14
  • The camera's protocol version is not supported

3.10 BTAgetFrame

BTA_StatusInvalidParameter -1
  • The given handle is not valid
BTA_StatusIllegalOperation -2
  • BTAclose was called from a different thread
BTA_StatusRuntimeError -16
  • Queueing is not configured properly
  • Device could not convert raw data
BTA_StatusNotSupported -21
  • The data received from the device can not be used (with current frameMode)
BTA_StatusTimeOut -5
  • No frame received from device within timeout
BTA_StatusOutOfMemory -17
  • Could not allocate memory for internal use
BTA_StatusCommunicationError -24
  • An error occured while accessing registers on the devide
BTA_StatusUnexpectedDataFormat -26
  • The device is not configured correctly for the currently set frame mode

3.11 BTAgetIntegrationTime

same as BTAreadRegister

3.12 BTAsetIntegrationTime

same as BTAwriteRegister

BTA_StatusInvalidParameter -1
  • The given integration time is not valid


3.13 BTAgetFrameRate

same as BTAreadRegister


3.14 BTAsetFrameRate

same as BTAwriteRegister

BTA_StatusInvalidParameter -1
  • The given frame rate time is not valid


3.15 BTAgetGlobalOffset

same as BTAreadRegister

BTA_StatusInvalidConfiguration -23
  • For the current device configuration (e.g. modulation frequency) the operation can not be performed


3.16 BTAsetGlobalOffset

same as BTAreadRegister same as BTAwriteRegister

BTA_StatusInvalidParameter -1
  • The given offset is not valid


3.17 BTAreadRegister

BTA_StatusInvalidParameter -1
  • The given handle is not valid
  • The given registerCount is not valid
BTA_StatusIllegalOperation -2
  • BTAclose was called from a different thread
BTA_StatusNotConnected -12
  • The connection to the device has been lost
BTA_StatusDeviceUnreachable - 6
  • Reading from or writing to the device resulted in an error
BTA_StatusProtocolViolation -4
  • Something went wrong internally, please contact Bluetechnix support
BTA_StatusInvalidAddress -10
  • The given register address is not valid
BTA_StatusIllegalOperation -2
  • Reading/writing the given register is not allowed
BTA_StatusOutOfMemory -17
  • Could not allocate memory
BTA_StatusInvalidProtocolVersion -14
  • The camera's protocol version is not supported

3.18 BTAwriteRegister

BTA_StatusInvalidParameter -1
  • The given handle is not valid
  • The given registerCount is not valid
  • The given register value is not valid
BTA_StatusIllegalOperation -2
  • BTAclose was called from a different thread
BTA_StatusNotConnected -12
  • The connection to the device has been lost
BTA_StatusDeviceUnreachable -6
  • Reading from or writing to the device resulted in an error
BTA_StatusProtocolViolation -4
  • Something went wrong internally, please contact Bluetechnix support
BTA_StatusInvalidAddress -10
  • The given register address is not valid
BTA_StatusIllegalOperation -2
  • Reading/writing the given register is not allowed
BTA_StatusInvalidProtocolVersion -14
  • The camera's protocol version is not supported

3.19 BTAflashUpdate

BTA_StatusInvalidParameter -1
  • The given handle is not valid
  • The given flash target is not valid
  • The given flash ID is not valid
BTA_StatusIllegalOperation -2
  • BTAclose was called from a different thread
BTA_StatusNotConnected -12
  • The connection to the device has been lost
BTA_StatusDeviceUnreachable -6
  • Reading from or writing to the device resulted in an error
BTA_StatusProtocolViolation -4
  • Something went wrong internally, please contact Bluetechnix support
BTA_StatusInvalidAddress -10
  • The given register address is not valid
BTA_StatusIllegalOperation -2
  • Reading/writing the given register is not allowed
BTA_StatusRuntimeError -16
  • The device did not respond as expected during the update process
BTA_StatusCommunicationError -24
  • There was an error during the file transmission
BTA_StatusOutOfMemory -17
  • Not enough memory for performing the update process
BTA_StatusFlashingFailed -22
  • Flash Update failed
BTA_StatusInvalidProtocolVersion -14
  • The camera's protocol version is not supported
BTA_StatusInvalidFile -25
  • The provided file is not suitable

3.20 BTAfirmwareUpdate

same as BTAflashUpdate

BTA_StatusInvalidParameter -1
  • The given handle is not valid
  • The given file name is not valid
BTA_StatusOutOfMemory -17
  • Not enough memory for reading in the firmware file
BTA_StatusRuntimeError -16
  • The file could not be (fully) read

3.21 BTAgetDistances

BTA_StatusInvalidParameter -1
  • The given frame or a given buffer is not valid
BTA_StatusInvalidDataFormat -15
  • The given frame does not contain distance data


3.22 BTAgetAmplitudes

BTA_StatusInvalidParameter -1
  • The given frame or a given buffer is not valid
BTA_StatusInvalidDataFormat -15
  • The given frame does not contain amplitude data


3.23 BTAgetFlags

BTA_StatusInvalidParameter -1
  • The given frame or a given buffer is not valid
BTA_StatusInvalidDataFormat -15
  • The given frame does not contain flag data


3.24 BTAgetXYZcoordinates

BTA_StatusInvalidParameter -1
  • The given frame or a given buffer is not valid
BTA_StatusInvalidDataFormat -15
  • The given frame does not contain x/y/z data


3.25 BTAfreeFrame

BTA_StatusInvalidParameter -1
  • The given frame is not valid


3.26 BTAfreeDeviceInfo

BTA_StatusInvalidParameter -1
  • The given deviceInfo is not valid


3.27 BTAwriteCurrentConfigToNvm

same as BTAwriteRegister and BTAreadRegister

BTA_StatusRuntimeError -16
  • The device reports, that the write process was not successful

3.28 BTArestoreDefaultConfig

same as BTAwriteRegister and BTAreadRegister

BTA_StatusRuntimeError -16
  • The device reports, that the restore process was not successful
Personal tools