def main():
parser = argparse.ArgumentParser(
description=textwrap.dedent("""\
Command line tool to get and set date and time on the Heliotherm heat pump.
To change date and/or time on the heat pump the date and time has to be passed
in ISO 8601 format (YYYY-MM-DDTHH:MM:SS) to the program. It is also possible to
pass an empty string, therefore the current date and time of the host will be
used. If nothing is passed to the program the current date and time on the heat
pump will be returned.
Example:
$ python3 htdatetime.py --device /dev/ttyUSB1 --baudrate 9600
Tuesday, 2017-11-21T21:48:04
$ python3 htdatetime.py -d /dev/ttyUSB1 -b 9600 "2008-09-03T20:56:35"
Wednesday, 2008-09-03T20:56:35
"""),
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(
"datetime",
type=str,
nargs="?",
help=
"date and time in ISO 8601 format (YYYY-MM-DDTHH:MM:SS), if empty current date and time will be used, "
"if not specified current date and time on the heat pump will be returned",
)
args = parser.parse_args()
# activate logging with level DEBUG in verbose mode
log_format = "%(asctime)s %(levelname)s [%(name)s|%(funcName)s]: %(message)s"
if args.verbose:
logging.basicConfig(level=logging.DEBUG, format=log_format)
else:
logging.basicConfig(level=logging.WARNING, format=log_format)
hp = HtHeatpump(args.device, baudrate=args.baudrate)
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",
rid)
ver = hp.get_version()
if args.verbose:
_LOGGER.info("software version = %s (%d)", *ver)
if args.datetime is None:
# get current date and time on the heat pump
with Timer() as timer:
dt, wd = hp.get_date_time()
exec_time = timer.elapsed
print("{}, {}".format(WEEKDAYS[wd - 1], dt.isoformat()))
else:
# set current date and time on the heat pump
if not args.datetime:
# no date and time given, so use the current date and time on the host
dt = datetime.datetime.now()
else:
# otherwise translate the given string to a valid datetime object
dt = datetime.datetime.strptime(args.datetime,
"%Y-%m-%dT%H:%M:%S")
with Timer() as timer:
dt, wd = hp.set_date_time(dt)
exec_time = timer.elapsed
print("{}, {}".format(WEEKDAYS[wd - 1], dt.isoformat()))
# print execution time only if desired
if args.time:
print("execution time: {:.2f} sec".format(exec_time))
except Exception as ex:
_LOGGER.exception(ex)
sys.exit(1)
finally:
hp.logout() # try to logout for an ordinary cancellation (if possible)
hp.close_connection()
sys.exit(0)
def test_set_date_time_raises_TypeError(self, cmdopt_device: str,
cmdopt_baudrate: int):
hp = HtHeatpump(device=cmdopt_device, baudrate=cmdopt_baudrate)
with pytest.raises(TypeError):
hp.set_date_time(123) # type: ignore
