Cycle Analyst 3.13v1S - Release Notes
SETTINGS SUMMARY    CAV3 ONLINE

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


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


Release: 3.13v1S                                                      2018-12-23

    NOTE: This firmware is instrumented to detect illegal writes to any setting
          in EEPROM.  The CA intercepts these errors before they occur, ceases
	  normal operation, and displays a special 'watchdog' screen.  If this
          occurs, please record all screen information either by manual
          transcription or (phone) photo, press the right console button, and
          repeat until all screens have been recorded and the CA reboots.

          Please forward the recorded information with a description of the
          failure circumstances to Grin at: info@ebikes.ca.  Please include a
          setup file if possible. Thank you!


(1) 5883 - Extend Main Screen Voltage Field to provide Custom Battery Views

    The top left Main Screen view was previously constrained to provide either
    pack voltage or pack voltage alternating with calculated cell voltage.
    There was no ability to display only cell voltage.  Ah and Wh are other
    battery related statistics that are slow changing but share the right field
    with other parameters of interest.

    Setup of Custom Views has been revised to select attributes for both left
    and right top Main Screen fields: 'Battery Views' and 'Custom Views'
    respectivley. The available Battery Views are: V, Vc, Ah, and Wh.  These
    alternate in exactly the manner as the left field.  Ah and Wh are common
    selections for both fields allowing display identical to the earlier
    screen format if desired.

    The earlier setting Batt->VoltsDisp has been eliminated. The existing
    setting Disp->CustViews has added options.

    This revision affects EEPROM configuration. Existing CA configurations,
    setup files, and prior firmware may require manual adjustment.  Inspect the
    Setup Utility Firmware Update 'details' on the warning pop-up when
    upgrading.  Other settings will be carried forward unchanged.


(2) 5723 - Provide firmware to support 'Solar Current Sense' Shunt product

    The new 'Solar Current Sense' shunt allows a second (solar) charging source
    to be monitored by the CA3 via the AuxA connector.  This new firmware is
    based on the standard 3.13 foundation release but deletes AuxA support in
    exchange for solar shunt support.
    
    Display changes include:

        a) configuration of L/R 'Battery' or 'Custom' Views
        b) Solar Amps/Watts information on the 'Electrical Stats' Screen
        c) Solar Whr information on the 'Whrs Stats' screen
        d) Solar Ah information on the 'Regen Stats' screen
        e) Solar Lifetime Solar kW/h on the 'Batt/kWh Stats' screen
        f) Solar Amps/Watts, Ah, and NetWh/mi Custom Views on the Main Screen
        g) Revised selectable Custom Fields (* = new/changed)

           *01 - L - V          (Left Battery Views)
           *02 - L - Vc
           *03 - L - Ah
           *04 - L - Wh

            05 - R - mi/km      (Right Custom Views)
            06 - R - Ah
            07 - R - Wh
            08 - R - Wh/km
            09 - R - Wh/km (instantaneous)
           *10 - R - Net Wh/km
            11 - R - Temp
            12 - R - Temp Alert (show if temp 'near' threhold)
            13 - R - RPM / SPM
            14 - R - Human Watts
            15 - R - ThrOut
            16 - R - AuxD  {Amps,Spd,Watts,PAS} {A,S,W,X} DX
            17 - R - Gear Inch
            18 - R - RBatt
           *19 - R - Solar Amps
           *20 - R - Solar Watts
           *21 - R - Solar Ah

    The serial data log uses a format similar to that of the Sun Trip 2018 Solar
    DataBox but modified as follows to adjust for absent GPS data:

            01  Ah      -  Std (3.0x, 3.1x)
            02  V       -  Std (3.0x, 3.1x)
            03  A       -  Std (3.0x, 3.1x)
            04  S       -  Std (3.0x, 3.1x)
            05  D       -  Std (3.0x, 3.1x)
            06  Deg     -  Std (3.0x, 3.1x)
            07  RPM     -  Std (3.0x, 3.1x)
            08  HW      -  Std (3.0x, 3.1x)
            09  Nm      -  Std (3.0x, 3.1x)
            10  ThI     -  Std (3.0x, 3.1x)
            11  ThO     -  Std (3.0x, 3.1x)
            12  AuxD    -  Std (3.0x, 3.1x)
            13  SAh     - *Solar Ah
            14  SA      - *Solar Amps
            15  Flgs    -  Std (3.0x, 3.1x)

    NOTE: Increased log record length due to the new solar data log fields can
          occationally cause truncation of the flags column at the 10Hz data
          rate.  Log record truncation is indicated by a terminating '!'
          character.  Although this is undesirable in the general case, the
          relatively low importance of the flag field seemed to make this the
          better tradeoff compared to reducing the high log rate to only 5Hz.


