WOWDiesel Version 4 Indexed CV's

From Train Control Systems Documentation
Revision as of 00:30, 24 August 2023 by TCSDanM (talk | contribs)
Jump to navigation Jump to search

WARNING - THIS PAGE IS CURRENTLY UNDER CONSTRUCTION -

Some information on this page has yet to be entered, and is missing! We are working to fill out the rest of this page as quickly as possible. Please pardon the mess, and watch your step!

Explanation of Indexed CV's

"Indexed CV's" are a method which a decoder can use to store and change more configuration options than could be possible using the 256 Standard CV's. TCS Non-sound decoders do not use Indexed CV's, since all of the configuration options can be squeezed into the Standard CV's. In WOWSound Version 4 and older decoders, TCS uses an indexed CV method which uses CV 201, 202, 203, and 204, which are described in detail below. All four of these CV's combined work as a method to "index" and manipulate the more complicated configuration options with many many possible options such as Mapping Sounds to Buttons.

How to Use Indexed CV's

Think of CV 201 through 204 as a filing cabinet. To make a change to a "file" in the "filing cabinet" you need to know the drawer and folder number where that file is. You also need to know what the info in that file is, or what you want it to be.

CV 201

CV 201 acts like the drawer - this is a "coarse" location of the information you want to edit. We use this to indicate the type of setting you would like to change.

For example, changes made to sound options and sound behaviour settings are in "drawer" number 4. Another example would be CV 201 = 6 for changing sound volumes.

CV 202

CV 202 acts like the "folder" within the "drawer" (CV 201) in which the setting (or "file" in this analogy) lives. CV 202 indicates what specific type of change you would like to make.

For example, if CV 201 is 4, and CV 202 is 19, this indicates that you would like to reconfigure the "User Options" settings. Another example would be CV 201 = 1 and CV 202 = 5, which would map a sound to Button 5.

CV 203

CV 203 is the "high byte" of the data/setting, and can vary in behaviour and usefulness depending on the situation. For some settings ("files"), the number of available options is less (0-255), meaning that this CV is not necessary and not used. In these cases, it should be set to 0. In some cases, any other random/erroneous value will not affect anything.

In bit-wise CV's like the User Options, or settings with more than 256 available setpoints however, CV 203's value WILL affect said setting, and should always be verified to be correct and taken into account before proceeding. Neglecting CV203 in some circumstances will result in erroneous programming changes that may affect other settings you were not intending to change.

CV 204

CV 204 Is used as the final step in the process. Programming a value into this CV will use the information/data in CV203 and CV204 to make a change to the setting as indicated by CV201 and CV202. Only after programming CV 204 with a value will the changes you made actually take place. You can freely manipulate CV 201, 202, and 203 without any affect taking place until you program CV 204.

Reading Indexed CV's

Note that all of the above steps are for writing to an indexed CV. In order to read the value from an Indexed CV, you need to follow these steps:

  1. Determine the "drawer" or primary index value, such as 4.
  2. Add a value of 100 to the primary index (CV 201). EG "4" = 104
  3. Set CV 202 to the secondary index location (same as described above).
  4. Program CV 204 to a value of 0, or any other bogus value. The value of CV 203 is irrelevant and can be skipped. After writing any value to CV 204, the decoder will fetch the data from the index you selected (CV 201:CV 202), and place the value(s) into CV 203 and CV 204.
  5. Immediately after writing to CV 204, you can read CV 204 and/or CV 203. CV 203 may not necessarily be in use, so it may return a 0, but CV 204 will always have some sort of data in it, including 0, which can be valid data.


Sounding too complicated? We agree! That's why we created Audio Assist®, and why we also offer Programming Tools which can be used to generate all of these values for you!

Related

List of WOWDiesel Version 4 Indexed CV's

Index 1:X - Sound Button Remapping

Set CV 201 and CV 202 to a value shown in the table below to select a button to map a sound to. Then, use CV 203 and CV 204 to select the sound you would like to map to the button.

Note: it is highly recommended that you use Audio Assist to remap sound functions, as it requires much less effort and no lookup tables!

