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.