Commit e2da3f66 authored by Jonathan Lock's avatar Jonathan Lock

Update documentation to v1.1.1

parent 4e318c11
......@@ -550,7 +550,7 @@ C7
\end_layout
\begin_layout Itemize
R8
R6
\end_layout
\begin_layout Itemize
......
This source diff could not be displayed because it is too large. You can view the blob instead.
This diff is collapsed.
This diff is collapsed.
......@@ -11,7 +11,7 @@
\newcommand*{\projectauthor}{Jonathan Lock} %Author of the project
\newcommand*{\projectyear}{2018} %Stated year of writing
\newcommand*{\projectname}{Modular BMS} %Project name
\newcommand*{\projectdocversion}{1.1.0} %Version of the documentation
\newcommand*{\projectdocversion}{1.1.1} %Version of the documentation
\newcommand*{\docname}{modular-bms\_manual\_v\projectdocversion\_\today} %Document ID
\newcommand*{\projecturl}{\url{http://www.rabidmantis.se}} %URL to webpage of project
\newcommand*{\licencetext}{Licensed under Creative Commons BY-SA 3.0 License} %Text in footer referring to licence
......
......@@ -223,6 +223,59 @@ Use a versioning structure similar to that of the structure above.
\end_layout
\begin_layout Description
1.1.1 Clarified voltage thresholds, added
\begin_inset Quotes eld
\end_inset
standard
\begin_inset Quotes erd
\end_inset
parameter setup,
\begin_inset CommandInset ref
LatexCommand formatted
reference "fig:dischg-graph"
plural "false"
caps "false"
noprefix "false"
\end_inset
,
\begin_inset CommandInset ref
LatexCommand formatted
reference "fig:chg-graph"
plural "false"
caps "false"
noprefix "false"
\end_inset
, and
\begin_inset CommandInset ref
LatexCommand formatted
reference "fig:chg-graph-typ"
plural "false"
caps "false"
noprefix "false"
\end_inset
.
Fixed erronous component in
\begin_inset CommandInset ref
LatexCommand nameref
reference "sec:Assembly"
plural "false"
caps "false"
noprefix "false"
\end_inset
reference in section.
\end_layout
\begin_layout Description
1.1.0 Update for software revision 1.1.0.
\end_layout
......
......@@ -182,7 +182,7 @@ System structure
\begin_inset Float figure
wide false
sideways false
status collapsed
status open
\begin_layout Plain Layout
\align center
......@@ -190,7 +190,7 @@ status collapsed
placement h
wide false
sideways false
status collapsed
status open
\begin_layout Plain Layout
\align center
......@@ -237,7 +237,7 @@ name "fig:BMS-system-low-charge"
placement h
wide false
sideways false
status collapsed
status open
\begin_layout Plain Layout
\align center
......@@ -311,6 +311,9 @@ noprefix "false"
\end_inset
.
For many cell chemistries the charger can simply be a constant-voltage
constant-current type DC power supply (more below on how to size the unloaded
voltage).
Note that each
\begin_inset ERT
status open
......@@ -417,8 +420,12 @@ devices has the following behavior:
\end_layout
\begin_layout Itemize
\emph on
When the device is first powered up, if it crashes, or if it otherwise resets,
a warning is triggered.
a warning (with an audible tone and a displayed message) is triggered
\emph default
.
While in this state the text
\family typewriter
BUG
......@@ -523,8 +530,31 @@ VTHRS_DISCH_MIN_V
\family typewriter
VTHRS_DISCH_MAX_V
\family default
, then the cell-balancing resistors will be turned on and off repeatedly,
with an average duty cycle (on-time) proportional to the range.
, then the cell-balancing resistors will be turned on and off repeatedly
for the associated
\begin_inset ERT
status open
\begin_layout Plain Layout
\backslash
projectname
\end_layout
\end_inset
, dissipating energy from the connected cell.
The average duty cycle (on-time) of the resistors will be proportional
to the voltage in the range
\family typewriter
VTHRS_DISCH_MIN_V
\family default
\family typewriter
VTHRS_DISCH_MAX_V
\family default
.
E.g.
if
\family typewriter
......@@ -573,37 +603,6 @@ VTHRS_DISCH_MAX_V
, then the cell-balancing resistors will be kept on.
\end_layout
\begin_layout Itemize
If any cell voltage exceeds
\family typewriter
VTHRS_DISCH_START_V
\family default
, the cell-balancing resistors will be activated for the associated
\begin_inset ERT
status open
\begin_layout Plain Layout
\backslash
projectname
\end_layout
\end_inset
, dissipating energy from the connected cell.
Note that this will only discharge the connected cell, not any other cells
in the pack.
The cell-balancing resistors will be kept active until the measured voltage
is below
\family typewriter
VTHRS_DISCH_STOP_V
\family default
.
An LED near the LCD will light up when the cell-balancing resistors are
active.
\end_layout
\begin_layout Itemize
If any cell voltage exceeds
\family typewriter
......@@ -704,6 +703,350 @@ VHYST_ALARMS_V
\end_layout
\end_deeper
\begin_layout Standard
An illustration showing the behavior during a typical discharge cycle is
shown in
\begin_inset CommandInset ref
LatexCommand formatted
reference "fig:dischg-graph"
plural "false"
caps "false"
noprefix "false"
\end_inset
.
An illustration of an abnormal charge cycle is shown in
\begin_inset CommandInset ref
LatexCommand formatted
reference "fig:chg-graph"
plural "false"
caps "false"
noprefix "false"
\end_inset
.
The cell voltage during a typical charge cycle will never exceed
\family typewriter
VTHRS_CHGDIS_START_V
\family default
(as this will disconnect the charger from the cells).
To generate the illustrated voltage profile some other current source must
be present and charging the cell.
\end_layout
\begin_layout Standard
A more typical charge cycle is shown in
\begin_inset CommandInset ref
LatexCommand formatted
reference "fig:chg-graph-typ"
plural "false"
caps "false"
noprefix "false"
\end_inset
.
Here, the external charger is set to an unloaded voltage in the middle
of the
\family typewriter
VTHRS_DISCH_MIN_V
\family default
and
\family typewriter
VTHRS_DISCH_MAX_V
\family default
range.
When the charger is disconnected, the balancing resistors eventually discharge
the cell to
\family typewriter
VTHRS_DISCH_MIN_V
\family default
, after which they are completely turned off.
\end_layout
\begin_layout Standard
\begin_inset Float figure
wide false
sideways false
status collapsed
\begin_layout Plain Layout
\align center
\begin_inset Graphics
filename gfx/bms_graph_disch.svg
width 80text%
\end_inset
\end_layout
\begin_layout Plain Layout
\begin_inset Caption Standard
\begin_layout Plain Layout
Typical behavior during discharge.
\begin_inset CommandInset label
LatexCommand label
name "fig:dischg-graph"
\end_inset
\end_layout
\end_inset
\end_layout
\begin_layout Plain Layout
\end_layout
\end_inset
\end_layout
\begin_layout Standard
\begin_inset Float figure
wide false
sideways false
status collapsed
\begin_layout Plain Layout
\align center
\begin_inset Graphics
filename gfx/bms_graph_chg.svg
width 80text%
\end_inset
\end_layout
\begin_layout Plain Layout
\begin_inset Caption Standard
\begin_layout Plain Layout
Behavior during (abnormal) charge, showing behavior of all parameters.
\begin_inset CommandInset label
LatexCommand label
name "fig:chg-graph"
\end_inset
\end_layout
\end_inset
\end_layout
\begin_layout Plain Layout
\end_layout
\end_inset
\end_layout
\begin_layout Standard
\begin_inset Float figure
wide false
sideways false
status collapsed
\begin_layout Plain Layout
\align center
\begin_inset Graphics
filename gfx/bms_graph_chg_typ.svg
width 80text%
\end_inset
\end_layout
\begin_layout Plain Layout
\begin_inset Caption Standard
\begin_layout Plain Layout
Typical charge cycle.
\begin_inset CommandInset label
LatexCommand label
name "fig:chg-graph-typ"
\end_inset
\end_layout
\end_inset
\end_layout
\begin_layout Plain Layout
\end_layout
\end_inset
\end_layout
\begin_layout Subsection*
Suggested parameter values
\end_layout
\begin_layout Standard
Suggestions for reasonable default parameter values are as follows:
\end_layout
\begin_layout Description
\family typewriter
VTHRS_UV_ALARM_V
\family default
Minimum expected unloaded cell voltage.
\end_layout
\begin_layout Description
\family typewriter
TMIN_UV_ALARM_S
\family default
Typically 60
\begin_inset space \thinspace{}
\end_inset
s.
\end_layout
\begin_layout Description
\family typewriter
VTHRS_DISCH_MIN_V
\family default
Desired final, fully charged, cell voltage.
\end_layout
\begin_layout Description
\family typewriter
VTHRS_DISCH_MAX_V
\family default
Typically 0.05
\begin_inset space \thinspace{}
\end_inset
V above
\family typewriter
VTHRS_DISCH_MIN_V.
\end_layout
\begin_layout Description
\family typewriter
VTHRS_CHGDIS_STOP_V
\family default
Typically equal to
\family typewriter
VTHRS_DISCH_MAX_V.
\end_layout
\begin_layout Description
\family typewriter
VTHRS_CHGDIS_START_V
\family default
Typically 0.05
\begin_inset space \thinspace{}
\end_inset
V above
\family typewriter
VTHRS_DISCH_MAX_V
\family default
.
Must be below absolute maximum cell voltage!
\end_layout
\begin_layout Description
\family typewriter
VTHRS_OV_ALARM_V
\family default
Typically 0.05
\begin_inset space \thinspace{}
\end_inset
V above
\family typewriter
VTHRS_CHGDIS_START_V.
\family default
Should be below absolute maximum cell voltage!
\end_layout
\begin_layout Description
\family typewriter
VHYST_ALARMS_V
\family default
Typically 0.05
\begin_inset space \thinspace{}
\end_inset
V.
\end_layout
\begin_layout Description
\family typewriter
TMIN_CHGDIS_S
\family default
Typically 60
\begin_inset space \thinspace{}
\end_inset
s.
\end_layout
\begin_layout Standard
If a constant-voltage constant-current voltage charger is used, set the
unloaded voltage to
\begin_inset Formula $\mathtt{VTHRS\_DISCH\_MAX\_V}+\mathtt{VTHRS\_DISCH\_MIN\_V}/2$
\end_inset
.
This will ensure that all cells are balanced while the charger is plugged
in, and the balance LED's can be used to judge the charge state.
When all
\begin_inset ERT
status open
\begin_layout Plain Layout
\backslash
projectname
\backslash
\end_layout
\end_inset
balance LED's are on approximately 50% of the time the entire pack is near
fully charged.
\end_layout
\begin_layout Subsection*
On-line system parameter printout
\end_layout
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment