Wakespeed Offshore WS500 User manual

CONFIGURING THE WS500
REGULATOR WITH THE WAKESPEED
FILE TRANSFER UTILITY
Wakespeed’s WS500 Advanced Alternator Regulator provides
onboard support for multiple battery technologies, via selectable
DIP switches, including standard ooded (thin plate) and deep
cycle ooded, Gel, standard AGM, carbon foam AGM (Firey),
high-density AGM, and LiFePO4.
In addition, the WS500 offers the ability to upload pre-engineered
conguration les for a growing number of battery brands and
chemistries, based on the battery manufacturer’s charging
recommendations by using the Wakespeed File Transfer Utility.
With the use of a Windows PC and a Micro USB cable, these
conguration les are downloadable from the Wakespeed website,
and uploaded to the WS500 Regulator. Conguring the regulator
does not require that the WS500 is installed in the vehicle or
vessel. Software and rmware upgrades can be done at the
workbench or at the dining table, as well as in place.
The following guide is designed to walk the installer or end user
through the upgrade/conguration process.
These items are necessary for the upgrade process:
• Windows-based computer with available USB port
• Access to the internet to download conguration .ZIP les
• High-quality Micro-USB cable
• Phillips hand or cordless screwdriver
• A non-metallic tool for depressing RESET button (doweling or
end of a pen or unsharpened pencil work well) is helpful
©2020 Thomason Jones Co. LLC (Wakespeed Offshore)

PREPARING THE WS500
REGULATOR
Place the WS500 Alternator Regulator on your
work surface and carefully unscrew the four
retaining screws on the top of the regulator. The
screws don’t need to be completely removed
from the lid.
When they have been sufciently loosened, the
regulator’s lid will lift off. The lid may need to be
wiggled as it’s lifted to free the sealing gasket.
GETTING STARTED
Conguration/rmware upgrade les are included in a .ZIP folder, which may be
downloaded from the Wakespeed website, or may be received from your Wakespeed
dealer as a link or email.
For the sake of illustration, we’ll look at a conguration update le from the
Wakespeed website. Conguration les are accessed on the website’s Technical page
(www.wakespeed.com/technical.html). Under the table header “WS500 Conguration
Files” is a list of available les, broken down by manufacturer and product series.
When the desired battery prole is found, click on the hyperlink. A .ZIP folder will be
downloaded to your computer. Drag the .ZIP le to your desktop and double-click to
extract the folder. Inside that folder will be all of the components required to upgrade
your regulator’s battery conguration.
Note: Your Windows computer should automatically update the drivers required to
support the Wakespeed File Transfer Utility, particularly if you are connected to the
internet. If your computer will not allow you to open the utility, it may be necessary to
upgrade your driver le. Driver les can be downloaded from Wakespeed’s Technical
page.
Figure 1 — Location of Conguration les at www.wakespeed.com/technical.html
Figure 2 — Unscrewing regulator lid
PAGE 2

Remove the regulator’s lid and
place out of the way.
The open regulator box will provide
access to the micro USB port and
RESET button.
The USB connector is scaled for
use with a standard Micro USB
cable, like one would use with
an Android smartphone. Use a
high quality cable that’s as short
as possible. Disconnecting other
USB cables from the computer will
ensure faster conguration.
RUNNING
THE NEW
CONFIGURATION
PROGRAM
Once the desired
battery conguration
prole is found on the
Wakespeed website, and
is downloaded to your
computer, it should be
placed on the computer’s
desktop.
Depending on the Windows
system being used,double
click the .ZIP le, or right click
and select Extract, to provide
access to the contents of the
Conguration folder.
The Conguration folder
shown in this example would
be optimized for use with MG
Energy LFP-Series batteries. File
names indicate the brand and
battery series, as well as the le
revision number.
Figure 3 — Removing regulator lid
Figure 4 — Shows Conguration .ZIP le on Windows desktop
Figure 5 — Shows contents of the Conguration folder
PAGE 3

