Cycle Analyst 3.1.a - Release Notes
SETTINGS SUMMARY    CAV3 ONLINE

----- Summary of Changes in this Release -----


Section titles show the feature/problem tracking number and description.


Release: 3.1.a                                                     2018-11-20

This is a re-release of 3.1 that includes the following updates to correct
Setup Utility issues. The release alters Setup Utility presentation of settings
values but otherwise provides no new CA functionality or CA Console Setup
changes.  This affects only the Setup Utility; CA firmware for this release is
identical to all previous 3.1(.x) releases and require no CA update of those
versions.  Existing 3.1 setup files will display affected data according to
the new format.  


(1)  6247 - SU Power Limit Max displays incorrect # of decimal places

    Setup Utility displays PLim->MaxPower as 'xxxx.00 W' in Lo-Range and
    'xxxx kW' in Hi-Range.  These formats are interchanged. CA Console Setup
    handles this setting properly.

    Setup Utility formatting has been corrected to:
    'xxxx W' in Lo-Range and 'xx.xx kW' in Hi-Range.
    
    This is an internal change with no consequences for CA setup or existing
    setup files. Settings displayed by Setup Utility will appear in the revised
    format.


(2) 6241 - SU Fast Ramp Thresh Display is not scaled x10 for Hi-Range

    Setup Utility incorrectly accepts ThrO->FastThrsh input only as 'x.xx A'
    regardless of Cal->Range Lo or Hi setting.  When in Hi-Range, this
    misrepresents values as 1/10 the value that the CA actually uses. CA Console
    Setup handles this setting properly.

    Setup Utility operation has been corrected to allow entry of:
    'x.xx A' in Lo-Range and 'xx.x A' in Hi-Range with proper internal value
    scaling.

    This is an internal change with no consequences for CA setup or existing
    setup files. Settings displayed by Setup Utility will appear in the revised
    format.


_______________________________________________________________________________
Release: 3.1                                                       2018-02-18


This is the initial production release of Cycle Analyst 3.1 firmware.  The
sections below describe changes from the 3.0x product as they appeared in
intervening beta releases.


_______________________________________________________________________________
Release: 3.1b22                                                      2018-02-09


(1) 2020 - (new) Add PAS Device support for new 2018 Sempu BB

    The new 2018 Sempu BB is now selectable as a predefined PAS Torque device.
    This device can be purchased as either a '1-wire' or '2-wire' interface; the
    predefined default assumes the '2-wire' style distributed by Grin.  Units
    from other vendors may be of the '1-wire' type and so require customizing
    PASD->SignlType.


(2) 2020 - (new) Select settings are moved to MISC category

    Disp->Averaging and Cal->Defaults have been relocated to the MISC category
    as Misc->DspAvging and Misc->Defaults respectively.  This seemed a more
    sensible grouping and freed space for future display settings.


(3) 4935 - RowBike Strokes per Minute displays linger too long

    When configured for a 'RowBike' PAS device, DIsplayed and logged SPM as well
    as the PAS bar graph displayed the last measured value for several seconds
    after rowing halted.  These displays now show a zero value as soon as the
    rpm signal from the PAS sensor ceases.


(4) 5286 - Battery Chemistry chooser options are corrupted

    The Battery chemistry chooser options have been corrected to properly show
    the available chemistry types.  The CA Console chooser was correct and is
    unchanged.


_______________________________________________________________________________
Release: 3.1b21                                                      2018-01-31


(1) 5016 - (new) Make Settings transferable across firmware flashes

    Although the size and content of individual settings are generally unchanged
    in EEPROM across firmware versions, their location can change making the
    settings unusable by newly flashed firmware.  This has frequently required
    users flashing new beta firmware to reconfigure all settings from scratch.
    
    The new Setup Utility 1.52 can preserve individual settings across firmware
    flashes if the settings are relocated within the EEPROM map but retain their
    original form.  Only new or changed settings must be re-entered. This feature
    works with all firmware released with or subsequent to Setup Utility 1.52.
    
    See the documentation for Setup utility 1.52 for an explanation of operation
    and applicability to various older firmware versions.


(2) 5136 - (new) Add Tool Tip and Help support, retire SettingsSummary.pdf

    New firmware-specific help documentation has been added to provide Tool Tips
    for each setting in Setup utility as well as Setup Utility Help menu
    content.

    A printed version of the help window content may be obtained by opening
    <installDir>/data/help/XXXX_SettingSummary.html in a browser and printing
    the page (e.g. FireFox, Chrome, etc).

    This is a documentation change with no configuration consequences.
    EEPROM data layout is unchanged; no existing CA configurations or
    settings files are affected.


(3) 5182 - (new) Convert Release Notes to HTML, retire ASCII text version

    Release Notes can now be accessed from the navigation bar on the new Setup
    utility 'Help' window.  This is identical to the previous ASCII content but
    is directly accessible from the GUI instead of navigating to the file by
    Explorer.

    A printed version of the Release Nores may be obtained by opening
    <installDir>/data/help/XXX_ReleaseNotes.html in a browser and printing the
    page (e.g. FireFox, Chrome, etc).

    This is a documentation change with no configuration consequences.
    EEPROM data layout is unchanged; no existing CA configurations or
    settings files are affected.


(4) 5016 (new) Replace multiple installed firmware files with a single file

    Classically, new firmware release contained multiple firmware files.  The
    user selected the appropriate file according to how EEPROM should be
    affected by the flash operation.  A separate default.hex file provided a
    baseline setup appropriate for creating new user setups for the firmware.

    Upgrades to the Setup Utility and CA firmware packaging now utilize a
    single file 'CA3-1xxx_firmware.cahex' that replaces the multiple firmware
    files as well as the default setup file.  The enhanced Setup Utility
    provides the all original functionality but derived from the single file
    distribution. 
    
    >> This feature is now available only with the new 1.52 or later Setup
       Utility.  Older firmware packages will not operate properly if installed
       on the new Setup Utility.


(5) 4234 - Backspacing twice into Setup entry with leading +/- does not work

    In Setup, moving the cursor to the right off a leading +/-, then back, then
    repeating the steps causes the +/- character to transform to a digit. Escape
    from the edit mode becomes impossible.  This is a general failure of all
    Setup fields with a leading +/- sign character.
    
    The numeric field edit routine common to Setup input fields has been repaired.

    This is a processing change with no configuration consequences.  Configuration
    data layout is unchanged; no existing CA configurations or settings files
    are affected.


(6) 2160 - (new) Separate Settings and Firmware hex files into different directories

    Support of separate 'settings' and 'firmware' subdirectories was originally
    enforced by installation of CA zip packages.  The new Setup Utility now
    provides this organization out-of-box.  The older 'settings' directory has
    been replaced with 'setups'.
    
    EEPROM data layout is unchanged; existing CA configurations and settings
    files are unaffected.


(7) 5014 (new) Change PAS Start/Stop thresholds from rpm to time-based

    The original PAS Start and Stop Thresholds were specified in units of rpm
    which is somewhat misleading and obscures the underlying detection
    mechanism.

    The Start/Stop thresholds are now specified as the maximum time in seconds
    that can pass between poles for Assist to Start or Stop; the range is 0.01
    sec to 2.00 sec.  In other words when starting, if the time from pole to
    pole is less than the threshold, then assist is applied. Once underway,
    assist continues until the pole to pole time is greater than the Stop
    threshold.  The Stop Threshold is typically set less than the Start
    Threshold to provide quicker assist turn off.
 
    This revision affects EEPROM configuration.  Existing CA configurations,
    setup files, and prior firmware are incompatible.

    >> A fresh configuration must be instated after flashing the new firmware.


(8) 4432 - Console Setup editing of Lifetime Ah statistic works improperly

    There are two problems:

    (a) If the Total Ah is set less than the present Trip Ah, then the stored
	Lifetime Ah goes negative. This occurs because of the logic that adds
	the Trip Ah to the Lifetime Ah for edit and then subtracts the Trip Ah
	when edit is complete.

    (b) Unlike all other setup categories, the Stats category present both A and
	B battery stats for editing.  This was handled improperly as Trip Ah
	were always added/subtracted from the edited Lifetime Ah.  This made the
	unselected pack Ah appear 'TripAh' too large when editing.
	
    The stored value of Lifetime Ah is now clamped to 0 to prevent negative
    values.  Trip Ah are no longer added to the Lifetime Ah of the unselected
    pack for editing.

    This is a user interface change with no configuration consequences.
    EEPROM data layout is unchanged; no existing CA configurations or
    settings files are affected.


(9) 2386 - (new) Replace per-Battery Lifetime Ah with Lifetime Wh

    Watt-hours are arguably a more useful lifetime statistic than Amp-hours
    since the statistic allows comparisons between batteries with different
    terminal voltages.

    Storage previously used for lifetime AH has been reassigned as lifetime Wh.

    This revision affects the content of lifetime statistics in EEPROM although
    the general layout is unaffected.  Either the specific lifetime statistics
    must be manually corrected or a new Setup must be configured from scratch.


(10) 1746 - (new) Relocate A/B RBatt values to calibration region

    RBatt values are computed as a running calculation. Changing to new
    firmware or loading a new setup file erases the existing RBatt values so
    they must be recalculated from scratch.

    The RBatt values for batteries A and B have been relocated to the
    Calibration region to preserve the values regardless of loading a new
    Setup or flashing new firmware.

    This revision affects EEPROM configuration.  Existing CA configurations,
    setup files, and prior firmware are incompatible.

    >> A fresh configuration must be instated after flashing the new firmware.


(11) 1650 - (new) Remove configuration of 'RBatt Min Delta Amps'

    The RBatt calculation depends on real time data exceeding a minimum change
    in present current.  Although adjustable, this parameter is seldom if ever
    used, is hidden, and occupies valuable EEPROM space.

    The configuration option has been removed to free up EEPROM. The previous
    EEPROM default value is now used a fixed non-configurable constant.  Future
    releases may enhance operation to dynamically calculate a more optimal
    value.

    This revision affects EEPROM configuration.  Existing CA configurations,
    setup files, and prior firmware are incompatible.

    >> A fresh configuration must be instated after flashing the new firmware.


(12) 4162 - (new) Watchdog Exception shows only 3 stack entries

    The existing Watchdog display is a stack dump that is invoked on a main loop
    timing overrun.  It displays the top three stack entries and awaits a Right
    Button press to reboot.  The user should record the specific displayed
    values, then Right Press to reboot.

    The Watchdog display has been revised to loop and display up to 3 stack
    entries per screen.  A new group of entries appears on each Right Button
    press until the stack is empty.  Here the user does as before but records
    each screen in turn doing a sequence of Right Presses until the CA reboots.

    EEPROM layout is unchanged and existing CA configurations and settings files
    are unaffected.


(13) 4150 - EEPROM setup parameters can become corrupted

    The long-standing but rare 3.0 problem of Setup values in EEPROM being corrupted
    became more acute in 3.1. The problem arose when CA voltage was applied
    slowly as with a precharge switch, because of regen when pedaling with the
    controller powered OFF, or in other situations where VShutdown was
    configured at 11V (default) and the CA voltage fluctuated above/below that
    threshold.

    A number of internal changes to power up and low power shutdown processing
    have been implemented to remedy this problem. The modifications are normally
    invisible to the user except for these specific cases:

	a. The 'Low V' shutdown display now reads 'Low Volts'. As before, if the
	   CA voltage rises back up to VShutdown, the CA will reboot
	   automatically and power up normally.

	b. A 'Slow Pwr Up' display will appear if initial CA voltage is too low
	   or rises too slowly. This can be the case with precharge switches or
	   regen pedaling with the controller powered OFF.  The CA will reboot
	   automatically and power up normally as soon as the CA voltage reaches
	   VShutdown.

	c. Setup can be entered by pressing either console button while in a
	   'Low Volts' or 'Slow Pwr Up' condition. In the past only the right
	   button had this function.
    
	d. A continuously running EEPROM 'change monitor' has been added
	   that scans EEPROM about once every 4 seconds.  If a change is
	   detected, a 'Setup Changed!' pop-up is displayed for several seconds.
	   Normal CA operation is not interrupted, but the pop-up should be a
	   prompt to review Setup for corruption.  With the corruption problem
	   now repaired, this popup should never appear except after flashing
	   new firmware or loading a new setup from the Setup Utility.

	e. The default Pref->VShutdown setting has been restored to 11V after
	   being raised to 13V in previous releases as a temporary fix until
	   this problem could be properly resolved.


    This revision affects EEPROM configuration.  Existing CA configurations,
    setup files, and prior firmware are incompatible.

    >> A fresh configuration must be instated after flashing the new firmware.


(14) 4650 - Human Watts statistic accumulates with non-torque PAS device

    PAS logic incorrectly computes Human Watts when the the CA is configured
    for a Basic PAS device (without torque sensor).  Since there is no valid
    torque signal, human power cannot be calculated.  This error was introduced
    in the PAS revisions that separated PAS device and operating mode
    configuration.

    PAS logic has been revised to force zero torque for non-torque PAS device
    configuration.  However, Human Watts are accumulated and displayed if a
    torque device is installed but is operated in Basic PAS (non-torque mode);
    in that case supplied assist does not consider pedal torque but the
    displayed human power statistic can be useful.
    
    EEPROM layout is unchanged and existing CA configurations and settings files
    are unaffected.


(15) 4702 - (new) Increase the max PAS pole count back to 32

    The pole count in 3.00 was originally upgraded over beta releases from 24 to
    32 to accommodate new PAS sensors being evaluated. This was restored to the
    original maximum of 24 in release 3.01. However, once again new equipment
    makes support of 32 poles necessary/desirable.
    
    The maximum configurable value for PAS->PASPoles has been increased to
    32 from the original 24.

    EEPROM layout is unchanged and existing CA configurations and settings files
    are unaffected.