_______________________________________________________________________________
Release: 3.13                                                        2018-12-21


This production release of Cycle Analyst firmware remedies issues in earlier
3.1x releases. Upgrade to this release is strongly recommended.  Changes
implemented in this and intermediate beta versions are outlined below.


(1) 6313 - Leaving Setup from right-press power-up causes Watchdog trap

    Holding the right console button depressed at power-up causes Setup to be
    entered immediately instead of showing the splash screen. When entered by
    this means, exiting Setup causes a Watchdog trap as 'normal' writes to
    EEPROM are incorrectly detected as critical errors.  This only affects
    firmware releases where EEPROM write protection code is active as noted in
    the Release Notes.

    EEPROM write protection code has been corrected for power-up Setup entry.

    This is an internal change with no consequences for CA setup or existing
    setup files.


(2) 6243 - Hot-swapping batteries causes a watchdog trap

    CA beta firmware is instrumented to detect illegal attempts to modify
    settings and to report details by means of a 'watchdog' screen.  Changing
    batteries using a console hot-swap button-press causes the change to be
    erroneously detected as an illegal EEPROM modification.

    Hot-swap battery changes are now excepted from EEPROM write checks.

    This is an internal change with no consequences for CA setup or existing
    setup files.


(3) 6371 - Console Setup of MxNoPdlSpd only works properly for preset 1

    Setting SLim->MxNoPdlSpd via the CA Console buttons works properly for
    preset 1 but incorrectly alters EEPROM for presets 2 and 3.  This problem is
    unique to the CA - the Setup Utility works properly to inspect and configure
    this setting for all presets.

    Console Setup operation for SLim->MxNoPdlSpd has been corrected.

    This change affects EEPROM configuration. Existing CA configuration and
    setup files may require manual adjustment.  Inspect all SLim (Speed)
    category parameters for each configured preset and correct values as
    appropriate.


_______________________________________________________________________________
Release: 3.13b2                                                      2018-11-20


(1) 6243 - Hot-swapping presets causes a watchdog trap if PAS is configured

    CA beta firmware is specially instrumented to detect illegal attempts to
    modify settings and report details by means of a 'watchdog' screen.  If PAS
    is enabled, changing presets using a console hot-swap button-press causes
    the change to be erroneously detected as an illegal EEPROM modification.

    Hot-swap preset changes are now excepted from EEPROM write checks.

    This is an internal change with no consequences for CA setup or existing
    setup files.


