From: suchinton2001 Date: Fri, 20 Oct 2023 13:09:31 +0000 (+0530) Subject: agl-demo-control-panel: Update documentation X-Git-Tag: 16.91.1~6 X-Git-Url: https://gerrit.automotivelinux.org/gerrit/gitweb?a=commitdiff_plain;h=2887f945590adbb6ceaf590e4fb0f542792c6e04;p=AGL%2Fdocumentation.git agl-demo-control-panel: Update documentation - Add steps to add custom configs - Update image assets and fix typo in dir name Bug-AGL: SPEC-4905 Signed-off-by: suchinton2001 Change-Id: Ib0ffcdc3c6c0ee9fa693bba2959901c174f01a4e Reviewed-on: https://gerrit.automotivelinux.org/gerrit/c/AGL/documentation/+/29292 Reviewed-by: Jan-Simon Moeller Tested-by: Jan-Simon Moeller --- diff --git a/docs/06_Component_Documentation/09_AGL_Demo_Control_Panel.md b/docs/06_Component_Documentation/09_AGL_Demo_Control_Panel.md index 1a48000..af42523 100644 --- a/docs/06_Component_Documentation/09_AGL_Demo_Control_Panel.md +++ b/docs/06_Component_Documentation/09_AGL_Demo_Control_Panel.md @@ -1,7 +1,6 @@ --- title: AGL Demo Control Panel --- - # AGL Demo Control Panel ## Introduction @@ -11,23 +10,31 @@ This document describes the design and usage of the **AGL Demo Control Panel**, To use the control panel, you need to connect the main machine that runs the control panel to the target machine that runs the AGL image(s) using a **LAN/ethernet cable**. You also need to configure the IP address of the Kuksa server and set your preferences in the tool’s settings menu. -![Layers_And_Extensions](images/AGL-Deom-Control-Panel/Application-Logic.png) - -## # Installation +![Layers_And_Extensions](images/AGL-Demo-Control-Panel/Application-Logic.png) +## Installation -Clone the repository + +- _Note_: + If errors occur in Debian based/Rasbian OS during installation, follow the steps mentioned below and skip to step 2: ```bash -git clone "https://gerrit.automotivelinux.org/gerrit/src/agl-demo-control-panel" && cd ./AGL_Demo_Control_Panel +$ nano requirements.txt +# -> Comment pyqt5 dependency using "#" +$ sudo apt install python3-pyqt5 python3-qtpy pyqt5-dev-tools python3-pyqt5.qtsvg -y ``` -Install the Python dependencies - -``` -pip install -r requirements.txt +- Step 1 +```bash +$ python3 -m venv control-panel +$ source control-panel/bin/activate ``` -## # Setup +- Step 2 +```bash +$ pip3 install -r requirements.txt +$ pyrcc5 assets/res.qrc -o res_rc.py +``` +## Setup Before using the `AGL Demo Control Panel`, we need to make sure to run the Kuksa.val server and also have our `can0` interface set up (Optional). @@ -65,58 +72,69 @@ To set up the CAN interface between the Host system and the target machine(s) we You should now be able to send and receive CAN messages between the two machines using the vcan interface and cannelloni. -### 3. Kuksa-val-server +### 3. Configuration for Kuksa-val-server/ Kuksa databroker -Restart AGL's `kuksa-val-server` +Run the `kuksa-val-server`/`databroker` on `0.0.0.0` by either restarting the server, editing `/etc/default/kuksa-databroker` or add the `agl-demo-preload` as a feature to your build of AGL. The server should be started using the `--address 0.0.0.0` argument. -```bash -$ pkill kuksa -$ kuksa-val-server --address 0.0.0.0 -``` - -_Note_: if you are testing on a local build (or) docker image of kuksa.val server, make sure to remove `cacertificate` and `tls_server_name` arguments from `extras/config.py`. +Now, you can create a custom configuration to save your specific preferences for the settings page by creating the `*.ini*` files in the, +- `/etc/agl-demo-control-panel.ini` +- `$HOME/.local/share/agl-demo-control-panel/config.ini` ```python -KUKSA_CONFIG = { -"ip": '', -"port": "8090", -'protocol': 'ws', -'insecure': False, -} +[default] +preferred-config=AGL-kuksa-val-server + +# [cutom-config-template] +# ip= +# port= +# protocol= # ws/grpc -> kuksa-val-server, grpc -> databroker +# insecure= +# cacert= +# token= +# tls_server_name= + +[kuksa-val-server] +ip=localhost +port=8090 +protocol=ws +insecure=false +token=default +tls_server_name= ``` ### 4. Start AGL Demo Control Panel -1. To use the control panel +1. To start the control panel ``` - cd /Path/to/agl-demo-control-panel - python -u main.py + $ cd /Path/to/agl-demo-control-panel + $ source control-panel/bin/activate + $ python -u main.py ``` -![Layers_And_Extensions](images/AGL-Deom-Control-Panel/Dashboard.png) +![Layers_And_Extensions](images/AGL-Demo-Control-Panel/Dashboard.png) 2. Go to settings - - Start (load default config) - - Configure - - Ip-Address ("local" if running kuksa server on host) - - JWT Token path - - CA certificate path - - Insecure mode (default off) - - Reconnect (Status will be updated accordingly) + - Start (load default config from drop-down menu) + - Configure: make changes as required + - IP-Address + - Port + - Secure Mode: if toggled **"on"**, specify the `CA.pem File` + - Protocol: websocket ← ? → gRPC + - TLS Server Name + - JWT/Auth Token path + - CA.pem certificate path + - Start/Stop + - Reconnect - Page settings: Configure the visibility of pages and switch between CAN and Kuksa messages by using the toggle for the same. -![Layers_And_Extensions](images/AGL-Deom-Control-Panel/Settings_Page.png) +![Layers_And_Extensions](images/AGL-Demo-Control-Panel/Settings_Page.png) -3. Navigate to the desired page using the provided buttons at the bottom +1. Navigate to the desired page using the provided buttons at the bottom | | |---| -| ![Layers_And_Extensions](images/AGL-Deom-Control-Panel/IC.png) | +| ![Layers_And_Extensions](images/AGL-Demo-Control-Panel/IC.png) | | | | |---|---| -| ![Layers_And_Extensions](images/AGL-Deom-Control-Panel/HVAC.png) | ![Layers_And_Extensions](images/AGL-Deom-Control-Panel/SC.png) | - - - - +| ![Layers_And_Extensions](images/AGL-Demo-Control-Panel/HVAC.png) | ![Layers_And_Extensions](images/AGL-Demo-Control-Panel/SC.png) | diff --git a/docs/06_Component_Documentation/images/AGL-Deom-Control-Panel/Application-Logic.png b/docs/06_Component_Documentation/images/AGL-Demo-Control-Panel/Application-Logic.png similarity index 100% rename from docs/06_Component_Documentation/images/AGL-Deom-Control-Panel/Application-Logic.png rename to docs/06_Component_Documentation/images/AGL-Demo-Control-Panel/Application-Logic.png diff --git a/docs/06_Component_Documentation/images/AGL-Demo-Control-Panel/Dashboard.png b/docs/06_Component_Documentation/images/AGL-Demo-Control-Panel/Dashboard.png new file mode 100644 index 0000000..e31024e Binary files /dev/null and b/docs/06_Component_Documentation/images/AGL-Demo-Control-Panel/Dashboard.png differ diff --git a/docs/06_Component_Documentation/images/AGL-Demo-Control-Panel/HVAC.png b/docs/06_Component_Documentation/images/AGL-Demo-Control-Panel/HVAC.png new file mode 100644 index 0000000..c4db3b2 Binary files /dev/null and b/docs/06_Component_Documentation/images/AGL-Demo-Control-Panel/HVAC.png differ diff --git a/docs/06_Component_Documentation/images/AGL-Demo-Control-Panel/IC.png b/docs/06_Component_Documentation/images/AGL-Demo-Control-Panel/IC.png new file mode 100644 index 0000000..72555dc Binary files /dev/null and b/docs/06_Component_Documentation/images/AGL-Demo-Control-Panel/IC.png differ diff --git a/docs/06_Component_Documentation/images/AGL-Demo-Control-Panel/SC.png b/docs/06_Component_Documentation/images/AGL-Demo-Control-Panel/SC.png new file mode 100644 index 0000000..4e3ec84 Binary files /dev/null and b/docs/06_Component_Documentation/images/AGL-Demo-Control-Panel/SC.png differ diff --git a/docs/06_Component_Documentation/images/AGL-Demo-Control-Panel/Settings_Page.png b/docs/06_Component_Documentation/images/AGL-Demo-Control-Panel/Settings_Page.png new file mode 100644 index 0000000..2812a8d Binary files /dev/null and b/docs/06_Component_Documentation/images/AGL-Demo-Control-Panel/Settings_Page.png differ diff --git a/docs/06_Component_Documentation/images/AGL-Deom-Control-Panel/Dashboard.png b/docs/06_Component_Documentation/images/AGL-Deom-Control-Panel/Dashboard.png deleted file mode 100644 index 367c6cd..0000000 Binary files a/docs/06_Component_Documentation/images/AGL-Deom-Control-Panel/Dashboard.png and /dev/null differ diff --git a/docs/06_Component_Documentation/images/AGL-Deom-Control-Panel/HVAC.png b/docs/06_Component_Documentation/images/AGL-Deom-Control-Panel/HVAC.png deleted file mode 100644 index 528db89..0000000 Binary files a/docs/06_Component_Documentation/images/AGL-Deom-Control-Panel/HVAC.png and /dev/null differ diff --git a/docs/06_Component_Documentation/images/AGL-Deom-Control-Panel/IC.png b/docs/06_Component_Documentation/images/AGL-Deom-Control-Panel/IC.png deleted file mode 100644 index dd0ea1d..0000000 Binary files a/docs/06_Component_Documentation/images/AGL-Deom-Control-Panel/IC.png and /dev/null differ diff --git a/docs/06_Component_Documentation/images/AGL-Deom-Control-Panel/SC.png b/docs/06_Component_Documentation/images/AGL-Deom-Control-Panel/SC.png deleted file mode 100644 index b5f1172..0000000 Binary files a/docs/06_Component_Documentation/images/AGL-Deom-Control-Panel/SC.png and /dev/null differ diff --git a/docs/06_Component_Documentation/images/AGL-Deom-Control-Panel/Settings_Page.png b/docs/06_Component_Documentation/images/AGL-Deom-Control-Panel/Settings_Page.png deleted file mode 100644 index 2429e87..0000000 Binary files a/docs/06_Component_Documentation/images/AGL-Deom-Control-Panel/Settings_Page.png and /dev/null differ