Function API description PSF 90316 PTC04 old 603 DownloadLink 5001

!"$#&% ' % )(*+ % +,#&-& % "$ % +
M L X 9 0 3 1 6 P RO D U CT
S P E C IF I C F UN C T I O NS
S OFTWARE L IBRARY
MLX90316 PSF Library Object Model
22-09-05
-1-
!"$#&% ' % )(*+ % +,#&-& % "$ % +
1
CONTENTS........................................................................................................................................................2
2
INTRODUCTION ..............................................................................................................................................9
3
SOFTWARE STRUCTURE ..............................................................................................................................9
3.1
3.2
3.3
4
MLX90316PSFMANAGER OBJECT .............................................................................................................11
4.1
5
OBJECT MODEL .............................................................................................................................................9
OBJECT STRUCTURE AND HIERARCHY ............................................................................................................9
OBJECTS WITH INTERFACES .........................................................................................................................10
BACKGROUND .............................................................................................................................................11
MLX90316PSFDEVICE OBJECT...................................................................................................................12
5.1
BACKGROUND .............................................................................................................................................12
5.2
SCOPE OF THE MLX90316PSFDEVICE OBJECT .............................................................................................13
5.3
SELECTEDDEVICE PROPERTY .......................................................................................................................13
5.3.1
Description .........................................................................................................................................13
5.3.2
Syntax .................................................................................................................................................13
5.3.3
Parameters..........................................................................................................................................13
5.3.4
Return value........................................................................................................................................14
5.3.5
Quick Info ...........................................................................................................................................14
5.4
PTC04 PROPERTY .......................................................................................................................................14
5.4.1
Description .........................................................................................................................................14
5.4.2
Syntax .................................................................................................................................................14
5.4.3
Parameters..........................................................................................................................................14
5.4.4
Return value........................................................................................................................................14
5.4.5
Quick Info ...........................................................................................................................................15
5.5
SOLVER PROPERTY ......................................................................................................................................15
5.5.1
Description .........................................................................................................................................15
5.5.2
Syntax .................................................................................................................................................15
5.5.3
Parameters..........................................................................................................................................15
5.5.4
Return value........................................................................................................................................15
5.5.5
Quick Info ...........................................................................................................................................15
5.6
ADVANCED PROPERTY.................................................................................................................................16
5.6.1
Description .........................................................................................................................................16
5.6.2
Syntax .................................................................................................................................................16
5.6.3
Parameters..........................................................................................................................................16
5.6.4
Return value........................................................................................................................................16
5.6.5
Quick Info ...........................................................................................................................................16
5.7
READFULLDEVICE METHOD ........................................................................................................................16
5.7.1
Description .........................................................................................................................................16
5.7.2
Syntax .................................................................................................................................................17
5.7.3
Parameters..........................................................................................................................................17
5.7.4
Return value........................................................................................................................................17
5.7.5
Quick Info ...........................................................................................................................................17
5.8
PROGRAMDEVICE METHOD .........................................................................................................................17
5.8.1
Description .........................................................................................................................................17
5.8.2
Syntax .................................................................................................................................................17
5.8.3
Parameters..........................................................................................................................................17
5.8.4
Return value........................................................................................................................................17
5.8.5
Quick Info ...........................................................................................................................................18
5.9
GETEEPARAMETERCODE METHOD ..............................................................................................................18
5.9.1
Description .........................................................................................................................................18
MLX90316 PSF Library Object Model
22-09-05
-2-
!"$#&% ' % )(*+ % +,#&-& % "$ % +
5.9.2
Syntax .................................................................................................................................................18
5.9.3
Parameters..........................................................................................................................................18
5.9.4
Return value........................................................................................................................................18
5.9.5
Quick Info ...........................................................................................................................................19
5.10 SETEEPARAMETERCODE METHOD ..............................................................................................................19
5.10.1 Description .........................................................................................................................................19
5.10.2 Syntax .................................................................................................................................................19
5.10.3 Parameters..........................................................................................................................................19
5.10.4 Return value........................................................................................................................................19
5.10.5 Quick Info ...........................................................................................................................................19
5.11 GETEEPARAMETERVALUE METHOD ............................................................................................................20
5.11.1 Description .........................................................................................................................................20
5.11.2 Syntax .................................................................................................................................................20
5.11.3 Parameters..........................................................................................................................................20
5.11.4 Return value........................................................................................................................................20
5.11.5 Quick Info ...........................................................................................................................................20
5.12 SETEEPARAMETERVALUE METHOD ............................................................................................................20
5.12.1 Description .........................................................................................................................................20
5.12.2 Syntax .................................................................................................................................................21
5.12.3 Parameters..........................................................................................................................................21
5.12.4 Return value........................................................................................................................................21
5.12.5 Quick Info ...........................................................................................................................................21
5.13 GETVDD METHOD .......................................................................................................................................21
5.13.1 Description .........................................................................................................................................21
5.13.2 Syntax .................................................................................................................................................21
5.13.3 Parameters..........................................................................................................................................22
5.13.4 Return value........................................................................................................................................22
5.13.5 Quick Info ...........................................................................................................................................22
5.14 GETIDD METHOD ........................................................................................................................................22
5.14.1 Description .........................................................................................................................................22
5.14.2 Syntax .................................................................................................................................................22
5.14.3 Parameters..........................................................................................................................................22
5.14.4 Return value........................................................................................................................................22
5.14.5 Quick Info ...........................................................................................................................................23
5.15 MEASURE METHOD .....................................................................................................................................23
5.15.1 Description .........................................................................................................................................23
5.15.2 Syntax .................................................................................................................................................23
5.15.3 Parameters..........................................................................................................................................23
5.15.4 Return value........................................................................................................................................24
5.15.5 Quick Info ...........................................................................................................................................24
5.16 GETANGLE METHOD ...................................................................................................................................24
5.16.1 Description .........................................................................................................................................24
5.16.2 Syntax .................................................................................................................................................24
5.16.3 Parameters..........................................................................................................................................24
5.16.4 Return value........................................................................................................................................24
5.16.5 Quick Info ...........................................................................................................................................24
5.17 DEVICEREPLACED METHOD.........................................................................................................................25
5.17.1 Description .........................................................................................................................................25
5.17.2 Syntax .................................................................................................................................................25
5.17.3 Parameters..........................................................................................................................................25
5.17.4 Return value........................................................................................................................................25
5.17.5 Quick Info ...........................................................................................................................................25
5.18 GETEEPARAMETER METHOD.......................................................................................................................25
5.18.1 Description .........................................................................................................................................25
5.18.2 Quick Info ...........................................................................................................................................25
5.19 SETEEPARAMETER METHOD .......................................................................................................................25
5.19.1 Description .........................................................................................................................................25
MLX90316 PSF Library Object Model
22-09-05
-3-
!"$#&% ' % )(*+ % +,#&-& % "$ % +
5.19.2
6
Quick Info ...........................................................................................................................................26
MLX90316PSFSOLVER OBJECT..................................................................................................................27
6.1
BACKGROUND .............................................................................................................................................27
6.2
SCOPE .........................................................................................................................................................27
6.3
SOLVER PROCEDURE FLOW...........................................................................................................................28
6.4
SETCOORDINATEA METHOD ........................................................................................................................29
6.4.1
Description .........................................................................................................................................29
6.4.2
Syntax .................................................................................................................................................29
6.4.3
Parameters..........................................................................................................................................29
6.4.4
Return value........................................................................................................................................29
6.4.5
Quick Info ...........................................................................................................................................29
6.5
SETCOORDINATEB METHOD ........................................................................................................................29
6.5.1
Description .........................................................................................................................................29
6.5.2
Syntax .................................................................................................................................................30
6.5.3
Parameters..........................................................................................................................................30
6.5.4
Return value........................................................................................................................................30
6.5.5
Quick Info ...........................................................................................................................................30
6.6
SETCOORDINATEC METHOD ........................................................................................................................30
6.6.1
Description .........................................................................................................................................30
6.6.2
Syntax .................................................................................................................................................30
6.6.3
Parameters..........................................................................................................................................31
6.6.4
Return value........................................................................................................................................31
6.6.5
Quick Info ...........................................................................................................................................31
6.7
SETCOORDINATED METHOD ........................................................................................................................31
6.7.1
Description .........................................................................................................................................31
6.7.2
Syntax .................................................................................................................................................31
6.7.3
Parameters..........................................................................................................................................31
6.7.4
Return value........................................................................................................................................31
6.7.5
Quick Info ...........................................................................................................................................32
6.8
SETSLOPES0 METHOD .................................................................................................................................32
6.9
SETSLOPEA METHOD ..................................................................................................................................32
6.10 SETSLOPEB METHOD ..................................................................................................................................32
6.11 SETSLOPEC METHOD ..................................................................................................................................32
6.11.1 Description .........................................................................................................................................32
6.11.2 Syntax .................................................................................................................................................32
6.11.3 Parameters..........................................................................................................................................32
6.11.4 Return value........................................................................................................................................32
6.11.5 Quick Info ...........................................................................................................................................33
6.12 SETCLAMPING METHOD ..............................................................................................................................33
6.12.1 Description .........................................................................................................................................33
6.12.2 Syntax .................................................................................................................................................33
6.12.3 Parameters..........................................................................................................................................33
6.12.4 Return value........................................................................................................................................33
6.12.5 Quick Info ...........................................................................................................................................33
6.13 SETROUGHGAIN METHOD ...........................................................................................................................33
6.13.1 Description .........................................................................................................................................33
6.13.2 Syntax .................................................................................................................................................34
6.13.3 Parameters..........................................................................................................................................34
6.13.4 Return value........................................................................................................................................34
6.13.5 Quick Info ...........................................................................................................................................34
6.14 CHARACTERIZEOUTPUTDAC METHOD ........................................................................................................34
6.14.1 Description .........................................................................................................................................34
6.14.2 Syntax .................................................................................................................................................35
6.14.3 Parameters..........................................................................................................................................35
6.14.4 Return value........................................................................................................................................35
6.14.5 Quick Info ...........................................................................................................................................35
MLX90316 PSF Library Object Model
22-09-05
-4-
!"$#&% ' % )(*+ % +,#&-& % "$ % +
6.15 COPYSOLVERSETTINGSTOPARAMETERS METHOD ........................................................................................35
6.15.1 Description .........................................................................................................................................35
6.15.2 Syntax .................................................................................................................................................35
6.15.3 Parameters..........................................................................................................................................35
6.15.4 Return value........................................................................................................................................36
6.15.5 Quick Info ...........................................................................................................................................36
6.16 MEMLOCK METHOD ....................................................................................................................................36
6.16.1 Description .........................................................................................................................................36
6.16.2 Syntax .................................................................................................................................................36
6.16.3 Parameters..........................................................................................................................................36
6.16.4 Return value........................................................................................................................................36
6.16.5 Quick Info ...........................................................................................................................................36
7
MLX90316PSFADVANCED OBJECT............................................................................................................37
7.1
BACKGROUND .............................................................................................................................................37
7.2
SCOPE OF THE MLX90316PSFADVANCED OBJECT .......................................................................................37
7.3
SETVDD METHOD........................................................................................................................................37
7.3.1
Description .........................................................................................................................................37
7.3.2
Syntax .................................................................................................................................................37
7.3.3
Parameters..........................................................................................................................................37
7.3.4
Return value........................................................................................................................................37
7.3.5
Quick Info ...........................................................................................................................................38
7.4
SETVBAT METHOD .....................................................................................................................................38
7.4.1
Description .........................................................................................................................................38
7.4.2
Syntax .................................................................................................................................................38
7.4.3
Parameters..........................................................................................................................................38
7.4.4
Return value........................................................................................................................................38
7.4.5
Quick Info ...........................................................................................................................................38
7.5
SELECTDEVICE METHOD .............................................................................................................................38
7.5.1
Description .........................................................................................................................................38
7.5.2
Syntax .................................................................................................................................................38
7.5.3
Parameters..........................................................................................................................................39
7.5.4
Return value........................................................................................................................................39
7.5.5
Quick Info ...........................................................................................................................................39
7.6
GETSETTING METHOD .................................................................................................................................39
7.6.1
Description .........................................................................................................................................39
7.6.2
Syntax .................................................................................................................................................39
7.6.3
Parameters..........................................................................................................................................39
7.6.4
Return value........................................................................................................................................39
7.6.5
Quick Info ...........................................................................................................................................40
7.7
SETSETTING METHOD..................................................................................................................................40
7.7.1
Description .........................................................................................................................................40
7.7.2
Syntax .................................................................................................................................................40
7.7.3
Parameters..........................................................................................................................................40
7.7.4
Return value........................................................................................................................................40
7.7.5
Quick Info ...........................................................................................................................................41
7.8
SETTINGINUSE PROPERTY ...........................................................................................................................41
7.8.1
Description .........................................................................................................................................41
7.8.2
Syntax .................................................................................................................................................41
7.8.3
Parameters..........................................................................................................................................41
7.8.4
Return value........................................................................................................................................41
7.8.5
Quick Info ...........................................................................................................................................41
7.9
GETSOLVERSETTING METHOD .....................................................................................................................42
7.9.1
Description .........................................................................................................................................42
7.9.2
Syntax .................................................................................................................................................42
7.9.3
Parameters..........................................................................................................................................42
7.9.4
Return value........................................................................................................................................42
MLX90316 PSF Library Object Model
22-09-05
-5-
!"$#&% ' % )(*+ % +,#&-& % "$ % +
7.9.5
Quick Info ...........................................................................................................................................42
7.10 SETSOLVERSETTING METHOD .....................................................................................................................43
7.10.1 Description .........................................................................................................................................43
7.10.2 Syntax .................................................................................................................................................43
7.10.3 Parameters..........................................................................................................................................43
7.10.4 Return value........................................................................................................................................43
7.10.5 Quick Info ...........................................................................................................................................43
7.11 SOLVERSETTINGINUSE PROPERTY ...............................................................................................................43
7.11.1 Description .........................................................................................................................................43
7.11.2 Syntax .................................................................................................................................................44
7.11.3 Parameters..........................................................................................................................................44
7.11.4 Return value........................................................................................................................................44
7.11.5 Quick Info ...........................................................................................................................................44
7.12 OPENPROFILE METHOD ...............................................................................................................................44
7.12.1 Description .........................................................................................................................................44
7.12.2 Syntax .................................................................................................................................................45
7.12.3 Parameters..........................................................................................................................................45
7.12.4 Return value........................................................................................................................................45
7.12.5 Quick Info ...........................................................................................................................................45
7.13 SAVEPROFILE METHOD ...............................................................................................................................45
7.13.1 Description .........................................................................................................................................45
7.13.2 Syntax .................................................................................................................................................45
7.13.3 Parameters..........................................................................................................................................45
7.13.4 Return value........................................................................................................................................45
7.13.5 Quick Info ...........................................................................................................................................46
7.14 SAVEPROFILEAS METHOD ...........................................................................................................................46
7.14.1 Description .........................................................................................................................................46
7.14.2 Syntax .................................................................................................................................................46
7.14.3 Parameters..........................................................................................................................................46
7.14.4 Return value........................................................................................................................................46
7.14.5 Quick Info ...........................................................................................................................................46
7.15 READFULLRAM METHOD ...........................................................................................................................46
7.15.1 Description .........................................................................................................................................46
7.15.2 Syntax .................................................................................................................................................47
7.15.3 Parameters..........................................................................................................................................47
7.15.4 Return value........................................................................................................................................47
7.15.5 Quick Info ...........................................................................................................................................47
7.16 PROGRAMRAM METHOD ............................................................................................................................47
7.16.1 Description .........................................................................................................................................47
7.16.2 Syntax .................................................................................................................................................47
7.16.3 Parameters..........................................................................................................................................47
7.16.4 Return value........................................................................................................................................47
7.16.5 Quick Info ...........................................................................................................................................48
7.17 GETRAMPARAMETER METHOD...................................................................................................................48
7.17.1 Description .........................................................................................................................................48
7.17.2 Syntax .................................................................................................................................................48
7.17.3 Parameters..........................................................................................................................................48
7.17.4 Return value........................................................................................................................................48
7.17.5 Quick Info ...........................................................................................................................................48
7.18 SETRAMPARAMETER METHOD ...................................................................................................................49
7.18.1 Description .........................................................................................................................................49
7.18.2 Syntax .................................................................................................................................................49
7.18.3 Parameters..........................................................................................................................................49
7.18.4 Return value........................................................................................................................................49
7.18.5 Quick Info ...........................................................................................................................................49
7.19 MEMWRITEWITHCRC METHOD ..................................................................................................................49
7.19.1 Description .........................................................................................................................................49
MLX90316 PSF Library Object Model
22-09-05
-6-
!"$#&% ' % )(*+ % +,#&-& % "$ % +
7.19.2 Syntax .................................................................................................................................................49
7.19.3 Parameters..........................................................................................................................................50
7.19.4 Return value........................................................................................................................................50
7.19.5 Quick Info ...........................................................................................................................................50
7.20 MEMWRITE METHOD ..................................................................................................................................51
7.20.1 Description .........................................................................................................................................51
7.20.2 Syntax .................................................................................................................................................51
7.20.3 Parameters..........................................................................................................................................51
7.20.4 Return value........................................................................................................................................51
7.20.5 Quick Info ...........................................................................................................................................51
7.21 MEMREAD METHOD ....................................................................................................................................52
7.21.1 Description .........................................................................................................................................52
7.21.2 Syntax .................................................................................................................................................52
7.21.3 Parameters..........................................................................................................................................52
7.21.4 Return value........................................................................................................................................52
7.21.5 Quick Info ...........................................................................................................................................52
7.22 READDATA METHOD ...................................................................................................................................52
7.22.1 Description .........................................................................................................................................52
7.22.2 Syntax .................................................................................................................................................53
7.22.3 Parameters..........................................................................................................................................53
7.22.4 Return value........................................................................................................................................53
7.22.5 Quick Info ...........................................................................................................................................53
7.23 WRITEDATA METHOD .................................................................................................................................54
7.23.1 Description .........................................................................................................................................54
7.23.2 Syntax .................................................................................................................................................54
7.23.3 Parameters..........................................................................................................................................54
7.23.4 Return value........................................................................................................................................54
7.23.5 Quick Info ...........................................................................................................................................54
7.24 STARTCOM METHOD ...................................................................................................................................55
7.24.1 Description .........................................................................................................................................55
7.24.2 Syntax .................................................................................................................................................55
7.24.3 Parameters..........................................................................................................................................55
7.24.4 Return value........................................................................................................................................55
7.24.5 Quick Info ...........................................................................................................................................55
7.25 SETDBMUX METHOD..................................................................................................................................55
7.25.1 Description .........................................................................................................................................55
7.25.2 Syntax .................................................................................................................................................55
7.25.3 Parameters..........................................................................................................................................55
7.25.4 Return value........................................................................................................................................56
7.25.5 Quick Info ...........................................................................................................................................56
7.26 HOTRESET METHOD ....................................................................................................................................56
7.26.1 Description .........................................................................................................................................56
7.26.2 Syntax .................................................................................................................................................56
7.26.3 Parameters..........................................................................................................................................56
7.26.4 Return value........................................................................................................................................56
7.26.5 Quick Info ...........................................................................................................................................56
7.27 NOPALIVE METHOD ....................................................................................................................................57
7.27.1 Description .........................................................................................................................................57
7.27.2 Syntax .................................................................................................................................................57
7.27.3 Parameters..........................................................................................................................................57
7.27.4 Return value........................................................................................................................................57
7.27.5 Quick Info ...........................................................................................................................................57
7.28 HAMWRITE METHOD...................................................................................................................................57
7.28.1 Description .........................................................................................................................................57
7.28.2 Syntax .................................................................................................................................................57
7.28.3 Parameters..........................................................................................................................................58
7.28.4 Return value........................................................................................................................................58
MLX90316 PSF Library Object Model
22-09-05
-7-
!"$#&% ' % )(*+ % +,#&-& % "$ % +
7.28.5 Quick Info ...........................................................................................................................................58
7.29 DISCONNECTDEVICE METHOD .....................................................................................................................58
7.29.1 Description .........................................................................................................................................58
7.29.2 Syntax .................................................................................................................................................58
7.29.3 Parameters..........................................................................................................................................58
7.29.4 Return value........................................................................................................................................58
7.29.5 Quick Info ...........................................................................................................................................58
7.30 LOGGING PROPERTY ....................................................................................................................................59
7.30.1 Description .........................................................................................................................................59
7.30.2 Syntax .................................................................................................................................................59
7.30.3 Parameters..........................................................................................................................................59
7.30.4 Return value........................................................................................................................................59
7.30.5 Quick Info ...........................................................................................................................................59
7.31 CHIPVERSION PROPERTY .............................................................................................................................59
7.31.1 Description .........................................................................................................................................59
7.31.2 Syntax .................................................................................................................................................60
7.31.3 Parameters..........................................................................................................................................60
7.31.4 Remarks..............................................................................................................................................60
7.31.5 Return value........................................................................................................................................60
7.31.6 Quick Info ...........................................................................................................................................60
8
ENUMERATION CONSTANTS .....................................................................................................................61
8.1
8.2
8.3
8.4
8.5
8.6
9
PARAMCODESEEPROM ENUMERATION .......................................................................................................61
PARAMCODESRAM ENUMERATION..............................................................................................................64
MEASUREPARAMETERS ENUMERATION ........................................................................................................65
MEASURETYPES ENUMERATION ...................................................................................................................65
SETTINGCODES ENUMERATION ....................................................................................................................65
SOLVERSETTINGCODES ENUMERATION ........................................................................................................66
DISCLAIMER..................................................................................................................................................68
MLX90316 PSF Library Object Model
22-09-05
-8-
!"$#&% ' % )(*+ % +,#&-& % "$ % +
MLX90316 PSF is MS Windows software library, which meets the requirements for a Product Specific
Functions (PSF) module, defined in Melexis Programmable Toolbox (MPT) object model. The library
implements in-process COM objects for interaction with MLX90316 firmware for Melexis PTC04 programmers.
It is designed primarily to be used by MPT Framework application, but also can be loaded as a standalone inprocess COM server by other applications that need to communicate with the above-mentioned Melexis
products.
!#"
MPT object model specifies that a PSF module must expose two COM objects which implement certain COM
interfaces. MLX90316 PSF implements these two objects and two additional objects for advanced operations.
$
•
MLX90316PSFManager object – implements IPSFManager standard MPT interface. This is a standard
PSFManager object. MPT Framework and other client applications create a temporary instance of that
object, just for device scanning procedure. After that this instance is released.
This is the first required object. Refer to MPT Developer Reference document for more information about
PSFManager object and IPSFManager interface.
•
MLX90316PSFDevice object – implements IMLX90316PSFDevice specific interface. However, this
interface derives from IMPTDevice standard MPT interface and therefore MLX90316PSFDevice also
implements the functionality of MPTDevice standard MPT object. In addition to standard IMPTDevice
methods, IMLX90316PSFDevice interface exposes methods, which are specific to this library. They are
described in this document.
This is the second required COM object. Refer to MPT Developer Reference document for more
information about MPTDevice object and IMPTDevice interface.
•
MLX90316PSFAdvanced object – implements IMLX90316PSFAdvanced library specific interface.
This object implements advanced functions that would be rarely used in order to perform specific
operations not available with the standard device functions. In general, most of the methods of that object
provide direct access to MLX90316 firmware commands implemented in PTC04 programmer.
•
MLX90316PSFSolver object - implements IMLX90316PSFSolver library specific interface. This object
provides methods to easy tune your product in your application
&%' (*) )#(+-,.'!0/21 #( ,(*#34
MLX90316PSFManager
MLX90316PSFDevice
MLX90316 PSF Library Object Model
Solver
MLX90316PSFSolver
Advanced
MLX90316PSFAdvanced
PTC04
PTC04PSFDevice
22-09-05
-9-
!"$#&% ' % )(*+ % +,#&-& % "$ % +
.
13
( ,
IMLX90316PSFDevice
IPSFManager
IMPTDevice
IDispatch
IDispatch
ISupportErrorInfo
MLX90316PSF
Device
MLX90316PSF
Manager
MLX90316PSF
Solver
ISupportErrorInfo
IPersist
IMLX90316PSFSolver
IMLX90316PSFAdvanced
ISupportErrorInfo
IDispatch
IPTC04PSFDevice
ISpecifyPropertyPages
MLX90316PSF
Advanced
ISupportErrorInfo
IDispatch
IMPTDevice
IDispatch
PTC04PSF
Device
ISupportErrorInfo
ISpecifyPropertyPages
IPersist
MLX90316 PSF Library Object Model
22-09-05
- 10 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
, ( ). !
This object is created only once and is destroyed when the library is unmapped from process address space. Each
subsequent request for this object returns the same instance.
MLX90316PSFManager object implements standard MPT category CATID_MLXMPTPSFSerialModule,
which is required for automatic device scanning. C++ standalone client applications can create an instance of
this object by using the standard COM API CoCreateInstance with class ID CLSID_MLX90316PSFManager,
or ProgID “MPT. MLX90316PSFManager”:
hRes = ::CoCreateInstance(CLSID_MLX90316PSFManager, NULL, CLSCTX_INPROC,
IID_IPSFManager, (void**) &pPSFMan);
Visual Basic applications should call CreateObject function to instantiate MLX90316PSFManager:
Set PSFMan = CreateObject(“MPT. MLX90316PSFManager”)
The primary objective of this instantiation is to call ScanStandalone method. C++:
hRes = pPSFMan->ScanStandalone(dtSerial, varDevices, &pDevArray);
Or in Visual Basic:
Set DevArray = PSFMan.ScanStandalone(dtSerial)
ScanStandalone function returns collection of MLX90316PSFDevice objects, one for each connected PTC-04
programmer. The collection is empty if there are no connected programmers.
MLX90316 PSF Library Object Model
22-09-05
- 11 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
, ( ). !
This object implements standard MPT category CATID_MLXMPTPSFSerialDevice as well as library specific
CATID_MLXMPT90316Device
category.
It
also
declares
required
specific
category
CATID_MLXMPT90316UIModule for identification of required user interface modules.
This object can be created directly with CoCreateInstance/CreateObject or by calling the device scanning
procedure ScanStandalone of MLX90316PSFManager object. The following Visual Basic subroutine shows how
to instantiate MLX90316PSFDevice object by performing device scan on the system:
Sub CreateDevice()
Dim PSFMan As MLX90316PSFManager, DevicesCol As ObjectCollection, I As Long
On Error GoTo lError
Set PSFMan = CreateObject("MPT.MLX90316PSFManager")
Set DevicesCol = PSFMan.ScanStandalone(dtSerial)
If DevicesCol.Count <= 0 Then
MsgBox ("No PTC-04 programmers found!")
Exit Sub
End If
' Dev is a global variable of type MLX90316PSFDevice
‘ Select first device from the collection
Set Dev = DevicesCol(0)
MsgBox (Dev.Name & " device found on " & Dev.Channel.Name)
If DevicesCol.Count > 1 Then
For I = 1 To DevicesCol.Count - 1
' We are responsible to call Destroy(True) on the device objects we do not need
Call DevicesCol(I).Destroy(True)
Next I
End If
Exit Sub
lError:
MsgBox Err.Description
Err.Clear
End Sub
Developers can also manually connect the device object to a serial channel object thus bypassing standard device
scanning procedure. The following Visual Basic subroutine allows manual connection along with standard
device scanning depending on input parameter bAutomatic:
Sub CreateDevice(bAutomatic As Boolean)
Dim PSFMan As MLX90316PSFManager, DevicesCol As ObjectCollection, I As Long
Dim CommMan As CommManager, Chan As MPTChannel
On Error GoTo lError
If bAutomatic Then
' Automatic device scanning begins here
Set PSFMan = CreateObject("MPT.MLX90316PSFManager")
Set DevicesCol = PSFMan.ScanStandalone(dtSerial)
If DevicesCol.Count <= 0 Then
MsgBox ("No PTC-04 programmers found!")
Exit Sub
End If
If DevicesCol.Count > 1 Then
For I = 1 To DevicesCol.Count - 1
'We are responsible to call Destroy(True) on device objects we do not need
Call DevicesCol(I).Destroy(True)
Next I
End If
Set MyDev = DevicesCol(0)
Else
MLX90316 PSF Library Object Model
22-09-05
- 12 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
' Manual connection begins here
Set CommMan = CreateObject("MPT.CommManager")
Set MyDev = CreateObject("MPT.MLX90316PSFDevice")
I = ActiveWorkbook.Names("SerialPort").RefersToRange.Value2
Set Chan = CommMan.Channels.CreateChannel(CVar(I), ctSerial)
MyDev.Channel = Chan
' Check if a PTC04 programmer is connected to this channel
Call MyDev.CheckSetup(False)
End If
MsgBox (MyDev.Name & " programmer found on " & MyDev.Channel.Name)
Exit Sub
lError:
MsgBox Err.Description
Err.Clear
End Sub
MLX90316PSFDevice object implements IMPTDevice standard MPT interface. Please refer to MPT Developer
reference document for description of the properties and methods of this interface.
In addition MLX90316PSFDevice object implements IMLX90316PSFDevice library specific interface, which
derives from IMPTDevice. The following is a description of its properties and methods.
$
%' '
3 %2 1 -
This object supports all needs for a standard user.
With these basic functions, you’re able to discover this Melexis Product.
%'#" !& 1 ( #(+ 4
Specifies what die to be used by subsequent operations: It’s a soft switch, meaning that there is not an immediate
action visible on hardware.
All functions implemented in the library use the SelectedDevice property to determine what die (A or B) you‘re
working with. It also concerns settings as for example SetParameter.
DEFAULT: when never used, die A is selected.
!#" $%
Visual Basic:
Property SelectedDevice as Long
C++:
HRESULT get_SelectedDevice(/*[out,retval]*/ int* pValue);
HRESULT set_SelectedDevice(/*[in]*/ int Value);
&#$ $'() Value
A int specifying new value for the property. 1 selects die A and 2 selects die B.
pValue
MLX90316 PSF Library Object Model
22-09-05
- 13 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
An address of int variable that receives current value of the property. 1 specifies that die A is currently
selected and 2 specifies that die B is currently selected.
$ Visual Basic:
1 if die A is currently selected or 2 if die B is currently selected.
C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully. *pValue contains valid number.
Any other error code
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
( #(* 4
This property holds a reference to PTC04PSFDevice co-object.
!#" $%
Visual Basic:
Property PTC04 as Object
C++:
HRESULT get_PTC04(/*[out][retval]*/ LPDISPATCH* pVal);
HRESULT set_PTC04(/*[in]*/ LPDISPATCH Value);
&#$ $'() Value
An IDispatch* specifying new PTC04 object. Nothing happens if the object is the same instance as the
existing one. Otherwise MLX90316PSFDevice object releases its current PTC04 object and connects to
the new one. This also includes replacing of the communication Channel object with the one from the
new PTC04 object.
pVal
Address of IDispatch* pointer variable that receives the interface pointer to the PTC04 device object. If
the invocation succeeds, the caller is responsible for calling IUnknown::Release() on the pointer when it
is no longer needed.
$ Visual Basic:
MLX90316 PSF Library Object Model
22-09-05
- 14 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
A reference to the PTC04 co-object.
C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully. *pVal contains valid pointer.
Any other error code
The operation failed. *pVal contains NULL.
Header: Declared in MLX90316PSFModule_TLB.
% " ##(
(*(* 4
This is a read-only property which returns a reference to MLX90316PSFSolver co-object.
!#" $%
Visual Basic:
Property Solver as Object
Read only
C++:
HRESULT get_Solver(/*[out][retval]*/ IMLX90316PSFSolver** pVal);
&#$ $'() pVal
Address of IMLX90316PSFSolver* pointer variable that receives the interface pointer to the Solver
object. If the invocation succeeds, the caller is responsible for calling IUnknown::Release() on the
pointer when it is no longer needed.
$ Visual Basic:
A reference to the Solver co-object.
C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully. *pVal contains a valid pointer.
Any other error code
The operation failed. *pVal contains NULL.
Header: Declared in MLX90316PSFModule_TLB.h.
MLX90316 PSF Library Object Model
22-09-05
- 15 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
! ,. !
( #(* 4
This is a read-only property which returns a reference to MLX90316PSFAdvanced co-object.
!#" $%
Visual Basic:
Property Advanced as Object
Read only
C++:
HRESULT get_Advanced(/*[out][retval]*/ IMLX90316PSFAdvanced* pVal);
&#$ $'() pVal
Address of IMLX90316PSFAdvanced* pointer variable that receives the interface pointer to the
Advanced object. If the invocation succeeds, the caller is responsible for calling IUnknown::Release()
on the pointer when it is no longer needed.
$ Visual Basic:
A reference to the Advanced co-object.
C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully. *pVal contains a valid pointer.
Any other error code
The operation failed. *pVal contains NULL.
Header: Declared in MLX90316PSFModule_TLB.h.
&,! )#" " & 1 -- 3 !
Reads the whole EEPROM of MLX90316. Updates the internal EEPROM cache with values taken from the
chip. This method is provided to speed up the performance because it updates the whole cache with a single
command.
MLX90316 PSF Library Object Model
22-09-05
- 16 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
!#" $%
Visual Basic:
Sub ReadFullDevice()
C++:
HRESULT ReadFullDevice();
&#$ $'() None
$ C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully.
Any other error code
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
(* (*, & 1 -- 3!
Writes the whole EEPROM of MLX90316. Takes the values from the internal EEPROM cache.
Only the variables that are modified will be programmed.
!#" $%
Visual Basic:
Sub ProgramDevice()
C++:
HRESULT ProgramDevice();
&#$ $'() None
$ C++:
The return value obtained from the returned HRESULT is one of the following:
MLX90316 PSF Library Object Model
22-09-05
- 17 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
Return value
S_OK
Any other error code
Meaning
The operation completed successfully.
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
2
,(*, #(
!-- 3!
Returns the code of a particular EEPROM parameter as it is represented in EEPROM. It is optimized because it
uses the EEPROM cache maintained by the library. ReadFullDevice method could be called before calling
GetEEParameterCode to update the whole cache. However GetEEParameterCode works correctly even if
ReadFullDevice is not called.
!#" $%
Visual Basic:
Function GetEEParameterCode(paramID as ParamCodesEEPROM)
C++:
HRESULT GetEEParameterCode(/*[in]*/ ParamCodesEEPROM paramID, /*[out,retval]*/
TVariant* pVal);
&#$ $'() paramID
A ParamCodesEEPROM constant specifying the ID of the EEPROM parameter.
pVal
An address of VARIANT variable that will receive the return value of the method. The caller is
responsible to call VariantClear on that variable when it is no longer needed. The values are represented
as bytes or unsigned integers depending on the parameter.
$ Visual Basic:
A Variant containing the code of an EEPROM parameter.
C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully. *pVal contains a valid value.
Any other error code
The operation failed. *pVal is Empty.
MLX90316 PSF Library Object Model
22-09-05
- 18 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
Header: Declared in MLX90316PSFModule_TLB.h.
%'
,( , #(
!-- 3 !
Changes the code of a particular EEPROM parameter. The method works with the EEPROM cache maintained
by the library.
ProgramDevice method must be called in order to update the EEPROM of the chip with the codes from the
cache.
!#" $%
Visual Basic:
Sub SetEEParameterCode(paramID as ParamCodesEEPROM, Value)
C++:
HRESULT SetEEParameterCode(/*[in]*/ ParamCodesEEPROM paramID, /*[in]*/
TVariantInParam Value);
&#$ $'() paramID
A ParamCodesEEPROM constant specifying the ID of the EEPROM parameter.
Value
A VARIANT containing new code for the parameter.
$ C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully.
Any other error code
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
MLX90316 PSF Library Object Model
22-09-05
- 19 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
2
,(*, #( ," )-0 3 !
Returns the translated value of a particular EEPROM parameter. It first calls GetEEParameterCode method
and then translates the code of the parameter into a suitable value. For example, the parameter is
translated into a floating point number which represents degrees.
Translation is not defined for all parameters and this method returns an error if it receives paramID which is not
supported.
!#" $%
Visual Basic:
Function GetEEParameterValue(paramID as ParamCodesEEPROM)
C++:
HRESULT GetEEParameterValue(/*[in]*/ ParamCodesEEPROM paramID, /*[out,retval]*/
TVariant* pVal);
&#$ $'() paramID
A ParamCodesEEPROM constant specifying the ID of the EEPROM parameter.
pVal
An address of VARIANT variable that will receive the return value of the method. The caller is
responsible to call VariantClear on that variable when it is no longer needed.
$ Visual Basic:
A Variant containing the translated value of an EEPROM parameter.
C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully. *pVal contains a valid value.
Any other error code
The operation failed. *pVal is Empty.
Header: Declared in MLX90316PSFModule_TLB.h.
$
%'
,( , #('," )-- 3!
Changes the value of a particular EEPROM parameter. It first translates the value to a corresponding code and
then calls SetEEParameterCode method to modify the parameter in the cache. For example, this method
MLX90316 PSF Library Object Model
22-09-05
- 20 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
expects the parameter to be a floating point number which will be translated into a 2-byte code
which can be stored into the EEPROM.
Translation is not defined for all parameters and this method returns an error if it receives paramID which is not
supported.
ProgramDevice method must be called in order to update the EEPROM of the chip with the codes from the
cache.
!#" $%
Visual Basic:
Sub SetEEParameter(paramID as ParamCodesEEPROM, Value)
C++:
HRESULT SetEEParameter(/*[in]*/ ParamCodesEEPROM paramID, /*[in]*/
TVariantInParam Value);
&#$ $'() paramID
A ParamCodesEEPROM constant specifying the ID of the EEPROM parameter.
Value
A VARIANT containing new value for the parameter.
$ C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully.
Any other error code
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
2
!!-- 3!
Measures the VDD value of the selected device. Returns the value in a calibrated Voltage signal.
!#" $%
Visual Basic:
Function GetVdd() as Single
MLX90316 PSF Library Object Model
22-09-05
- 21 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
C++:
HRESULT GetVdd(/*[out,retval]*/ float* pVal);
&#$ $'() pVal
An address of float variable that will receive the return value of the method.
$ Visual Basic:
A Single containing the VDD value of the selected device.
C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully. *pVal contains a valid value.
Any other error code
The operation failed. *pVal is zero.
Header: Declared in MLX90316PSFModule_TLB.h.
2 !! 0 3 !
Measures the IDD value of the selected device.
!#" $%
Visual Basic:
Function GetIdd() as Single
C++:
HRESULT GetIdd(/*[out,retval]*/ float* pVal);
&#$ $'() pVal
An address of float variable that will receive the return value of the method.
$ Visual Basic:
A Single containing the IDD value of the selected device.
C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully. *pVal contains a valid value.
MLX90316 PSF Library Object Model
22-09-05
- 22 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
Any other error code
The operation failed. *pVal is zero.
Header: Declared in MLX90316PSFModule_TLB.h.
0, )#(*-0 3 !
Measures the resp. signal on the selected device and returns the value in %VDD or Absolute value or PWM. It is
important the relays controlling PWM or Voltage measurements (bits 2 and 3 of DB-IO byte accordingly for
DieA and DieB; PWM is on when the bit=1) to be properly set in advance. This can be done by the following
code fragments:
Visual Basic:
btDBIO = PTC.GetDBIO
If bPWM Then
btDBIO = btDBIO Or 4 Or 8
Else
btDBIO = btDBIO And (Not (4 Or 8))
End If
Call PTC.SetDBIO(btDBIO)
C++:
pPTC->GetDBIO(&btDBIO);
if (bPWM)
btDBIO |= (1 << 2) | (1 << 3);
else
btDBIO &= ~((1 << 2) | (1 << 3));
pPTC->SetDBIO(btDBIO);
!#" $%
Visual Basic:
Function Measure(paramOut as MeasureParameters, paramType as MeasureTypes) as Single
C++:
HRESULT Measure(/*[in]*/ MeasureParameters paramOut, /*[in]*/ MeasureTypes
paramType, /*[out,retval]*/ float* pVal);
&#$ $'() paramID
A MeasureParameters constant specifying the output to measure.
paramID
A MeasureTypes constant specifying the type of measurement.
pVal
An address of float variable that will receive the return value of the method.
MLX90316 PSF Library Object Model
22-09-05
- 23 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
$ Visual Basic:
A Single containing the result of measurement.
C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully. *pVal contains a valid value.
Any other error code
The operation failed. *pVal is zero.
Header: Declared in MLX90316PSFModule_TLB.h.
2
. " -- 3 !
Looks into the RAM, gets the measured angle (RAM address 18h) and converts it into Degrees – 0 till
359.999999.
!#" $%
Visual Basic:
Function GetAngle() as Single
C++:
HRESULT GetAngle(/*[out,retval]*/ float* pfAngle);
&#$ $'() pfAngle
An address of float variable that will receive the return value of the method in Degrees.
$ Visual Basic:
A Single containing the modified angle in Degrees.
C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully. *pfAngle contains a valid value.
Any other error code
The operation failed. *pfAngle is zero.
Header: Declared in MLX90316PSFModule_TLB.h.
MLX90316 PSF Library Object Model
22-09-05
- 24 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
& 1 2 " ,!-- 3 !
Informs the object that the sensor is replaced and the EEPROM cache and some internal variables should be
invalidated. Only the selected device is taken into account.
!#" $%
Visual Basic:
Sub DeviceReplaced()
C++:
HRESULT DeviceReplaced();
&#$ $'() None
$ C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully.
Any other error code
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
2
,(*, #(&- 3!
This function is obsolete and should not be used. It is superseded by GetEEParameterCode method.
Header: Declared in MLX90316PSFModule_TLB.h.
%'
,( , #(&- 3 !
This function is obsolete and should not be used. It is superseded by SetEEParameterCode method.
MLX90316 PSF Library Object Model
22-09-05
- 25 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
Header: Declared in MLX90316PSFModule_TLB.h.
MLX90316 PSF Library Object Model
22-09-05
- 26 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
# , ( ). !
This object cannot be created directly; it is only accessible as “Solver” property of MLX90316PSFDevice object.
MLX90316PSFSolver object implements IMLX90316PSFSolver library specific interface. The following is a
description of its methods.
# $
%' This object provides services to easy tune your product in your application.
When these functions are not fully serving your needs, you can check with your application contact into Melexis
how to get support.
Note: By using the MLX90316PSFDevice object, you’re always able to do everything what you want.
The methods below are based on following calibration principle:
Idea is that point A is the first point that is mechanical positioned.
Figure 6-1
MLX90316 PSF Library Object Model
22-09-05
- 27 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
# % " ##( '( !)(*
MLX90316 PSF Library Object Model
" 22-09-05
- 28 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
#
%'
(*!#1 ., - 3!
When the mechanical position is set to position A, this function will make the INITIALISATION for solving this
device.
Actions:
* This function will use the Angle parameter to calculate the DP point
* It will store the X and Y coordinates of point A to the device
* It will clear (means FFFF) the coordinates for point B, C, D
* It will clear (means 0) all the slopes S0, SA, SB and SC
NOTE: Also for all solver functions, only the selected device is taken into account!
!#" $%
Visual Basic:
Sub SetCoordinateA(Level as Single, Angle as Single)
C++:
HRESULT SetCoordinateA(/*[in]*/ float Level, /*[in]*/ float Angle);
&#$ $'() Level
A Single specifying Y coordinate of point A in %VDD (from 0.0 to 100.0).
Angle
A Single specifying X position of point A in degrees.
$ C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully.
Any other error code
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
#
%'
(*!#1 ., - 3!
This method is called when the mechanical position is set to position B. It will treat next action:
* This gets the current angle by asking the device for it
* It will store the X and Y coordinates of point B to the device
MLX90316 PSF Library Object Model
22-09-05
- 29 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
* It will calculate the Slope for A and copy it to the slope for B and C
NOTE: Also for all solver functions, only the selected device is taken in account!
!#" $%
Visual Basic:
Sub SetCoordinateB(Level as Single)
C++:
HRESULT SetCoordinateB(/*[in]*/ float Level);
&#$ $'() Level
A Single specifying Y coordinate of point B in %VDD (from 0.0 to 100.0).
$ C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully.
Any other error code
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
# %'
(*!#1 ., - 3!
This method is called when the mechanical position is set to position C. It will treat next action:
* This gets the current angle by asking the device for it
* It will store the X and Y coordinates of point C to the device
* It will calculate the Slope for B and copy it to the slope C
NOTE: Also for all solver functions, only the selected device is taken in account!
NOTE: If this step is not executed, no problem will appear. This can happen in the case of a two points solver.
!#" $%
Visual Basic:
Sub SetCoordinateC(Level as Single)
C++:
MLX90316 PSF Library Object Model
22-09-05
- 30 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
HRESULT SetCoordinateC(/*[in]*/ float Level);
&#$ $'() Level
A Single specifying Y coordinate of point C in %VDD (from 0.0 to 100.0).
$ C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully.
Any other error code
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
#
%'
(*!#1 . , - 3 !
This method is called when the mechanical position is set to position D. It will treat next action:
* This gets the current angle by asking the device for it
* It will calculate the Slope for C
NOTE: Also for all solver functions, only the selected device is taken in account!
NOTE: If this step is not executed, no problem will appear. This can happen in the case of a two points solver.
NOTE: This point also can be a fictive point, overwriting the slope for C can be done with the function
SetSlopeC.
!#" $%
Visual Basic:
Sub SetCoordinateD(Level as Single)
C++:
HRESULT SetCoordinateD(/*[in]*/ float Level);
&#$ $'() Level
A Single specifying Y coordinate of point D in %VDD (from 0.0 to 100.0).
$ MLX90316 PSF Library Object Model
22-09-05
- 31 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully.
Any other error code
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
#
#
%' %" %#-- 3 !
# %' %" %' %" # %' %" - 3 !
- 3 !
- 3 !
When you need a specific or fixed slope for resp A, B, C or S0, you can overwrite an eventual calculated slope
with this function.
!#" $%
Visual Basic:
Sub SetSlopeA(Slope as Single)
C++:
HRESULT SetSlopeA(/*[in]*/ float Slope);
&#$ $'() Slope
A Single specifying slope to overwrite default or calculated slope in [%VDD / DEG].
$ C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully.
Any other error code
The operation failed.
MLX90316 PSF Library Object Model
22-09-05
- 32 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
Header: Declared in MLX90316PSFModule_TLB.h.
# $
%'
" , 1 .
0 3 !
With this method, you can fix the levels for Clamping High \ Low. Usually this is the last step of the solver
procedure.
NOTE: Also for all solver functions, only the selected device is taken in account!
!#" $%
Visual Basic:
Sub SetClamping(LowLevel as Single, HighLevel as Single)
C++:
HRESULT SetClamping(/*[in]*/ float LowLevel, /*[in]*/ float HighLevel);
&#$ $'() LowLevel
A Single specifying low clamping level in %VDD (from 0.0 to 100.0).
HighLevel
A Single specifying high clamping level in %VDD (from 0.0 to 100.0).
$ C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully.
Any other error code
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
# %' ) 3 &,1 . - 3 !
Iterates over all available rough gain values (0->15) and then selects the best one for which FG=50%. Usually
this method is called just before SetCoordinateA method.
MLX90316 PSF Library Object Model
22-09-05
- 33 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
!#" $%
Visual Basic:
Sub SetRoughGain()
C++:
HRESULT SetRoughGain();
&#$ $'() None
$ C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully.
Any other error code
The operation failed.
# Header: Declared in MLX90316PSFModule_TLB.h.
3 ,( , #( 1 #2) ) - 3 !
With this method, you can measure and calculate coefficients (OutputDacGain;OutputDacOffset) for level
correction. The following is a detailed description of the steps:
1.
2.
3.
4.
Set Clamp Low\High to 5% and measure point1
Set Clamp Low\High to 95% and measure point2
Calculate to get OutputDacGain and OutputDacOffset
Set Clamp low = 0% and Clamp high = 100%
All subsequent calls to SetEEParameterValue method will calculate the level value to store in the EEPROM by
using the following formula:
DAC_Value_EEPROM [%VDD] = Requested_DAC_Value [%VDD] * Gain + Offset
All subsequent calls to GetEEParameterValue method will calculate the level value from that in the EEPROM
by using the following formula:
Returned_DAC_Value [%VDD] = (DAC_Value_EEPROM [%VDD] – Offset) / Gain
NOTE: Also for all solver functions, only the selected die is taken in account!
NOTE: Gain and Offset coefficients can be read or write directly with GetSolverSetting and SetSolverSetting
functions, setting codes SolverSettingOutputDACGain and SolverSettingOutputDACOffset
MLX90316 PSF Library Object Model
22-09-05
- 34 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
NOTE: Gain and Offset coefficients can be set to 1.0 and 0.0 respectively with a call to DeviceReplaced
method
!#" $%
Visual Basic:
Sub CharacterizeOutputDAC()
C++:
HRESULT CharacterizeOutputDAC();
None
$ &#$ $'() C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully.
Any other error code
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
# 4% " ##(*%' 1 .
,( , #( -- 3!
Copies all Solver settings (without Solver targets) to corresponding parameters in the EEPROM cache. Thus, a
client application could use just a profile to read the settings, optionally modify some of them and then do
CopySolverSettingsToParameters to set them in the EEPROM cache. This method should be called before
CharacterizeOutputDAC and SetRoughGain methods.
!#" $%
Visual Basic:
Sub CopySolverSettingsToParameters()
C++:
HRESULT CopySolverSettingsToParameters();
&#$ $'() None
MLX90316 PSF Library Object Model
22-09-05
- 35 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
$ C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully.
Any other error code
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
# 0 0" 0 3 !
Locks the EEPROM of the selected die. Such EEPROM cannot be modified anymore but can be read. Usually
this is the last step of the calibration procedure.
!#" $%
Visual Basic:
Sub Memlock()
C++:
HRESULT Memlock();
&#$ $'() None
$ C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully.
Any other error code
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
MLX90316 PSF Library Object Model
22-09-05
- 36 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
, ( ). !
This object cannot be created directly; it is only accessible as “Advanced” property of MLX90316PSFDevice
object.
MLX90316PSFAdvanced object implements IMLX90316PSFAdvanced library specific interface. The following
is a description of its methods.
$
%' - 3' %
! ,. !-
This object implements advanced functions that would be rarely used in order to perform specific operations not
available with the standard device functions. In general, most of the methods of that object provide direct access
to MLX90316 firmware commands, implemented in PTC04 programmer.
%'
'!!-0 3 !
Changes the VDD of MLX90316. This applies only to the selected die.
NOTE: Most of the PTC04 firmware commands manipulate VDD, thus the voltage set by this method is valid
until the next command is sent to the programmer. SetSetting method must be used if persistent voltage is
needed.
!#" $%
Visual Basic:
Sub SetVdd(fVdd as Single)
C++:
HRESULT SetVdd(/*[in]*/ float fVdd);
&#$ $'() fVdd
A Single specifying new VDD in voltages.
$ C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully.
Any other error code
The operation failed.
MLX90316 PSF Library Object Model
22-09-05
- 37 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
Header: Declared in MLX90316PSFModule_TLB.h.
%'
, - 3 !
Changes the VBat voltage of MLX90316 (PPS3 of PTC04). This applies to both dies.
NOTE: Many of the PTC04 firmware commands manipulate VBat, thus the voltage set by this method must be
considered valid until the next command is sent to the programmer. SetSetting method must be used if persistent
voltage is needed.
!#" $%
Visual Basic:
Sub SetVBat(fVBat as Single)
C++:
HRESULT SetVBat(/*[in]*/ float fVBat);
&#$ $'() fVBat
A Single specifying new VBat in voltages.
$ C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully.
Any other error code
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
%'#" & 1 -0 3 !
Immediately sends the SelectDevice command to PTC04 programmer.
!#" $%
Visual Basic:
Sub SelectDevice(nDev as Long)
MLX90316 PSF Library Object Model
22-09-05
- 38 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
C++:
HRESULT SelectDevice(/*[in]*/ int nDev);
&#$ $'() nDev
A Long specifying die A (1) or B (2).
$ C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully.
Any other error code
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
2 % 1 .
- 3 !
Returns the value of a particular setting.
!#" $%
Visual Basic:
Function GetSetting(settingID as SettingCodes)
C++:
HRESULT GetSetting(/*[in]*/ SettingCodes settingID, /*[out,retval]*/ TVariant* pVal);
&#$ $'() settingID
A SettingCodes constant specifying the ID of the setting.
pVal
An address of VARIANT variable that will receive the return value of the method. The caller is
responsible to call VariantClear on that variable when it is no longer needed.
$ Visual Basic:
MLX90316 PSF Library Object Model
22-09-05
- 39 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
A Variant containing the value of a setting.
C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully. *pVal contains valid value.
Any other error code
The operation failed. *pVal is Empty.
Header: Declared in MLX90316PSFModule_TLB.h.
%' %' 1 .
- 3 !
Changes the value of a particular setting. Sets an associated internal variable. The setting is also sent
immediately to PTC04 programmer.
NOTE: If necessary, the changes can be saved in the profile with a subsequent call to SaveProfile or
SaveProfileAs methods.
!#" $%
Visual Basic:
Sub SetSetting(settingID as SettingCodes, Value)
C++:
HRESULT SetSetting(/*[in]*/ SettingCodes settingID, /*[in]*/ TVariantInParam Value);
&#$ $'() settingID
A SettingCodes constant specifying the ID of the setting to modify.
Value
A VARIANT containing new value for the setting.
$ C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully.
Any other error code
The operation failed.
MLX90316 PSF Library Object Model
22-09-05
- 40 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
Header: Declared in MLX90316PSFModule_TLB.h.
.
%' 1 .
( #(* 4
Specifies if the setting will be stored in the profile when SaveProfile or SaveProfileAs methods are called.
These usage flags are also updated by OpenProfile method – a certain setting is marked as “used” if it exists in
the profile being opened, otherwise it is marked as unused and a default value is assigned to the setting itself.
!#" $%
Visual Basic:
Property SettingInUse(settingID as SettingCodes) as Boolean
C++:
HRESULT get_SettingInUse(/*[in]*/ SettingCodes settingID, /*[out,retval]*/
VARIANT_BOOL* pValue);
HRESULT set_SettingInUse(/*[in]*/ SettingCodes settingID, /*[in]*/ VARIANT_BOOL Value);
&#$ $'() settingID
A SettingCodes constant specifying the ID of the setting to get or modify its usage.
pValue
An address of VARIANT_BOOL variable that receives current value of the property.
VARIANT_TRUE means that the associated setting is used, VARIANT_FALSE means unused.
Value
A VARIANT_BOOL specifying new value for the property. VARIANT_TRUE marks the associated
setting as used, VARIANT_FALSE – as unused.
$ Visual Basic:
True if the associated setting is in use, False otherwise.
C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully. *pValue contains valid value.
Any other error code
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
MLX90316 PSF Library Object Model
22-09-05
- 41 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
2 %'" ##(*%' 1 .
- 3!
Returns the value of a particular solver setting.
NOTE: The module is just a container for the solver settings and completely ignores them. This method provides
an interface for higher layers to access the contents of the profile. The higher layers are responsible to read these
settings when necessary and put them at the right places (usually the EEPROM of the selected die) as part of
their solver sequence.
NOTE: The solver targets, kept in the profile, are also accessible with this method.
!#" $%
Visual Basic:
Function GetSolverSetting(settingID as SolverSettingCodes)
C++:
HRESULT GetSolverSetting(/*[in]*/ SolverSettingCodes settingID, /*[out,retval]*/ TVariant*
pVal);
&#$ $'() settingID
A SolverSettingCodes constant specifying the ID of the solver setting.
pVal
An address of VARIANT variable that will receive the return value of the method. The caller is
responsible to call VariantClear on that variable when it is no longer needed.
$ Visual Basic:
A Variant containing the value of a solver setting.
C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully. *pVal contains valid value.
Any other error code
The operation failed. *pVal is Empty.
Header: Declared in MLX90316PSFModule_TLB.h.
MLX90316 PSF Library Object Model
22-09-05
- 42 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
%' % " ##(+% 1 .
3 !
Changes the value of a particular solver setting.
NOTE: If necessary, the changes can be saved in the profile with a subsequent call to SaveProfile or
SaveProfileAs methods.
NOTE: The module is just a container for the solver settings and completely ignores them. This method provides
an interface for higher layers to change the contents of the profile. The higher layers are responsible to read these
settings when necessary and put them at the right places (usually the EEPROM of the selected die) as part of
their solver sequence.
NOTE: The solver targets, kept in the profile, are also accessible with this method.
!#" $%
Visual Basic:
Sub SetSolverSetting(settingID as SolverSettingCodes, Value)
C++:
HRESULT SetSolverSetting(/*[in]*/ SolverSettingCodes settingID, /*[in]*/ TVariantInParam
Value);
&#$ $'() settingID
A SolverSettingCodes constant specifying the ID of the solver setting to modify.
Value
A VARIANT containing new value for the solver setting.
$ C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully.
Any other error code
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
% "#
#(+% 1 .
.
( #(+ 4
Specifies if the solver setting will be stored in the profile when SaveProfile or SaveProfileAs methods are
called. These usage flags are also updated by OpenProfile method – a certain solver setting is marked as “used”
MLX90316 PSF Library Object Model
22-09-05
- 43 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
if it exists in the profile being opened, otherwise it is marked as unused and a default value is assigned to the
setting itself.
NOTE: The usage of the solver targets, kept in the profile, is also accessible with this method.
!#" $%
Visual Basic:
Property SolverSettingInUse(settingID as SolverSettingCodes) as Boolean
C++:
HRESULT get_SolverSettingInUse(/*[in]*/ SolverSettingCodes settingID, /*[out,retval]*/
VARIANT_BOOL* pValue);
HRESULT set_SolverSettingInUse(/*[in]*/ SolverSettingCodes settingID, /*[in]*/
VARIANT_BOOL Value);
&#$ $'() settingID
A SolverSettingCodes constant specifying the ID of the solver setting to get or modify its usage.
pValue
An address of VARIANT_BOOL variable that receives current value of the property.
VARIANT_TRUE means that the associated solver setting is used, VARIANT_FALSE means unused.
Value
A VARIANT_BOOL specifying new value for the property. VARIANT_TRUE marks the associated
solver setting as used, VARIANT_FALSE – as unused.
$ Visual Basic:
True if the associated solver setting is in use, False otherwise.
C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully. *pValue contains valid value.
Any other error code
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
$
.
( 1 " - 3!
Opens the specified file and updates the settings.
MLX90316 PSF Library Object Model
22-09-05
- 44 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
!#" $%
Visual Basic:
Sub OpenProfile(FileName as String)
C++:
HRESULT OpenProfile(/*[in]*/ BSTR FileName);
&#$ $'() FileName
A String specifying the path of the file to open.
$ C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully.
Any other error code
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
% ,)#
( 1 " - 3 !
Saves the settings into a previously opened profile. This function fails if there is not a profile in use.
!#" $%
Visual Basic:
Sub SaveProfile()
C++:
HRESULT SaveProfile();
&#$ $'() None
$ C++:
MLX90316 PSF Library Object Model
22-09-05
- 45 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully.
Any other error code
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
% ,)#
( 1"
- 3!
Saves the settings into the specified file.
!#" $%
Visual Basic:
Sub SaveProfileAs(FileName as String)
C++:
HRESULT SaveProfileAs(/*[in]*/ BSTR FileName);
&#$ $'() FileName
A String specifying the path of the file.
$ C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully.
Any other error code
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
&,! )#" "
2
- 3 !
Reads the whole RAM of MLX90316. Updates the internal RAM cache with values taken from the chip. This
method is provided to speed up the performance because it updates the whole cache with a single command.
MLX90316 PSF Library Object Model
22-09-05
- 46 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
!#" $%
Visual Basic:
Sub ReadFullRAM()
C++:
HRESULT ReadFullRAM();
&#$ $'() None
$ C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully.
Any other error code
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
(* (*,
2
- 3!
Writes the whole RAM of MLX90316. Takes the values from the internal RAM cache.
Only the variables that are modified will be programmed.
!#" $%
Visual Basic:
Sub ProgramRAM()
C++:
HRESULT ProgramRAM();
&#$ $'() None
$ C++:
The return value obtained from the returned HRESULT is one of the following:
MLX90316 PSF Library Object Model
22-09-05
- 47 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
Return value
S_OK
Any other error code
Meaning
The operation completed successfully.
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
2
2
,( ,
(&- 3 !
Returns the code of a particular RAM parameter. It is optimized because it uses the RAM cache maintained by
the library. ReadFullRAM method could be called before calling GetRAMParameter to update the whole
cache. However GetRAMParameter works correctly even if ReadFullRAM is not called.
!#" $%
Visual Basic:
Function GetRAMParameter(paramID as ParamCodesRAM)
C++:
HRESULT GetRAMParameter(/*[in]*/ ParamCodesRAM paramID, /*[out,retval]*/ TVariant*
pVal);
&#$ $'() paramID
A ParamCodesRAM constant specifying the ID of the RAM parameter.
pVal
An address of VARIANT variable that will receive the return value of the method. The caller is
responsible to call VariantClear on that variable when it is no longer needed.
$ Visual Basic:
A Variant containing the value of a RAM parameter.
C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully. *pVal contains a valid value.
Any other error code
The operation failed. *pVal is Empty.
Header: Declared in MLX90316PSFModule_TLB.h.
MLX90316 PSF Library Object Model
22-09-05
- 48 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
%'
2
,(*, #(&- 3 !
Changes the code of a particular RAM parameter. The method works with the RAM cache maintained by the
library.
ProgramRAM method must be called in order to update the RAM of the chip with the codes from the cache.
!#" $%
Visual Basic:
Sub SetRAMParameter(paramID as ParamCodesRAM, Value)
C++:
HRESULT SetRAMParameter(/*[in]*/ ParamCodesRAM paramID, /*[in]*/ TVariantInParam
Value);
&#$ $'() paramID
A ParamCodesRAM constant specifying the ID of the RAM parameter to modify.
Value
A VARIANT containing new value for the RAM parameter.
$ C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully.
Any other error code
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
0
( 1 13
- 3 !
Sends MemWriteWithCRC command to PTC04 programmer. Writes 2 bytes into chip’s memory.
!#" $%
Visual Basic:
MLX90316 PSF Library Object Model
22-09-05
- 49 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
Sub MemWriteWithCRC(Addr as Long, Data as Long, Ack as Long, Tim as Long, T1 as Long,
T2 as Long, T3 as Long, T4 as Long)
C++:
HRESULT MemWriteWithCRC(/*[in]*/ long Addr, /*[in]*/ long Data, /*[out]*/ int* Ack,
/*[out]*/ int* Tim, /*[out]*/ int* T1, /*[out]*/ int* T2, /*[out]*/ int* T3, /*[out]*/
int* T4);
&#$ $'() Addr
A Long specifying memory address to modify in the chip. Only the lowest 16 bits are used.
Data
A Long containing new value to write in the chip. Only the lowest 16 bits are used.
Ack
An address of int variable that will receive the acknowledge data returned from the chip during the
communication. This pointer could be NULL if this value is not needed.
Tim
An address of int variable that will receive the Tim timing measured during the communication with the
chip. This pointer could be NULL if this value is not needed.
T1
An address of int variable that will receive the T1 timing measured during the communication with the
chip. This pointer could be NULL if this value is not needed.
T2
An address of int variable that will receive the T2 timing measured during the communication with the
chip. This pointer could be NULL if this value is not needed.
T3
An address of int variable that will receive the T3 timing measured during the communication with the
chip. This pointer could be NULL if this value is not needed.
T4
An address of int variable that will receive the T4 timing measured during the communication with the
chip. This pointer could be NULL if this value is not needed.
$ C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully.
Any other error code
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
MLX90316 PSF Library Object Model
22-09-05
- 50 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
$
0
( 1 -- 3 !
Sends MemWrite command to PTC04 programmer. Writes 2 bytes into chip’s memory.
!#" $%
Visual Basic:
Sub MemWrite(Addr as Long, Data as Long, Ack as Long, Tim as Long, T1 as Long, T2 as
Long)
C++:
HRESULT MemWrite(/*[in]*/ long Addr, /*[in]*/ long Data, /*[out]*/ int* Ack, /*[out]*/ int*
Tim, /*[out]*/ int* T1, /*[out]*/ int* T2);
&#$ $'() Addr
A Long specifying memory address to modify in the chip. Only the lowest 16 bits are used.
Data
A Long containing new value to write in the chip. Only the lowest 16 bits are used.
Ack
An address of int variable that will receive the acknowledge data returned from the chip during the
communication. This pointer could be NULL if this value is not needed.
Tim
An address of int variable that will receive the Tim timing measured during the communication with the
chip. This pointer could be NULL if this value is not needed.
T1
An address of int variable that will receive the T1 timing measured during the communication with the
chip. This pointer could be NULL if this value is not needed.
T2
An address of int variable that will receive the T2 timing measured during the communication with the
chip. This pointer could be NULL if this value is not needed.
$ C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully.
Any other error code
The operation failed.
MLX90316 PSF Library Object Model
22-09-05
- 51 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
Header: Declared in MLX90316PSFModule_TLB.h.
$ 0
&, !-- 3 !
Sends MemRead command to PTC04 programmer. Reads 2 bytes from chip’s memory.
!#" $%
Visual Basic:
Function MemRead(Addr as Long, CRCrec as Long) as Long
C++:
HRESULT MemRead(/*[in]*/ long Addr, /*[out]*/ int* CRCrec, /*[out,retval]*/ long* pData);
&#$ $'() Addr
A Long specifying memory address to read from the chip. Only the lowest 16 bits are used.
CRCrec
An address of int variable that will receive the CRC data returned from the chip during the
communication. This pointer could be NULL if this value is not needed.
pData
An address of long variable that will receive the return value of the method. Only the lowest 16 bits are
valid, the highest 16 bits are always zero.
$ Visual Basic:
A Long containing the value that is read from the chip’s memory.
C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully. *pData contains valid value.
Any other error code
The operation failed. *pData is zero.
Header: Declared in MLX90316PSFModule_TLB.h.
$$
&,! , 0
, - 3 !
Sends ReadData command to PTC04 programmer. Reads a certain number of words from the chip’s memory.
MLX90316 PSF Library Object Model
22-09-05
- 52 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
!#" $%
Visual Basic:
Function ReadData(Addr as Long, N as Long, Format as Long)
C++:
HRESULT ReadData(/*[in]*/ long Addr, /*[in]*/ long N, /*[in]*/ long Format, /*[out,retval]*/
TVariant* varData);
&#$ $'() Addr
A Long specifying memory address to start reading from the chip. Only the lowest 16 bits are used.
N
A Long specifying a number of words to be read (up to 125).
Format
A Long specifying the format of the returned data in varData. Possible values are:
Value
Format
1
Return value is an array of bytes
2
Return value is an ANSI string packed in bstrVal member of *varData. This is the
preferred format for C++ applications because of the best performance. It is a binary
data so the string can contain zeroes and may not be zero terminated. Callers can get its
real length by calling SysStringByteLen API on bstrVal member
4
Return value is an array of words (Integers). This is the preferred format for Visual
Basic applications
varData
An address of VARIANT variable that will receive the return value of the method. The caller is
responsible to call VariantClear on that variable when it is no longer needed.
$ Visual Basic:
A Variant containing the data read from the chip.
C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully. *varData contains valid value.
Any other error code
The operation failed. *varData is Empty.
Header: Declared in MLX90316PSFModule_TLB.h.
MLX90316 PSF Library Object Model
22-09-05
- 53 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
$
( 1 &, ,00 3 !
Sends WriteData command to PTC04 programmer. Writes a certain number of words into the chip’s memory.
!#" $%
Visual Basic:
Sub WriteData(Format as Long, arr)
C++:
HRESULT WriteData(/*[in]*/ long Format, /*[in]*/ TVariantInParam arr);
&#$ $'() Format
A Long specifying the format of the data in arr. Possible values are:
Value
Format
1
arr is an array of words (Integers) in the following format:
Add0
Word0
Add1
Word1
…
Word 0 H
…
or an array of bytes in the following format:
Add0 L
Add0 H
Word 0 L
where Add0 is the first memory address to change and Word0 is the new value for that
memory cell, Add1 is the second memory address and Word1 is the corresponding new
value and so on.
2
arr is an ANSI string packed in bstrVal member. This is the preferred format for C++
applications because of the best performance. It is a binary data so the string can contain
zeroes and may not be zero terminated.
arr
A VARIANT containing the data to be written.
$ C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully.
Any other error code
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
MLX90316 PSF Library Object Model
22-09-05
- 54 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
$
%' ,(*
0 3 !
Sends StartCom command to PTC04 programmer.
!#" $%
Visual Basic:
Sub StartCom()
C++:
HRESULT StartCom();
None
$ &#$ $'() C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully.
Any other error code
The operation failed.
$
Header: Declared in MLX90316PSFModule_TLB.h.
%' -)0 3 !
Sends SetDBMux command to PTC04 programmer.
!#" $%
Visual Basic:
Sub SetDBMux(MUXChanNr as Byte)
C++:
HRESULT SetDBMux(/*[in]*/ unsigned char MUXChanNr);
&#$ $'() MUXChanNr
MLX90316 PSF Library Object Model
22-09-05
- 55 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
A Byte specifying new channel for the mux.
$ C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully.
Any other error code
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
$)
/ 2 - 3!
Sends HotReset command to PTC04 programmer.
!#" $%
Visual Basic:
Function HotReset() As Long
C++:
HRESULT HotReset(/*[out,retval]*/ int* Ack);
&#$ $'() Ack
An address of int variable that will receive the acknowledge data returned from the chip during the
communication.
$ C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully. *Ack contains valid value.
Any other error code
The operation failed. *Ack is zero.
Header: Declared in MLX90316PSFModule_TLB.h.
MLX90316 PSF Library Object Model
22-09-05
- 56 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
$
2" 1 #-- 3 !
Sends NopAlive command to PTC04 programmer.
!#" $%
Visual Basic:
Function NopAlive() As Long
C++:
HRESULT NopAlive(/*[out,retval]*/ int* Ack);
&#$ $'() Ack
An address of int variable that will receive the acknowledge data returned from the chip during the
communication.
$ C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully. *Ack contains valid value.
Any other error code
The operation failed. *Ack is zero.
Header: Declared in MLX90316PSFModule_TLB.h.
$
/ ,
( 1 -- 3 !
Sends HamWrite command to PTC04 programmer.
!#" $%
Visual Basic:
Sub HamWrite()
C++:
HRESULT HamWrite();
MLX90316 PSF Library Object Model
22-09-05
- 57 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
&#$ $'() None
$ C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully.
Any other error code
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
$
1 .. & 1 -- 3!
Sends DisconnectUart command to PTC04 programmer. It disconnects the output of the chip from the Uart line
on the daughter board. Such disconnected output can be measured with external equipment.
There is no ConnectUart command. The firmware connects the output automatically when necessary.
!#" $%
Visual Basic:
Sub DisconnectDevice()
C++:
HRESULT DisconnectDevice();
&#$ $'() None
$ C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully.
Any other error code
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
MLX90316 PSF Library Object Model
22-09-05
- 58 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
1 .
( #(* 4
Specifies whether the objects (MLX90316PSFDevice, MLX90316PSFSolver and MLX90316PSFAdvanced)
perform logging of their activity.
!#" $%
Visual Basic:
Property Logging as Boolean
C++:
HRESULT get_Logging(/*[out,retval]*/ VARIANT_BOOL* pValue);
HRESULT set_Logging(/*[in]*/ VARIANT_BOOL Value);
&#$ $'() pValue
An address of VARIANT_BOOL variable that receives current value of the property.
VARIANT_TRUE means that logging is active, VARIANT_FALSE means inactive.
Value
A VARIANT_BOOL specifying new value for the property. VARIANT_TRUE activates the logging,
VARIANT_FALSE deactivates it.
$ Visual Basic:
True if logging is active, False otherwise.
C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully. *pValue contains valid value.
Any other error code
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
31 #( #1 . ( #(* 4
Specifies the version of the connected MLX90316 chip. This value determines the EEPROM map in use and
some settings, specific for each different version of the chip.
MLX90316 PSF Library Object Model
22-09-05
- 59 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
!#" $%
Visual Basic:
Property ChipVersion as Long
C++:
HRESULT get_ChipVersion(/*[out,retval]*/ long* pValue);
HRESULT set_ChipVersion(/*[in]*/ long Value);
&#$ $'() pValue
An address of Long variable that receives current value of the property.
Value
A Long specifying new value for the property. VARIANT_TRUE activates the logging,
VARIANT_FALSE deactivates it.
'($ Meaning of this property:
1
2
3
Chip is MLX90316ABB or MLX90316BAA
Chip is MLX90316BAC
Chip is MLX90316BAD
Normally this property is set once as part of the initialization of the software.
$ Visual Basic:
1
2
3
Chip is MLX90316ABB or MLX90316BAA
Chip is MLX90316BAC
Chip is MLX90316BAD
C++:
The return value obtained from the returned HRESULT is one of the following:
Return value
Meaning
S_OK
The operation completed successfully. *pValue contains valid value.
Any other error code
The operation failed.
Header: Declared in MLX90316PSFModule_TLB.h.
MLX90316 PSF Library Object Model
22-09-05
- 60 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
# ,( , ! 2
#.')
# (*, 1 .
The following constants refer to parameters in EEPROM. They are used by GetEEParameterCode,
SetEEParameterCode, GetEEParameterValue and SetEEParameterValue methods.
Parameters with translation value ‘-‘ are not supported by GetEEParameterValue and
SetEEParameterValue methods.
!" #$ % &')(*+ , , $ -- , . /0/1. $ &
2 34 5 6
7 . % - ,8 , 9 + $ . 7
2 2 ' 6
:; 5 6
2 $ 7 . - . < . - =
. 7 /'% - >0? @'> 1 A
B! C
C" /0D E 2 $ 7 ,+ - D + -B% -! C F
# ! G 2
64 H
# !1G G 2 I
J4 5 6
, - > , , ,B? % . % $ 7 A
I!
4 5 6
, - > , , ,B? ! $ 0 , ,8 % - , A
7 , < G . $ 1 8 8 7 -B , . 8 -8 , /M : K F- N! C F
2 D /
: K
L
!
? L K 3 6 #O O A
7 , < G . $ 1 8 8 7 -B , . 8 -8 , /M : K F- N! C F
2 D PB/
: K
K
!
? L K 3 6 #O O A
7 , < G . $ 1 8 8 7 -B , . 8 -8 , /Q! C F- ) ! C F
2 D ! C
!
? L K 3 6 #O O A
7 , < G . $ 1 8 8 7 -B , . 8 -8 , /Q! C F- ) ! C F
2 D P ! C
!
!
? L K 3 6 #O O A
R
3S 5 6
R1 R!
: 5 6
RB! RB3
CT 5 6
R3N # O R
6S 5 6
$ % U 7 % . U1% $ 0 U + &/' 7
K
JS V 7 . + % 8 8 7 -B% -! C F WBONXK
PK
S PY 7 . + % 8 8 7 -B% -! C F WBONXK
+ - D + -7 - % & 7% $ % &'
ZV[/' 2 R
L
6
\ 7 1 \ ] W \ R1- 07 + - D + -B7 - % & R #RB^ ]B O P B_! K` Za_8 % -b & cd R #RB^ ]B O P B G .- ,
! e Za
2 -G . - , - = D \ 2 R
! !f Za
\ 2 R' \ 2 RB!
! 3` Zg 6
\ 2 R!0 \ 2 R3
! :h Zg 6
\ 2 RB3 RB 6
! Cij 6
R. 7 $ - . $ + . - =0D . $ -? @'> 1 A
Z
8
%
] 2 K
!6
6 b kNlB & c $ . - . % 7 D 0? 7 D 0U 8 , 0D . $ -#A
] #
! J` Zg 6m8 % -b & cn) , . $ % - 1 8D . $ - #
] # P
! ` Zg 6;8 % -b kNlB cPV , . $ % - 1 8BD . $ - #
] #B2
! L Z 6 b kNlB8 % - & c 2 D 0% 8 - ,D . $ - #
]O 3 K` Zg 6m8 % -b & cn) , . $ % - 1 8D . $ -O
]O P
3e Zg 6;8 % -b kNlB cPV , . $ % - 1 8BD . $ -O
]O 2
3 ! Z 6 b kNlB8 % - & c 2 D 0% 8 - ,D . $ -O
MLX90316 PSF Library Object Model
22-09-05
- 61 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
] ] P
] 2
#
Z
#
IB BI
G B #
G B #!
R 6
\ 2 G BK
\ BI #B ]
G I P2 ] IB 2 ] IB 2 IB
RBI P2 B 6
RB \ #B 2 ]2
RB2 2 RB 2 ]BG # \ R3 ZV RBG ]B #B ]
Bl \ !
R B#
RB \ G #J C
#] # \ RB I #] # B
#BG B
\ R
\ ]
\ ZV
\ B! R
\ B! ]
\ B! ZV
- % - . $ R. , - . $
IB2
RB 2 BIB!
#B B
ZVG
2
2 IB BI
2 2 3 3` Zg 6m8 % -b & cn) , . $ % - 1 8D . $ -B
3 :h Zg 6;8 % -b kNlB cPV , . $ % - 1 8BD . $ -B
3 C Z 6 b kNlB8 % - & c 2 D 0% 8 - ,D . $ -B
3 6` Zg 6;8 % -b kNlB cH @[ % /1D . $ &1< % + 3 J` Zg 6;8 % -b kNlB cHI. & >1 % /0D . $ &0< % + 3 ` Zg 6
N8 . - , #' 8 8 . . $ 3 L` Zg 6
G B #B! [ :K
!
7 , < . @'$0D 7 . - . $0? @'> 1 A
:B 5 6
\ 2 G BKN : !f Za
\ BI #B ]Y : 3` Za
G I P2 Y : :h Za
] IB 2 : Cf Za
] IB 2 IB :6
8 % -b & cd 7 , < RBI P2 V : J` Za
N : S 5 6
= . ' E > :L
R. 7 % U . /1 + -. $0U = - 1 > % $ & CK
$ % U #B7 7 = /1 - , . % )2 $ 7 . < . - =
7 , < R. 7 % U 02 E . 7 /M% $ 0, - > , , ,
C
, , - . $0? L K 3 6 #O O A
C !f Z R. 7 % U 0 7 -B $0G % + 7 , < R. 7 % U 13ND . $ - 7
D . @'. 7 . $ % ,
C3
- , % $ 7 8 , /Q? L K 3 6 #O O A
C :h Z R. 7 % U 18 . $ 0& % . $1 $ - , CC
$ % U 1 $ 7 - % $ -B + - D + -< % + 1 $0 \ Z
R. 7 % U 0 $ - E + & >18 8 7 - #B % $ 1% 1%
C6
% + & >18 8 7 -. $ 7 - % C J` Z R. 7 % U . /1 + Z
G , 1 . , 0, % . + 7% + 7 - /1 $ -- 0J C k ? . $ 7 - % C
8L K kVA
CL
$ % U #$ % &N /0+ % - . $0? D , -! K ! K E E ! 3 A
6 K` Z R. 7 % U 0 > 6
$ % U #$ % &1 7 - 7
6 !f Z + & > B% . $
#B + 7 - /1 $ -$0G . $ % . $1 . D
6 3` Za3
. $1 \ 1/' 6 :h Z . $1 \ ' $ % U Z
. $1 \ ' $ % U Z)
?B% 7 0 > ZV
6C
% $ ZV A
66
. $1 \ !/' 6J
. $1 \ !0 $ % U 6
. $1 \ !0 $ % U Z)
Z
- % - . $0 . , - . $0? K XY + $ - , @'. 7 1 ,
6L
XY @
. 7 A
Z
@ @
,B? % A/' 1 ,BI. & > 2 D JK
? B> , - - A/' Je Z R. 7 % U 0 , - > & $ % . - =1 , , , 8 - > 0! , ,
J !f Z #+ - /'% - . ' + & > B% . $1 $ - , 7 - % , - + D
J 3S H
RB 8 . $ 7- > 0 ZV[G , 9 + $ =0? L K 3 6 #O O A
Z
$ % U 12 D , - ?B + -1X 2 W + - ! X
J:
:
'% $ + - 3NX) 2 2 A
J CT I. & >12 D N 07 . % - ,BG , 9 + $ =
J 6S 2 $ 7 . - . < . - =/1. 7 /1% - >1 , , - . $'8 % - ,
MLX90316 PSF Library Object Model
22-09-05
- 62 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
2 Z
2 2 P
RB
R
RK
] lB2 # ! 2 R #B IB 2
ZV
G 2 2 G 2 2 IBB
G 2 2 R
P G 2 2 P G 2 2 IB
P G 2 2 R
\ 2 G IB 2
G !
I #IB ZV
ZV ZV !
#BRB K
#BRB IB 2 Z
IB 2 IB I
R #RR #B]
R \ ]B]G # \ ]G #B B
# ! 2 IBB
# ! 2 R
#B ]B ]
#B ]BB#
2]
JJ
3
J S 3
J LS KS e Zg C
!
!
3
Z
:
C
6S H
JS 5 6
6
L LK L 6
L! L3 L : 5 6
LC
L 6` Z 6
L J` Z 6
L ` Z L L Z K K Z K Z K ! Z K 3 Z :
K: Z :
K C Z K 6 Z K J Z K
KL
K
!
MLX90316 PSF Library Object Model
7 , < #$ % &0> % . $
/1D , % - + , 8 8 . . $ - + & >', . /0/1. $ &
+ , , $ -B7 + , 7- , . /0/0. $ &
@ @
,B 17 . % - ,BG , 9 + $ =
2 2 =0U . -. $12 2 ' 60 ? 2 2 'b c A
8 % -b & cdR. 7 $ - . $ + . - =0D . $ -? K F E E 3 6 K F A
8 % -b & cd . @'$0D 7 . - . $
. @'$0D 7 . - . $ 2 O? RBK A
$ < , -7 . & $1 8B + & >18 8 7 -B /0D $ 7 % - . $
? L K 3 6 #O O A
# ! 2 ? L K 3 6 O # A
R #B IB 2N ? L K 3 6 O # A
ZVY ? L K 3 6 O #B A
G 2 2 ? @'> 1 A
? L K 3 6 O # A
G 2 2 IBBY ? L K 3 6 O # A
G 2 2 R* ? L K 3 6 O # A
PG 2 2 ? @'> 1 A
? L K 3 6 O # A
PG 2 2 IBBV ? L K 3 6 O # A
PG 2 2 R* ? L K 3 6 O # A
\ 2 G 1 ? L K 3 6 O #B A
IB 2N ? L K 3 6 O # A
+ 7 0 BIB 2 Z0 BIB 2 IB I)- 7 < % + G ! ? L K 3 6 O #B A
I #
I 0 $ % U 0 ZV[I Z % $ 2 Z ? L K 3 6 O #B A
$ < , -D % , . - =1 8 \ '. $0 ZV[/1 ? L K 3 6 O # A
$ < , -D % , . - =1 8 \ B!0. $0 ZV[/1 ? L K 3 6 O # A
#R KNU . -. $ \ 2 G '? L K 3 6 O #B A
#R B1U . -. $ \ 2 G '? L K 3 6 O #B A
BIB 2 Z U . - 7
. $ IB 2
? L K 3 6 O # A
BIB 2 IB BI*U . - 7
. $ BIB 2
? L K 3 6 O # A
R. 7 % U '#BRBN% $ R #B)/' $ . - ,B? L K 3 6 O # A
R. 7 % U 0 + -. $18 % + -@'> $1 > . D0. $18 % + ? L K 3 6 O # A
]08 . $ 0& % . $1 + , . $ &'#B B)? L K 3 6 O #B A
# ! 2 IBY ? L K 3 6 O #BR O G A
# ! 2 RY ? L K 3 6 O #BR O G A
7 , < ? L K 3 6 O G A
7 , < ? L K 3 6 O G A
7 , < $ % U 02 ] V. $ - , 8 % 0? L K 3 6 O G A
22-09-05
- 63 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
2K
2
# R
K
1
#] # \ !
# $
,( ,
3
:
C
6
J
L
!
2
#. )
7 , < $ % U 02 ] )% $ 2 . $ - , 8 % 7
U - >0U . - 7
/0+ 7 -U )'? L K 3 6 O G A
7 , < $ % U 0% + - /1% - . '& % . $1 $ - , ? L K 3 6 O G A
7 , < RB + U '- > 0 + - D + -7 % /1D 1% $ > D , . ? L K 3 6 O G A
7 , < #R), 7 + - . $0/1 0? L K 3 6 O G A
7 , < $ % U 0% $ % & /0+ % - . $1! K O > E U 3
? L K 3 6 O G A
#( , 1 .
The following constants refer to parameters in RAM. They are used by GetRAMParameter and
SetRAMParameter methods
G #B2
\ BI #B ] % /
G ]B #B ]
2
2 ]
:
3
6
\ BIBG G 2 P
IB G G 2 IB G G 2 P
BI #B! BI # \ G . % & $ . - + IB
IB O #B
PB IB
PB IB O #
B # \ B O P B BZ
] B O P B
G 2 O P B
P G 2 O P B
J
C
\ BIBG G 2 MLX90316 PSF Library Object Model
!
L
K
!
3
:
C
6
J
!C
!6
L
!K
6>
>
L>
K #>
K >
K >. $
L K 3 6 #O O
: K >0. $
L K 3 6 O #B
K R>0. $
L K 3 6 #O O
:B >0. $
L K 3 6 O #B
: >
6>
>
#>
>
!:>
!6>
!>
! #>
3 #>
3O>
K>
>
!
, , ,8 % & 7
h + & >0& % . $
hG . $ 1& % . $
! % % & $ . 7 - . 8 . 0% /0D . - + 1 $'- > ! P % % & $ . 7 - . 8 . 0% /0D . - + 1 $'- > h + & >1 8 8 7 -. $1
h + & >1 8 8 7 -. $'P
! > D D ,B 8 8 7 -. $'
! > D D ,B 8 8 7 -. $
P
!`#$ & U 8 , D 7 -B , , - . $ 7
!`#$ & 0% 8 - ,% , , - . $ 7
! G . /1% & $ . - + 0? 7 9 + % , '< % + A
!h IB #BRBN + - D + !h IB O #0#BRBN + - D + !`PB IB #BRBN + - D + !`PB IB O #B#BRBN + - D + - , . /0/0/1D . $ , %& - + , 0 8- > 0 < . 1% 8 - ,
<N% + 2 O0 8 - > '- /0D , % - + , 17 $ 7 ,
G? . $ 1 L 8 K 8 73 -B6 O #, , A - . $'8 % - ,B. $'
G . $ 1 8 8 7 -B , , - . $'8 % - ,B. $
P
22-09-05
- 64 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
G 2
G 2 ]
R #B] O P B
#BRB] O P B
# 0, )#(*
!
!!
!3
!:
!>
3K>
C6>
CJ>
,(*, #( 0#. )
!
!
? L K 3 6 O # A
% & $ - . 8 . 0% /0D . - + 1 $'- > % . 7
? L K 3 6 O #B A
% & $ - . 8 . 0% /0D . - + 1 $'- > % . 7
? L K 3 6 O #B A
N/'7 U . - 7 8BR #)7 $ 7 , < % + ? L K 3 6 O # A
N/'7 U . - 7 8 #RN< % + 1@'> $
+ - D + -. 77 > , - ? L K 3 6 O # A
( , 1 .
The following constants specify different outputs of MLX90316. They are used by Measure method
#
% 7 \ % 7 \ B!
% 7 \ 3
% 7 lRBR
0, )#(*
40#.
3
:
)
% 7 + , 1 \ % 7 + , 1 \ !0?] #A
% 7 + , 1 \ 3? ] #BA
% 7 + , lRBR
!
#( , 1 .
The following constants specify different types of measurement. They are used by Measure method
% 7 , $ - lBRR
% 7 lB % 7 Z)
% 7 Z)
, . #
!0#.') %' 1 .
:
3
!
- + , $0, 7 + -. $1kNlRBR
- + , $0, 7 + -. $1% U 7 + - '< % + 0? /' % 7 + , '< - % & A
% 7 + , ZV
% 7 + , ZV D , . #(*, 1 .
The following constants specify different settings. They are used by GetSetting and SetSetting methods
and SettingInUse property
2 - - . $ & lRBR @
2 - - . $ & lRBR] , /
2 - - . $ & lRBRB /1/
h8 % -? 2 . $ & AK E KNb lc"P 7 2 (! < K
8 % -? 2 . $ & A C E KNb lc"P 7 2 (! < 3 8 % -? 2 . $ & AJ E Cb lc"P 7 2 (! < !
!
MLX90316 PSF Library Object Model
22-09-05
- 65 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
2 - - . $ & lO % - @
: 8 % -? 2 . $ & AK E KNb lc"P 7
2 - - . $ & lO % - ] , /
C 8 % -? 2 . $ & A6 E KNb lc"P 7
2 - - . $ & BD ,
6 $ &? $ & A ! K K K KNb 7 c P 7
2 - - . $ & 7 = $ > , J $ &? $ & A 6 K K KNb 7 c P 7
2 - - . $ & BD + 7 . $
$ &? $ & A : K K KNb 7 c P 7
2 - - . $ & BD + 7 %
L $ &? $ & A ! K K K KNb 7 c P 7
2 - - . $ & 2 = $ > , RB % =h K $ &? $ & Aj! K KNb 7 c P 7
2 - - .$ & O % + , % - $ &? $ & A
L 6 K KmP 7
2 - - . $ & RO % !5U = - 0? O = - A
2 - - . $ & % 7 + , R % = 3
2 - - . $ & 2 % /0D RB % = :
2 - - . $ & % 7 + , G . - ,e C
# % " ##(*% 1 .
K
P 7
$ &? $ & AT K K KNb 7 c P 7
$ &? $ & A KNb 7 cP 7
7 > ,KK
P 7
? $ - & ,A
!0#.
)
2 3 < K
2 3 < B. /0. $ &0K
B. /0. $ &)
B. /0. $ &!
B. /0. $ &03
B. /0. $ &1:
/0/0+ $ . % - . $0U % + , % - B - 7 -- > 0 % 0 $'- > + - D + - 7 $'- > 1 % + & > - ,
U % , E 7 7 . U 1< % + 7
% , $ 7 . 7 % - , 7
C 61- N 2 3
% $ ) : J0- 'lRBRY? D + + D 7
7 - A
7 . 7 - , 71 K 1- ]R
? D + @'$ 7
7 - A
O - >0D + + D 7
% $ ND + ! @'$ 77 - RB % =U 8 , 0/1 % 7 + , /1 $ 2 % /0D 0 % =
% 7 + , 18 . - ,
( , 1 .
The following constants specify different settings. They are used by GetSolverSetting and
SetSolverSetting methods and SolverSettingInUse property
2 < , 2 - - . $ & RB % ^ $ S8 % -? 2 . $ & A K E KNb & cnP 7
2 < , 2 - - . $ & % /0D . $ & @
!a8 % -? 2 . $ & A5K E KNb kNlRBRBc P 7
2 < , 2 - - . $ & % /0D . $ & I. & >
3 8 % -? 2 . $ & A K K E KNb kNlRBRc P 7
2 < , 2 - - . $ & - % - . $ R. , - . $T:
O % $ G % 7 0 ? @' +. 7 $ - A , P 7
2 < , 2 - - . $ & + - D + - R # B% . $
Ca8 % -? 2 . $ & A
EK
] 2 < , 2 - - . $ & + - D + - R # 8 8 7 - 6 8 % -? 2 . $ & A5K E KNb kNlRBRBc ] KN? % $ % &
2 < , 2 - - . $ & + - D + - = D J U = - 0? O = - A
P 7
+ -D + -A
2 < , 2 - - . $ & + - D + - U = - 0? O = - A
:
P 7
G
%
7
0
?
@
2 < , 2 - - . $ & #D D . % - . $ 2 D HL
O % $
D @
,B/1 A P 7
2 < , 2 - - . $ & G . - ,
K U = - 0? O = - A
C
P 7
2 < , 2 - - . $ & 2 D O % $ G % 7 0? D 7 . - . < P 7
MLX90316 PSF Library Object Model
RB % $ % /0D . $ & @
% /0D . $ &N> . & >
- % - . $0 . , - . $
+ - D + - R #B % . $
8 8 . . $ + - D + - R #B 8 8 7 8 8 . . $ + - D + -- = D KB% $ % &
ZV
!0B2 + - D + -/1 @
,B/1 G . - ,B7 - - . $ &
B> 07 . & $1 8 - > 22-09-05
- 66 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
7 D A
2 < , 2 - - . $ & ZV
G , 9
2 < , % , & - #$ & . $ - #
2 < , % , & - < . $ - #
2 < , % , & - < . $ - O
2 < , % , & - < . $ - 2 < , % , & - < . $ - R
2 < , % , & - 2 D 2 K
2 < , % , & - 2 D 2 #
2 < , % , & - 2 D 2 O
2 < , % , & - 2 D 2 ! 8 % -? 2 . $ & A K K E KNb I c"P 7
K Kf8 % -? 2 . $ & A K E KNb & cnP 7
K 8 % -? 2 . $ & A5K E KNb kNlRBRBc P 7
K ! 8 % -? 2 . $ & A5K E KNb kNlRBRBc P 7
K 3f8 % -? 2 . $ & A5K E KNb kNlRBRBc P 7
K :`8 % -? 2 . $ & A5K E KNb kNlRBRBc P 7
K C 8 % -? 2 . $ & A b kNlRBK R E K & c ]
K 6f8 % -? 2 . $ & A b kNlRBK R E K & c ]
K Jf8 % -? 2 . $ & A b kNlRBK R E K & c ]
K f8 % -? 2 . $ & A b kNlRBK R E K & c ]
7 D G % 7 D 7 .- .< 7 D 0 ? 8 % + % D D . % - . $ A
B, + $ & % - . < 7 D ZV8 , 9 + $ =
% . 7
D . $ - #
P % . 7
D . $ - #
P % . 7
D . $ -O
P % . 7
D . $ -B
P % . 7
D . $ -R
2 D U 8 , 0D . $ - #
?2 K A
2 D 0% 8 - ,D . $ - #
? 2 #A
2 D 0% 8 - ,D . $ -O
?2 O A
2 D 0% 8 - ,D . $ -B
?2 A
* These settings are never saved to or read from the profile, thus they are constantly marked as unused
MLX90316 PSF Library Object Model
22-09-05
- 67 -
!"$#&% ' % )(*+ % +,#&-& % "$ % +
&
Devices sold by Melexis are covered by the warranty and patent indemnification provisions appearing in its
Term of Sale. Melexis makes no warranty, express, statutory, implied, or by description regarding the
information set forth herein or regarding the freedom of the described devices from patent infringement.
Melexis reserves the right to change specifications and prices at any time and without notice. Therefore,
prior to designing this product into a system, it is necessary to check with Melexis for current information.
This product is intended for use in normal commercial applications. Applications requiring extended
temperature range, unusual environmental requirements, or high reliability applications, such as military,
medical life-support or life-sustaining equipment are specifically not recommended without additional
processing by Melexis for each application.
The information furnished by Melexis is believed to be correct and accurate. However, Melexis shall not be
liable to recipient or any third party for any damages, including but not limited to personal injury, property
damage, loss of profits, loss of use, interrupt of business or indirect, special incidental or consequential
damages, of any kind, in connection with or arising out of the furnishing, performance or use of the technical
data herein. No obligation or liability to recipient or any third party shall arise or flow out of Melexis’ rendering
of technical or other services.
© 2004 Melexis NV. All rights reserved.
website at:
www.melexis.com
Or for additional information contact Melexis Direct:
Europe and Japan:
Phone: +32 13 67 04 95
E-mail: [email protected]
All other locations:
Phone: +1 603 223 2362
E-mail: [email protected]
QS9000, VDA6.1 and ISO14001 Certified
MLX90316 PSF Library Object Model
22-09-05
- 68 -