}
[
...
]
Let us look at these lines in more details.
YAPI.RegisterHub
The
yAPI.RegisterHub
function initializes the Yoctopuce API and indicates where the modules
should be looked for. The parameter is the address of the Virtual Hub able to see the devices. If the
initialization does not succeed, an exception is thrown.
YLatitude.FindLatitude
The
YLatitude.FindLatitude
function allows you to find a latitude sensor 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-GPS module with serial number
YGNSSMK1-123456
which you have named "
MyModule
", and for which you have given the
latitude
function the name "
MyFunction
". The following five calls are strictly equivalent, as long as
"
MyFunction
" is defined only once.
latitude = YLatitude.
FindLatitude
(
"YGNSSMK1-123456.latitude"
)
latitude = YLatitude.
FindLatitude
(
"YGNSSMK1-123456.MyFunction"
)
latitude = YLatitude.
FindLatitude
(
"MyModule.latitude"
)
latitude = YLatitude.
FindLatitude
(
"MyModule.MyFunction"
)
latitude = YLatitude.
FindLatitude
(
"MyFunction"
)
YLatitude.FindLatitude
returns an object which you can then use at will to control the
latitude sensor.
isOnline
The
isOnline()
method of the object returned by
YLatitude.FindLatitude
allows you to
know if the corresponding module is present and in working order.
get_latitude
The
get_latitude()
method of the object returned by
YGps.FindGps
provides the latitude
currently measured by the Yocto-GPS. The value returned is a string, the format will vary according
to the Yocto-GPS configuration. To get a floating point value, no matter the configuartion, use the
YLatitude Class.
A real example
Launch you Java environment and open the corresponding sample project provided in the directory
Examples/Doc-GettingStarted-Yocto-GPS
of the Yoctopuce library.
In this example, you will recognize the functions explained above, but this time used with all the side
materials needed to make it work nicely as a small demo.
import
com.yoctopuce.YoctoAPI.*
;
public
class
Demo
{
public
static
void
main
(
String
[]
args
)
{
try
{
// setup the API to use local VirtualHub
YAPI.
RegisterHub
(
"127.0.0.1"
)
;
}
catch
(
YAPI_Exception ex
)
{
System
.
out
.
println
(
"Cannot contact VirtualHub on 127.0.0.1 ("
+
ex.
getLocalizedMessage
()
+
")"
)
;
System
.
out
.
println
(
"Ensure that the VirtualHub application is running"
)
;
System
.
exit
(
1
)
;
}
YGps gps;
if
(
args.
length
==
0
)
{
15. Using the Yocto-GPS with Java
100
www.yoctopuce.com
Summary of Contents for Yocto-GPS
Page 1: ...Yocto GPS User s guide...
Page 2: ......
Page 6: ...22 Characteristics 557 Blueprint 559 Index 561...
Page 10: ...4 www yoctopuce com...
Page 14: ...8 www yoctopuce com...
Page 18: ...12 www yoctopuce com...
Page 22: ...16 www yoctopuce com...
Page 38: ...32 www yoctopuce com...
Page 42: ...36 www yoctopuce com...
Page 54: ...48 www yoctopuce com...
Page 72: ...66 www yoctopuce com...
Page 92: ...86 www yoctopuce com...
Page 122: ...116 www yoctopuce com...
Page 132: ...126 www yoctopuce com...
Page 564: ...22 Characteristics 558 www yoctopuce com...
Page 565: ......
Page 566: ......
