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
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
