def test_set_param_raises_ValueError(self, cmdopt_device: str,
cmdopt_baudrate: int, name: str,
param: HtParam):
hp = HtHeatpump(device=cmdopt_device, baudrate=cmdopt_baudrate)
with pytest.raises(ValueError):
hp.set_param(name, param.min_val - 1,
ignore_limits=False) # type: ignore
with pytest.raises(ValueError):
hp.set_param(name, param.max_val + 1,
ignore_limits=False) # type: ignore
def main():
parser = argparse.ArgumentParser(
description=textwrap.dedent('''\
Command line tool to set the value of a specific parameter of the heat pump.
Example:
$ python3 %(prog)s --device /dev/ttyUSB1 "HKR Soll_Raum" "21.5"
21.5
'''),
formatter_class=argparse.RawDescriptionHelpFormatter,
epilog=textwrap.dedent('''\
DISCLAIMER
----------
Please note that any incorrect or careless usage of this program as well as
errors in the implementation can damage your heat pump!
Therefore, the author does not provide any guarantee or warranty concerning
to correctness, functionality or performance and does not accept any liability
for damage caused by this program or mentioned information.
Thus, use it on your own risk!
''') + "\r\n")
parser.add_argument(
"-d",
"--device",
default="/dev/ttyUSB0",
type=str,
help=
"the serial device on which the heat pump is connected, default: %(default)s"
)
parser.add_argument(
"-b",
"--baudrate",
default=115200,
type=int,
# the supported baudrates of the Heliotherm heat pump (HP08S10W-WEB):
choices=[9600, 19200, 38400, 57600, 115200],
help=
"baudrate of the serial connection (same as configured on the heat pump), default: %(default)s"
)
parser.add_argument("-t",
"--time",
action="store_true",
help="measure the execution time")
parser.add_argument("-v",
"--verbose",
action="store_true",
help="increase output verbosity by activating logging")
parser.add_argument("name",
type=str,
nargs=1,
action=ParamNameAction,
help="parameter name (as defined in htparams.csv)")
parser.add_argument("value",
type=str,
nargs=1,
help="parameter value (as string)")
args = parser.parse_args()
# activate logging with level INFO in verbose mode
if args.verbose:
logging.basicConfig(level=logging.INFO)
else:
logging.basicConfig(level=logging.ERROR)
hp = HtHeatpump(args.device, baudrate=args.baudrate)
start = timer()
try:
hp.open_connection()
hp.login()
rid = hp.get_serial_number()
if args.verbose:
_logger.info(
"connected successfully to heat pump with serial number {:d}".
format(rid))
ver = hp.get_version()
if args.verbose:
_logger.info("software version = {} ({:d})".format(ver[0], ver[1]))
# convert the passed value (as string) to the specific data type
value = HtParams[args.name[0]].from_str(args.value[0])
# set the parameter of the heat pump to the passed value
value = hp.set_param(args.name[0], value)
print(value)
except Exception as ex:
_logger.error(ex)
sys.exit(1)
finally:
hp.logout() # try to logout for an ordinary cancellation (if possible)
hp.close_connection()
end = timer()
# print execution time only if desired
if args.time:
print("execution time: {:.2f} sec".format(end - start))
sys.exit(0)
def test_set_param_raises_KeyError(self, cmdopt_device: str,
cmdopt_baudrate: int):
hp = HtHeatpump(device=cmdopt_device, baudrate=cmdopt_baudrate)
with pytest.raises(KeyError):
hp.set_param("BlaBlaBla", 123)