(16) 3836 - Increase range of Select Setup parameters

    Maximum Batt->Capacity has been increased from 0-99.0 to 0-599.0 Ah

    EEPROM layout is unchanged and existing CA configurations and settings files
    are unaffected.


(17) 4196 - TRQ OFFSET for pre-defined PAS devices resets to default on reboot

    If the sensor is a predefined type, then on boot (power up or after Settings
    download) the CA instates device-specific default settings for PAS device
    parameters.  Unfortunately, this erases any new Zero Torque Offset Voltage
    that the user may have established.  Whereas changing other PAS device
    parameters forces the PAS sensor type to 'Custom' to recognize the
    nonstandard configuration, the Zero Offset parameter is unusual in that
    adjustment is expected and normal. This adjustment should not be
    over-written and should not require gross sensor type reclassification to
    'Custom'.
    
    The 'predefined type' logic has been revised to only apply the default zero
    torque offset if the present value (newly downloaded or user-modified) is
    outside the acceptable operating range for that particular sensor type.
    Newly zeroed offsets will now remain unchanged if the CA is either
    power-cycled or the new offset is uploaded to the Setup utility and
    subsequently downloaded.  Only offsets that cannot reasonably work will be
    replaced with a default.
    
    EEPROM layout is unchanged and existing CA configurations and settings files
    are unaffected.


(18) 4873 - Revise torque device naming in the PAS Device chooser

    Although accurate, the Torque device naming in the PAS Device chooser is not
    as descriptive as space allows.
    
    The 'NCTE BB' choice has been renamed to 'NCTE ISIS' to differentiate it
    from the other square taper devices.

    This revision affects EEPROM configuration.  Existing CA configurations,
    setup files, and prior firmware are incompatible.

    >> A fresh configuration must be instated after flashing the new firmware.


(19) 4851 - (new) Add 'Bypass' diagnostic throttle mode

    Disconnectng the CA is often a recommended step to localize the offending
    component when diagnosing a misbehaving bike setup.  This can be problematic
    because the throttle runs through the CA and proper controller operation
    often relies on the CA to re-map Throttle voltage levels (e.g. for resistive
    throttles or avoiding controller throttle fault or regen voltages).
    
    A new diagnostic 'Bypass' throttle mode has been added.  In this mode the CA
    only performs the configured Throttle IN to Throttle OUT voltage mapping -
    all other processing and features are bypassed. All displays work normally
    including the Limit Flags which show what limits the CA would apply in the
    current situation. Ebrakes, throttle ramping, PAS, Autocruise, etc are all
    deactivated so the controller sees only mapped throttle activity.

    This is a diagnostic mode not recommended for normal use. All normal CA
    limiting/protection features are bypassed and cannot affect bike operation
    although screen indicators will display (e.g. no thermal rollback, no low
    battery cutoff, no battery current limiting).

    EEPROM layout is unchanged and existing CA configurations and settings files
    are unaffected.


(20) 4182 = AutoPAS Aux Change Pop-up does not show actual Assist Power

    The Aux Change pop-up shows only the baseline PAS->AsstStart power and does
    not include additional power due to optionally configured RPM scaling.

    The 'Aux Change' pop-up for AutoPAS mode has been revised to show the total
    target power value after Aux scaling including the rpm-based component. The
    displayed value is the setpoint power for the PID controller reflecting the
    power that will be achieved shortly, not the actual present power applied.
    This allows a quick adjustment of the desired power without waiting for the
    bike to actually achieve the new setting.

    EEPROM layout is unchanged and existing CA configurations and settings files
    are unaffected.


(21) 2020 = Changing PAS Modes causes odd values for PAS->AssistStart, AsstFactr

    Reconfiguring PAS modes with non-default values already configured can
    result in display of strange values.  This arises because the same internal
    numeric values are interpreted differently according to mode.  Although the
    default values result in reasonable values for all modes, user-supplied
    values may not.
    
    Console Setup behavior has been revised so that changing the PAS mode causes
    default values to be re-instated for PAS->AssistStart and PAS->AsstFactr.
    This does not occur in the Software Setup Utility which requires manual
    correction to default or other desired values.

    EEPROM layout is unchanged and existing CA configurations and settings files
    are unaffected.


(22) 4935 (new) Add PAS Row Bike Mode

    A new 'Row Bike' device type has been added that expects a PAS wheel
    input with back and forth strokes being signaled as forward and reverse
    pedaling via the DIR PAS input.  The PAS wheel start/stop thresholds and
    number of PAS poles are configured to match the PAS wheel as per normal.

    RPM displays are replaced with SPM (Strokes per minute) on status screens -
    including the Main Screen custom field.  Assist is calculated assuming a
    minimum of 25 SPM.  SPM power scaling operates on stroke rates in excess of
    this figure so at 60SPM an Assist Factor of 10 W/SPM will yield an extra
    ( 60SPM - 25SPM ) * 10 W/SPM = 350W

    This revision affects EEPROM configuration.  Existing CA configurations,
    setup files, and prior firmware are incompatible.

    >> A fresh configuration must be instated after flashing the new firmware.


(23) 4456 (new) Add new PAS mode with ThrO instead of Power PID control

    Certain controllers can make it difficult to tune the Power PID controller
    for stable oscillation-free operation due to the granularity of the
    controller throttle measurement.  This can indirectly affect PAS operation
    for those modes that use that PID controller. Also, some users desire a more
    speed-oriented (voltage) PAS adjustment instead of the power scaling that
    occurs in modes where the Poser PID controller is in play.

    Add a new 'AutoPAS ThO' mode that directly controls ThrOUT and is configured
    in terms of percentage of the MinOut-MaxOut voltage range. This eliminates
    the Power PID controller tuning issue and goes to direct voltage scaling for
    Aux controls that is more closely related to speed.

    This revision affects EEPROM configuration.  Existing CA configurations,
    setup files, and prior firmware are incompatible.

    >> A fresh configuration must be instated after flashing the new firmware.


(24) 5180 rename 'AutoPAS' to 'Basic' and split into PWR and ThO modes 

    AutoPAS mode is a legacy term from early CA PAS development and the meaning
    is non-obvious to new users.

    Retire AutoPAS mode and replace it with 'Basic (Pwr)' and 'Basic (ThO)'
    modes to carry over nomenclature from the 'Basic' PAS non-Torque device.
    In conjunction with task 4456 that implements PAS ThO mode, the new PAS Mode
    menu appears as:

	1. NoAssist
	2. Basic (Pwr)
	3. Basic (ThO)
	6. Torque

    This revision affects EEPROM configuration.  Existing CA configurations,
    setup files, and prior firmware are incompatible.

    >> A fresh configuration must be instated after flashing the new firmware.


(25) 2412 (new) Display Aux Limit changes as either 'pop-up' or 'Custom View'

    Limiting adjustments to Aux inputs classically caused a transient pop-up
    screen that remains displays as long as the input is changing (e.g. making
    a pot adjustment for PAS limiting).  Unfortunately this hides the normal
    status screen display fields.

    A new chooser Pref->AuxChgDsp allows selection of whether the classic pop-up
    display or causes the custom field to immediately display the AX or DX
    custom view.  Pref->CustViews does not need to be configured to display the
    AX or DX fields.

    This revision affects EEPROM configuration.  Existing CA configurations,
    setup files, and prior firmware are incompatible.

    >> A fresh configuration must be instated after flashing the new firmware.


(26) 5206 - (new) Add AutoMain feature to return to main screen after delay

    Actively switching screens while riding can be problematic and typically
    requires advancing from the Main Screen to a alternate screen of interest
    and then navigating back.

    A new 'AutoMain' feature can be enabled to automatically return to the Main
    Screen after a short period of console button inactivity.  This allows the
    rider to scan a screen or two and then let the CA restore the Main Screen
    after the buttons have been idle for about 12 seconds.

    As part of this effort, the Prefernces category was split into two new
    categories: 'Display' and 'Miscellaneous' settings.
    
    This feature does not affect any existing CA configurations or settings
    file.


_______________________________________________________________________________
Release: 3.1b20                                                      2017-04-27


Note: V3.1b20 Setup files are **incompatible** with firmware or Setup files
      of **ALL** prior releases.

      ------------------------------------------------------------------------
      IMPORTANT:                               __________________
      Please install this package according to README_install.txt.
      Failure to do so may result in improper operation of the Setup Utility.
      ------------------------------------------------------------------------
      
      ------------------------------------------------------------------------
      IMPORTANT:
      After installing this zip package on a PC, the Setup utility will no
      longer be able to properly utilize 3.1 Setup files prepared for prior
      3.1 versions.  Prior 3.1 settings files will not be usable for either
      display or download. Similarly, setup files prepared with this release
      cannot be used with earlier CA 3.1 firmware versions. 3.0 Setup files are
      unaffected.
      ------------------------------------------------------------------------

      >> Any incompatible existing CA setup must be recorded and manually
         reconfigured over a fresh 'CA3-1b20_firmware.hex' installation.

      >> All existing CA Setups must either be:
	    1. exported manually from the CA console (at least the statistics)
	    2. OR read by the Setup Utility and preserved in screen snapshots
	       PRIOR to installing this package. Saving to a 3.1 Setup file and
	       reading the file after installing the zip package will not work.
	    3. OR read and displayed by a Setup Utility installation that has
	       not been updated with this release so that values can be manually
	       copied into a second Setup utility that has been updated.

      ------------------------------------------------------------------------
      IMPORTANT:
      Because a CA3-1b20_firmware.hex flash will load default settings, throttle
      voltage configuration may be incorrect. Treat this as an initial CA
      installation and place the bike on a stand or otherwise elevate the drive
      wheel to prevent a runaway when the flash completes and before a proper
      configuration can be restored.
      ------------------------------------------------------------------------


(1) 4358 - Revise product to transparently support different EEPROM layouts

    CA settings file incompatibilities are not unusual between different
    versions of production firmware as new features alter the configuration
    EEPROM layout.  This problem is worse for beta releases where evolving
    features and EEPROM layouts are more frequent with increased risk of loading
    the CA with settings for the wrong firmware version because the Setup
    utility cannot discriminate between beta versions.

    The file naming and content of EEPROM layout files (i.e. Vxxx,cas, Vxxx.hex,
    and user settings files) have been revised so that there is now an explicit
    version relationship between settings files and each particular firmware
    revision (e.b. 3.1b16).  This does not make it possible to convert settings
    across incompatible firmware versions, but it does prevent version cross
    loading errors.  Importantly, it also allows the Setup utility to
    differentiate EEPROM layouts between beta releases.  For instance, if
    3.1b13, 3.1b14, and 3.1b15 firmware with differing EEPROM layouts are all
    installed on the PC, the Setup Utility can properly configure any of the
    versions. As before, the 'default' settings files are simply specially
    named settings files.

    This change affects all existing settings files and installed CA firmware.
    A new installation of the Software Setup Utility is required. Previously
    released 3.1 beta release packages are incompatible. All existing 3.1
    settings files are incompatible with the new Setup Utility.  See
    documentation for the new Setup utility for a detailed compatibility
    discussion.


(2) 4412 - (new) Convert firmware package Settings Summary doc to PDF

    The settingsSummary.txt file installed by the CA package is in text format
    which may not provide the most easily readable or searchable for some users.
    
    The document is not provided in PDF format which is affords search,
    highlighting, and other features using available Adobe or third party
    tools on PC and mobile devices.
    
    This is a documentation change. Existing CA configurations or settings files
    are unaffected.


(3) 4150 - EEPROM setup parameters can become corrupted

    Setup values in EEPROM can be corrupted when the CA battery voltage is
    applied slowly as with a precharge switch, because of regen when pedaling
    with the controller powered OFF, or in other situations where VShutdown was
    configured at 11V (default) and the CA voltage fluctuates above/below that
    threshold.

    This is a rare occurence and the workaround is to raise Pref->VSHutdown to
    13V.  This indirectly remedies the underlying issue.  A more thorough repair
    is slated for release in 3.1 that allows specifying VShutdown to the
    original 11V default.  This should have negligible effect on all except
    users of 12V systems.

    The default value for Pref->VShutdown has been raised to 13V.

    This is a default parameter value change.  Configuration data layout is
    unchanged; no existing CA configurations or settings files are affected
    although users experiencing this issue should manually alter VShutdown in
    existing configurations.


(4) 5202 - Enable Throttle controlled regen braking by default

    The feature was originally disabled by default, however, most users with
    controllers that support the feature will enable it, and the users with no
    hardware support are unaffected if it is enabled.

    EBk->PropRegen is now enabled by default.

    This change has no configuration consequences.  EEPROM data layout is
    unchanged; no existing CA configurations or settings files are affected.


_______________________________________________________________________________
Release: 3.1b16                                                      2017-03-26


Note: V3.1b16 Setup files are **incompatible** with firmware or Setup files
      of **ALL** prior releases except version 3.1b15.

      ------------------------------------------------------------------------
      IMPORTANT:                               __________________
      Please install this package according to README_install.txt.
      Failure to do so may result in improper operation of the Setup Utility.
      ------------------------------------------------------------------------
      
      ------------------------------------------------------------------------
      IMPORTANT:
      After installing this zip package on a PC, the Setup utility will no
      longer be able to properly utilize 3.1 Setup files prepared for prior
      3.1 versions.  Prior 3.1 settings files will not display or edit properly
      and will download to the CA incorrectly resulting in improper CA
      operation. Similarly, setup files prepared with this release cannot be
      used with earlier CA 3.1 firmware versions. 3.0 Setup files are unaffected.
      ------------------------------------------------------------------------

      >> Any incompatible existing CA setup must be recorded and manually
         reconfigured over a fresh 'CA3-1b16_firmware.hex' installation.

      >> All existing CA Setups must either be:
	    1. exported manually from the CA console (at least the statistics)
	    2. OR read by the Setup Utility and preserved in screen snapshots
	       PRIOR to installing this package. Saving to a 3.1 Setup file and
	       reading the file after installing the zip package will not work.
	    3. OR read and displayed by a Setup Utility installation that has
	       not been updated with this release so that values can be manually
	       copied into a second Setup utility that has been updated.

      ------------------------------------------------------------------------
      IMPORTANT:
      Because a CA3-1b16_firmware.hex flash will load default settings, throttle
      voltage configuration may be incorrect. Treat this as an initial CA
      installation and place the bike on a stand or otherwise elevate the drive
      wheel to prevent a runaway when the flash completes and before a proper
      configuration can be restored.
      ------------------------------------------------------------------------