RUNNING THE NEW CONFIGURATION PROGRAM
The Conguration folder provides all of the les required to update the regulator’s
rmware, and customize the battery program prole, CAN conguration
for BMS (if used), and alternator congurations.
To begin the conguration process:
1. Double-click the le labeled
Update.bat. This will open the
window which will guide you
through the rmware update
and upload of the conguration
parameters for the battery type
selected. In some Windows
environments, there may be a message
indicating tha Windows is not allowing
the batch le to be opened. This can be
overridden by clicking the “More info”
link and clicking on the “Run anyway”
button on the next window.
2. A new window will open on the desktop,
providing step-by-step conguration
instructions. See Figure 9 on the
following page for an example of the
conguration window.
3. Carefully connect the Micro USB
connector to the USB plug on the
regulator’s circuit board.
4. See Figure 7 for the location of the USB
plug and reset button. The Micro USB
Figure 6 — Close-up of contents in the Conguration folder
Figure 7 — Micro USB connector & reset button
Figure 8 — Micro USB cable connected
See instructions for customizing battery
proles starting on Page 7.
PAGE 4

cable will provide power for
the regulator’s processor
during the conguration
process.
5. The conguration program
will update the regulator’s
rmware before installing
the conguration les. To
start the rmware upgrade,
press and hold the reset
button for ve seconds and
release.
6. Press any key on the
computer’s keyboard after
releasing the reset button.
This will begin to test and
install the newest version
of the regulator rmware.
7. The batch le window (as
shown in Figure 10) will
upload rmware to the
regulator, and verify the
upload.
8. If the conguration window
indicates that the rmware
has been successfully
loaded and veried, press
and release the regulator’s
reset button.
9. Count to ve, then press
any key on the computer’s
keyboard to load the
conguration le for your
battery type.
10.As shown in Figure 11, the program will upload the ASCII commands into
the regulator’s processor. When the new conguration is successfully
loaded into the regulator, the batch le window will indicate “Finished”. Note
that in Figure 11, the computer tried multiple ports before successfully
connecting with the regulator. Disconnecting any unused USB devices from
the computer will minimize these error messages. Press any key to exit the
program.
11.Carefully disconnect the Micro USB connector from the regulator.
Figure 10 — Batch le window. Showing rmware update.
Figure 11 — Batch le window. Showing conguration update.
PAGE 5

MODIFYING THE CONFIGURATION PROGRAM
While the downloaded .ZIP le is designed to t a broad range of applications, there
may be certain values that the installer or user may want to modify. The following
instructions are intended to provide guidelines for some of the more commonly
changed values, additional information is provided in the Communication and
Programming Guide that’s available at www.wakespeed.com/technical.html.
In most instances, the installer/user will consider adjusting four main values in the
conguration code:
• The alternator temperature set point
• The duration of the warm up delay
• The percentage of alternator de-rate
• The actual capacity of the batteries being
charged.
ACCESSING THE
CONFIGURATION FILE
Within the .ZIP le is the folder containing the
data and Wakespeed File Transfer Utility required
to update the regulator’s rmware and charging
proles. Within the folder is a .txt le which
contains the ASCII strings required to control the
regulator’s behavior.
The .txt. can be opened with a standard text
editing application . To access the text le:
1. Open the folder extracted from the .Zip
le downloaded from the Wakespeed
Conguration table at www.wakespeed.com/
technical.html.
2. Using your preferred text editing or terminal
console, open the le in the folder with the .txt
sufx.
Figure 12 — Location of .txt le in
conguration folder.
PAGE 6

MODIFYING A CONFIGURATION FILE
The conguration text le contains a string of command lines; each that modies the
behavior of the WS500 to optimize control of the alternator to match the needs of the
batteries and charging system.
The .txt le shown in Figure 12 is a good example of a typical conguration le. In
most cases, the le will provide all the settings the regulator requires to provide a
safe, effective prole for charging.
On the following several pages, we’ll look at the actual text le for a Lifeline AGM
battery, and consider some of the values that the user may want to alter to best
support his or her specic application. Note that in most cases, the only values
which may need modication are battery capacity, target alternator temperature,
percentage of alternator de-rate, and the duration of the start delay and charge ramp.
Other conguration values should be modied with caution.
Note that conguration les are carefully designed, based on
testing and manufacturer charging recommendations. Improper
modications can result in damage to the batteries, regulator
and alternator. DO NOT attempt to modify the conguration le
if you are not familiar with this process. Failure to properly follow
guidelines may void your warranty and damage your system.
The conguration le broken down in the next several pages is intended to provide
a generalized look at how the code is laid out. Note that different battery types,
different alternator types, battery capacity, and additional components like battery
BMS units may require command lines not shown in this example.
The Wakespeed Communication and Conguration Guide, which can be downloaded
from the Technical Page at www.wakespeed.com, provides a complete list of
available command lines, which can be used to modify the behavior of the WS500
Alternator Regulator.
If your battery, BMS, or alternator type are not supported by an existing command
line, you may nd a conguration le for a similar application and modify it to support
!
PAGE 7
IMPORTANT: The following information is provided to describe the numerous
user-congurable features available in the WS500 regulator. We have highlighted
the four most commonly adjusted values in the example. Those values are dis-
played in RED. For more information about advanced user congurations, please
refer to the Wakespeed Communication and Conguration Guide, which can be
downloaded in PDF format from the Technical Page at www.wakespeed com.

