Innovative Model Railroad Control System

User Tools

Site Tools

Trace:
userpages:hermannk:function_mapping-en

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
userpages:hermannk:function_mapping-en [2020/05/30 15:35] – [Mapping to address and function number] hermannkuserpages:hermannk:function_mapping-en [2021/02/28 09:02] (current) – [What is Function Mapping] hermannk
Line 1: Line 1:
 ====== What is Function Mapping ====== ====== What is Function Mapping ======
-{{menatwork40left.png?|}} work in progress by hermannk - not ready yet !!!  {{menatwork40right.png?|}} \\+[[:userpages#Hermann (hermannk)|Userpages - Hermann (hermannk)]] \\ 
 + \\
 **Foreword 0:** as described in the wiki, the settings are only saved if the "Description" field contains an entry!!! \\ **Foreword 0:** as described in the wiki, the settings are only saved if the "Description" field contains an entry!!! \\
-see https://wiki.rocrail.net/doku.php?id=loc-fun-en \\+see **[[:loc-fun-en#description|Description]]** \\
  
 **Foreword 1:** the function zero (function "F0") has a special role. It is intended for the "light" function and there is therefore no way to redirect function number zero to another function number (mapping). \\ **Foreword 1:** the function zero (function "F0") has a special role. It is intended for the "light" function and there is therefore no way to redirect function number zero to another function number (mapping). \\
  
 **Foreword 2:** if the handheld controller enables easy-to-read function labels, mapping should avoided, but rather display the full range of functions of each locomotive individually on the handheld controller. \\ **Foreword 2:** if the handheld controller enables easy-to-read function labels, mapping should avoided, but rather display the full range of functions of each locomotive individually on the handheld controller. \\
 +
 +**Foreword 3:** \\
 +3a) not all locomotive and/or function controllers do support 32 function numbers; \\
 +3b) not all protocols do support 32 function numbers. \\
 +Inside this documentation function number 32 is reserved for "do nothing". If this is not possible in a given configuration please define a function number other than 32 that is reserved for "do nothing". There may also be the need of having one reserved function number for locomotive controllers and another reserved function number for function controllers. \\
  
 ===== Why Function Mapping? =====  ===== Why Function Mapping? ===== 
Line 18: Line 24:
 ^  #  ^  Description  ^|    ^  #  ^  Description  ^|    ^  #  ^  Description  ^ ^  #  ^  Description  ^|    ^  #  ^  Description  ^|    ^  #  ^  Description  ^
 |  0  |  light  ||    |  0  |  light  ||    |  0  |  light  | |  0  |  light  ||    |  0  |  light  ||    |  0  |  light  |
-|  1  |  head light  ||    |  1  |  rear light  ||    |  1  |  whistle  | +|  1  |  head light 1 ||    |  1  |  rear light  ||    |  1  |  whistle  | 
-|  2  |  rear light  ||    |  2  |  whistle  ||    |  2  |  smoke  |+|  2  |  head light 2 ||    |  2  |  whistle  ||    |  2  |  smoke  |
 |  3  |  horn 1  ||    |  3  |  pantograph  ||    |  3  |  brake  | |  3  |  horn 1  ||    |  3  |  pantograph  ||    |  3  |  brake  |
 |  4  |  horn 2  ||    |  4  |  distant light  ||    |  4  |   | |  4  |  horn 2  ||    |  4  |  distant light  ||    |  4  |   |
Line 28: Line 34:
 |  9  |  motor sound  ||    |  9  |    ||    |  9  |   | |  9  |  motor sound  ||    |  9  |    ||    |  9  |   |
 |  10  |  sand  ||    |  10  |    ||    |  10  |    | |  10  |  sand  ||    |  10  |    ||    |  10  |    |
