Skip to main content

DEST

Syntax​

DEST <a.b.c.d> or DEST NONE

Description​

Sets the destination PC of the board: the PC that receives the data stream and the events. That PC becomes the board's owner (see Session and Ownership).

  • DEST <a.b.c.d> makes the given address the owner. If another PC was the owner, it receives EVT dest taken. A running acquisition or Studio program is not interrupted.
  • DEST NONE releases the board: acquisition and programs keep running, but nothing is streamed and no event is sent until a new destination is set.

Replies to commands never depend on DEST: they always go back to the sender.

Parameters​

ParameterDescription
<a.b.c.d>IPv4 address of the PC that should receive the stream and the events.
NONENo destination.

Response​

OK DEST dest=<a.b.c.d>
OK DEST dest=none

Errors​

ReplyCondition
ERR DEST bad_argMissing or invalid address.

Example​

dest.py
from hmcls_udp import Board

board = Board("192.168.1.11")
print(board.request("DEST 192.168.1.50")) # {'dest': '192.168.1.50'}