WOWElectric Version 2 Indexed CV's

From Train Control Systems Documentation
Revision as of 21:30, 20 May 2023 by TCSDanM (talk | contribs)
Jump to navigation Jump to search

NOTE: Most of the items on this page also apply to Version 1. Look for specific notes for Version-2-specific additions which would not be included in Version 1.

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 WOWElectric Version 2 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.

Listed below are the TCS Indexed CV's for VERSION 2 of the ACS-64 decoder:

Indexed CV Number Indexed CV Value (CV203,CV204) Description
1 0,7 Active Quill - This CV selects which Quills can play if the Grade X Quill button is pressed. TCS decoders include up to 3 unique quills for each horn type. Bit 7 will randomize which order the quills play in if set; otherwise, they will play in order.

(0) Use Quill 1

(1) Use Quill 2

(2) Use Quill 3

(7) Randomize Quills when played

2 0,200 Random Sound 1 Frequency (Air Compressor)
3 0,100 Random Sound 2 Frequency (Power Converter Blower)
4 0,130 Random Sound 2 Frequency (Traction Motor Blower)
5 0,255 Random Sound 4 Frequency (Default - not used)

NOTE: This channel is used/overwritten when the "Random Whoosh" function is activated

6 3,3 Random Sound Overall Frequency
7 0,15 Random Sound Cutout Speed Step (Default - Speed Step 15)
8 V1: 0,3

V2: 0,6

Horn Selection
9 0,1 Throttle Mode - Not Used
10 0,100 Master Volume
11 V2=0,1 Traction Motor Selection

VERSION 2 ONLY - NOT USED IN V1 - Only one Traction Motor sound is available in Version 1 the ACS-64 decoder

12 255,2 Automatic and DC Mode Sounds

(0)   CREW ALERT ACTIVE

(1)* ENABLE DC MODE GRADE X QUILL

(2)   NOT USED

(3)   AUTOMATIC DCC MODE BELL

(4)   AUTOMATIC DCC MODE FORWARD HORN QUILL

(5)   AUTOMATIC DCC MODE REVERSE HORN QUILL

(6)   AUTOMATIC DCC MODE STOP HORN BLAST

(7)   ENABLE DIRECTION CHANGE SOUND

(8)*  ENABLE RANDOM SOUND 1 CHANNEL

(9)*  ENABLE RANDOM SOUND 2 CHANNEL

(10)* ENABLE RANDOM SOUND 3 CHANNEL

(11)* ENABLE RANDOM SOUND 4 CHANNEL

(12)* ENABLE DC MODE AUTOMATIC BELL

(13)* ENABLE DC MODE FORWARD SOUND

(14)* ENABLE DC MODE REVERSE SOUND

(15)* ENABLE DC MODE STOP SOUND

CV 203 = 255 + CV 204 = 2 will enable all DC mode automatic sounds only

13 0,30 Brake Grinding Start Speed - Speed step at which the brake squeal sound will switch from train brake sounds to locomotive disc brake squeal sounds
14 3,79 Dual Enabled Functions

(0)*  F0F

(1)*  F0R

(2)*  F1

(3)*  F2

(4)   F3

(5)   F4

(6)*  F5

(7)   F6

(8)*  F7

(9)*  F8

(10)  F9

(11)  F10

(12)  F11

(13)  F12

(14)  [reserved]

(15)  [reserved]

ACS-64 default is F0F, F0R, F1, F2, F5, F7, and F8

19 V1: 18,251

V2: 192,248

"USER OPTIONS" Indexed CV - bitwise (inclusive selection):

(0) Not Used

(1) Not Used

(2) Mute on startup/engine auto start mute if set

(3)  Enable switching/mainline mode audio feedback

(4)  Enable Rotate horn/bell audio feedback

(5)*  Enable light mode/sound mode audio feedback

(6)  Enable Audio auto shutoff timer

(7)*  Digitrax bit-set simulates button 2 as toggle while in A.A. mode

