yaq/daemons/fake-discrete-hardware


Idealized simulated discrete hardware which reports as the requested position upon setting after configurable delay.

bugtracker
source

installation

The fake-discrete-hardware daemon can be installed using the following package managers:

PyPI
conda-forge

traits

The fake-discrete-hardware daemon is composed of the following traits:

has-position
is-daemon
is-discrete

configuration

enable (boolean) default: True
Disable this daemon. The kind entry-point will not attempt to start this daemon.
from is-daemon

identifiers ({'type': 'map', 'values': 'double'}) default: {'blue': 470, 'green': 540, 'orange': 613, 'red': 667, 'violet': 425, 'yellow': 575}
Position identifiers
from is-discrete

log_level ({'name': 'level', 'symbols': ['debug', 'info', 'notice', 'warning', 'error', 'critical', 'alert', 'emergency'], 'type': 'enum'}) default: info
Set daemon log-level.
from is-daemon

log_to_file (boolean) default: False
Optionally force logging to a file.
from is-daemon

make (['null', 'string']) default: None
from is-daemon

model (['null', 'string']) default: None
from is-daemon

port (int)
TCP port for daemon to occupy.
from is-daemon

serial (['null', 'string']) default: None
Serial number for the particular device represented by the daemon
from is-daemon

sleep (float) default: 1.0

tolerance (float) default: 1.0

units (['null', 'string']) default: None

state

The fake-discrete-hardware daemon will provide the following state information:

destination (double)
from has-position

position (double)
from has-position

position_identifier (['null', 'string'])
Current position identifier.
from is-discrete

messages

The fake-discrete-hardware daemon will expose the following public messages:

busy ➜ boolean
Returns true if daemon is currently busy.
from is-daemon

get_config ➜ string
Full configuration for the individual daemon as defined in the TOML file. This includes defaults and shared settings not directly specified in the daemon-specific TOML table.
from is-daemon

get_config_filepath ➜ string
String representing the absolute filepath of the configuration file on the host machine.
from is-daemon

get_destination ➜ double
Get current daemon destination.
from has-position

get_identifier ➜ ['null', 'string']
Get current identifier string. Current identifier may be None.
from is-discrete

get_position ➜ double
Get current daemon position.
from has-position

get_position_identifier_options ➜ {'items': 'string', 'type': 'array'}
Get position identifier names. Identifiers may not change at runtime.
from is-discrete

get_position_identifiers ➜ {'type': 'map', 'values': 'double'}
Get position identifiers. Identifiers may not change at runtime.
from is-discrete

get_state ➜ string
Get version of the running daemon
from is-daemon

get_units ➜ ['null', 'string']
Get units of daemon. These units apply to the position and destination properties.
from has-position

id ➜ {'type': 'map', 'values': ['null', 'string']}
JSON object with information to identify the daemon, including name, kind, make, model, serial.
from is-daemon

set_identifier ➜ double
Set using an identifier. Returns new destination.
from is-discrete
parameters:

identifier (string)

set_position ➜ null
Give the daemon a new destination, and begin motion towards that destination.
from has-position
parameters:

position (double)

set_relative ➜ double
Give the daemon a new destination relative to its current position. Daemon will immediately begin motion towards new destination. Returns new destination.
from has-position
parameters:

distance (double)

shutdown ➜ null
Cleanly shutdown (or restart) daemon.
from is-daemon
parameters:

restart (boolean) default: False


built 2024-02-09 01:44:16                                      CC0: no copyright