(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 a Setup Utility data file change with no consequences for CA setup
    or existing setup files.


(3)  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 a Setup Utility data file change with no consequences for CA setup
    or existing setup files.


_______________________________________________________________________________
Release: 3.13b1                                                      2018-11-16


(1) 3888 - Slow Power off causes an 'empty' SOC graphic for LiFePo4 chemistry

    Power-cycling a CA with LiFePo4 chemistry and slow power down can result in
    the SOC graphic 'sticking' at empty. This situation arises because of
    difficulties in accounting for the low confidence in Open circuit voltage
    (OCV) as a good indicator of SOC for LiFePo4 batteries except near full and
    empty charge levels. Other chemistries do not have this issue.
    
    State of Charge calculation for LiFePo4 chemistry has been revised to
    minimize the effects of power cycling with slow power off situations.  This
    corrects the SOC graphic.

    This is an internal change with no consequences for CA setup or existing
    setup files.


(2) 5941 - Rowbike PAS mode computes erratic SPM values

    PAS changes in release 3.11 introduced a bug in rowbike SPM computation
    (strokes per minute) that resulted in large persistent errors that would
    appear sometime after a period of normal operation.  A pause in rowing
    briefly restored the proper values, but errors would shortly occur.

    Rowbike SPM calculations have been corrected.
    
    This is an internal change with no consequences for CA setup or existing
    setup files.


(3) 5971 - Low cadence results in spurious RPM errors

    Spurious RPM errors could occur at cadences under 12rpm for certain PAS
    configurations.  Because RPM is a factor in other calculations, this problem
    could directly cause spurious Human Watts errors and peculiar fluctuations
    in power assist.

    RPM calculation has been repaired.
    
    This is an internal change with no consequences for CA setup or existing
    setup files.


(4) 4474 - Autocruise 'engaged' state persists when preset is changed

    Switching presets using an Aux control will carry an engaged autocruise
    state to the new preset even if the new preset has autocruise disabled.
    
    This behavior has been corrected and autocruise is now disengaged whenever
    the preset is changed by any means.
    
    This is an internal change with no consequences for CA setup or existing
    setup files.


(5) 5981 - AutoMain does not skip to proper unmasked screen when timer expires

    The AutoMain feature resumes display of the Main Screen automatically after
    the timer expires. Presently display always returns to the Main Screen
    irrespective of masking bits.
    
    Code has been revised such that timer expiration examines the still or
    moving masks and causes Main or the next right unmasked screen to appear
    appropriately.

    This is an internal change with no consequences for CA setup or existing
    setup files.


(6) 5983 - Diagnostic Screen Rate flags are undocumented

    Rate Limit flags displayed on the Diagnostic Screen were introduced in 3.1
    but were documented only in the beta release announcement.  Since they
    appear on the screen only fleetingly when active, this feature is largely
    unknown to customers.
    
    Although not a 'Setup Feature' per se, a brief summary of the flags has been
    added to the ThrO section header of ToolTips and the Help File.
    
    This is a documentation change with no consequences for CA setup or existing
    setup files.


(7) 6105 - PAS Basic(Pwr) mode does not work in Calibration HiRange

    Basic(Pwr) PAS mode is inoperative when Cal->Range = Hi(kW).

    PAS now properly supports Basic(Pwr) mode.

    This is an internal change with no consequences for CA setup or existing
    setup files.


(8) 6135 - Small pedal motions can cause false PAS Start detection

    Improved PAS start/stop sensitivity introduced in version 3.11 can cause
    Sempu sensors to mistakenly detect pedaling startup when the cranks are
    positioned near a point of sensor signal transition and jiggled back and
    forth.  This can occur when coasting on rough surfaces and appears as a
    brief application of assist without actual crank rotation.  TDCM, Thun,
    simple cadence wheels, and other sensors with lower pole counts do not
    experience this behavior.

    PAS logic has been revised to activate enhanced start/stop sensitivity only
    for sensors with less than 16 poles. Sensors with 16 or more poles will
    continue to benefit from the start/stop advantages inherent in greater pole
    count, but without the extra sensitivity enhancement (i.e will operate as in
    version 3.1).

    This is an internal change with no consequences for CA setup or existing
    setup files.


(9) 6157 - PAS Power Modes use Start Threshold for both starting and stopping

    When pedaling stops in either 'Basic(Pwr)' or 'Torque' PAS modes, assist
    power remains applied for PAS->StartThrsh instead of PAS->StopThrsh seconds
    even though RPM==0 is detected and reported correctly.
    
    PAS logic now removes power immediately when RPM==0 is detected.
    
    This is an internal change with no consequences for CA setup or existing
    setup files.


_______________________________________________________________________________
Release: 3.12                                                      2018-08-30


This production release of Cycle Analyst firmware remedies program hangs when CA
versions 3.1 or 3.11 communicate with Setup Utilty 1.54. All other documentation
and operational aspects of the previous 3.11 release are unchanged.

Changes are listed below for intermediate beta versions.


(1) 5893 - Torque Device Scaling for some predefined devices are incorrect

    Selecting predefined devices TDCM, Sempu, or CycleStoker improperly copies
    the stored table value resulting in a torque scale factor error of approx
    +2%.  Errors for these specific devices are of little consequence but the
    underlying flaw might have greater impact with other scaling values.

    Programming to copy the table scaling value has been corrected.

    This is an internal change with no consequences for CA setup or existing
    setup files.


_______________________________________________________________________________
Release: 3.12b1                                                      2018-06-21


(1) 5885 - 3.1/3.11 experience communications problems with the Setup Utility

    Communication timeout problems on can occur between Cycle Analysts running
    firmware versions 3.1 or 3.11 and the Setup Utility running on certain PC
    platforms.  These difficulties occur when either 3.1 or 3.11 firmware is
    already loaded and one of the following Setup Utility operations are
    attempted:
    
        a. 'Update Firmware' - either the program flash does not start or
           the last step updating the setup fails
        b. 'Read CA' or 'Write CA' operations hang and fail to retrieve or
           modify the CA setup
    
    In either case the CA typically hangs showing "PC Connection..." and the
    Setup Utility reports a timeout error.
    
    CA serial comms programming has been revised to better provide timely
    communication with Setup Utility.

    This is an internal change with no CA setup or setup file consequences.


_______________________________________________________________________________
Release: 3.11                                                      2018-07-19


This production release of Cycle Analyst firmware remedies issues in the
original 3.1 release as well as providing other improvements.  It should in all
cases be installed in place of the original 3.1 production release.

Changes are listed below for intermediate beta versions.


_______________________________________________________________________________
Release: 3.11b3                                                      2018-06-21


(1) 5781 - Battery 'Hot Swap' screen shows 0V and corrupted special characters

    The transient Battery 'Hot Swap' screen shows the nominal pack volatge as
    zero.  Other non-ASCII custom characters on the screen are corrupted.

    Proper display of this screen has been restored.

    This is a display change with no CA setup or setup file consequences.


(2) 5785 - (new) improve PAS startup performance for crank bikes

    For bikes other than rowbikes, version 3.1 implemented a conservative
    strategy to detect when pedaling starts and assist begins.  This aspect of
    PAS relates to the degree of crank rotation and is distinct from cadence
    detection controlled by the Start and Stop Thresholds
    
    A less conservative strategy has been implemented so that PAS is (re)applied
    more briskly from a standing start or when pedaling resumes while underway.
    This gives most noticeable benefit when the PAS sensor has few poles
    (magnets).
    
    This is an operational enhancement with no CA setup or setup file
    compatibility consequences.


_______________________________________________________________________________
Release: 3.11b2                                                      2018-06-05


(1) 5575 - Browsing Console Setup Aux Analog menu causes settings to be corrupted

    Traversing 'Lo/Hi Deadband' or 'Switch Lo/Med Level' settings of the AuxA
    menu in Console Setup causes the PAS device to change to 'Disabled' or other
    settings to be unintentionally altered. Other unintended setup changes might
    also occur on the next power-up causing a 'Setup Changed!' message to appear.

    This issue has been corrected.

    Setup files read from the CA under version 3.1 may contain errors and should
    be rebuilt or visually checked in the Setup Utility or CA Console. There are
    no compatibility issues with setup files produced in prior versions.


(2) 5547 - Speedometer reads improperly over 45mph (72kph)

    The speedometer debounce logic limits accurate speed display to a specific
    maximum (only) for pole counts of 1, 2, or 3.  In 3.0x firmware this maximum
    speed was approximately 90mph (145kph), however, 3.1 firmware reduces that
    limit to only 45mph (72kph).  Many ebikes can exceed this limit resulting in
    improper speed display.
 
    The original limit of 90mph (145kph) has been restored.

    This is an operational issue with no CA setup or setup file consequences.


(3) 5617 - Aux Change PAS Power indication displays 'true power'/10 in Hi Range

    Actual applied PAS power is correct, but in Hi Range the AuxChange display
    is 1/10 the true value.
 
    The Aux Change PAS power display is now multiplied by 10 to show the correct
    value to the nearest 10 watts.

    This is a display issue with no CA setup or setup file consequences.

    
(4) 5427 - Setup Utility sometimes fails to communicate with CA

    The Setup Utility occasionally fails to read/write CA settings or to update
    firmware.  An issue with CA processing of communication messages has been
    identified and repaired.

    This is related only to communication using the programming cable and does
    not affect CA settings or setup files.


(5) 5369 - Help files don't have link in category index to battery setup menu

    A proper hyperlink to the referenced Battery Category has been added to the
    Setting Summary Help file "2.0 Category Index".

    This is a documentation change with no CA setup or setup file consequences.


(6) 2020 - The 'Miscellaneous' Setup category identifies settings using 'Pref'

    The earlier 'Preferences' 3.0x category was split into 'Disp' and 'Misc' in
    3.1.  Settings in CA Console setup continue to use the 'Pref' designation.

    This labeling has been corrected.

    This is a display change with no CA setup or setup file consequences.


(7) 5539 - Setup 'Disp' Category Preview Screen shows 'Misc->DspAvging'

    The reorganization from the Preferences' to 'Display' and 'Misc' categories
    left the CA Console Setup erroneously showing the 'Display Averaging'
    setting on the display category preview screen.

    The Display Preview screen has been revised to show the selected Custom
    Views in place of the previous content.

    This is a display change with no CA setup or setup file consequences.


(8) 2020 - Navigation arrows in Setup MISC category are incorrect

    The submenu navigation arrows in the MISC category have been corrected to
    properly show the first and last menu items.

    This is an operational issue with no CA setup or setup file consequences.


(9) 5699 - Negative PAS Start Level does not work correctly

    Both PAS Start level and Scale Factor can be specified as signed numbers,
    however negative Start Levels were previously treated as zero in Basic(Pwr)
    mode.

    Proper handling has been implemented allowing an initial negative power
    assist to postpone PAS assist until the cadence power contribution exceeds
    the initial negative power level.
    
    This is an operational issue with no CA setup or setup file consequences.


(10) 4982 - (new) Improve PAS start/Stop sensitivity

    PAS Start/Stop sensitivity is related to the time between pulses from the
    PAS sensor.  PAS sensors with more magnets have to rotate less to create
    faster pulse streams. The PAS firmware has been revised to effectively
    double the pulse rate allowing the CA to detect crank motion much sooner.
    This enhancement works for all PAS modes and devices including rowbikes.

    An accompanying change has been made to PAS->StrtThrsh and PAS->StopThrsh
    default values to reduce sensitivity to slow pedal motion (e.g. PAS starts
    too soon, stops too late). This issue may present after upgrading the
    firmware and inheriting settings from the previous version (i.e. upgrading
    without loading defaults). If so, reset the PAS Start/Stop thresholds to the
    new defaults (Start, Stop) = (0.30, 0.19) or reduce custom setting values by
    about one third.

    This is an operational enhancement with no CA setup or setup file
    compatibility consequences.


(11) 5543 - (new) Change default PAS Start Levels for various modes

    The default PAS Start Levels are lower than might typically be useful and
    require adjustment, defeating the out-0f0box operation idea of default
    values.  The power levels have been adjusted upward to:

        Basic (Pwr) = 500 Watts
        Basic (ThO) = 50% throttle
        Torque      = 62 Human Watts

    This is an operational enhancement with no CA setup or setup file
    compatibility consequences.  The new defaults appear on a fresh firmware
    flash or when PAS->PASMode is altered.


(12) 5092 - (new) Reduce maximum pole count to 30

    The previous v3.1 maximum pole count of 60 has been reduced to 30 to
    conserve memory resources.  The previous value accommodated a limited number
    of unusual motor and gearing configurations that can be addressed indirectly
    with a lower pole count by making a corresponding alteration to wheel
    circumference.


_______________________________________________________________________________
Release: 3.1                                                      2018-02-18


Initial production release of Cycle Analyst 3.1 firmware.



		
  2018-12-23 [top]