-|  11  |  front cabin light  ||    |  11  |    ||    |  11  |    | +|  11  |  cabin light 1  ||    |  11  |    ||    |  11  |    | 
-|  12  |  rear cabin light  ||    |  12  |    ||    |  12  |    |+|  12  |  cabin light 2  ||    |  12  |    ||    |  12  |    |
 |  13  |  rear light  ||    |  13  |    ||    |  13  |    | |  13  |  rear light  ||    |  13  |    ||    |  13  |    |
 |  xx  |  xxxx  ||    |  xx  |  xxxx  ||    |  xx  |  xxxx  | |  xx  |  xxxx  ||    |  xx  |  xxxx  ||    |  xx  |  xxxx  |
Line 50: Line 56:
 |  0  |  light  |    |  0  |  light  ||    |  0  |  light  ||    |  0  |  light  | |  0  |  light  |    |  0  |  light  ||    |  0  |  light  ||    |  0  |  light  |
 |  1  |  rear light  |    |  1  |  head light  ||    |  1  |  rear light  ||    |  1  |  whistle  | |  1  |  rear light  |    |  1  |  head light  ||    |  1  |  rear light  ||    |  1  |  whistle  |
-|  2  |  front cabin light  |    |  2  |  rear light  ||    |  2  |  whistle  ||    |  2  |  smoke  |+|  2  | cabin light 1 |    |  2  |  rear light  ||    |  2  |  whistle  ||    |  2  |  smoke  |
 |  3  |  whistle  |    |  3  |  horn 1  ||    |  3  |  pantograph  ||    |  3  |  brake  | |  3  |  whistle  |    |  3  |  horn 1  ||    |  3  |  pantograph  ||    |  3  |  brake  |
 |  4  |  brake  |    |  4  |  horn 2  ||    |  4  |  distant light  ||    |  4  |   | |  4  |  brake  |    |  4  |  horn 2  ||    |  4  |  distant light  ||    |  4  |   |
 |  5  |  smoke  |    |  5  |  distant light  ||    |  5  |  brake  ||    |  5  |   | |  5  |  smoke  |    |  5  |  distant light  ||    |  5  |  brake  ||    |  5  |   |
-|  6  |  engine  |    |  6  |  coupler loco  ||    |  6  |  Sanden  ||    |  6  |   |+|  6  |  engine  |    |  6  |  coupler loco  ||    |  6  |  sand  ||    |  6  |   |
 |  7  |  pantograph  |    |  7  |  fan  ||    |  7  |  engine  ||    |  7  |   | |  7  |  pantograph  |    |  7  |  fan  ||    |  7  |  engine  ||    |  7  |   |
 |  8  |  coupler loco  |    |  8  |  brake  ||    |  8  |   ||    |  8  |   | |  8  |  coupler loco  |    |  8  |  brake  ||    |  8  |   ||    |  8  |   |
Line 140: Line 146:
 ^  Handheld control assignment  ^^ ^  Handheld control assignment  ^^
 ^  Function  ^^ ^  Function  ^^
-^  #  ^  Describtion  ^+^  #  ^  Description  ^
 |  xx  |  xxxx  | |  xx  |  xxxx  |
 |  10  |  interior lighting  | |  10  |  interior lighting  |
Line 164: Line 170:
 ^  11  ^  #  ^  Description  ^  Address  ^  fx  |    ^  #  ^  Description  ^  Fx  ^|    ^  #  ^  Description  ^  Fx  ^ ^  11  ^  #  ^  Description  ^  Address  ^  fx  |    ^  #  ^  Description  ^  Fx  ^|    ^  #  ^  Description  ^  Fx  ^
 |    |  xx  |  xxxx  |  -  |  -  |    |  xx  |  xxxx  |  xx  ||    |  xx  |  xxxx  |  xx  | |    |  xx  |  xxxx  |  -  |  -  |    |  xx  |  xxxx  |  xx  ||    |  xx  |  xxxx  |  xx  |