TCS Index 1.X "Sound Button Remapping"
Indexed CV Description
1:1 Function Button 1 Sound Mapping
1:2 Function Button 2 Sound Mapping
1:3 Function Button 3 Sound Mapping
1:4 Function Button 4 Sound Mapping
(...)
1:28 Function Button 28 Sound Mapping


Index 4:X - Sound Options

This is the primary index which holds most of the configuration options for the WOWSound decoder, especially those pertaining to how the decoder operates.

TCS Index 4.x "Sound Options"
Indexed CV Name/Feature Description
4:1 Quill Selection (0)* Short Quill,

(1)* Medium Quill

(2)* Long Quill

(3 - 6) Not used

(7) Randomize Quill Play Order

If a value of zero is entered, the short quill is defaulted to. In order to disable the whistle quill function, the button mapping for Grade X Quill must be overwritten or disabled.

Default = 7 (X:7) | Short, Medium, and Long quill enabled.

4:2 Random Sound Channel #1 Frequency
4:3 Random Sound Channel #2 Frequency
4:4 Random Sound Channel #3 Frequency
4:5 Random Sound Channel #4 Frequency
4:6 Random Sounds Overall Frequency
4:7 Random Sounds Cut-out Speed Step
4:8 Rotate Horn Pointer / Horn Set Selection Uses CV 204 to select the Horn Type from the List of Sounds.
4:9 Notching Mechanism
4:10 Master Volume
4:11 Prime Mover Type Uses CV 204 to select the Prime Mover number from the List of Sounds.
4:12 Automatic Sounds Selection (0)   Crew Alert (ON if set)

(1)   NU

(2)   NU

(3)   NU

(4)   Enable Automatic Forward Whistle Quill

(5)   Enable Automatic Reverse Whistle Quill

(6)   Enable Automatic Stop Whistle Quill

(7)   Enable Direction Change Sound (not used)

(8)*  Enable Random Sound 1

(9)*  Enable Random Sound 2

(10) Enable Random Sound 3

(11) Enable Random Sound 4

(12-15) NU

*Default is all on except Automatic Whistles and Bell

Default (XXXX0011 00000000) = 768 (3:0)

4:13 Brake Grinding Noise Start Speed Speed step at which "squeals" stop and "grinding" starts while braking. Brake grinding noises are sounds more accurate to low speeds and heavy brake application.

Range of Values is 0-126. A Value of 0 disables brake grinding and only uses brake squeal.

Default = 15

4:14 Dual-Enabled Functions For functions F0F-F12, set bit to have a function button available in both Light Mode and Sound Mode.

*Default is F0F, F0R, and F8 (mute) dual-enabled.

Default (XXX00010 00000011) = 515 (1:3)

4:15 Dynamic Brake Notch The notch the prime mover will go to under dynamic braking. See also: Notch Up with Dynamic Brakes feature.
4:16 (Not Used)
4:17 BEMF Low Calibration Used in the calculation to determine which notch the prime mover should be in. This calibration value is the BEMF level when running across a level surface without a load.
4:18 BEMF High Calibration Used in the calculation to determine which notch the prime mover should be in. This calibration value is the BEMF level when running up a grade or otherwise pulling a heavy load.
4:19 User Options (0)   Enable CAM

(1)   (Not Used)

(2)   Enable Mute on startup

(3)*  Allow Articulated Chuff to Slip

(4)*  Enable Rotate whistle/bell Audio feedback

(5)*  Enable Light Mode/Sound Mode Audio feedback

(6)*  Enable Audio auto shutoff timer

(7)*  "Momentary F2" - Improves performance while in Audio Assist with some throttles.

(8)   Enable Articulated Chuff

(9)   (Not Used)

(10)  Reverse Directional Whistles

(11)* Enable Power Braking

(12)* Enable Momentum Mode Audio Feedback

(13)* Enable Johnson Bar Audio Feedback

(14)  Enable "Function Pagination"||***WOWSteam Version 4.6 ONLY***

(15)  [reserved]

*Default (X0010010 11111011) = 4859 (10:40)

4:20 (Not Used)
4:21 Automatic Audio Shut-off Timer This feature will automatically mute the decoder after the set period of time. To completely disable this feature, see Index 4:19 "User Options." This feature will extend the life of your decoder by muting the sound when stationary without any user input received. A value of 256 equals approximately three minutes.