(1) 4222 - Aux Change 'PAS Power Factor' pop-up only shows data for preset #1

    When configured to control 'PAS Assist', the Aux Change pop-up screen always
    displays the Assist Power Factor for preset #1 regardless of the actual
    selected preset #1 to #3.

    The firmware has been corrected to properly consider the preset setting.
    
    This is a display change with no configuration consequences.  Configuration
    data layout is unchanged; no existing CA configurations or settings files
    are affected.


(2) 4224 - Setup Utility 'Assist Pwr Fctr' units do not vary with Assist Mode

    PAS Assist Mode controls the interpretation of values 'Assist Start Power'
    and 'Assist Power Factor'. In the Setup Utility the PAS Assist Mode
    selection should alter both displayed units and input value bounds checking
    for both settings. These features are broken in 3.1b15 due to shortening the
    PAS Mode menu.

    The installed Setup Utility V310.cas file has been revised to provide the
    proper conditional behavior for both PAS Start Power and PAS Power Factor.
    Once this package is installed, Setup Utility behavior will be corrected.

    This is a display change with no configuration consequences.  Configuration
    data layout is unchanged; no existing CA configurations or settings files
    are affected.


_______________________________________________________________________________
Release: 3.1b15                                                      2017-03-19


Note: V3.1b15 Setup files are **incompatible** with firmware or Setup files
      of **ALL** prior releases including any earlier 3.1 version.

      ------------------------------------------------------------------------
      IMPORTANT:                               __________________
      Please install this package according to README_install.txt.
      Failure to do so may result in improper operation of the Setup Utility.
      ------------------------------------------------------------------------
      
      ------------------------------------------------------------------------
      IMPORTANT:
      After installing this zip package on a PC, the Setup utility will no
      longer be able to properly utilize 3.1 Setup files prepared for prior
      3.1 versions.  Prior 3.1 settings files will not display or edit properly
      and will download to the CA incorrectly resulting in improper CA
      operation. Similarly, setup files prepared with this release cannot be
      used with earlier CA 3.1 firmware versions. 3.0 Setup files are unaffected.
      ------------------------------------------------------------------------

      >> Any incompatible existing CA setup must be recorded and manually
         reconfigured over a fresh 'CA3-1b15_firmware.hex' installation.

      >> All existing CA Setups must either be:
	    1. exported manually from the CA console (at least the statistics)
	    2. OR read by the Setup Utility and preserved in screen snapshots
	       PRIOR to installing this package. Saving to a 3.1 Setup file and
	       reading the file after installing the zip package will not work.
	    3. OR read and displayed by a Setup Utility installation that has
	       not been updated with this release so that values can be manually
	       copied into a second Setup utility that has been updated.

      ------------------------------------------------------------------------
      IMPORTANT:
      Because a CA3-1b15_firmware.hex flash will load default settings, throttle
      voltage configuration may be incorrect. Treat this as an initial CA
      installation and place the bike on a stand or otherwise elevate the drive
      wheel to prevent a runaway when the flash completes and before a proper
      configuration can be restored.
      ------------------------------------------------------------------------


(1) 2918 - Change DigiAux circuit to use Schottky Diodes

    The design change to Schottky diodes in the DigiAux circuit is finalized.
    From this release forward conventional diode support is discontinued.
    
    Circuits constructed by early beta adopted must be upgraded to use Schottky
    parts for compatibility.

    This is a hardware change with no configuration consequences.  Configuration
    data layout is unchanged; no existing CA configurations or settings files
    are affected.


(2) 3834 - (new) Eliminate ThotPAS mode

    The existing 'ThrotPAS' is not a distinct mode but rather a basic behavior
    shared by other PAS modes that persists even when there is no actual
    'assist'.  Remove the mode and assign this behavior to be present even in
    'No PAS' mode.  Rename 'No PAS' mode to 'No Assist' to emphasize the absence
    of powered assist differing from a completely inert PAS device; that is the
    previous ThrotPAS behavior is in effect in 'No Assist' mode.

    PAS Setup has been revised as described.
    
    This revision affects EEPROM configuration.  Existing CA configurations,
    setup files, and prior firmware are incompatible.

    >> A fresh configuration must be instated after flashing the new firmware.


(3) 3838 - (new) Relocate 'PAS->MxThotSpeed' to 'SLim->MxNoPdlSpd'

    PAS 'Max Throttle-Only Speed' is should be relocated to the Speed Limits
    category to consolidate speed-related configuration parameters. It should be
    renamed to 'Max No-Pedal Speed' to emphasize the relationship to pedaling,

    The parameter has been relocated and renamed as indicted.

    This revision affects EEPROM configuration.  Existing CA configurations,
    setup files, and prior firmware are incompatible.

    >> A fresh configuration must be instated after flashing the new firmware.


(4) 3994 - Torque Offset re-sample mode has unnecessary 'sample display' view

    Previous menu updates to the 'torque offset' screen introduced a separate
    display mode that shows only the sampled value after release of the long
    press that forces the sample.  However, the Torque Offset screen already
    shows both the EEPROM (new sample) configuration value and the live voltage
    making the extra display view of 'sample only' unnecessary.

    1. The extra 'sample only' view has been removed to revert to the original
       design.
    2. The setting operation 'Trq Offst' has also bee changed to 'Zero Torq'
       to be consistent with the Calibration operation 'Zero Amps'.
    3. The live data fields in the 'Zero Torq' and 'Zero Amps' settings have
       been bracketed with parentheses () to emphasize the non-EEPROM display
       content.

    EEPROM data layout is unchanged; no existing CA configurations or
    settings files are affected.


(5) 2020 - 'Torque Offset' operation has different terminology than 'Zero Amps'

    The Setup menu command to sample and set the PAS zero torque offset is named
    as if it is an entry field instead of an operation like 'Zero Amps'.

    The Setup menu item has been renamed to 'Zero Torq'.

    EEPROM data layout is unchanged; no existing CA configurations or
    settings files are affected.


(6) 4000 - AuxA 'Lo Deadband' setting cannot always eliminate deadband

    If the actual Schottky Vfwd is lower than the defined value of 0.43V, then
    the low end deadband cannot be eliminated/reduced as the actual voltage is
    lower than the expected minimum or (2*Vfwd). This leaves a low deadband that
    must be tranversed before the pot develops a voltage equal to the expected
    low voltage value

    The 'AuxD enabled' Low Pot voltage has been reduced to 0.7525V from the
    previous 0.86V.  This adds headroom to allow adjustment of the low deadband.

    This computation change may have configuration consequences for existing
    'Lo Deadband' settings.  This is a local adjustment with no EEPROM
    incompatibilities.  Except for this adjustment existing CA configurations or
    settings files are unaffected.

    >> Any existing AuxA Pot 'Lo Deadband' setting should be revisited/verified.


(7) 2418 - (new) Extend Speed Limiting to use regen braking

    Classic CA speed limiting operates by reducing motor power. Although this is
    effective on level terrain it does not allow speed limiting down inclines
    where the natural unpowered rolling speed of the bike exceeds the configured
    speed limit.

    All Grinfineon and Phaserunner controllers can provide regen braking in the
    CA Throttle Out voltage range 0V - 0.8V.  'Speed Limiting' can now
    optionally utilize this lower voltage range to apply regen braking if speed
    cannot be adequately reduced by simply removing power.  This means it is now
    possible to configure a maximum speed (or dial in a speed using AuxIn) and
    the CA will apply regen braking as needed when descending hills to enforce
    that limit.  This feature can also be used with Throttle-based Proportional
    regen; the greater of the two regen braking demands is applied.

    This feature requires a Grin controller.

    The new option is 'SLim->RegenLmtg' which defaults to 'disabled'.

    This revision affects EEPROM configuration.  Existing CA configurations,
    setup files, and prior firmware are incompatible.

    >> A fresh configuration must be instated after flashing the new firmware.


_______________________________________________________________________________
Release: 3.1b14                                                      2017-02-26


Note: V3.1b14 Setup files are compatible with firmware nad Setup files
      of **ALL** prior releases. Only documentation files have changed.

      ------------------------------------------------------------------------
      IMPORTANT:                               __________________
      Please install this package according to README_install.txt.
      Failure to do so may result in improper operation of the Setup Utility.
      ------------------------------------------------------------------------
      
      ------------------------------------------------------------------------
      IMPORTANT:
      After installing this zip package on a PC, the Setup utility will no
      longer be able to properly utilize 3.1 Setup files prepared for prior
      3.1 versions.  Prior 3.1 settings files will not display or edit properly
      and will download to the CA incorrectly resulting in improper CA
      operation. Similarly, setup files prepared with this release cannot be
      used with earlier CA 3.1 firmware versions. 3.0 Setup files are unaffected.
      ------------------------------------------------------------------------

      >> Any incompatible existing CA setup must be recorded and manually
         reconfigured over a fresh 'CA3-1b14_firmware.hex' installation.

      >> Existing incompatible CA Setups must either be:
	    1. exported manually from the CA console (at least the statistics)
	    2. OR read by the Setup Utility and preserved in screen snapshots
	       PRIOR to installing this package. Saving to a 3.1 Setup file and
	       reading the file after installing the zip package will not work.
	    3. OR read and displayed by a Setup Utility installation that has
	       not been updated with this release so that values can be manually
	       copied into a second Setup utility that has been updated.

      ------------------------------------------------------------------------
      IMPORTANT:
      Because a CA3-1b14_firmware.hex flash will load default settings, throttle
      voltage configuration may be incorrect. Treat this as an initial CA
      installation and place the bike on a stand or otherwise elevate the drive
      wheel to prevent a runaway when the flash completes and before a proper
      configuration can be restored.
      ------------------------------------------------------------------------


(1) 3992 - Add Settings Summary documentation to firmware package

    Beta firmare changes can result in settings and menu changes that are not
    reflected on the official Grin CA3 web page and are available only as posts
    in the Endless Sphere CA Beta thread. A composite listing of menus and
    settings does not exist.
   
    A SettingsSummary.txt file has been added to the packaging to provide an
    aggregate summary of settings contemporary with each release. The summary is
    brief and in the manner of the Grin CA web page settings description,
    relying on other beta posts or documentation to fully explain features.
    
    This is documentation change. No existing CA configurations or settings
    files are affected.


_______________________________________________________________________________
Release: 3.1b13                                                      2017-02-05


Note: V3.1b13 Setup files are **incompatible** with firmware or Setup files
      of **ALL** prior releases except version 3.1b12.

      ------------------------------------------------------------------------
      IMPORTANT:                               __________________
      Please install this package according to README_install.txt.
      Failure to do so may result in improper operation of the Setup Utility.
      ------------------------------------------------------------------------
      
      ------------------------------------------------------------------------
      IMPORTANT:
      After installing this zip package on a PC, the Setup utility will no
      longer be able to properly utilize 3.1 Setup files prepared for prior
      3.1 versions.  Prior 3.1 settings files will not display or edit properly
      and will download to the CA incorrectly resulting in improper CA
      operation. Similarly, setup files prepared with this release cannot be
      used with earlier CA 3.1 firmware versions. 3.0 Setup files are unaffected.
      ------------------------------------------------------------------------

      >> Any incompatible existing CA setup must be recorded and manually
         reconfigured over a fresh 'CA3-1b13_firmware.hex' installation.

      >> Existing incompatible CA Setups must either be:
	    1. exported manually from the CA console (at least the statistics)
	    2. OR read by the Setup Utility and preserved in screen snapshots
	       PRIOR to installing this package. Saving to a 3.1 Setup file and
	       reading the file after installing the zip package will not work.
	    3. OR read and displayed by a Setup Utility installation that has
	       not been updated with this release so that values can be manually
	       copied into a second Setup utility that has been updated.

      ------------------------------------------------------------------------
      IMPORTANT:
      Because a CA3-1b13_firmware.hex flash will load default settings, throttle
      voltage configuration may be incorrect. Treat this as an initial CA
      installation and place the bike on a stand or otherwise elevate the drive
      wheel to prevent a runaway when the flash completes and before a proper
      configuration can be restored.
      ------------------------------------------------------------------------


(1) 1874 - Save/Restore feature cannot detect saved 'defaults'

    The Save/Restore feature cannot detect that 'dafaults' have been written to
    the image buffer. This has two effects:

	1. The Restore feature cannot be invoked either from the Setup menu or
	   by a very long right press of the right console button
	2. A new save operation occurs on every boot. The success of this
	   operation cannot be subsequently detected.

    The issue has been repaired.
    
    EEPROM data layout is unchanged; no existing CA configurations or
    settings files are affected.


_______________________________________________________________________________
Release: 3.1b12                                                      2017-02-04


