Yoctopuce Yocto-RangeFinder, User Manual, Page: 179 / 497

21. High-level API Reference
YModule module
→
checkFirmware()
Tests whether the byn file is valid for this module.
js
function checkFirmware( path , onlynew )
cpp
string checkFirmware( string path , bool onlynew )
m
-(NSString*) checkFirmware : (NSString*) path
: (bool) onlynew
pas
function checkFirmware( path : string, onlynew : boolean): string
vb
function checkFirmware( ) As String
cs
string checkFirmware( string path , bool onlynew )
java
String checkFirmware( String path , boolean onlynew )
uwp
async Task<string> checkFirmware( string path , bool onlynew )
py
def checkFirmware( path , onlynew )
php
function checkFirmware( $path , $onlynew )
es
function checkFirmware( path , onlynew )
cmd
YModule target checkFirmware path onlynew
This method is useful to test if the module needs to be updated. It is possible to pass a directory as
argument instead of a file. In this case, this method returns the path of the most recent appropriate
.byn
file. If the parameter
onlynew
is true, the function discards firmwares that are older or equal to
the installed firmware.
Parameters :
path the path of a byn file or a directory that contains byn files
onlynew returns only files that are strictly newer
Returns :
the path of the byn file to use or a empty string if no byn files matches the requirement
On failure, throws an exception or returns a string that start with "error:".
www.yoctopuce.com 173