(8) Not Used

(9) Not Used

(10) Reverse directional horns

(11) Not Used

(12) Not Used

(13) Not Used

(14) Enable Bachmann Function Pagination (Not available in First Run models)

(15) Grade Crossing Quill sound blinks ditch lights (Not available in First Run models)

ACS-64 First Run default 4859 [00010010 11111011], (Enables all audio feedback options, Momentary F2 in AA, Mainline mode)

ACS-64 Second Run default 49400 [11000000 11111000], (Same as above except: ADD Function Pagination and Ditch Light Quill Blink)

20 0,0 Idling Sound Selection

VERSION 2 ONLY - Valid Values are 0 or 1

21 10,40 Automatic Audio Shutoff Timer - Mutes the decoder after the configured amount of time

Default is approximately 15 minutes

23 0,0 Bell Selection - Only 1 bell available (E-bell)
43 5,0 DC Mode start voltage – Voltage at which the engine will start making noise in DC mode, the higher the value the higher the voltage
44 5,70 Voltage at which the DC mode bell will stop playing, the higher the value the higher the voltage threshold.
45 15 Speed step in DCC mode that the automatic bell will stop playing at
46 V2: 0,150 DC Mode motor hysteresis – When the engine starts moving in DC mode the increased current draw may cause some oscillation.

If so, increase the value in this CV until the oscillation goes away.

If the engine is going through a power on reset try increasing Sound CV 43 (Voltage at which the Engine will power up at while in DC mode)

48 3,232 Traction Motor Minimum Volume - The minimum volume the traction motor is allowed to be at Speed Step 1
50 6 “Switching" momentum mode acceleration value
51 6 “Switching" momentum mode deceleration value
52 20 “Mainline" momentum mode acceleration value
53 60 “Mainline" momentum mode deceleration value
54 0,80 Traction Motor Fade-Out Speed Step - Speed step at which the Traction Motor sound will be completely faded into Gearbox sound
55 0,15 Traction Motor Gearbox Starting Speed Step - Speed step at which the Traction Motor Gearbox sound will begin fading into the Traction Motor sound
56 0,0 Traction Motor Gearbox Minimum Volume - The volume at which the Traction Motor Gearbox sound will begin to fade in from

NOTE: It is not recommended to change this CV value; Recommended Maximum is 10

58 0,7 High Horn Threshold (5mph safety switch)

Speed step at which the decoder will begin playing the High-Pressure Horn. When the speed is set to below this value, the decoder will use the low-pressure horn. A value of 0 disables this feature, and the high horn will always play. A value of 1 will only play the low horn when stationary.

(Valid Values = 0-126) VERSION 2+ ONLY

NOTE: This feature only applies to specific horns, and does not apply to all horn sets available on this decoder.

59 0,2 Traction Motor Blower Selection - Selects which Traction Motor Blower sound is played while moving

0 = Siemens Traction Motor Blower 1 | 1 = Siemens Traction Motor Blower 2 | 2 = Siemens Traction Motor Blower 3

TCS Index 4.x "Sound Options"
Indexed CV Name/Feature Description
4:1 Cylinder Cox Shut-off Speed Step
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 Whistle Pointer / Whistle Set Selection Uses CV 204 to select the Whistle Type from the List of Sounds.
4:9 (Not Used)
4:10 Master Volume
4:11 Chuff Set Selection Uses CV 204 to select the Chuff Set number from the List of Sounds.
4:12 Automatic Sounds Selection (0)*  Snifter Valves

(1)*  Rod Clank

(2)*  Idling Sound

(3)   Enable Automatic Bell

(4)   Enable Automatic Forward Whistle Quill

(5)   Enable Automatic Reverse Whistle Quill

(6)   Enable Automatic Stop Whistle Quill

(7)*  Enable Direction Change Sound (power reverser)

