mbusScanStop (Function)

This function is used to stop an M-Bus scan started with mbusScan.

Input:

handle : SYSHANDLE

A handle to the connection to stop scanning on.

Returns: INT

Declaration:

FUNCTION mbusScanStop : INT;
VAR_INPUT
  handle   : SYSHANDLE;
END_VAR;

Example:

INCLUDE rtcu.inc
 
FUNCTION CALLBACK OnScan;
VAR_INPUT
  handle      : SYSHANDLE;
  secondary   : STRING;
  primary     : INT;
END_VAR;
  DebugFmt(message:="device found: \1: "+secondary, v1:=primary);
END_FUNCTION;
 
FUNCTION CALLBACK OnProgress;
VAR_INPUT
  handle      : SYSHANDLE;
  secondary   : STRING;
  primary     : INT;
END_VAR;
  DebugFmt(message:="scanning: \1: "+secondary, v1:=primary);
END_FUNCTION;
 
PROGRAM test;
VAR
  mb : SYSHANDLE;
  rc : INT;
END_VAR;
 
  ...
  // Open wired M-Bus interface
  rc := mbusOpen(handle := mb);
  ...
  // Start scan for any secondary address
  rc := mbusScan(handle:=mb, cb_found:=@OnScan, cb_progress:=@OnProgress, smode:=2, mask:="FFFFFFFFFFFFFFFF");
  DebugFmt(message:="mbusScan(): \1", v1:=rc);
BEGIN
 
  ...
END;
END_PROGRAM;