Note: V3.1b12 Setup files are **incompatible** with firmware or Setup files
      of **ALL** prior releases including any earlier 3.1 version.

      ------------------------------------------------------------------------
      IMPORTANT:                               __________________
      Please install this package according to README_install.txt.
      Failure to do so may result in improper operation of the Setup Utility.
      ------------------------------------------------------------------------
      
      ------------------------------------------------------------------------
      IMPORTANT:
      After installing this zip package on a PC, the Setup utility will no
      longer be able to properly utilize 3.1 Setup files prepared for prior
      3.1 versions.  Prior 3.1 settings files will not display or edit properly
      and will download to the CA incorrectly resulting in improper CA
      operation. Similarly, setup files prepared with this release cannot be
      used with earlier CA 3.1 firmware versions. 3.0 Setup files are unaffected.
      ------------------------------------------------------------------------

      >> Any incompatible existing CA setup must be recorded and manually
         reconfigured over a fresh 'CA3-1b12_firmware.hex' installation.

      >> All existing CA Setups must either be:
	    1. exported manually from the CA console (at least the statistics)
	    2. OR read by the Setup Utility and preserved in screen snapshots
	       PRIOR to installing this package. Saving to a 3.1 Setup file and
	       reading the file after installing the zip package will not work.
	    3. OR read and displayed by a Setup Utility installation that has
	       not been updated with this release so that values can be manually
	       copied into a second Setup utility that has been updated.

      ------------------------------------------------------------------------
      IMPORTANT:
      Because a CA3-1b12_firmware.hex flash will load default settings, throttle
      voltage configuration may be incorrect. Treat this as an initial CA
      installation and place the bike on a stand or otherwise elevate the drive
      wheel to prevent a runaway when the flash completes and before a proper
      configuration can be restored.
      ------------------------------------------------------------------------


(1) 2430 - Temp Stats Screen 'Time Temp-Limiting' field displays even when 0

    Formerly, the rightmost field of the Temp Stats screen always alternated
    between 'Tavg' and 'Mins'.  For most users and riding situations, the motor
    is never temperature limited making the 'Mins' display unnecessary.

    The display has been revised to only alternate and display the 'Mins' field
    (total time temperature limiting) when the time is non-zero.
    
    Configuration data layout is unchanged; no existing CA configurations or
    settings files are affected.


(2) 2700 - Bikes w/o Speed monitoring can't activate features dependent on 'Moving'

    Display of 'Moving' vs 'Still' screens, accumulation of 'trip time', and
    accumulation of temperature averages are conditioned by detection of vehicle
    motion according to the Spd signal. Vehicles without this signal are never
    considered 'moving' which effectively deactivates these features. 

    'Movement' detection has been revised to be triggered by either activity of
    the Spd signal OR current greater than 1A (10A for HiRange shunt). The new
    current-based detection mode is disabled once a valid speed signal has been
    detected so that vehicles with working speed sensors preferentially use only
    sensor-based motion detection.

    NOTE: This change can result in slightly inaccurate average speed and trip
	  time if a bike without speed sensors is left standing with accessories
	  ON and drawing more than 1A since this will be considered 'moving'.
    
    Configuration data layout is unchanged; no existing CA configurations or
    settings files are affected.


(3) 2566 - PAS TorqMode should not be selectable for non-torque PAS devices

    It is possible to erroneously configure PAS for torque mode operation even
    though there is no installed torque device.

    PAS Mode selection has been revised to exclude the TorqMode option for
    non-torque devices. Additionally, changing to a non-torque device forces a
    previously configured TorqMode to PASOFF when either changing the device,
    changing to a preset with a conflict, or downloading a conflicting
    configuration from the Setup Utility.
    
    However, PAS Mode selection is not restricted nor automatically altered if
    there is no PAS device defined since there can be no actual operational
    conflict. This allows PAS to be deactivated by selecting NO DEVICE without
    adverse effect on the existing PAS Mode.

    Configuration data layout is unchanged; no existing CA configurations or
    settings files are affected.


(4) 2834 - 'Low Volts' LVC cutoff message does not display properly

    a) The 'Low Volts' screen message disappears after only brief display and
       the screen backlight instead pulses bright/dim. 

    b) When in 'Low Volts' mode there is no 'Entering Setup' message to prompt
       the user when the button can be released on the required long press.

    c) The 'Low Volts' message is not present when leaving SETUP if the
       condition persists.

    Display and button code has been revised to make the 'Low Volts' message
    persist, eliminate the backlight pulsing, force re-evaluation/re-display of
    the 'Low Volts' condition on exit of Setup mode, and add the missing button
    prompt.

    Configuration data layout is unchanged; no existing CA configurations or
    settings files are affected.


(5) 1874 - (new) Provide means to restore all settings to (factory) defaults

    Presently there is no means to clear all user configuration and restore
    EEPROM settings to (factory) defaults.

    A new 'Cal->Defaults' item has been added to the Calibration category with
    a chooser menu to either:

	1. Restore EEPROM settings to non-EEPROM defaults. All EEPROM settings
	   including Calibration but excluding Lifetime Stats are overwritten
	   and replaced with 'default' settings.

	2. Save the present EEPROM settings to redefine a new set of 'defaults'.
	   All settings including Calibration but excluding Lifetime Stats are
	   saved. Previous 'Default' settings are overwritten and lost.

    Default settings reside in a reserved region of firmware memory that is
    initially clear when new firmware is flashed. EEPROM settings are
    automatically copied to this reserved region to define new default settings
    on the first boot after a firmware flash.  This strategy sets the new
    'defaults' differently according to the type of hex file used to flash
    firmware because of the contents of EEPROM after the flash operation:

	a. In the case of flashing a CA3-xxxx_firmware.hex file, EEPROM is
	   freshly initialized with 'factory defaults' from the hex file so the
	   'defaults' are set to factory defaults.

	b. In the case of flashing a CA3-xxxx_firmware_NoEeprom.hex file, EEPROM
	   contains the existing user configuration so the 'defaults' are set to
	   the existing user configuration *NOT* factory defaults. It is not
	   possible to preserve factory defaults when flashing a 'NoEeprom' file.
	   
    To ensure data integrity, the CA will only restore default settings which
    were saved in their entirety without interruption.  If an automatic or user-
    initiated save operation is interrupted before completion (e.g. power loss),
    a new automatic 'defaults' save will occur on the next program boot.

    A 'restore defaults' operation can be initiated either of two ways:
    
	a. from the 'Cal->Defaults' Setup Menu, or
	
	b. with a very long (6 sec) RIGHT button press from the main screen.

    Configuration data layout is unchanged; no existing CA configurations or
    settings files are affected.


(6) 2020 - Y/N popup screens do not handle simultaneous button pushes

    The Y/N popups used for Reset and Restore operations select the operation on
    the first button push and ignore the second push. Also, subsequent release
    of two simultaneous button pushes causes the last released button to be
    handled by the normal status screen after the popup is dismissed.

    Behavior is revised so that simultaneous Y/N button pushes are interpreted
    as a 'No' response and popups are not dismissed until both buttons are
    released. For example, selecting a 'reset' operation can be canceled by
    simultaneously pressing 'No' before releasing the 'Yes' button.

    Configuration data layout is unchanged; no existing CA configurations or
    settings files are affected.


(7) 2020 - Y/N popup screens do not allow [Y] for CAs with a single button

    Historically some CAs have been configured to have a single button (the
    Right button).  Features of the CA are designed to allow operation with only
    the single Right button (e.g. entering Setup on boot via the Right instead
    of Left button). The recent y/n pop-ups for 'Reset' and 'Restore' allow
    single button CA's to only invoke the right [n] option.
    
    All Y/N popups have been reversed to place the [y] response on the right.
    
    Configuration data layout is unchanged; no existing CA configurations or
    settings files are affected.


(8) 2014 - Speed Limiting flag is not displayed for DSGain-induced limiting

    Some vehicles may experience cutouts during hard acceleration due to an
    excessively high DSGain setting. This particular speed limiting is not
    reflected in the Limit Flags display making the issue difficult to diagnose.

    The speed flag mechanism has been revised to include this case so that any
    speed-related limiting is reflected as an 'S' Limit Flag.
    
    Configuration data layout is unchanged; no existing CA configurations or
    settings files are affected.


(9) 2086 - ThrIn 'Min/Max Input' parms suggest actual Throttle min/max values

    The present 'Min/Max Input' nomenclature suggests that the actual throttle
    range should be specified instead of the required padded voltages that
    include high and low dead bands. This leads to a variety of Support issues.

    The nomenclature has been revised to 'Zero/Full/Fault Throttle Threshold'
    to suggest that there is some voltage discrimination intended for the
    settings rather than actual throttle min/max voltages.

    Configuration data layout is unchanged; no existing CA configurations or
    settings files are affected.


(10) 2020 - Convert battery Chemistry option 'LiMn' to 'Li-ion'

    Several common battery chemistries are not represented in the Battery
    Chemistry Setup options, however, they all share voltage and SOC
    characteristics with LiMn and all belong to the larger classification of
    Li-ion. Configuration of these other types presently requires selection of
    LiMn which is not obvious to many users.

    The battery chemistry option 'LiMn' has been renamed to 'Li-ion'.
    
    This is a text change only with no operational consequences.  Configuration
    data layout is unchanged; no existing CA configurations or settings files
    are affected.


(11) 2020 - Preset displays do not indicate the total number of presets

    The Preset popup, Setup PRESET preview screen, and Current Preset config
    screen display as '#n <name>' which does not reveal the max value for '#n'.

    Preset displays have been revised to the form '#n/m <name>' where m is the
    max configured preset (e.g. '#1/3 Medium').

    This is a display change with no configuration consequences.  Configuration
    data layout is unchanged; no existing CA configurations or settings files
    are affected.


(12) 2020 - AuxA 'Limit Change' Pop-up shows blank field for Speed=0

    The displayed speed field disappears in the AuxA 'Limit Change' pop-up when
    configured for speed limiting and speed = 0.

    Code has been revised to properly display '0'.

    This is a display change with no configuration consequences.  Configuration
    data layout is unchanged; no existing CA configurations or settings files
    are affected.


(13) 2918 - (new) Change DigiAux circuit to use Schottky Diodes

    The beta design for the DigiAux Circuit uses two conventional silicon diodes
    to extablish fixed thresholds for the digital button inputs.  Product
    considerations have led to a revision of these parts to Schottky diodes
    instead which lowers the button threshold voltages and expands the available
    analog range.

    Circuits constructed by early beta adopted must be upgraded to use schottky
    parts for compatibility.

    This is a hardware change with no configuration consequences.  Configuration
    data layout is unchanged; no existing CA configurations or settings files
    are affected.


(14) 2918 - (new) Reconfigure AuxA/AuxD menus

    (1) The classic 3-position switch configuration required guesswork or tables
    to configure desired limit percentages for Low and Med settings.

    (2) The Aux menu system presents configuration options that require
    reconfiguration of the analog device when the digital option is added
    because of a shift in the baseline analog voltage. This complicates
    configuration both for initial installation and DigiAux upgrades. In
    particular the 3-position switch configuration is non-obvious to configure
    for desired percentage levels and requires different tables than when
    configured without the DigiAux button assembly installed.
    
    (a) The menu structure has been revised to separate configuration of the
	particular installed controls (pot, 3-pos switch, etc) and the function
	the devices perform (Amps Limit, Presets, etc).
    
    (b) 'Standard' controls available off-shelf form Grin are called out as
        specific control options. Custom analog controls are supported by
	selecting one of the standard types.
    
    (c) Configuration of an installed pot has now presents parameters defining
	the high and low dead band voltages instead of the high and low absolute
	voltages so that adding/removing a DigiAux button assembly will not
	require reconfiguration of the pot.

    (d) Configuration of an installed pot is now in terms of the percentage
	limiting for the Low and Med settings with the High setting always
	assumed to be 100%. Configuration of the simple 2-pos switch
	installation is similarly supported.

    This revision affects EEPROM configuration.  Existing CA configurations,
    setup files, and prior firmware are incompatible.

    >> A fresh configuration must be instated after flashing the new firmware.


(15) 3396 - Precision of Per-cell LVC entry field in Setup Menu is too high

    The Per-Cell entry entry field allows entry to 1mv which suggests a
    measurement precision that the CA cannot actually achieve.
    
    The per-cell voltage LVC field width has been reduced by one digit reducing
    display/entry precision to 10mv.

    This is a user interface change with no configuration consequences.
    Configuration data layout is unchanged; no existing CA configurations or
    settings files are affected.


(16) 2020 - ThrI Setup Preview Screen is incorrect for mode=Disabled(ZERO)

    The ThrottleIn Setup Preview screen incorrectly displays the throttle
    percentage when mode = 'Disabled (ZERO)'. This percentage should be hidden
    as in the case of mode = 'Disabled (WOT)'.

    Preview screen display corrected to suppress the '%' field so both disabled
    modes have similar displays.

    This is a user interface change with no configuration consequences.
    Configuration data layout is unchanged; no existing CA configurations or
    settings files are affected.


(17) 3518 - (new) Add "watt-hours" as a custom display field option

    A 'Wh' custom display field is not available for users wishing to see an
    energy-based display (e.g. W, Wh, wh/mi, Wh/mi!).

    A new 'Wh' option has been added to the Pref->CustViews parameter screen.
    This value is the same value shown on the 'Energy Mileage' screen and shows
    only the Whrs the battery supplied without compensation for any regen
    contribution. The field shifts to 'kWh' over 9999Wh.

    This revision affects EEPROM configuration.  Existing CA configurations,
    setup files, and prior firmware are incompatible.

    >> A fresh configuration must be instated after flashing the new firmware.


(18) 3502 - (new) Change Setup PAS Config Preview to show HW/W for Trq mode

    The PAS Config preview screen shows the assist start watts which is not as
    meaningful as the W/HW assist gain.

    The PAS Config Preview screen has been revised to show PAS->AsstFctr in
    units of W/HW.

    This is a user interface change with no configuration consequences.
    Configuration data layout is unchanged; no existing CA configurations or
    settings files are affected.


(19) 3594 - PAS bar graph is inoperative in 'PAS noTRQ' mode

    When PAS->SensrType=PASnoTRQ the main screen Human bar graph does not show
    the scaled 0-120rpm rider cadence when PAS->PASMode is set to a non-torque
    setting.

    This issue arose when the PAS menus were revised in the recent beta release.
    The bar graph display has been corrected to properly display the rpm-scaled
    graph in PASnoTRQ mode and to suppress the bar graph animation/display if
    there is no PAS device installed.

    This is a user interface change with no configuration consequences.
    Configuration data layout is unchanged; no existing CA configurations or
    settings files are affected.