(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 (00001111 10000111) = 3975 (15:135)

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 WOWSteam V4.6 ONLY See Below
4:16 Chuff Rate Overall Adjustment Percentage of adjustment to increase or decrease the chuff rate at all speed steps. Valid range of values is 1-200

Default = 100 (X:100)

4:17 Rod Clank Set Selection Determines which set of Rod clank sounds are played. The number of Rod Clank sound sets is determined by the Sound List.
4:18 Cylinder Cox Auto Turn-on Time Sets how long the locomotive must be stationary before the cylinder cox will come on automatically the next time the locomotive starts moving.

Valid Range of values 1 - 65535

Default = 256 (1:0)

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 (X0111000 11111000) = 14584 (56:248)

4:20 Articulated Chuff Slip Rate Determines how frequently articulated chuffs slip in and out of sync. The higher the number the more frequently it happens.

Valid values are 0-255

Default = 240 (X:240)

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 = 1200 (4:176) - Approximately 15 Minutes

4:22 Not Used
4:23 Minimum Chuff Volume This setting will set the minimum volume the chuff volume can fall to, regardless of the BEMF/load. Changing this setting will prevent the sound from behaving prototypical, but can force the decoder to always "chuff chuff chuff" as long as it is moving.

Valid range of values is 0 - 32767

Default = 0 (chuff/throttle can shut off completely)

4:24 Rotate Bell / Bell Selection Uses CV 204 to select the Bell type from the List of Sounds.
4:25 Grade Crossing Quill Options TCS records multiple grade crossing quills, and puts up to three of them in the decoder. This CV's selection controls which quills will play when the Grade X Quill Button is pressed.

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

4:26 Cylinder Cox Set Determines which set of cox sounds are active

NOTE: Using CV programming to assign a cylinder cox sound to a button will put the cylinder cocks sound type on that button, but might not set up the correct set. I.E. if you remap the "cylinder cox set 2" sound onto a button, but don't change this CV, that button will play a "cylinder cox set 1" instead. Changing this CV will affect any button or buttons already mapped with the Cylinder Cox sound type.

Valid values are 1-2

Default = 1 (X:1)

4:27 Idling Sounds Selection Determines which "Idling Sounds" sound plays while the locomotive is idle.

Valid values are determined by the Sound List.

4:28 Not Used
4:29 Chuff Volume Change Time Controls how fast the chuff volume can change from one level to another in response to a change in the load. This setting effectively adds "hysteresis" to the chuff volume if you feel the locomotive's chuff sound response is too sensitive and changes too quickly. A change of "1" adds or subtracts approximately 0.5 milliseconds to the responsiveness. This setting only affects the responsiveness when coasting at a set speed, and does not affect the performance and responsiveness when changing speed. See 4:32 "Chuff Volume Velocity Factor" for more info.

Default = 4500 (17:148) | (Approximately 2.25 seconds transition time from min to max)

4:30 BEMF Low Calibration (Forward)
4:31 BEMF High Calibration (Forward)
4:32 Chuff Volume Velocity Factor
4:33 BEMF Low Calibration (Reverse)
4:34 BEMF High Calibration (Reverse)
4:35 Rod Clank Volume from BEMF At the calculated minimum BEMF volume (BEMF Low Calibration) rod clank will be at full volume (rod clank type volume) and will fade away as the load increases. This CV is a percentage above the BEMF Low Calibration value that the rod clank will cut out.

Valid values are 0-100

Default = 30 (X:30)

4:42 Throttle Mode Selection 0 = Traditional Throttle Mode

1 = Prototype Throttle Mode This setting controls how the chuff sound behaves: In "traditional" mode, the chuff volume is constant and determined by the "Chuff" Sound Type Volume. Snifters will play at their maximum programmable volume when the throttle is shut off, rod clank will not play at all.

In "Prototype" throttle mode, the chuff volume is determined by the velocity, speed, BEMF/load, and calibration settings. The snifter valve and rod clank volume are also controlled dynamically by prototype throttle mode. Snifters will play when the throttle is deemed to be "off" and rod clank will start playing when the throttle is deemed to be appropriate (See Index 4:35)

Default = 1 (Prototype Throttle Mode)

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 DC Mode Quill Delta - Regulated Supply Mode Default = 431
4:49 WOWSteam V4.6 ONLY See Below
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

New Indexed CV's Unique to WOWSteam Version 4.6

TCS Index 4.X "Sound Options" (NEW!)
Indexed CV Description
NOTE: ALL OF THE INDEXED CV NUMBERS LISTED ABOVE IN THE SAME PRIMARY INDEX (4:X) STILL APPLY. THE CV'S LISTED IN THIS TABLE ARE ADDITIONS OR REVISIONS TO THE PREVIOUS TABLE
4:15 DC Mode Sounds Selection (0)*  DC mode automatic bell enabled

(1)*  DC mode Forward Sound

(2)*  DC mode Reverse Sound

(3)*  DC mode stop sound

(4)*  DC mode quill enabled

(5-15) NU

*Default is all on.

Default (XXXXXXXX XXX11111) = 31 (X:31)

4:41 DC Mode Chuff Volume Sets the chuff volume level while in DC mode. If you are using a high power speaker and an power pack with poor regulation, loud chuffs can cause a significant drop in voltage. Lowering the maximum chuff volume can alleviate this issue.

Default = 5888

4:43 DC Mode Start Voltage - Regulated Supply Mode Default = 2400
4:44 DC Mode Bell Cutout Voltage - Regulated Supply Mode Default = 2525
4:45 Automatic Bell Cutout Speed DCC speed step above which the bell will stop playing (when enabled to play automatically).

Default = 15

4:46 DC Mode Motor Hysteresis - Regulated Supply Mode Default = 600
4:48 DC Mode Quill Delta - Regulated Supply Mode Default = 431
4:49 Track Voltage BEMF Offset Factor Default = 0
4:54 DC Mode Max ADC Value - Regulated Supply Mode Sets the expected maximum ADC value the decoder can expect to see when running in Analog mode. This gives the decoder a range that can be used to determine which speed to go depending on the track voltage. By default=, this CV is set to the maximum resolution size, which means the decoder will max out at about 14.5V on the rails. This CV will not help for DC power packs with higher max outputs than 15V, but for max outputs below 15V, the speed step range can be tuned; additionally, going above the ADC range, or increasing this CV, can limit the speed step at full throttle. This often does sound nicer, and gives more of a range in the "nice chuff rate zone" where speed is limited but enjoy-ability is increased.

Range of values is 0-4250. Recommended absolute minimum value is 2800.

This CV MUST NOT be less than or equal to the Motor Start Voltage

Default = 4250 (16:154)

4:66 DC Mode Start Voltage - Unregulated Supply Mode Default = 2816
4:67 DC Mode Motor Hysteresis - Unregulated Supply Mode Default = 1250
4:68 DC Mode Motor Hysteresis - Unregulated Supply Mode Default = 12
4:69 DC Mode Bell Cutout Voltage - Unregulated Supply Mode Default = 2500
4:70 DC Mode Quill Delta - Unregulated Supply Mode Default = 1000
4:72 DC Mode Speed Step Hysteresis - Regulated Supply Mode Default = 8

Index 6:X - Sound Type Volumes

Set CV 201 to 6 and CV 202 to the desired Volume Level (x), then set CV 204 to the value of the Sound Type you want to change. (CV 203 is unused and should be Zero.) The Sound Type Numbers are listed in the List of Sounds for a specific project. There are typically 30 sound types or less.

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

TCS Index 6.X "Sound Type Volumes"
Indexed CV Description
6:x:0:1 Sound Type 1 Volume
6:x:0:2 Sound Type 2 Volume
(...)
6:x:0:28 Sound Type 28 Volume
(...) Additional Sound Types*