List of changes: * New component esp_local_ctrl added * Example added under examples/protocols/esp_local_ctrl * Documentation added under protocols/esp_local_ctrl * Demo client side app esp_local_ctrl.py added under examples/protocols/esp_local_ctrl/scripts * protocomm_ble : protocomm_ble_config_t given struct name for allowing forward declaration * esp_prov/transport_softap renamed to transport_http * transport_http module supports verification of server certificate * transport_http module performs name resolution before connection
273 lines
8.9 KiB
Python
273 lines
8.9 KiB
Python
#!/usr/bin/env python
|
|
#
|
|
# Copyright 2018 Espressif Systems (Shanghai) PTE LTD
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
#
|
|
|
|
from __future__ import print_function
|
|
from future.utils import tobytes
|
|
from builtins import input
|
|
import os
|
|
import sys
|
|
import struct
|
|
import argparse
|
|
|
|
import proto
|
|
|
|
try:
|
|
import esp_prov
|
|
|
|
except ImportError:
|
|
idf_path = os.environ['IDF_PATH']
|
|
sys.path.insert(1, idf_path + "/tools/esp_prov")
|
|
import esp_prov
|
|
|
|
|
|
# Set this to true to allow exceptions to be thrown
|
|
config_throw_except = False
|
|
|
|
|
|
# Property types enum
|
|
PROP_TYPE_TIMESTAMP = 0
|
|
PROP_TYPE_INT32 = 1
|
|
PROP_TYPE_BOOLEAN = 2
|
|
PROP_TYPE_STRING = 3
|
|
|
|
|
|
# Property flags enum
|
|
PROP_FLAG_READONLY = (1 << 0)
|
|
|
|
|
|
def prop_typestr(prop):
|
|
if prop["type"] == PROP_TYPE_TIMESTAMP:
|
|
return "TIME(us)"
|
|
elif prop["type"] == PROP_TYPE_INT32:
|
|
return "INT32"
|
|
elif prop["type"] == PROP_TYPE_BOOLEAN:
|
|
return "BOOLEAN"
|
|
elif prop["type"] == PROP_TYPE_STRING:
|
|
return "STRING"
|
|
return "UNKNOWN"
|
|
|
|
|
|
def encode_prop_value(prop, value):
|
|
try:
|
|
if prop["type"] == PROP_TYPE_TIMESTAMP:
|
|
return struct.pack('q', value)
|
|
elif prop["type"] == PROP_TYPE_INT32:
|
|
return struct.pack('i', value)
|
|
elif prop["type"] == PROP_TYPE_BOOLEAN:
|
|
return struct.pack('?', value)
|
|
elif prop["type"] == PROP_TYPE_STRING:
|
|
return tobytes(value)
|
|
return value
|
|
except struct.error as e:
|
|
print(e)
|
|
return None
|
|
|
|
|
|
def decode_prop_value(prop, value):
|
|
try:
|
|
if prop["type"] == PROP_TYPE_TIMESTAMP:
|
|
return struct.unpack('q', value)[0]
|
|
elif prop["type"] == PROP_TYPE_INT32:
|
|
return struct.unpack('i', value)[0]
|
|
elif prop["type"] == PROP_TYPE_BOOLEAN:
|
|
return struct.unpack('?', value)[0]
|
|
elif prop["type"] == PROP_TYPE_STRING:
|
|
return value.decode('latin-1')
|
|
return value
|
|
except struct.error as e:
|
|
print(e)
|
|
return None
|
|
|
|
|
|
def str_to_prop_value(prop, strval):
|
|
try:
|
|
if prop["type"] == PROP_TYPE_TIMESTAMP:
|
|
return int(strval)
|
|
elif prop["type"] == PROP_TYPE_INT32:
|
|
return int(strval)
|
|
elif prop["type"] == PROP_TYPE_BOOLEAN:
|
|
return bool(strval)
|
|
elif prop["type"] == PROP_TYPE_STRING:
|
|
return strval
|
|
return strval
|
|
except ValueError as e:
|
|
print(e)
|
|
return None
|
|
|
|
|
|
def prop_is_readonly(prop):
|
|
return (prop["flags"] & PROP_FLAG_READONLY) is not 0
|
|
|
|
|
|
def on_except(err):
|
|
if config_throw_except:
|
|
raise RuntimeError(err)
|
|
else:
|
|
print(err)
|
|
|
|
|
|
def get_transport(sel_transport, service_name):
|
|
try:
|
|
tp = None
|
|
if (sel_transport == 'http'):
|
|
example_path = os.environ['IDF_PATH'] + "/examples/protocols/esp_local_ctrl"
|
|
cert_path = example_path + "/main/certs/rootCA.pem"
|
|
tp = esp_prov.transport.Transport_HTTP(service_name, cert_path)
|
|
elif (sel_transport == 'ble'):
|
|
tp = esp_prov.transport.Transport_BLE(
|
|
devname=service_name, service_uuid='0000ffff-0000-1000-8000-00805f9b34fb',
|
|
nu_lookup={'esp_local_ctrl/version': '0001',
|
|
'esp_local_ctrl/session': '0002',
|
|
'esp_local_ctrl/control': '0003'}
|
|
)
|
|
return tp
|
|
except RuntimeError as e:
|
|
on_except(e)
|
|
return None
|
|
|
|
|
|
def version_match(tp, expected, verbose=False):
|
|
try:
|
|
response = tp.send_data('esp_local_ctrl/version', expected)
|
|
return (response.lower() == expected.lower())
|
|
except Exception as e:
|
|
on_except(e)
|
|
return None
|
|
|
|
|
|
def get_all_property_values(tp):
|
|
try:
|
|
props = []
|
|
message = proto.get_prop_count_request()
|
|
response = tp.send_data('esp_local_ctrl/control', message)
|
|
count = proto.get_prop_count_response(response)
|
|
if count == 0:
|
|
raise RuntimeError("No properties found!")
|
|
indices = [i for i in range(count)]
|
|
message = proto.get_prop_vals_request(indices)
|
|
response = tp.send_data('esp_local_ctrl/control', message)
|
|
props = proto.get_prop_vals_response(response)
|
|
if len(props) != count:
|
|
raise RuntimeError("Incorrect count of properties!")
|
|
for p in props:
|
|
p["value"] = decode_prop_value(p, p["value"])
|
|
return props
|
|
except RuntimeError as e:
|
|
on_except(e)
|
|
return []
|
|
|
|
|
|
def set_property_values(tp, props, indices, values, check_readonly=False):
|
|
try:
|
|
if check_readonly:
|
|
for index in indices:
|
|
if prop_is_readonly(props[index]):
|
|
raise RuntimeError("Cannot set value of Read-Only property")
|
|
message = proto.set_prop_vals_request(indices, values)
|
|
response = tp.send_data('esp_local_ctrl/control', message)
|
|
return proto.set_prop_vals_response(response)
|
|
except RuntimeError as e:
|
|
on_except(e)
|
|
return False
|
|
|
|
|
|
if __name__ == '__main__':
|
|
parser = argparse.ArgumentParser(add_help=False)
|
|
|
|
parser = argparse.ArgumentParser(description="Control an ESP32 running esp_local_ctrl service")
|
|
|
|
parser.add_argument("--version", dest='version', type=str,
|
|
help="Protocol version", default='')
|
|
|
|
parser.add_argument("--transport", dest='transport', type=str,
|
|
help="transport i.e http or ble", default='http')
|
|
|
|
parser.add_argument("--name", dest='service_name', type=str,
|
|
help="BLE Device Name / HTTP Server hostname or IP", default='')
|
|
|
|
parser.add_argument("-v", "--verbose", dest='verbose', help="increase output verbosity", action="store_true")
|
|
args = parser.parse_args()
|
|
|
|
if args.version != '':
|
|
print("==== Esp_Ctrl Version: " + args.version + " ====")
|
|
|
|
if args.service_name == '':
|
|
args.service_name = 'my_esp_ctrl_device'
|
|
if args.transport == 'http':
|
|
args.service_name += '.local'
|
|
|
|
obj_transport = get_transport(args.transport, args.service_name)
|
|
if obj_transport is None:
|
|
print("---- Invalid transport ----")
|
|
exit(1)
|
|
|
|
if args.version != '':
|
|
print("\n==== Verifying protocol version ====")
|
|
if not version_match(obj_transport, args.version, args.verbose):
|
|
print("---- Error in protocol version matching ----")
|
|
exit(2)
|
|
print("==== Verified protocol version successfully ====")
|
|
|
|
while True:
|
|
properties = get_all_property_values(obj_transport)
|
|
if len(properties) == 0:
|
|
print("---- Error in reading property values ----")
|
|
exit(4)
|
|
|
|
print("\n==== Available Properties ====")
|
|
print("{0: >4} {1: <16} {2: <10} {3: <16} {4: <16}".format(
|
|
"S.N.", "Name", "Type", "Flags", "Value"))
|
|
for i in range(len(properties)):
|
|
print("[{0: >2}] {1: <16} {2: <10} {3: <16} {4: <16}".format(
|
|
i + 1, properties[i]["name"], prop_typestr(properties[i]),
|
|
["","Read-Only"][prop_is_readonly(properties[i])],
|
|
str(properties[i]["value"])))
|
|
|
|
select = 0
|
|
while True:
|
|
try:
|
|
inval = input("\nSelect properties to set (0 to re-read, 'q' to quit) : ")
|
|
if inval.lower() == 'q':
|
|
print("Quitting...")
|
|
exit(5)
|
|
invals = inval.split(',')
|
|
selections = [int(val) for val in invals]
|
|
if min(selections) < 0 or max(selections) > len(properties):
|
|
raise ValueError("Invalid input")
|
|
break
|
|
except ValueError as e:
|
|
print(str(e) + "! Retry...")
|
|
|
|
if len(selections) == 1 and selections[0] == 0:
|
|
continue
|
|
|
|
set_values = []
|
|
set_indices = []
|
|
for select in selections:
|
|
while True:
|
|
inval = input("Enter value to set for property (" + properties[select - 1]["name"] + ") : ")
|
|
value = encode_prop_value(properties[select - 1],
|
|
str_to_prop_value(properties[select - 1], inval))
|
|
if value is None:
|
|
print("Invalid input! Retry...")
|
|
continue
|
|
break
|
|
set_values += [value]
|
|
set_indices += [select - 1]
|
|
|
|
if not set_property_values(obj_transport, properties, set_indices, set_values):
|
|
print("Failed to set values!")
|