TRANSLATING THE .TXT PROFILE
When opened in a terminal program or text editor, the Lifeline Standard AGM program
will appear as follows:
#
# LIFELINE AGM cong le
#
# Based on details in: Lifeline Technical Manual, rev E
#
# Date: 3/17/2020
#
# Lifeline standard
# 100c alternator
#
# Lifeline AGM
$SCA: 0,100,1.00,0.75,0.50,0,0,0,10000,0,0,30,0@
$CPA:7 14.3,360,3,0@
$CPO:7 0, 0, 0.0, 0@
$CPF:7 13.3, -1, 0, 0, -50, 12.5, 0@
$CPE:7 15.5,25,600,0@
$CPP:7 0,0.0,0,0.0@
$CPB:7 0.022, -30, -40, 71, 0.0, -99, -99, 15, 2000@
$SCN: 0,Lifeline,1234@
$SCO: 0,0,0,0@
Each line of the .txt le provides commands and values specic to various aspects
of the charge program. The rst line of code, designated as $SCA, changes the
parameters of the alternator in the table of system congurations. Meanings for the
values are as follows (note that values are deliniated by commas):
$SCA: 0,100,1.00,0.75,0.50,0,0,0,10000,0,0,30,0@
12 3 4 5 6 7 8 9 10 11 12 13
1. Factory use only
2. Alternator target temperature (°C) – Temperature regulator will attempt to maintain at
alternator temperature sensor. Contact your alternator manufacturer for recommended
temperature setting and sensor location. For added system safety, consider setting your
value 10-20 degrees below the manufacturer’s recommendation.
3. Alternator Derate (Normal) – When no derate modes are selected.
4. Alternator Derate (Small Alternator Mode) – When DIP Switch #8 is selected.
5. Alternator Derate (Half Output) – Selected when alternator temperature sensor wires
are shorted.
6. Pull Back Factor (PBF) – Reduces eld at idle (Set “0” to disable) (Set “1” to enable).
7. Amp Cap – (-1500) Allows maximum amperage limit if current shunt is connected.
8. System Watts Cap – (-120000) Limits maximum wattage.
9. Amp Shunt Ratio – Indicates the current shunt’s ratio (Amps/mVolts) Default setting is
for a 500A/50mV shunt (500/0.050=10000)
PAGE 8
IMPORTANT: The following information is provided for reference, and is intended
to provide guidance required to tailor the configuration profile to your system.
Commonly adjusted settings are highlighted in RED. Please refer to the Wakespeed
Communications and Configuration Guide for detailed configuration instructions.

10. Shunt Reversal – Allows user to compensate if a shunt is installed backward. “0” is
normal polarity. “1” will reverse the polarity of the readings.
11. Idle RPMs – Used in conjunction with Pull Back Factor (PBF). Determined in whole
numbers (0 1500). Default zero setting enables regulator to automatically deter-
mine idle RPM.
12. Warmup Delay – Determined in whole numbers (15 600), controls the number of
seconds the regulator will wait before moving into ramp mode.
13. Required Sensors – Determined in whole numbers (0 255) controls regulator
response to missing alternator temperature, battery temperature and current sen-
sors. Default value is “0”. See Communication and Conguration Guide for detailed
programming instructions.
The second line of code, designated as $CPA, updates the parameters of the
ACCEPT (and BULK) portions of the charge prole. Meanings for the values are as
follows (note that values are deliniated by commas):
The third line of code, designated as $CPO, updates the parameters of the Over-
Charge (or nish) portion of the charge prole. Meanings for the values are as
follows (note that values are deliniated by commas):
$CPA: 7,14.3,360,3,0@
$CPO: 7,0,0,0.0,0@
1
1
2
2
3
3
4
4
5
5
1. Charge Prole Table Entry – Identies the Prole number being modied by the new
conguration. Select 7 or 8.
2. VBat Set Point – Identies the voltage set point that the regulator will use during the Ac-
ceptance phase of charging. Value is a oating point number, and is entered for a normal-
ized 12V system.
3. Exit Duration – Value represents the timer duration between entry into acceptance and
exit to over-charge phase. Setting the value at “0” will disable time-based exiting and will
activate current-based monitoring. Range is 0 600 (10 hours).
4. Exit Amps – Represents the minimum amperage allowed before regulator advances
from acceptance to over-charge. Range is whole numbers -1 200. See Communication
and Conguration Guide for details on special settings.
5. Factory Only
1. Charge Prole Table Entry – Identies the Prole number being modied by the new
conguration. Select 7 or 8.
2. Limit Amps – After entering over-charge, the delivered amps will be monitored and regu-
late to the value set. Range is 0 50. Zero setting will disable over-charge mode.
3. Exit Duration – Value represents the timer duration between entry into over-charge and
exit to oat. Setting the value at “0” will disable time-based exiting and will activate cur-
rent-based monitoring. Range is 0 600 (10 hours).
PAGE 9