Valid range of values is 1-65535

Default = 2600 (4:20) - Approximately 30 Minutes

4:22 Dual Prime Mover Delay Sets the amount of time the second prime mover sound (if enabled) will wait before changing notches.
4:23 Rotate Bell / Bell Selection Uses CV 204 to select the Bell type from the List of Sounds.
4:24 (Not Used)
4:25 Speed-to-notch Ratio Used as part of a calculation to determine how many notches the prime mover should change by when accelerating or decelerating. Best when used with high momentum values. Valid range of values is 0-255. Higher values will increase the sensitivity.
4:26 Momentum-to-notch Ratio Used as part of a calculation to determine how many notches the prime mover should change by when accelerating or decelerating. Best when used with high momentum values. Valid range of values is 0-255. Higher values will increase the sensitivity.
4:27 BEMF Load Sensitivity Used as part of a calculation to determine how many notches the prime mover should change by when accelerating or decelerating. Best when used with high momentum values. Valid range of values is 0-255. Higher values will increase the sensitivity.
4:28 Prime Mover Hysteresis Defines how much +/- the load/notch calculation has to be above or below the notch set points for the notch to change. Valid range of values is 0 to 2040. Every increment of 255 is a different notch up to 2040.
4:29 Crew Alert Timer Sets a timer for how long the engineer must be idle for the Crew Alert alarm to sound.

Default = 43 (0:43) | (Approximately 2 minutes)

4:30 Crew Alert Light Function Selects a lighting output (from 0 to 12) to turn on when the crew alert sound begins playing. For the best experience, it is recommended to also change the Lighting Effect for this output to a Flashing Light or Strobe.

A value greater than 12 disables this feature.

Default = 13 (Disabled)

4:31 Traditional Mode Notch 1 Transition Speed When using Traditional Throttle Mode, the prime mover with transition from Idle to Notch 1 at this speed.

Default = 1

4:32 Traditional Mode Notch 2 Transition Speed When using Traditional Throttle Mode, the prime mover with transition from Notch 1 to Notch 2 at this speed.

Default = 6

4:33 Traditional Mode Notch 3 Transition Speed When using Traditional Throttle Mode, the prime mover with transition from Notch 2 to Notch 3 at this speed.

Default = 13

4:34 Traditional Mode Notch 4 Transition Speed When using Traditional Throttle Mode, the prime mover with transition from Notch 3 to Notch 4 at this speed.

Default = 20

4:35 Traditional Mode Notch 5 Transition Speed When using Traditional Throttle Mode, the prime mover with transition from Notch 4 to Notch 5 at this speed.

Default = 27

4:36 Traditional Mode Notch 6 Transition Speed When using Traditional Throttle Mode, the prime mover with transition from Notch 5 to Notch 6 at this speed.

Default = 34

4:37 Traditional Mode Notch 7 Transition Speed When using Traditional Throttle Mode, the prime mover with transition from Notch 6 to Notch 7 at this speed.

Default = 41

4:38 Traditional Mode Notch 8 Transition Speed When using Traditional Throttle Mode, the prime mover with transition from Notch 7 to Notch 8 at this speed.

Default = 48

4:39 (Not Used)
4:40 AUX Input Loop Timer Controls how long a sound file triggered by the AUX Input is allowed to loop (if a looping sound). A value of 42 = approximately 3 seconds.

Default = 42

4:41 Smoke Unit On Time ***IF SUPPORTED*** controls the PWM ratio to the smoke unit fan output.
4:42 Smoke Unit Off Time ***IF SUPPORTED*** controls the PWM ratio to the smoke unit fan output.
4:43-4:46 Not Used
4:47 Thermal Overload Limit ***WOW501 ONLY***

This CV sets the temperature at which the decoder will trip the thermal overload. It is not recommended to adjust this CV unless otherwise guided to do so by TCS technical support. If the thermal overload is tripping, your decoder is overheating!

4:48 (Not Used)
4:49 (Not Used)
4:50 Switching Mode Acceleration Default = 5
4:51 Switching Mode Deceleration Default = 5
4:52 Mainline Mode Acceleration Default = 20
4:53 Mainline Mode Deceleration Default = 60