(20) 3554 - In AutoPAS mode the Aux Change PAS Assist Pop-up should show Watts

    The recently revised Aux Change pop-up shows the scaled PAS Assist as the
    Aux scaling percentage. This is not as useful as display of the resulting
    Aux-scaled Start Watts.

    The display has been restored to the earlier form showing scaled Start
    Watts.

    This is a user interface change with no configuration consequences.
    Configuration data layout is unchanged; no existing CA configurations or
    settings files are affected.


(21) 3636 - Change PAS Sensor chooser option from 'PAS noTRQ' to 'Basic PAS'

    The PAS noTRQ description may not be clear to non-technical users and
    does not reflect nomenclature in use by Grin Support personnel.

    The menu item has been renamed to "Basic PAS".

    This is a user interface change with no configuration consequences.
    Configuration data layout is unchanged; no existing CA configurations or
    settings files are affected.


(22) 2566 - PAS output is generated in AutoPAS mode even if PAS is Disabled

    Some default behavior predating the PAS menu organization allows PAS power
    to be developed in AutoPAS mode even though the PAS Device is set to
    'Disabled' (uninstalled),  An 'installed' condition should be required for
    any PAS operation.

    All logic including PAS power generation is now conditioned on configuration
    of an installed PAS device.

    This is an internal processing change with no configuration consequences.
    Configuration data layout is unchanged; no existing CA configurations or
    settings files are affected.


(23) 2020 - Difficult to differentiate initial change to temp alert icon

    Exceeding the temp threshold slowly fills the 'thermometer' icon pixel by
    pixel as temperature increases.  The first increase (2nd icon level) shows a
    single blinking pixel in the bulb which can be difficult to discern.
    
    The second icon has been revised to show two blinking pixels.

    This is a display change with no configuration consequences.  Configuration
    data layout is unchanged; no existing CA configurations or settings files
    are affected.


(24) 1732 - (new) Provide a configurable minimum time for eBrake power removal

    Middrives typically require that power is briefly removed while shifting.
    As with normal controller operation, the CA removes power when ebrakes are
    applied making the ebrake mechanism a convenient means to briefly remove
    power.
    
    CA ebrake operation has been enhanced to remove power for a preset minimum
    period even if ebrakes are released sooner. This minimum 'no power' period
    allows shifting by tapping the brakes or using a gear shift sensor.  Power
    is restored immediately if brakes are released after they have been applied
    longer than the preset period. The period begins with ebrake application and
    so will run from the last tap of a sequence of short taps.
    
    The ebrake period is configurable 0.0 to 2.0 seconds to allow deactivating
    the feature (0.0) or tuning operation for a particular drive installation.
    
    This revision affects EEPROM configuration.  Existing CA configurations,
    setup files, and prior firmware are incompatible.

    >> A fresh configuration must be instated after flashing the new firmware.


_______________________________________________________________________________
Release: 3.1b11                                                      2016-11-25


Note: V3.1b11 Setup files are **incompatible** with firmware or Setup files
      of ALL releases prior to 3.1b10.

      ------------------------------------------------------------------------
      IMPORTANT:                               __________________
      Please install this package according to README_install.txt.
      Failure to do so may result in improper operation of the Setup Utility.
      ------------------------------------------------------------------------
      
      ------------------------------------------------------------------------
      IMPORTANT:
      After installing this zip package on a PC, the Setup utility will no
      longer be able to properly utilize 3.1 Setup files prepared for prior
      versions prior to 3.1b10.  3.1 settings files prior to 3.1b10 will not
      display or edit properly and will download to the CA incorrectly resulting
      in improper CA operation. Similarly, setup files prepared with this
      release cannot be used with CA firmware versions prior to 3.1b10. 3.0
      Setup files are unaffected.
      ------------------------------------------------------------------------

      >> Any incompatible existing CA setup must be recorded and manually
         reconfigured over a fresh 'CA3-1b11_firmware.hex' installation.

      >> All existing CA Setups prior to 3.1b10 must either be:
	    1. exported manually from the CA console (at least the statistics)
	    2. OR read by the Setup Utility and preserved in screen snapshots
	       PRIOR to installing this package. Saving to a prior 3.1 Setup
	       file and reading the file after installing the zip package will
	       not work.

      ------------------------------------------------------------------------
      IMPORTANT:
      Because a CA3-1b11_firmware.hex flash will load default settings, throttle
      voltage configuration may be incorrect. Treat this as an initial CA
      installation and place the bike on a stand or otherwise elevate the drive
      wheel to prevent a runaway when the flash completes and before a proper
      configuration can be restored.
      ------------------------------------------------------------------------


(1) 2566 - PAS->Config Category improperly hides parameters in Console Setup

    Because of improper preset handling, the new PAS CONFIG category improperly
    hides two parameters in CA Console Setup: "Assist Start Power" and "Assist
    Power Factor". Although these feature work properly and can be configured
    from the Setup utility, they may not be able to be configured from the CA
    Console.
    
    Preset indexing has been repaired to properly give access to these
    parameters.

    This revision affects only operation of the Console Setup display logic. All
    existing CA configurations and settings files are unaffected.


_______________________________________________________________________________
Release: 3.1b10                                                      2016-10-12


Note: V3.1b10 Setup files are **incompatible** with firmware or Setup files
      of **ALL** prior releases including any earlier 3.1 version.

      ------------------------------------------------------------------------
      IMPORTANT:                               __________________
      Please install this package according to README_install.txt.
      Failure to do so may result in improper operation of the Setup Utility.
      ------------------------------------------------------------------------
      
      ------------------------------------------------------------------------
      IMPORTANT:
      After installing this zip package on a PC, the Setup utility will no
      longer be able to properly utilize 3.1 Setup files prepared for prior
      3.1 versions.  3.1 settings files prior to 3.1b10 will not display or edit
      properly and will download to the CA incorrectly resulting in improper
      CA operation. Similarly, setup files prepared with this release cannot be
      used with earlier CA 3.1 firmware versions. 3.0 Setup files are unaffected.
      ------------------------------------------------------------------------

      >> Any incompatible existing CA setup must be recorded and manually
         reconfigured over a fresh 'CA3-1b10_firmware.hex' installation.

      >> All existing CA Setups must either be:
	    1. exported manually from the CA console (at least the statistics)
	    2. OR read by the Setup Utility and preserved in screen snapshots
	       PRIOR to installing this package. Saving to a 3.1 Setup file and
	       reading the file after installing the zip package will not work.

      ------------------------------------------------------------------------
      IMPORTANT:
      Because a CA3-1b10_firmware.hex flash will load default settings, throttle
      voltage configuration may be incorrect. Treat this as an initial CA
      installation and place the bike on a stand or otherwise elevate the drive
      wheel to prevent a runaway when the flash completes and before a proper
      configuration can be restored.
      ------------------------------------------------------------------------


(1) 2566 - Reorganize PAS/TRQ categories to separte hardware and config features

    The classic PAS and TRQ categories have parameter overlap that can require
    modification to both groups to initially configure basic operation for certain
    devices. Subsequent PAS tuning also requires using parameters in both the
    PAS and Torque groups.

    Menu parameters have been reorganized to replace the PAS/TRQ grouping in
    favor of a group addressing basic hardware device features and a second
    group used only for tuning the assist. Simple PAS as well as Torque related
    parameters appear in each group as appropriate. This also allows using the
    OEM menu mask to hide the device configuration and leave only the tuning
    configuration parameters exposed.

    Device Menu:    -Device Sensor Type (pulldown menu)
			Disabled
			PAS noTrq ...... (simple cadence wheel)
			Custom Trq ..... (custom torque sensor device)
			Thun BB ........ (predefined device)
			TDCM BB ........ (predefined device)
			NCTE BB ........ (predefined device)
			Cycle Stoker ... (predefined device)

		    -PAS Poles
		    -PAS Signal Type (pulldown Menu)
			1-wire
			2-wire
		    -PAS Direction Polarity  (pulldown Menu)
			5V = FWD
			5V = REV
		    -Torque Scale
		    -Zero Torque Offset
		    -Torque Assist Averaging

    Config Menu:    -PAS Assist Mode (pulldown Menu)
			PAS Off
			Auto PAS
			Throt PAS
			Torq PAS
		    -Start RPM Threshold
		    -Stop RPM Threshold
		    -Assist Start Power
			(units = W  in Auto PAS mode)
			(units = HW in Torq PAS mode)
		    -Assist Power Factor
			(units = W/rpm in Auto PAS mode)
			(units = HW    in Torq PAS mode)
		    -Max Throttle-Only Speed
    
    As before, parameters are hidden if not relevant based on configuration of
    device or PAS/TRQ mode.
    _________
    IMPORTANT:
    Operation of the 'Device Sensor Type' menu has changed significantly.
    Previously, selecting a predefined type like 'Thun' hid other parameter
    items and caused operation from fixed values specific to the device. In the
    new scheme, selecting a 'canned' or 'predefined' device copies preset
    versions of *ALL* device parameters into place where they are available for
    user modification. If device parameters remain unmodified, the device type
    remains as the predefined type. However, editing any device parameter
    changes the device type to 'custom'.
    _________
    IMPORTANT:
    The Software Setup Utility is not capable of this more complicated parameter
    preset behavior so selection of a predefined type there does not affect
    displayed device parameters and changing them does not automatically switch
    to a 'custom' device type.
    
    However, setting a canned device type in the Setup Utility will force the CA
    to establish *ALL* preset device parameter values when the settings are
    downloaded.  In such cases, all downloaded device parameters are ignored by
    the CA in favor of the preset versions. If a device parameter is modified in
    the CA, the resulting 'custom Trq' device type will be uploaded to the Setup
    utility so that a subsequent download will no longer be a predefined type
    and all downloaded device parameters will be used by the CA. This allows the
    CA and Setup Utility to operate consistently as before but with the added
    ability to force preset device setups into place as needed.

    Several new predefined devices are now supported. Future devices will be
    added to the device menu with the same configuration behavior.

    This revision affects EEPROM configuration, existing Setup files, and the
    Setup Utility.

    >> A fresh configuration must be instated after flashing the new firmware
      (use 'CA3-1b10_firmware.hex').


(2) 1716 - Add RPM-proportional AutoPAS Support

    AutoPAS mode previous supported a fixed Power Assist level when pedaling was
    detected.  However, in some riding conditions, it can be useful to get
    increased power with increased cadence from either direct rider effort to
    achieve higher speed or from downshifting for inclines.
    
    AutoPAS has been revised to provide configuration of a power factor in
    'W/rpm' that is applied to crank rpm over 55rpm. For instance: at 75 rpm and
    4W/rpm then (75rpm-55rpm)*4W/rpm = 80W extra is applied to the configured
    Start Power.
    
    Setting this Power Factor to zero disables the feature and restores earlier
    V3.0 AutoPAS operation.  The Power Factor may be negative so that power
    declines with rpm. This may be useful for fixie riders who need extra
    assistance on getaway, but desire reduced assistance when underway.

    The AutoPAS Start Power and Power Factor are configured in the new 'PAS
    Config' category using the same parameters employed for Torque mode
    operation.
    
    This revision affects EEPROM configuration, existing Setup files, and the
    Setup Utility.

    >> A fresh configuration must be instated after flashing the new firmware
      (use 'CA3-1b10_firmware.hex').


______________________________________________________________________________
Release: 3.1b9                                                      2016-09-18


Note: V3.1b9 Setup files are **incompatible** with firmware or Setup files
      of **ALL** prior releases. However, CA configurations or setup files of
      version 3.1b8 are compatible with V3.1b9, but the AuxA and AuxD
      Function settings as well as Still and Moving Screen selections should be
      revisited in Setup to verify and/or correct any error deriving from added
      option choices.

      ------------------------------------------------------------------------
      IMPORTANT:                               __________________
      Please install this package according to README_install.txt.
      Failure to do so may result in improper operation of the Setup Utility.
      ------------------------------------------------------------------------
      
      ------------------------------------------------------------------------
      IMPORTANT:
      After installing this zip package on a PC, the Setup utility will no
      longer be able to properly utilize 3.1 Setup files prepared for prior
      3.1 versions.  3.1 settings files prior to 3.1b8 will not display or edit
      properly and will download to the CA incorrectly resulting in improper
      CA operation. Similarly, setup files prepared with this release cannot be
      used with earlier CA 3.1 firmware versions. 3.0 Setup files are unaffected.
      ------------------------------------------------------------------------

      >> Any incompatible existing CA setup must be recorded and manually
         reconfigured over a fresh 'CA3-1b9_firmware.hex' installation.

      >> All existing CA Setups prior to 3.1b8 must either be:
	    1. exported manually from the CA console (at least the statistics)
	    2. OR read by the Setup Utility and preserved in screen snapshots
	       PRIOR to installing this package. Saving to a 3.1 Setup file and
	       reading the file after installing the zip package will not work.

      ------------------------------------------------------------------------
      IMPORTANT:
      Because a CA3-1b9_firmware.hex flash will load default settings, throttle
      voltage configuration may be incorrect. Treat this as an initial CA
      installation and place the bike on a stand or otherwise elevate the drive
      wheel to prevent a runaway when the flash completes and before a proper
      configuration can be restored.
      ------------------------------------------------------------------------


