Page locked

This page is currently locked for editing by another user. You have to wait until this user finishes editing or the lock expires.
Currently locked by: 10.0.0.202,3.129.216.43
Lock expires at: 2025/03/14 21:38 (12 min)
This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== TGP driver ======

**TGP-4A-0X-IQ & TGP-7A-01-IQ programing & CyBro communication driver**

===== VisualTFT quick guide =====

SW & examples download:

|< 500px 250px >|
| TGP development SW            | [[https://cloud.hiq-lab.com/owncloud/index.php/s/Jh4vr4jpp1QmOyQ|VisualTFT]]|
| TP-4A-0X-IQ example project    | [[https://cloud.hiq-lab.com/owncloud/index.php/s/DdYyvHKTM7cSvyj|Example project]]|
| TGP-7A-01-IQ example project | |

==== Starting new TGP project ====

  * Start VisualTFT
  * menu: File -> New Project

{{:specifications:tp_driver:img:20210623-055941_img.png?nolink|}}

  * in "New Project" dialog set:
    * Project name and Path
    * Select Device Type according following table

|< 500px 150px 100px 100px >|
^  Robotina code  ^  VisualTFT Device Type                                 |||
^ :::             ^  Series                 ^  Type         ^  Resolution    |
| TGP-4A-0X-IQ     | M Serial                | DC48480M040   |   480 × 480 px |
| TGP-7A-01-IQ    | IOT                      | DC10600PW070  |  1024 × 600 px |

==== TGP Project Settings ====

{{:specifications:tp_driver:img:project.png?nolink|}}

{{:specifications:tp_driver:img:project_settings.png?nolink|}}
==== Connecting TP ====

{{:specifications:tp_driver:img:connection.png?nolink|}}

=== 1st time connection ===

{{:specifications:tp_driver:img:open_device.png?nolink|}}

After successful connection TGP should beep.

=== Connection after TGP is configured ===

{{:specifications:tp_driver:img:connect_configured_1.png?nolink|}}

{{:specifications:tp_driver:img:connect_configured_2.png?nolink|}}

{{:specifications:tp_driver:img:connect_configured_3.png?nolink|}}

{{:specifications:tp_driver:img:connect_configured_4.png?nolink|}}

{{:specifications:tp_driver:img:connect_configured_5.png?nolink|}}

{{:specifications:tp_driver:img:connect_configured_6.png?nolink|}}


==== Uploading project to TGP ====

=== Compile and verify project ===

{{:specifications:tp_driver:img:compile.png?nolink|}}

{{:specifications:tp_driver:img:no_error.png?nolink|}}

=== Load to panel ===

{{:specifications:tp_driver:img:load_start.png?nolink|}}

{{:specifications:tp_driver:img:load_dialog.png?nolink|}}

Load dialog is not translated to English :-(

==== Configuring TGP panel ====

{{:specifications:tp_driver:img:config_1.png?nolink|}}

{{:specifications:tp_driver:img:config_2.png?nolink|}}

{{:specifications:tp_driver:img:config_3.png?nolink|}}

{{:specifications:tp_driver:img:config_4.png?nolink|}}


===== TP screens examples =====

==== Screen ID: 00 ====

<WRAP column 500px>

{{ :specifications:tp_driver:scr_00.png?nolink |}}

</WRAP>

<WRAP column>
 
|< 400px 50px 100px >| 
^  ID  ^  type     ^ description                  |
^  1   |  button   | previous screen              |
^  2   |  button   | home screen                  |
^  3   |  button   | next screen                  |
^  10  |  button   | toggle controlled device     |
^  11  |  icon     | controlled device icon       |
^  12  |  message  | controlled device name       |


</WRAP>

<WRAP clear></WRAP>

==== Screen ID: 01 ====

<WRAP column 500px>

{{ :specifications:tp_driver:scr_01.png?nolink |}}

</WRAP>

<WRAP column>
 
|< 400px 50px 100px >| 
^  ID  ^  type     ^ description             ^
^  1   |  button   | previous screen         |
^  2   |  button   | home screen             |
^  3   |  button   | next screen             |
^  10  |  button   | up controlled device    |
^  11  |  button   | down controlled device  |
^  12  |  message  | controlled device name  |
^  13  |  icon     | controlled device icon  |

</WRAP>

<WRAP clear></WRAP>

==== Screen ID: 02 ====

<WRAP column 500px>

{{ :specifications:tp_driver:scr_02.png?nolink |}}

</WRAP>

<WRAP column>
 
|< 400px 50px 100px >| 
^  ID  ^  type     ^ description                 ^
^  1   |  button   | previous screen             |
^  2   |  button   | home screen                 |
^  3   |  button   | next screen                 |
^  11  |  button   | toggle controlled device 1  |
^  13  |  icon     | controlled device 1 icon    |
^  15  |  message  | controlled device 1 name    |
^  21  |  button   | toggle controlled device 2  |
^  23  |  icon     | controlled device 2 icon    |
^  25  |  message  | controlled device 2 name    |
^  31  |  button   | toggle controlled device 3  |
^  33  |  icon     | controlled device 3 icon    |
^  35  |  message  | controlled device 3 name    |
^  41  |  button   | toggle controlled device 4  |
^  43  |  icon     | controlled device 4 icon    |
^  45  |  message  | controlled device 4 name    |

</WRAP>

<WRAP clear></WRAP>

==== Screen ID: 03 ====

<WRAP column 500px>

{{ :specifications:tp_driver:scr_03.png?nolink |}}

</WRAP>

<WRAP column>
 
|< 400px 50px 100px >| 
^  ID  ^  type     ^ description               ^
^  1   |  button   | previous screen           |
^  2   |  button   | home screen               |
^  3   |  button   | next screen               |
^  11  |  button   | up controlled device 1    |
^  12  |  button   | down controlled device 1  |
^  13  |  icon     | controlled device 1 icon  |
^  15  |  message  | controlled device 1 name  |
^  21  |  button   | up controlled device 2    |
^  22  |  button   | down controlled device 2  |
^  23  |  icon     | controlled device 2 icon  |
^  25  |  message  | controlled device 2 name  |
^  31  |  button   | up controlled device 3    |
^  32  |  button   | down controlled device 3  |
^  33  |  icon     | controlled device 3 icon  |
^  35  |  message  | controlled device 3 name  |
^  41  |  button   | up controlled device 4    |
^  42  |  button   | down controlled device 4  |
^  43  |  icon     | controlled device 4 icon  |
^  45  |  message  | controlled device 4 name  |

</WRAP>

<WRAP clear></WRAP>

==== Screen ID: 04 ====

<WRAP column 500px>

{{ :specifications:tp_driver:scr_04.png?nolink |}}

</WRAP>

<WRAP column>
 
|< 400px 50px 100px >| 
^  ID  ^  type     ^ description                 ^
^  1   |  button   | previous screen             |
^  2   |  button   | home screen                 |
^  3   |  button   | next screen                 |
^  11  |  button   | toggle controlled device 1  |
^  13  |  icon     | controlled device 1 icon    |
^  15  |  message  | controlled device 1 name    |
^  21  |  button   | toggle controlled device 2  |
^  23  |  icon     | controlled device 2 icon    |
^  25  |  message  | controlled device 2 name    |
^  31  |  button   | toggle controlled device 3  |
^  33  |  icon     | controlled device 3 icon    |
^  35  |  message  | controlled device 3 name    |
^  41  |  button   | toggle controlled device 4  |
^  43  |  icon     | controlled device 4 icon    |
^  45  |  message  | controlled device 4 name    |
^  51  |  button   | toggle controlled device 5  |
^  53  |  icon     | controlled device 5 icon    |
^  55  |  message  | controlled device 5 name    |
^  61  |  button   | toggle controlled device 6  |
^  63  |  icon     | controlled device 6 icon    |
^  65  |  message  | controlled device 6 name    |


</WRAP>

<WRAP clear></WRAP>

==== Screen ID: 05 ====

<WRAP column 500px>

{{ :specifications:tp_driver:scr_05.png?nolink |}}

</WRAP>

<WRAP column>
 
|< 400px 50px 100px >| 
^  ID  ^  type     ^ description               ^
^  1   |  button   | previous screen           |
^  2   |  button   | home screen               |
^  3   |  button   | next screen               |
^  11  |  button   | up controlled device 1    |
^  12  |  button   | down controlled device 1  |
^  13  |  icon     | controlled device 1 icon  |
^  15  |  message  | controlled device 1 name  |
^  21  |  button   | up controlled device 2    |
^  22  |  button   | down controlled device 2  |
^  23  |  icon     | controlled device 2 icon  |
^  25  |  message  | controlled device 2 name  |
^  31  |  button   | up controlled device 3    |
^  32  |  button   | down controlled device 3  |
^  33  |  icon     | controlled device 3 icon  |
^  35  |  message  | controlled device 3 name  |
^  41  |  button   | up controlled device 4    |
^  42  |  button   | down controlled device 4  |
^  43  |  icon     | controlled device 4 icon  |
^  45  |  message  | controlled device 4 name  |
^  51  |  button   | up controlled device 5    |
^  52  |  button   | down controlled device 5  |
^  53  |  icon     | controlled device 5 icon  |
^  55  |  message  | controlled device 5 name  |
^  61  |  button   | up controlled device 6    |
^  62  |  button   | down controlled device 6  |
^  63  |  icon     | controlled device 6 icon  |
^  65  |  message  | controlled device 6 name  |


</WRAP>

<WRAP clear></WRAP>

==== Screen ID: 06 ====

<WRAP column 500px>

{{ :specifications:tp_driver:scr_06.png?nolink |}}

</WRAP>

<WRAP column>
 
|< 400px 50px 100px >| 
^  ID  ^  type     ^ description                       ^
^  1   |  button   | previous screen                   |
^  2   |  button   | home screen                       |
^  3   |  button   | next screen                       |
^  10  |  picture  | HVAC settings frame               |
^  11  |  icon     | HVAC fan limits                   |
^  12  |  message  | HVAC setpoint degrees             |
^  13  | message   | HVAC setpoint decimals and units  |
^  21  | button    | HVAC fan limit increment          |
^  22  | button    | HVAC fan limit decrement          |
^  23  | picture   | HVAC fan icon                     |
^  31  | button    | HVAC setpoint increment           |
^  32  | button    | HVAC setpoint decrement           |
^  33  | icon      | HVAC mode (heating/cooling)       |


</WRAP>

<WRAP clear></WRAP>

==== Screen ID: 07 ====

<WRAP column 500px>

{{ :specifications:tp_driver:scr_07.png?nolink |}}

</WRAP>

<WRAP column>
 
|< 400px 50px 100px >| 
^  ID  ^  type     ^ description                                ^
^  1   |  picture  | Room number frame                          |
^  2   |  icon     | Room state icon (idle/DND/MUR)             |
^  3   |  icon     | Door-bell icon (disabled/enabled/ringing)  |
^  4   |  picture  | Code keypad                                |
^  5   |  QCode    | Room QR code                               |
^  10  |  message  | Room number                                |
^  10  |  button   | toggle controlled device                   |
^  11  |  icon     | controlled device icon                     |
^  12  |  message  | controlled device name                     |
^  20  |  picture  | Room state frame                           |
^  21  |  button   | Door-bell button                           |
^  22  |  button   | Code keypad button                         |


</WRAP>

<WRAP clear></WRAP>

==== Screen ID: 08 ====

<WRAP column 500px>

{{ :specifications:tp_driver:scr_08.png?nolink |}}

</WRAP>

<WRAP column>
 
|< 400px 50px 100px >| 
^  ID     ^  type     ^ description    ^
^  4      |  button   | Cancel button  |
^  5      |  button   | OK button      |
^  10-19  |  button   | 0-9 button     |
^  20-29  |  message  | 0-9 text       |
^  30     |  message  | Code           |
^  60     |  picture  | Code frame     |

</WRAP>

<WRAP clear></WRAP>

==== Controlled devices icons ====

|< 500px 200px >|
| {{ :specifications:tp_driver:icon_4_00.png?nolink }}  | Scene off      |
| {{ :specifications:tp_driver:icon_4_01.png?nolink }}  | Scene on       |
| {{ :specifications:tp_driver:icon_4_02.png?nolink }}  | Light off      |
| {{ :specifications:tp_driver:icon_4_03.png?nolink }}  | Light off      |
| {{ :specifications:tp_driver:icon_4_04.png?nolink }}  | Blinds idle    |
| {{ :specifications:tp_driver:icon_4_05.png?nolink }}  | Blinds up      |
| {{ :specifications:tp_driver:icon_4_06.png?nolink }}  | Blinds down    |
| {{ :specifications:tp_driver:icon_4_07.png?nolink }}  | Fan off        |
| {{ :specifications:tp_driver:icon_4_08.png?nolink }}  | Fan 1          |
| {{ :specifications:tp_driver:icon_4_09.png?nolink }}  | Fan 2          |
| {{ :specifications:tp_driver:icon_4_10.png?nolink }}  | Fan 3          |
| {{ :specifications:tp_driver:icon_4_11.png?nolink }}  | DND idle       |
| {{ :specifications:tp_driver:icon_4_12.png?nolink }}  | DND active     |
| {{ :specifications:tp_driver:icon_4_13.png?nolink }}  | MUR idle       |
| {{ :specifications:tp_driver:icon_4_14.png?nolink }}  | MUR active     |
| {{ :specifications:tp_driver:icon_4_15.png?nolink }}  | Backlight off  |
| {{ :specifications:tp_driver:icon_4_16.png?nolink }}  | Backlight 0n   |
| {{ :specifications:tp_driver:icon_4_17.png?nolink }}  | Alarm off      |
| {{ :specifications:tp_driver:icon_4_18.png?nolink }}  | Alarm on       |
| {{ :specifications:tp_driver:icon_4_19.png?nolink }}  | Alarm ringing  |

==== HVAC fan limits icons ====

|< 500px 200px >|
| {{ :specifications:tp_driver:fan_0.png?nolink |}} | Fan off      |
| {{ :specifications:tp_driver:fan_1.png?nolink |}} | Fan limit 1  |
| {{ :specifications:tp_driver:fan_2.png?nolink |}} | Fan limit 2  |
| {{ :specifications:tp_driver:fan_3.png?nolink |}} | Fan limit 3  |

==== HVAC fan icon ====

|< 500px 200px >|
| {{ :specifications:tp_driver:fan.png?nolink |}}  |  Fan button  |

==== HVAC mode icons ====

|< 500px 200px >|
| {{ :specifications:tp_driver:temp_cool.png?nolink |}}  | Cooling  |
| {{ :specifications:tp_driver:temp_heat.png?nolink |}}  | Heating  |

==== Room mode icon ====

|< 500px 200px >|
| {{ :specifications:tp_driver:room_mode_0.png?nolink |}} | Idle  |
| {{ :specifications:tp_driver:room_mode_1.png?nolink |}} | DND active  |
| {{ :specifications:tp_driver:room_mode_2.png?nolink |}} | MUR active  |

==== Door-bell icons ====

|< 500px 200px >|
| {{ :specifications:tp_driver:doorbell_0.png?nolink |}} | Doorbell disabled  |
| {{ :specifications:tp_driver:doorbell_1.png?nolink |}} | Doorbell idle      |
| {{ :specifications:tp_driver:doorbell_2.png?nolink |}} | Doorbell ringing   |

==== Code keypad icons ====

|< 500px 200px >|
| {{ :specifications:tp_driver:code_0.png?nolink |}} | Code keypad off  |
| {{ :specifications:tp_driver:code_1.png?nolink |}} | Code keypad on   |


===== CyPro TGP driver =====

{{ :specifications:tp_driver:tp.cyp |PLC project example}}

==== TGP driver variables ====

|< 800px 100px 150px 500px >|
^  direction  ^  var                  ^  description                                                  ^  value    ^
| TP -> PLC   | tpanel_event          | TP events (button press, button release, screen change, ...)  | ppssooee  |
| PLC -> TP   | tpanel_beep_req       | TP beep request                                               | pptttt    |
| :::         | tpanel_screen_req     | TP screen request                                             | ppss      |
| :::         | tpanel_backlight_req  | TP backlight request                                          | ppbbb     |
| :::         | tpanel_icon_req       | set TP icon request                                           | ppssooii  |
| :::         | tpanel_txt[0..19]     | TP text                                                       | char      |
| :::         | tpanel_txt_req        | set TP text request                                           | ppssoo    |

**Value legend:**

|< 800px 100px 150px >|
| pp    | panel      | TP RS485 address             |
| ss    | screen     | TP Screen ID                 |
| oo    | object     | TP object (button, icon) ID  |
| ee    | event      | TP object event:             |
| :::   | :::        | - 01: pressed (fp)           |
| :::   | :::        | - 00: released (fn)          |
| :::   | :::        | - 09: screen change          |
| tttt  | time       | Beep time in 10*ms (1-255)   |
| ii    | icon       | TP Icon index                |
| bbb   | backlight  | Backlight 0-255 (0=max)      |