Analog Way MIDRA PLATFORM TPP Current Programmer's Guide - Manual (Page 3)

3
PROGRAMMER'S GUIDE FOR v01.02.11
Table of contents
1 INTRODUCTION......................................................................................................................................................................... 5
1.1 References .......................................................................................................................................................................... 5
1.2 Notices ................................................................................................................................................................................ 5
2 CONTROLING MIDRA™ ............................................................................................................................................................. 6
2.1 Introduction ........................................................................................................................................................................ 6
2.2 Physical interfaces ............................................................................................................................................................... 6
2.3 Protocol ............................................................................................................................................................................... 6
2.4 Command principle and structure ...................................................................................................................................... 7
2.4.1 Midra™ control principle ................................................................................................................................................. 7
2.4.2 Write command structure ............................................................................................................................................... 7
2.4.3 Read command structure ................................................................................................................................................ 7
2.4.4 Valid answer structure ..................................................................................................................................................... 8
2.4.5 Error answer .................................................................................................................................................................... 9
2.5 Commands sequencing ..................................................................................................................................................... 10
2.5.1 Write sequence .............................................................................................................................................................. 10
2.5.2 Read sequence ............................................................................................................................................................... 10
2.6 Command indexes and Command values ......................................................................................................................... 11
2.7 Multiple controllers........................................................................................................................................................... 12
2.8 Multiple machines ............................................................................................................................................................. 12
3 COMMON MIDRA™ USE CASES .............................................................................................................................................. 13
3.1 Establishing a connection with a Midra™ ......................................................................................................................... 14
3.1.1 usage .............................................................................................................................................................................. 14
3.1.2 summary of the commands sequence ........................................................................................................................... 14
3.1.3 detailed commands sequence ....................................................................................................................................... 14
3.1.4 example of connection establishment .......................................................................................................................... 16
3.2 Keeping a connection alive with a Midra™ ....................................................................................................................... 17
3.2.1 usage .............................................................................................................................................................................. 17
3.2.2 detailed command sequence ......................................................................................................................................... 17
3.2.3 example of PING command ........................................................................................................................................... 17
3.3 Changing a source displayed in a layer ............................................................................................................................. 18
3.3.1 usage .............................................................................................................................................................................. 18
3.3.2 Midra™ layers reminder ................................................................................................................................................ 18
3.3.3 detailed command parameters ..................................................................................................................................... 18
3.3.4 example of Preview layer source change ...................................................................................................................... 18
3.4 TAKE : Transitioning a Preview screen onto a Program screen ......................................................................................... 19
3.4.1 usage .............................................................................................................................................................................. 19
3.4.2 Midra™ transitions reminder ......................................................................................................................................... 19
3.4.3 detailed commands sequence ....................................................................................................................................... 19
3.4.4 example of TAKE ............................................................................................................................................................ 19
3.5 TAKE ALL : Transitioning from Preview onto the Program for all screens (matrix mode) ................................................ 20
3.5.1 usage .............................................................................................................................................................................. 20
3.5.2 Midra™ transitions reminder ......................................................................................................................................... 20
3.5.3 detailed commands sequence ....................................................................................................................................... 20
3.5.4 example of TAKE ALL...................................................................................................................................................... 20
3.6 Loading a Preset from Master memory to a single Program screen ................................................................................. 21
3.6.1 usage .............................................................................................................................................................................. 21
3.6.2 Midra™ “Master preset Memories” reminder .............................................................................................................. 21
3.6.3 detailed command parameters ..................................................................................................................................... 21
3.6.4 example of memorized preset recall ............................................................................................................................. 22
3.7 Loading a Preset from Master memory and changing the source displayed in a layer .................................................... 23
3.7.1 usage .............................................................................................................................................................................. 23
3.7.2 detailed commands sequence ....................................................................................................................................... 23
3.7.3 example of Master Memory preset recall ..................................................................................................................... 24
3.8 Displaying/Hiding the Quick Frame for one single screen ................................................................................................ 25
3.8.1 usage .............................................................................................................................................................................. 25