(1) 1730 - PAS->MxThrotSpd uses a hard power cutoff, use Speed Limiting instead

    The PAS->MxThrotSpd parameter is mostly of interest for EU or similar
    pedelec requirements. When using the throttle and not pedaling, the former
    PAS->MxThrotSpd implementation instantly reduces Throttle OUT to ThrOMin
    when the specified speed is exceeded. This results in an abrupt power loss.
    
    PAS operation has been revised in that scenario to replace the hard cutoff
    with Speed PID operation to instead limit the max speed to PAS->MxThrotSpd.
    This results in conventional CA speed limiting behavior that can be tuned to
    hold the max speed limit smoothly.

    This revision affects only operation of the PAS control logic. All existing
    CA configurations and settings files are unaffected.


(2) 2432 - (new) Add 'ThrOut Lim' to AuxPot Functions

    Direct scaling of ThrOut voltage can effectively give an adjustable speed
    limit without the difficulty of tuning the speed PID. Also useful for simple
    pushbutton throttles for low powered or PAS systems (walk the bike, etc)

    A new 'ThrO Lim' option has been added to AuxA and AuxD Function menus. Aux
    pop-ups and custom field displays are updated with new mode. An updated
    V310.cas file is supplied.
    
    This revision affects only the AuxA/AuxD Function settings. Existing CA
    configurations and settings files are generally compatible, but the AuxA and
    AuxD Function settings should be revisited to verify and/or correct any
    error deriving from the added option choice.


(3) 2470 - (new) Add RBatt to the Custom Views options

    A new 'RBatt' option has been added to the Main Screen Custom Views option.
    
    This revision affects only the Prefs->CustView option by adding a new bit
    definition. Existing CA configurations and settings files are compatible,
    but new settings files created with this release are incompatible with
    earlier firmware because of the added option.


(4) 2560 - Stated Display Averaging time is one half actual period

    The Stated display averaging times are based on binary powers of main loop
    cycles and the options are displayed as {.02, .04, .08, ...} seconds. The
    actual display averaging logic results in twice the indicated periods.
    
    The displayed menu options have revise to show the actual times of
    {.04, .08, .16, ...}  which are double the former values.

    This revision affects only Setup menu displays. All existing CA
    configurations and settings files are unaffected. Previously configured
    averaging periods are unchanged but will now appear with the proper value.


(5) 2430 - (new) Add Temperature Statistics Status Screen

    Temperature could formerly be viewed only as an alternating field of the
    Main Screen custom views field.

    A new 'Temperature Stats' screen has been added after the Speed Stats screen
    to display the current, maximum, and average temperatures in degrees
    Celcius. The elapsed time in minutes the temperature is limiting (between
    Temp->ThrshTemp and Temp->MaxTemp) is also displayed. The average
    temperature is accumulated only while the bike is moving. When temp limiting
    is in effect, the same thermometer glyph used on the Main Screen is
    displayed on the Temp Stats screen.
    
    NOTE: Unlike other statistics, the max and average values are not saved to
    EEPROM but are instead reset on power-up.  These values can be determined
    for various legs of a ride by cycling power to re-initialize the values.

    This revision affects EEPROM configuration, existing Setup files, and
    display of the menu mask bits by the Setup Utility.
    >> A fresh configuration must be instated after flashing the new firmware.


(6) 2610 - (new) Add per-screen statistics reset capability

    Formerly, 'Peak' statistics could be reset from the 'Amin,Amax,Vmin' screen.
    This allowed reset of a select set of accumulating trip statistics. The Trip
    and Peak Reset functions operated immediately on long right button button
    pushes.
    
    The former 'Peak Reset' functionality has been replaced with per-screen
    reset capabilities to reset accumulating trip parameters on the displayed
    screen.  Many trip parameters accumulate raw data but some are calculated
    from other values that cannot reasonably be cleared without compromising CA
    operation. The former can be reset, the latter cannot.

    Status Screens that can reset displayed statistics:
	Human Stats, V-A Max/Mins, Speed Stats, and Temperature Stats

    The 'Trip Reset' and 'Reset Stats' pop-up screens have been revised to
    require a verifying left/Right Yes/No button push to affect or skip the
    reset operation. This avoids accidental data loss due to a button
    'mis-push'.

    These revisions affect only reset operations invoked from the Status
    screens.  All existing CA configurations and settings files are unaffected.


______________________________________________________________________________
Release: 3.1b8                                                      2016-08-28


Note: V3.1b8 Setup files are **incompatible** with firmware or Setup files
      of **ALL** prior releases.

      ------------------------------------------------------------------------
      IMPORTANT:                               __________________
      Please install this package according to README_install.txt.
      Failure to do so may result in improper operation of the Setup Utility.
      ------------------------------------------------------------------------
      
      ------------------------------------------------------------------------
      IMPORTANT:
      After installing this zip package on a PC, the Setup utility will no
      longer be able to properly utilize 3.1 Setup files prepared for prior
      3.1 versions.  3.1 settings files prior to 3.1b8 will not display or edit
      properly and will download to the CA incorrectly resulting in improper
      CA operation. Similarly, setup files prepared with this release cannot be
      used with earlier CA 3.1 firmware versions. 3.0 Setup files are unaffected.
      ------------------------------------------------------------------------

      >> Any incompatible existing CA setup must be recorded and manually
         reconfigured over a fresh 'CA3-1b8_firmware.hex' installation.

      >> All existing CA Setups prior to 3.1b8 must either be:
	    1. exported manually from the CA console (at least the statistics)
	    2. OR read by the Setup Utility and preserved in screen snapshots
	       PRIOR to installing this package. Saving to a 3.1 Setup file and
	       reading the file after installing the zip package will not work.

      ------------------------------------------------------------------------
      IMPORTANT:
      Because a CA3-1b8_firmware.hex flash will load default settings, throttle
      voltage configuration may be incorrect. Treat this as an initial CA
      installation and place the bike on a stand or otherwise elevate the drive
      wheel to prevent a runaway when the flash completes and before a proper
      configuration can be restored.
      ------------------------------------------------------------------------


(1) 2524 - PAS Limiting operates improperly in 3.1b7

    The 3.1b7 release shows incorrect display pop-ups and an unsupported 'ThrO'
    limiting option in the Setup Utility. Other issues may be present. The
    difficulties arise from an improper build procedure that inadvertently
    introduced unwanted development code into the build.

    The erroneous code elements have been removed to restore the correct code
    base. The 3.1b7 release has been withdrawn.

    This revision affects EEPROM configuration, existing Setup files, and the
    Setup Utility.

    >> A fresh configuration must be instated after flashing the new firmware
      (use 'CA3-1b8_firmware.hex').


______________________________________________________________________________
Release: 3.1b7                                                      2016-08-25


Note: V3.1b7 Setup files are **incompatible** with firmware or Setup files
      of **ALL** prior releases.

      ------------------------------------------------------------------------
      IMPORTANT:                               __________________
      Please install this package according to README_install.txt.
      Failure to do so may result in improper operation of the Setup Utility.
      ------------------------------------------------------------------------
      
      ------------------------------------------------------------------------
      IMPORTANT:
      After installing this zip package on a PC, the Setup utility will no
      longer be able to properly utilize 3.1 Setup files prepared for prior
      3.1 versions.  3.1 settings files prior to 3.1b7 will not display or edit
      properly and will download to the CA incorrectly resulting in improper
      CA operation. Similarly, setup files prepared with this release cannot be
      used with earlier CA 3.1 firmware versions. 3.0 Setup files are unaffected.
      ------------------------------------------------------------------------

      >> Any incompatible existing CA setup must be recorded and manually
         reconfigured over a fresh 'CA3-1b7_firmware.hex' installation.

      >> All existing CA Setups prior to 3.1b7 must either be:
	    1. exported manually from the CA console (at least the statistics)
	    2. OR read by the Setup Utility and preserved in screen snapshots
	       PRIOR to installing this package. Saving to a 3.1 Setup file and
	       reading the file after installing the zip package will not work.

      ------------------------------------------------------------------------
      IMPORTANT:
      Because a CA3-1b7_firmware.hex flash will load default settings, throttle
      voltage configuration may be incorrect. Treat this as an initial CA
      installation and place the bike on a stand or otherwise elevate the drive
      wheel to prevent a runaway when the flash completes and before a proper
      configuration can be restored.
      ------------------------------------------------------------------------


(1) 2434 - (new) Add PasRate parameter to supersede UpRate in PAS mode

    Setting ThrO->UpRate has been a compromise of throttle responsiveness and
    gentle or natural PAS engagement for combined throttle/PAS systems
    because of the global effect on rate of throttle increase. 
    
    A new Setup parameter 'ThrO->PASRate' now exclusively limits the rate of
    throttle increase in AutoPAS and TorqPAS modes and the existing ThrO->UpRate
    limits the rate in all other situations: Throttle, Autocruise, and ThrotPAS.

    This revision affects EEPROM configuration, existing Setup files, and the
    Setup Utility.

    >> A fresh configuration must be instated after flashing the new firmware
      (use 'CA3-1b7_firmware.hex').


(2) 2458 - Diagnostic Screen Rate Flag display is unclear/unintuitive

    The transient throttle rate flags are displayed on the Diagnostic Screen in
    the space between 'Out' and its numerical value.  These custom graphic
    characters are non-intuitive and may appear to users as fleeting garbage
    characters indicating a program problem. The problem is compounded with the
    addition of the new 'PASRate' (see: 2434).

    The graphic Up, Down, Fast, and PAS rate flags have been replaced with small
    3x5 superscript U, D, F, and P characters respectively.

    This revision affects only the CA Diagnostic Status display. All existing CA
    configurations and settings files are unaffected.


(3) 2498 - Spurious AuxA pop-up screens appear randomly

    In certain installations the AuxA pop-up may appear randomly without
    operator control adjustment due to transient electrical noise. This behavior
    resulted from a reduction of the 'setting change' threshold for the AuxA
    pop-up display to improve visibility of small pot adjustments (b5 release).

    The original threshold has been restored.

    This revision affects only the AuxA pop-up display. All existing CA
    configurations and settings files are unaffected.


(4) 2500 - Human Watts Display is incorrect

    The Human Watts displays on the Human Stats screen and Main Screen Custom
    Field are incorrect. The internal computed Assist Watts value is correct so
    PAS operation is unaffected. This error was introduced in 3.1b1.

    Calculation of the Human watts display value has been corrected.

    This revision affects only Human Watts display. All existing CA
    configurations and settings files are unaffected.


(5) 2512 - cas file ThrO->OutptMode does not properly set Min/Max units

    Selecting Voltage or RC Pulse output mode does not display proper min/max
    units in the Setup Utility.

    The V310.cas file has been updated to correct the Setup Utility units
    display behavior. This file replaces the existing version during package
    installation.

    This revision affects only Setup Utility display. All existing CA
    configurations and settings files are unaffected.


______________________________________________________________________________
Release: 3.1b6                                                      2016-07-17


Note: V3.1b6 Setup files are **incompatible** with firmware or Setup files
      of any release prior to 3.1b3 including all earlier 3.1 versions.

      ------------------------------------------------------------------------
      IMPORTANT:                               __________________
      Please install this package according to README_install.txt.
      Failure to do so may result in improper operation of the Setup Utility.
      ------------------------------------------------------------------------
      
      ------------------------------------------------------------------------
      IMPORTANT:
      After installing this zip package on a PC, the Setup utility will no
      longer be able to properly utilize 3.1 Setup files prepared for versions
      prior to 3.1b3.  3.1 settings files prior to 3.1b3 will not display or edit
      properly and will download to the CA incorrectly resulting in improper
      CA operation. Similarly, setup files prepared with this release cannot be
      used with earlier CA 3.1 firmware versions. 3.0 Setup files are unaffected.
      ------------------------------------------------------------------------

      >> Any incompatible existing CA setup must be recorded and manually
         reconfigured over a fresh 'CA3-1b6_firmware.hex' installation.

      >> All existing CA Setups prior to 3.1b3 must either be:
	    1. exported manually from the CA console (at least the statistics)
	    2. OR read by the Setup Utility and preserved in screen snapshots
	       PRIOR to installing this package. Saving to a 3.1 Setup file and
	       reading the file after installing the zip package will not work.

      >> Existing 3.1b5 setups are compatible with this release, allowing
         re-flash of 3.1b6 firmware using the 'xxx_NoEeprom.hex' version to
	 preserve an existing configuration. See the 3.1b4 Release notes below
	 regarding 3.1b3 compatibility if you are jumping from 3.1b3 to 3.1b6.
      
      ------------------------------------------------------------------------
      IMPORTANT:
      Because a CA3-1b6_firmware.hex flash will load default settings, throttle
      voltage configuration may be incorrect. Treat this as an initial CA
      installation and place the bike on a stand or otherwise elevate the drive
      wheel to prevent a runaway when the flash completes and before a proper
      configuration can be restored.
      ------------------------------------------------------------------------


(1) 2442 - AuxA is not functional unless AuxD is enabled (not OFF)

    The Analog Aux feature is non-functional when configured solely for Analog
    Aux operation (e.g. AuxD->Function = OFF). Operation is correct when Digial
    Aux is enbled (not 'OFF').

    This issue is a side effect of internal code changes in 3.1b5 to minimize
    EEPROM updates due to AuxD level changes. Those modifications have been
    corrected.

    This revision affects only CA Analog Aux processing. All existing CA
    configurations and settings files are unaffected.


______________________________________________________________________________
Release: 3.1b5                                                      2016-07-15


