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 %(prog)s --device /dev/ttyUSB1 --baudrate 9600
Tuesday, 2017-11-21T21:48:04
$ python3 %(prog)s -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 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]))
if args.datetime is None:
# get current date and time on the heat pump
dt, wd = hp.get_date_time()
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")
dt, wd = hp.set_date_time(dt)
print("{}, {}".format(WEEKDAYS[wd - 1], dt.isoformat()))
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_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