4. Exit VBat – Represents the minimum amperage allowed before regulator advances from
acceptance to over-charge. Range is oating point numbers 0.0 20.0. Setting Exit V
Bat at zero will disable over-charge mode.
5. Exit Amps – Ranging in whole numbers from 0 50, this value will keep the regulator
in over-charge until acceptance current falls to or below the set value. A zero setting will
disable this option.
The fourth line of code, designated as $CPF, updates the parameters of the Float
portion of the charge prole. Meanings for the values are as follows (note that values
are deliniated by commas):
The fth line of code, designated as $CPE, updates the parameters of the Float
portion of the charge prole. Meanings for the values are as follows (note that values
are deliniated by commas):
$CPF: 7,13.3,-1, 0, 0, -50, 12.5, 0@
$CPE: 7,15.5,25, 600, 0@
1
1
2
2
54
4 5
3
3
6 7 8
1. Charge Prole Table Entry – Identies the Prole number being modied by the new
conguration. Select 7 or 8.
2. VBat Set Point – Floating point value (0.0 20.0) for target oat voltage in a normal-
ized 12V system.
3. Limit Amps – After entering oat, the delivered amps will be monitored and regulate to
the value set. Range is 0 50. Zero setting will disable over-charge mode.
4. Exit Duration – Whole number (0 30000) controls timer duration once oat stage
is started. A “0” will cause the regulator to remain in oat until triggered by other exit
criteria.
5. Revert Amps – Whole number (-300 0). Value of negative current, indicating large
system load, will cause regulator to revert to restart charge cycle. “0” will disable fea-
ture.
6. Revert Amps-Hours – Whole number (-250 0). Indicates accumulated number of amp
hours removed from the battery to restart charge cycle. “0” will disable this feature.
7. Revert Volts – Floating point value (0.0 20.0) establishes low voltage in oat which
will cause regulator to revert to restart charge cycle. “0” will disable this feature.
8. Revert SOC – Whole number (0 100). Will restart charge cycle from oat if BMS or
other RBM indicates drop below battery SOC level. “0” will disable this feature.
1. Charge Prole Table Entry – Identies the Prole number being modied by the new
conguration. Select 7 or 8.
2. VBat Set Point – Floating point value (0.0 20.0) for target equalization voltage in a
normalized 12V system.
3. Maxs Amps – Whole number (0 50). Caps the allowable amps in equalization mode.
“0” will disable this feature.
PAGE 10