Note: V3.1b5 Setup files are **incompatible** with firmware or Setup files
      of any release prior to 3.1b3 including all earlier 3.1 versions.

      ------------------------------------------------------------------------
      IMPORTANT:                               __________________
      Please install this package according to README_install.txt.
      Failure to do so may result in improper operation of the Setup Utility.
      ------------------------------------------------------------------------
      
      ------------------------------------------------------------------------
      IMPORTANT:
      After installing this zip package on a PC, the Setup utility will no
      longer be able to properly utilize 3.1 Setup files prepared for versions
      prior to 3.1b3.  3.1 settings files prior to 3.1b3 will not display or edit
      properly and will download to the CA incorrectly resulting in improper
      CA operation. Similarly, setup files prepared with this release cannot be
      used with earlier CA 3.1 firmware versions. 3.0 Setup files are unaffected.
      ------------------------------------------------------------------------

      >> Any incompatible existing CA setup must be recorded and manually
         reconfigured over a fresh 'CA3-1b5_firmware.hex' installation.

      >> All existing CA Setups prior to 3.1b3 must either be:
	    1. exported manually from the CA console (at least the statistics)
	    2. OR read by the Setup Utility and preserved in screen snapshots
	       PRIOR to installing this package. Saving to a 3.1 Setup file and
	       reading the file after installing the zip package will not work.

      >> Existing 3.1b4 setups are compatible with this release, allowing
         re-flash of 3.1b5 firmware using the 'xxx_NoEeprom.hex' version to
	 preserve an existing configuration. See the 3.1b4 Release notes below
	 regarding 3.1b3 compatibility if you are jumping from 3.1b3 to 3.1b5.
      
      ------------------------------------------------------------------------
      IMPORTANT:
      Because the firmware flash will load default settings, throttle voltage
      configuration may be incorrect. Treat this as an initial CA installation
      and place the bike on a stand or otherwise elevate the drive wheel to
      prevent a runaway when the flash completes and before a proper
      configuration can be restored.
      ------------------------------------------------------------------------


(1) 1730 - The UP BTN threshold voltage is incorrectly set to 0.35V

    The UP BTN threshold voltage was erroneously set to 0.35V for the 3.1b4
    release. This has been corrected to the proper 0.30V thrreshold.

    This revision affects only CA Digital Aux processing. All existing CA
    configurations and settings files are unaffected.


(2) 2394 - Watchdog timer fault may occur on power-up

    New features have increased processing time during CA initialization prior
    to normal operation. This additional delay could cause a watchdog timer
    fault on powerup as the increased initialization delay was interpreted as a
    processor hang.

    The watchdog feature has been revised to monitor only main CA processing
    exclusive of the initialization period, eliminating the one-time inaccuracy
    on powerup.

    This revision affects only CA internal fault detection. All existing CA
    configurations and settings files are unaffected.


(3) 1730 - DigiAux 'Current level' Setup parameter is not useful

    AuxD->CurLevel provides access to the current level but the value is itself
    transient and altered whenever the controls are manipulated.
    
    Access and display of this parameter in console Setup and the Software Setup
    utility has been removed. The actual parameter remains in EEPROM but is not
    exposed to configuration.

    New Software Setup Utility V310.cas and V310.hex files are installed to
    accommodate this change.

    This revision affects only the CA configuration user interface. All existing
    CA configurations and settings files are unaffected.


(4) 1730 - (new) Add Setup parm for initial AuxD level on power up

    New setup parameter AuxD->PowerOn now allows the initial level on power up
    to be set to either 'Last Level' or 'Level #1'. This mimics the behavior of
    PrSt->PowerOn. This feature can allow PAS to always begin at Level #1 or an
    Amps Limit to always start at the power down value.

    New Software Setup Utility V310.cas and V310.hex files are installed to
    accommodate this change.

    This feature affects operation of the CA console Setup, Software Setup
    utility, and CA power up initialization. It utilizes previously unallocated
    EEPROM so all existing CA configurations and settings files are unaffected.


(5) 1730 - DigiAux button response is sluggish

    Rapid digital aux button pushes in excess of approximately 7 per second
    often yield 'missed' pushes.  A value of approximately 10 per sec is
    desirable. The 'long press' (1100ms) to advance to min or max levels also
    seems unduly long compared to the target min period of around 100ms.

    The Analog/digital discrimination logic has been adjusted to detect button
    bushes up to 9+ per second. The long press discrimination time has been
    reduced to 900ms. Together these changes give a more responsive feel to
    the controls.

    This revision affects only the CA DigiAux button interface. All existing
    CA configurations and settings files are unaffected.


(6) 2390 - Instantaneous Wh/mi Custom View displays '---' for regen 

    The Wh/mi! calculation erroneously suppresses negative values deriving from
    regen and shows '---'.
    
    The field now displays '---' only when speed goes to zero and otherwise
    displays proper (+) or (-) values for normal or regen operation
    respectively.
    
    This change only affects the console display; all existing 3.1b3/b4 CA
    configurations and settings files are unaffected.


(7) 2414 - Digital Aux has power burst when start pedaling w/TorqPAS Assist=0

    If Digital Aux is set to 'PAS Assist' with ASSIST=0 and if pedaling begins
    after throttle is removed, then there is a single burst of assist power
    which diminishes to zero. The power surge does not reoccur until the
    sequence is repeated beginning with throttle application.

    An error was introduced in the PAS code in 3.1b4 that could prevent proper
    detection of the ASSIST=0 condition allowing the PAS logic to incorrectly
    initiate assist. Subsequent calculations do not maintain the inital
    erroneous power level. The code has been revised to restore proper handling
    of ASSIST=0.
    
    This change only affects operation of the PAS feature; all existing 3.1b3/b4
    CA configurations and settings files are unaffected.


(8) 2440 - PAS has brief power dropouts as AuxD buttons are pushed

    PAS operation experiences a brief power dropout when an AuxD UP or DOWN
    button is pressed. The dropout is transient and independent of the length of
    the button press. The effect is present even if PAS Limiting is not
    configured for either analog or digital channels - it is a global effect.

    Processing associated with EEPROM update with new AuxD levels arising from
    the UP/DOWN operations (level increment/decrement) were disrupting PAS
    operation. AuxD 'current level' EEPROM update has been restructured which
    eliminates the PAS side effect.
    
    This change only affects operation of the PAS feature; all existing 3.1b3/b4
    CA configurations and settings files are unaffected.


______________________________________________________________________________
Release: 3.1b4                                                      2016-06-25


Note: V3.1b4 Setup files are **incompatible** with firmware or Setup files
      of any release prior to 3.1b3 including all earlier 3.1 versions.

      ------------------------------------------------------------------------
      IMPORTANT:                               __________________
      Please install this package according to README_install.txt.
      Failure to do so may result in improper operation of the Setup Utility.
      ------------------------------------------------------------------------
      
      ------------------------------------------------------------------------
      IMPORTANT:
      After installing this zip package on a PC, the Setup utility will no
      longer be able to properly utilize Setup files prepared for versions
      prior to 3.1b3.  Settings in files prior to 3.1b3 will not display or edit
      properly and will download to the CA incorrectly resulting in improper
      CA operation. Similarly, setup files prepared with this release cannot be
      used with earlier CA 3.1 firmware versions. 3.0 Setup files are unaffected.
      ------------------------------------------------------------------------

      >> Any incompatible existing CA setup must be recorded and manually
         reconfigured over a fresh 'CA3-1b4_firmware.hex' installation.

      >> All existing CA Setups prior to 3.1b3 must either be:
	    1. exported manually from the CA console (at least the statistics)
	    2. OR read by the Setup Utility and preserved in screen snapshots
	       PRIOR to installing this package. Saving to a 3.1 Setup file and
	       reading the file after installing the zip package will not work.

      >> Existing 3.1b3 setups are compatible with this release, allowing
         re-flash of 3.1b4 firmware using the 'xxx_NoEeprom.hex' version to
	 preserve an existing configuration. However, there is a small
	 difference in the Pref->CustViews bit mapping. That particular
	 parameter should be opened in either Console or Software Setup and
	 the custom field selection corrected if necessary.
      
      ------------------------------------------------------------------------
      IMPORTANT:
      Because the firmware flash will load default settings, throttle voltage
      configuration may be incorrect. Treat this as an initial CA installation
      and place the bike on a stand or otherwise elevate the drive wheel to
      prevent a runaway when the flash completes and before a proper
      configuration can be restored.
      ------------------------------------------------------------------------


(1) 1730 - (new) Add AuxPot support of pushbutton limit and preset selection

    The classic CA AuxPot input accepts analog voltages in the range 0-5V which
    may be configured to either select presets or scale limits for Current,
    Power, Speed, or PAS Assist. These analog voltages can be supplied by any
    voltage source such as a potentiometer or switch with an appropriate
    resistor divider.

    This new 'digital' Aux Input mode can operate either as an alternative to,
    or in conjunction with, the previous 'analog' mode. This gives three
    hardware configuration options:
    
	1. Analog Only:
	    any of the existing analog pot/switch options
	2. Digital Only:
	    the new digital 1 or 2 pushbutton options
	3. Analog + Digital:
	    both analog and digital controls to operate two entirely different
	    AuxPot control functions
	    (e.g. Digital = 'Amps Limiting' and Analog = 'PAS Assist')

    In '2-BTN' mode this feature supports operation with two momentary
    pushbuttons or an (ON)-OFF-(ON) SPDT switch using the familiar digital
    UP|DOWN control concept to select fixed 'levels' or 'steps'. In '1 BTN'
    mode the level selection is always increasing and simply wraps around to
    the lowest setting if pressed in the highest setting. This allows
    re-purposing of commonly available horn and regen buttons.

    New V310.cas and V310.hex files are installed with this package to upgrade
    the Setup Utility to display two Aux categories instead of the original one.
    The new 'AuxD' category has these options:

	1. AuxD Input Function:
	    Same limit & preset options as the Analog category
	2. Control Type:
	    Select either 1 button (UP w/wrap) or 2 button (UP|DOWN) modes
	3. Number of Levels:
	    Selects the maximum number of levels (1-32)
	4. Present Level:
	    Selects the level presently in effect. This is normally adjusted
	    with the external button control.
	5. Low Percentage Limit:
	    Selects the 0-100% scaling in effect at the lowest step. The
	    remaining percentage range is evenly divided into steps up to 100%.

    A typical setup might be: AmpLim, 2BTN, 3Levels, - , 50%. This would give
    familiar 3-position current limiting with percentages of 50%, 75%, 100%.

    If the input function is set to 'Presets', then parameters 3, 4, & 5 above
    are not available and settings are taken from the Presets category.

    Documentation detailing wiring specifics is available for separate download.
    See the Endless Sphere CA V3 Unofficial User Guide download page:
	https://endless-sphere.com/forums/viewtopic.php?p=571345#p571345


(2) 1730 - (new) Serial log 'AuxA' and 'AuxD' columns replace old 'Aux' column

    The previous 'Aux' voltage column has been replaced with two columns, 'AuxA'
    and 'AuxD' that show the 0-100% setting of the analog Min/Max voltage range
    or relative digital step level respectively. This allows consistent
    processing of scaled data regardless of analog or digital control.

    This change only affects the serial data stream; all existing 3.1b3/b4 CA
    configurations and settings files are unaffected.


(3) 1730 - (new) Custom 'AuxA' and 'AuxD' views replace old 'AuxLim' View

    The Pref->CustViews parameter has been revised to expand the previous single
    'AuxLim' view into two separately selectable views for analog and digital
    control. The existing 'AX' custom identifying character is now used for the
    'AuxA' view and a new 'DX' character identifies the 'AuxD' view.

    New V310.cas and V310.hex files are installed with this package to upgrade
    the Setup Utility to display two Aux categories instead of the original one.

    Earlier 3.1b3 confiurations are not 100% compatible but can be corrected by
    reconfiguring the Pref->CustViews parameter.


(4) 2390 - The Gear-inch Custom View should be suppressed when not pedaling

    The 'Gear Inch' calculation yeilds erroneous results when RPM=0 resulting in
    display of very large values.
    
    The field now displays '---' when not pedaling. Proper values appear shortly
    after pedaling resumes.
    
    This change only affects the console display; all existing 3.1b3/b4 CA
    configurations and settings files are unaffected.


(5) 2392 - Custom Fields have periodic display glitching

    The main screen Custom Views field shows a faint periodic glitch displaying
    Ah. This is not noticeable if Ah is one of the selected custom views.

    Display code revised to remove the glitch.

    This change only affects the console display; all existing 3.1b3/b4 CA
    configurations and settings files are unaffected.


______________________________________________________________________________
Release: 3.1b3                                                      2016-05-12


Note: V3.1b3 Setup files are **incompatible** with firmware or Setup files
      of any earlier releases including any earlier 3.1 version.

      ------------------------------------------------------------------------
      IMPORTANT:                               __________________
      Please install this package according to README_install.txt.
      Failure to do so may result in improper operation of the Setup Utility.
      ------------------------------------------------------------------------
      
      ------------------------------------------------------------------------
      IMPORTANT:
      After installing this zip package on a PC, the Setup utility will no
      longer be able to properly utilize Setup files prepared for previous 3.1
      beta versions. Settings in older files will not display or edit properly
      and will download to the CA incorrectly resulting in improper CA
      operation. Similarly, setup files prepared with this release cannot be
      used with earlier CA firmware versions.
      ------------------------------------------------------------------------

      >> Any incompatible existing CA setup must be recorded and manually
         reconfigured over a fresh 'CA3-1b3_firmware.hex' installation.

      >> In particular, all existing 3.1 beta CA Setups must either be:
	    1. exported manually from the CA console (at least the statistics)
	    2. OR read by the Setup Utility and preserved in screen snapshots
	       PRIOR to installing this package. Saving to a Setup file and
	       reading the file after installing the zip package will not work.
      
      ------------------------------------------------------------------------
      IMPORTANT:
      Because the firmware flash will load default settings, throttle voltage
      configuration may be incorrect. Treat this as an initial CA installation
      and place the bike on a stand or otherwise elevate the drive wheel to
      prevent a runaway when the flash completes and before a proper
      configuration can be restored.
      ------------------------------------------------------------------------