-|    |  5  |  smoke  |  __0__  |  __32__  |    |  5  |  Kupplung  |  __32__  ||    |  5  |  Kupplung  |  __32__  |+|    |  5  |  smoke  |  __0__  |  __32__  |    |  5  |  coupler  |  __32__  ||    |  5  |  coupler  |  __32__  |
 |    |  xx  |  xxxx  |  -  |  -  |    |  xx  |  xxxx  |  xx  ||    |  xx  |  xxxx  |  xx  | |    |  xx  |  xxxx  |  -  |  -  |    |  xx  |  xxxx  |  xx  ||    |  xx  |  xxxx  |  xx  |
 |    |  10  |  interior lighting  |  __0__  |  __32__  |    |  10  |  interior lighting  |  __0__  ||    |  10  |  interior lighting  |  __0__  | |    |  10  |  interior lighting  |  __0__  |  __32__  |    |  10  |  interior lighting  |  __0__  ||    |  10  |  interior lighting  |  __0__  |
Line 180: Line 186:
 ===== Mapping to address and function number =====  ===== Mapping to address and function number ===== 
 There are vehicles that have a separate function decoder with a separate address installed. To support this the definition for the function mapping may use an address in addition to the function number. see https://wiki.rocrail.net/doku.php?id=loc-fun-en#address_fx \\ There are vehicles that have a separate function decoder with a separate address installed. To support this the definition for the function mapping may use an address in addition to the function number. see https://wiki.rocrail.net/doku.php?id=loc-fun-en#address_fx \\
-An example for a separate function decoder address of a locomotive (without a train) can be found at **Test 6**. \\+An example for a separate function decoder address of a locomotive (without a train) can be found at [[userpages:hermannk:function_mapping-en#test_6_-_separate_function_address|**Test 6**]]. \\
  
 ===== Practical test =====  ===== Practical test ===== 
Line 196: Line 202:
 |  car152-en  |  0x4098  |  152  | |  car152-en  |  0x4098  |  152  |
 **Preliminary note 2:** "fn=32, val=1" means: function-nummer=32, value=1 \\ **Preliminary note 2:** "fn=32, val=1" means: function-nummer=32, value=1 \\
-**Preliminary note 3:** the tests were done with Rocrail version 2.1.755 with this {{ functionmapping.zip | workspace}}. \\+**Preliminary note 3:** the tests were done with Rocrail version 2.1.755 with this {{ functionmapping02.zip | workspace}}. \\
  
 ==== Test 1 - whistle ==== ==== Test 1 - whistle ====
Line 207: Line 213:
 | Passed the test. ||||| | Passed the test. |||||
  
-==== Test 2 - Rangiergang ====+==== Test 2 - Shunting ====
 The locomotive is supposed to activate the "shunting gear" and the two cars do nothing; the hand controller function number is different with regard to the locomotive function number: \\ The locomotive is supposed to activate the "shunting gear" and the two cars do nothing; the hand controller function number is different with regard to the locomotive function number: \\
 |   ^  Handheld controller  ^  Locomotive Mapping  ^  Car 1 Mapping  ^  Car 2 Mapping  ^ |   ^  Handheld controller  ^  Locomotive Mapping  ^  Car 1 Mapping  ^  Car 2 Mapping  ^
-| Brief description:  |  F9 = "Rangiergang"  |  fx=24  |  car151 Fx=32  |  car152 Fx=32  |+| Brief description:  |  F9 = "Shunting"  |  fx=24  |  car151 Fx=32  |  car152 Fx=32  |
 | Result:  | loco [lc_11-en] addr=0x406F fn=24, val=1  |||| | Result:  | loco [lc_11-en] addr=0x406F fn=24, val=1  ||||
 | | loco [car151-en] addr=0x4097 fn=32, val=1  |||| | | loco [car151-en] addr=0x4097 fn=32, val=1  ||||
userpages/hermannk/function_mapping-en.1590845727.txt.gz · Last modified: 2020/05/30 15:35 by hermannk