The sixth line of code, designated as $CPP, updates the parameters of the Post
Float portion of the charge prole. Meanings for the values are as follows (note that
values are deliniated by commas):
$CPP: 7,0,0.0, 0, 0.0@
1 2 3 54
1. Charge Prole Table Entry – Identies the Prole number being modied by the new
conguration. Select 7 or 8.
2. Exit Duration – Whole number (0 30000 (500 hours) controls timer duration once
post oat stage is entered. When the end of the timed period is reached, the regulator
will loop back to bulk mode. Zero value will cause regulator to remain in Post Float until
triggered by another exit criteria.
3. Revert VBat – Floating point number (0.0 to 20.0) designates the minimum Post Float
voltage, below which the regulator will be triggered to return to bulk mode. O.O setting
disables this feature.
4. Revert Amp-Hours – Whole number (-250 to 0) determines the accumulated number of
amp-hours removed during Post Float which will cause the regulator to return to re-start a
charge cycle and return to bulk mode. Setting the value at zero will disable this function.
5. VBat Set Point – Floating point number (0.0 to 20.0) designates the target voltage used
during Post Float mode. Setting at 0.0 will disable charging during Post Float mode.
The seventh line of code, designated as $CPB, updates the battery parameters of
the regulator’s charge prole. Meanings for the values are as follows (note that values
are deliniated by commas):
$CPB:
7,0.022,-30, -40, 71, 0.0, -99, -99, 15, 0.0@
1 2 7 8 9 106543
1. Charge Prole Table Entry – Identies the Prole number being modied by the new
conguration. Select 7 or 8.
2. VBat Compensation – Floating point value (0.0 0.1) adjusts a VBat voltages based
on measured battery temperature. Normalized 12V system with zero correction at
25°C. “0.0” will disable temperature-based voltage compensation.
3. Minimum Compensated Temperature – Whole number (-40 40). Additional volt-
age compensation will be discontinued when measured battery temperature is below
value chosen. Measured in °C.
4. Minimum Charge Temperature – Whole number (-50 10). Charging will be discon-
tinued when measured battery temperature is below value chosen. Measured in °C.
4. Exit Duration – Whole number (0 600 (10 hours) controls duration regulator will
remain in equalization mode, at which point the regulator will return to oat voltage. “0”
will disable this feature.
5. Exit Amps – Whole number (0 50) Controls minimum delivered current level before
regulator exits equalization to oat. “0” will disable this feature. Note: operator is re-
quired to ensure that engine is kept at sufcient RPM to enable delivery of necessary
current to complete equalization, prior to returning to oat mode.
PAGE 11

$SCN updates the name and password of the regulator. In CANbus communication,
the regulator name acts as an identier of the regulator within the CAN network.
Meanings for the values are as follows (note that values are deliniated by commas):
$SCO overrides the DIP switches for Charge Prole and Battery Capacity settings,
and allows the auto-detect for system voltage to be overridden. Values are as follows:
$CPB: 0,Lifeline,1234@
$SCO: 7,0.0,0.0,0@
1
1
2
2
3
3 4
1. Reserved – Set at “0”.
2. Regulator Name – Up to 18 characters with no spaces, commas, or “@”. This name is
used for a CAN ID, and may be used to individual regulators in twin engine or other multi-
alternator applications.
3. Regulator Password – Up to 18 characters with no spaces, commas, or “@”.
1. Charge Prole Index – Whole number (0 8). Determines charge prole used. Zero
setting allows DIP switches to be used for charge prole selection.
2. Battery Capacity Multiplier Index – Floating point number (0.0 ±10.0) sets the mul-
tiplier for a normalized 500AH battery bank. Multiplier can be termined by dividing actual
battery capacity by the normalized value. As an example, if the battery capacity is 750
amp hours, the BC Index should be set at 1.5.
5. Maximum Charge Temperature – Whole number (20 95). Charging will be discon-
tinued when measured battery temperature exceeds value chosen. Measured in °C.
6. RDC Volts – Floating point value (0.0 12.0) regulator will work in Reduced Charge
mode where maximum current delivered will be limited to RDC amps. “0.0” will disable
this feature.
7. RDC Low Temperature – Whole number (-99 20). If battery temperature drops
below the set value in °C, the regulator will work in Reduced Charge mode. “-99” will
disable this feature.
8. RDC High Temperature – Whole number (-99 95). If battery temperature exceeds
the set value in °C, the regulator will work in Reduced Charge mode. “-99” will disable
this feature.
9. RDC Amps – Whole number (0 100). When the regulator is in Reduced Charge
mode, acceptance currrent will be limited to the set number. “0” will disable this fea-
ture.
10. Maximum Battery Amps – Whole number (0 2000). Maximum current allowed to
ow into the battery. This value is set relative to the 12v/500A ‘nominal’ battery and it
is also adjusted by the Battery Capacity Multiplier; so a value of 250 would cause the
regulator to limit charging current to a 0.5c rate. “0” will disable this feature.
PAGE 12

PAGE 13
3. SV Override – Floating point number (0.0 4.0). This override allows the regulator to
be used in other systems not supported by the auto-detect feature. To determine the SV
multiplier, divide the system voltage by 12. (i.e., a 32V system would be 32/12=2.67).
SV Override must be set at 0.0 to enable auto system voltage detect.
4. Lockout – Whole number (0 2). Restricts the ability to perform changes and/or pro-
vide input to the regulator which can impact how the alternator charges the batteries.
Zero setting disables system lockout. A value of one prevents any conguration changes.
A value of 2 creates a lockout level that can only be reversed by reashing the rmware
with a factory-level key. CAUTION: the only way to recover the regulator from this state
requires special programming hardware probes.
Notes:
Table of contents