
files into your project. In the second case, Visual Studio simply keeps a link on the original files. We
recommend you to use links, which makes updates of the library much easier.
Then add in the same manner the
yapi.dll
DLL, located in the
Sources/dll
directory
4
. Then,
from the
Solution Explorer
window, right click on the DLL, select
Properties
and in the
Properties
panel, set the
Copy to output folder
to
always
. You are now ready to use your Yoctopuce modules
from Visual Studio.
In order to keep them simple, all the examples provided in this documentation are console
applications. Naturally, the libraries function in a strictly identical manner if you integrate them in an
application with a graphical interface.
12.3. Control of the RangeFinder function
A few lines of code are enough to use a Yocto-RangeFinder. Here is the skeleton of a Visual Basic
code snipplet to use the RangeFinder function.
[
...
]
Dim
errmsg
As
String
errmsg
Dim
rangefinder
As
YRangeFinder
REM Get access to your device, connected locally on USB for instance
yRegisterHub
(
"usb"
, errmsg
)
rangefinder = yFindRangeFinder
(
"YRNGFND1-123456.rangeFinder"
)
REM Hot-plug is easy: just check that the device is online
If
(
rangefinder.
isOnline
())
Then
REM Use rangefinder.get_currentValue(), ...
End
If
Let's look at these lines in more details.
yRegisterHub
The
yRegisterHub
function initializes the Yoctopuce API and indicates where the modules should
be looked for. When used with the parameter
"usb"
, it will use the modules locally connected to the
computer running the library. If the initialization does not succeed, this function returns a value
different from
YAPI_SUCCESS
and
errmsg
contains the error message.
yFindRangeFinder
The
yFindRangeFinder
function allows you to find a range finder from the serial number of the
module on which it resides and from its function name. You can use logical names as well, as long
as you have initialized them. Let us imagine a Yocto-RangeFinder module with serial number
YRNGFND1-123456
which you have named "
MyModule
", and for which you have given the
rangeFinder
function the name "
MyFunction
". The following five calls are strictly equivalent, as long
as "
MyFunction
" is defined only once.
rangefinder = yFindRangeFinder
(
"YRNGFND1-123456.rangeFinder"
)
rangefinder = yFindRangeFinder
(
"YRNGFND1-123456.MyFunction"
)
rangefinder = yFindRangeFinder
(
"MyModule.rangeFinder"
)
rangefinder = yFindRangeFinder
(
"MyModule.MyFunction"
)
rangefinder = yFindRangeFinder
(
"MyFunction"
)
yFindRangeFinder
returns an object which you can then use at will to control the range finder.
isOnline
The
isOnline()
method of the object returned by
yFindRangeFinder
allows you to know if
the corresponding module is present and in working order.
4
Remember to change the filter of the selection window, otherwise the DLL will not show.
12. Using Yocto-RangeFinder with Visual Basic .NET
72
www.yoctopuce.com
Содержание Yocto-RangeFinder
Страница 1: ...Yocto RangeFinder User s guide...
Страница 2: ......
Страница 18: ...12 www yoctopuce com...
Страница 26: ...20 www yoctopuce com...
Страница 42: ...36 www yoctopuce com...
Страница 70: ...gcc lyocto lm lpthread lusb 1 0 lstdc 10 Using Yocto RangeFinder with C 64 www yoctopuce com...
Страница 90: ...84 www yoctopuce com...
Страница 120: ...114 www yoctopuce com...
Страница 130: ...124 www yoctopuce com...
Страница 158: ...21 High level API Reference On failure throws an exception or returns a negative error code 152 www yoctopuce com...
Страница 484: ...478 www yoctopuce com...
Страница 488: ...482 www yoctopuce com...
Страница 490: ...23 Characteristics 484 www yoctopuce com...
Страница 491: ......
Страница 492: ......