(1) 2228 - PassThru Throttle has initial 200ms delay

    When Throttle Input is intially increased above ZERO (ThrI->MinInput or
    less), the expected Throttle OUT voltage increase is delayed 180ms.  After
    this initial delay, Throttle OUT responds immediately without delay.  This
    small delay is typically noticable only on more powerful bikes.
    
    This behavior appeared as an unwanted side effect of adding throttle filter
    logic to minimize PAS dropouts due to small throttle excursions slightly
    above ZERO.
    
    (a) Throttle code has now been revised to eliminate the delay and restore
        immediate throttle response from ZERO.

    (b) PAS throttle noise filtering has been tuned to a narrower voltage range
        so that throttle application >25% in PAS mode does not incur the
        180msec delay.  This results in brisker initial power application in PAS
        mode for 'meaningful' throttle application to override PAS (e.g. to
	sprint across intersections).
    
    This revision alters CA processing and does not affect Setup files or the
    existing EEPROM configuration.


(2) 2252 - Menu mask bits affect the wrong setup parameters

    CA Setup incorrectly interprets menu mask bits set with the Software Setup
    Utility. This causes either masking of the wrong menu item or masking of
    several menu items by a single mask flag. CA Setup operates properly if all
    mask bits are set [default].

    CA interpretation of menu mask bits has been corrected.

    This revision affects only CA processing of EEPROM mask bits; other EEPROM
    parameters or statistics are unaffected.  Setup Utility operation is
    unaffected.  Pre-existing Setup files not using the masking feature are
    unaffected.


(3) 2260 - PAS->PASWatts operates globally instead of per-preset

    Although PAS->PASWatts may be configured for per-preset operation, operation
    is limited to use of only the value for preset 1 (global mode). This relates
    to issue 1718.

    Operation has been revised to properly use the confgigured PAS->PASWatts
    value in each preset

    This revision affects only CA processing. Existing EEPROM configuration,
    Setup files, or the Setup Utility are unaffected.


(4) 2264 - Menu mask items in Setup Utility are in reverse order

    Checkboxes in the Setup utility to disable access to individual submenu
    items (parameters) appear in the opposite order as the items are normally
    traversed in menus.

    Menu item ordering in the Setup utility has been reversed.

    This revision affects EEPROM configuration, existing Setup files, and
    display of the menu mask bits by the Setup Utility.
    >> A fresh configuration must be instated after flashing the new firmware.


(5) 2262 - (new) Lifetime statistics moved to new 'Statistics' category

    Total distance, total Ah, and Total Battery Cycles have been relocated to a
    new 'Statistics' category to make easier to locate and record ongoing
    vehicle status.

    This revision affects the manner in which CA Setup and Setup Utility operate
    on data. CA EEPROM and existing Setup files are unaffected.


(6) 2268 - (new) Maximum PAS Pole Count has been restored to 24

    The pole count in 3.00 was originally upgraded over beta releases from 24 to
    32 to accommodate new PAS sensors being evaluated. The increased pole count
    is no longer a requirement and was restored to 24 in release 3.01.
    
    The maximum configurable value for PAS->PASPoles 3.1 has been decreased from
    32 to the original 24 to duplicate the revision in release 3.01.

    This revision affects CA Setup and Setup utility maximum values for PAS
    Poles.  The reduction does not affect operation or configuration of
    previously supported sensors. 


(7) 2258 - Main Screen displays regen Watts w/o (-) sign if more than -999W

    If in LoRange and on Main Screen, then regen of more than -999W is displayed
    without the minus sign due to limited 4 character field width. There is no
    problem if in HighRange (units are kW).

    Main screen display code has been revised to display these high wattage
    regen cases using kW units. Increasing regen Watts now display as: '-999W'
    then '-1.0kW'.

    This revision affects only data display, Existing configuration, Setup
    Files, or the Software Setup Utility are unaffected.


(8) 2272 - Reducing Preset Count can leave Current Preset set to an unenabled preset

    If the number of presets is reduced to less than the current preset number,
    the current preset is left at the same, but now unenabled, preset.

    Operation has been revised in this situation to reset the current preset to
    the new preset count so that operation is the same as the Software Setup
    utility.

    This revision affects CA operation only. Existing Setup Files are
    unaffected.


(9) 1730 - (new) Simplify Aux Input Setup Menu

    The Aux Input Setup Menu has two separate parameters (Function and Limits)
    that together determine AUX POT operation.  Because 'Aux->Function' is now
    a global parameter, this arrangement is no longer necessary.
    
    The allowable modes of {OFF, Presets, AmpsLim, SpeedLim, PowerLim, PASLim}
    have been combined as options under the single 'Aux->Function' parameter and
    the 'Aux->Limits' parameter has been eliminated.

    These revisions affect EEPROM configuration, existing Setup files, and the
    Setup Utility.
    >> A fresh configuration must be instated after flashing the new firmware.


(10) 2274 - (new) Enhance the Preset and Preferences setup preview screens and menus

    The Preset and Preferences preview screens have been revised to display
    information more useful in normal setup operation or if all submenu mask
    bits are cleared and only the preview screen is visible. Some other minor
    Setup revisions were made to improve screen presentation.
    
    (a) Add 'Data Rate' and 'Averaging' to the Preferences Preview screen
    (b) Revise Presets Preview screen to show current preset as '#n PresetName'
    (c) Center line 2 display text of Preview Screens
    (d) Reorder the Preset Submenu so that PrSt->CrntPrset is the first item to
        facilitate changing the preset within Setup.
    (e) Fix PrSt->CurPrSet to decrement preset on short left press to make
	operation consistent with all other submenu edit operations
    (f) Rename PAS->SensrType to PAS->SignlType to avoid conflict with
        Trq->SensrType

    These revisions affect EEPROM configuration, existing Setup files, and the
    Setup Utility.
    >> A fresh configuration must be instated after flashing the new firmware.


______________________________________________________________________________
Release: 3.1b2                                                      2016-03-30


Note: V3.1b2 Setup files are not compatible with firmware or Setup files
      
      >> Existing Setup files must be manually transferred to new v3.10 setup
         files.
      >> An incompatible existing CA setup must be recorded and reconfigured
         over a fresh V3.1b3 firmware installation.
      
(1) 1716 - (new) Provide a new 'Ebrake' configuration category

    New features relating to Ebrakes and Regen configuration are described
    below. These features may be found in a new 'Ebrake' category on the CA
    console or in the Software Setup Utility. In addition to new features, the
    existing parameter ThrO->BrakeOut has been relocated to this new group as
    EBk->BrakeOut.


(2) 1716 - (new) Provide option to configure logic sense of EBK input voltage

    A new option EBk->SignalLvl allows use of ebrakes that are Active-High
    instead of the more common Active-Low configuration.  This reverses the
    normal interpretation of the EBK signal such that ebrakes will be applied
    with an OPEN switch on the ebrake connector and will be released with
    a CLOSED switch.


(3) 1716 - (new) Provide option to enable/disable Proportional regen

    In v3.0, proportional Regen for Grin Tech controllers is always active
    whenever ThrO->BrakeOut is set to a vlaue other than 0.0V.  A new parameter
    EBk->ThrtRegen = {Enable|Disable} allows proportional regen to be disable to
    give constant regen at any value of BrakeOut.
    

(4) 2020 - 'Number of Batteries' configuration is not in Battery Category

    The (PrSt->Batteries?) Setup parameter is located in the Preset instead of
    Battery category which may be non-intuitive for some users.

    The parameter has been relocated to the Battery group as (Batt->Batteries?).


(5) 1724 - (new) Provide option for per/cell voltage display

    This enhancement provides a configurable option to configure and display
    voltages in terms of either the battery or per-cell voltages.

    A new parameter flag (Batt->VoltageDisplay) has been added with two values:
    'Battery Volts' and 'Avg Cell Volts'.  The first provides operation
    identical to that of previous releases where the total pack voltage is
    displayed. The new second option causes an alternating display of 'pack' and
    'average cell' voltage on the Main and 'Electrical Only' screens.
    Configuration of Batt->VltCutoff similarly is in terms of either pack or
    per-cell values.  Displayed cell voltage is derived by dividing measured
    pack voltage by Batt->String#.


(6) 1722 - (new) Provide user-configurable custom display field on Main Screen

    The display field in the lower right of the Main Screen previously
    alternated distance, Ah, and degC (if temp sensor was enabled). A new
    Setup variable (Pref->CustViews) allows selection of any of the following
    data values to be displayed sequentially in the lower right field:
	01 - distance (mi or km)
	02 - AH
	03 - temperature
	04 - temperature alert
	05 - RPM (cadence)
	06 - Human Wt
	07 - ThrO
	08 - Aux Limit
	09 - Gear-inch (effective wheel diam for present pedal-to-road gearing)
	10 - Total Wh/mi or Wh/km
	11 - Instantaneous Wh/mi or Wh/km

    'Temperature alert' only displays if the temperature is within 5 degC of
    Temp->ThrshTemp. This allows extra display time for other selections when
    temperature does not warrant particular attention. It can be combined with
    the 'temperature' field to always display temperature but to double the
    field display time when the temperature gets high.


(7) 1722 - Provide descriptions for 'Display Screen' and 'Custom Field' flags

    The 'Still', 'Moving', and 'Custom Field' flags appear in Setup as
    mysterious strings of ones and zeros that do not reveal the features being
    configured.

    A long right press on any of these 'flagword' parameters now opens Edit Mode
    with a submenu sequence of 'flag screens' - one per flag - that may be:
	a - toggled with a long right press,
	b - exited to the summary flag screen with a long left press, or
	c - navigated L/R to adjacent flags with short left/right presses.

    Each 'flag screen' has a brief description of the associated flag.


(8) 2020 - (new) Main Screen 'mph' and 'custom field' positions are interchanged

    Alterations to add alternating Voltage display and alternating custom fields
    palaced changing field on both lines of the display in opposite sides. The
    effect may be visually distracting/delay interpreting the data.

    Interchanging the 'mph' and 'custom field' positions places both alternating
    fields on the first line and both static field on the second line resulting
    in a perceived smaller area of change and steadier display.


(9) 2174 - 'Aux Adjust' popup has no units for speed limiting

    When configured for Speed Limiting, the Aux Adjust pop-up lacks speed units
    and shows fractional speed digits which provide accuracy of little value.

    The speed display has been shortened to three digits showing the speed only to
    units accuracy. The proper mph/kph units are now displayed as a two
    character tag.


(10) 2160 - (new) Install settings and firmware hex files into different directories

    The installation directory structure provides no specific locations for
    firmware and settings files. Since these both have '.hex' extensions,
    loading errors are possible when many files of both types are present.

    The zip file packager used for beta and other custom releases has been
    revised to provide two child directories '<root>/data/settings' and
    '<root>/data/firmware'.  Files of each respective type are installed into
    those directories while the documentation files (README,txt,
    ReleaseNotes.txt, etc) continue to be installed in the installation base
    directory. Unzipping the package into the base directory properly places all
    files in the distribution.


(11) 2206 - (new) Aux Pot voltage added to serial data log

    Aux Pot limiting or preset selection affects the interpretation of log
    parameters. The raw Aux Pot voltage is now logged to assist in
    interpretation of other log data.


(12) 2206 - Acceleration column removed from serial data log

    The 'Acc' column was introduced during 3.0 development as a debug aid and
    serves no useful purpose in the production release.  Removed. 


(13) 1710 - (new) Log torque (Nm) data even when not pedaling

    Torque is spacially-averaged based on pedal rotation so there is no torque
    average available when not pedaling.

    Add time-based torque averaging as well and use that value for logging when
    there in no pedal motion. This enhancement is primarily to support use of
    the CA for dyno applications where rpm and torque signals drive the CA
    speedo and PAS torque inputs and there is no rider cadence (rpm) input.


(14) 2016 - (new) Allow import of all per-preset settings from another preset 

    Two new selections 'PrSt->Import #n' copy all per-preset settings from
    preset #n to the present preset. The source preset need not be enabled so a
    custom 'default' can be configured in preset #3 and the number of presets
    reduced to 2. #3 can then not be changed by accident, but can be imported
    into #1 or #2 to reset experimental setups.


(15) 1730 - (new) Aux->ScaleLim is now a global parameter

    As a precursor to introducing new Aux Pot features, Aux->ScaleLim has been
    converted to a global instead of per-preset parameter. This means that an
    external limit control must control the same limit (Amps/power/PAS/Speed) in
    all presets. This change simplifies configuration and reduces required
    EEPROM storage necessary to configure the new features.


(15) 1734 - (new) ThrO->DownRate is now a global parameter

    As a precursor to introducing new Aux Pot features, Aux->ScaleLim has been
    converted to a global instead of per-preset parameter. This means that an
    external limit control must control the same limit (Amps/power/PAS/Speed) in
    all presets. This change simplifies configuration and reduces required
    EEPROM storage necessary to configure the new features.


(16) 1746 - (new) ThrO->DownRate is now a global parameter

    As a part of a general effort to recover EEPROM configuration memory for use
    in other features, ThrO->DownRate has been converted to a global instead of
    per-preset parameter.  This means that the single Down Rate setting applies
    to all presets.


(17) 1718 - (new) PAS->PASWatts and TRQ->AsstFactr are now a pre-preset parameters

    These parameters have been expanded from global to per-preset so that the
    AutoPAS and Torque assist levels can be set on a per-preset basis.


(18) 2208 - (new) Add screen indicator when Up/Down/Fast Ramping are active

    The effects of UpRate, FastRate, and AGain/WGain are not always easy to
    differentiate.  In particular, throttle rate limiting has transient effect
    and it may not be clear when this limiting is in play and superseding other
    CA throttle control.

    Three new flags now appear on the upper right of the Diagnostics Screen to
    replace the space character between 'OUT' and the numeric Throttle OUT voltage.
    
      1. Downrate ... underscore ............... (floor   for throttle decrease)
      2. UpRate ..... overscore ................ (ceiling for throttle increase)
      3. FastRate ... overscore with upArrow ... (fast rate up until UpRate applied)
    
    This revision only affects the Diagnostic screen display. All existing CA
    configurations and settings files are unaffected.


		
  2018-11-20 [top]