openinverter.org wiki - User contributions [en]

Leaf stack with zombiverter

2025-10-02T19:07:57Z

Landsi: /* Zombie Leaf stack gen3 additions */

<nowiki>*</nowiki>this page is a work in progress and may not be fully accurate or up to date.

=== Setting up a leaf stack with the zombiverter VCU ===
The full leaf stack ( motor/inverter, pdm (charger, dcdc, hvjb)) can be controlled with the zombieverter VCU.

All you need is 12v+, enable, and CANbus. ''Note: You still need the OEM connection between the Inverter and Motor Temperature sensors and Resolver for things to function.''

''As of software release [https://github.com/damienmaguire/Stm32-vcu/releases/tag/2.20a V2.20A,] the IVT shunt used for UDC data is no longer required for precharge.''

''The leaf Inverter itself'' can supply UDC data for precharge (set the Shunt Type = 0)

the PDM is not needed for UDC data.

The leaf motor and inverter do not require the PDM to run with the zombieverter, or for UDC measurements.
== Wiring ==
[[File:Zombi-leaf-wiringv3.jpg|thumb|568x568px]]
=== Wiring the zombiverter to the leaf harness ===
===== Pinout =====
{| class="wikitable"
! colspan="2" |Description
!Zombieverter Pin
!PDM pin
!inverter pin
!inverter gen3 pin
!battery pin
|-
| +12V
|Permanent 12v+
|56
|18
|46, 48
|1, 6
|5, 11, 14, 17
|-
|Gnd
|permanent 12v -
|55
|pdm case
|47, 49
|4, 10
|6, 7, 8
|-
|Fwd signal
|Forward
|54
|
|
|
|
|-
|Rev signal
|Reverse
|53
|
|
|
|
|-
|momentary 12V
|Start signal
|52
|
|
|
|
|-
|Brake signal
|Brake Input
|49
|
|
|
|
|-
| +5V
|Throttle
|48
|
|
|
|
|-
|Throttle signal 1
|Throttle signal 1
|47
|
|
|
|
|-
|Throttle signal 2
|Throttle signal 2
|46
|
|
|
|
|-
|Throttle Gnd
|Throttle Gnd
|45
|
|
|
|
|-
|Precharge Contactor LS Switch
|Negative lead from precharge contactor
|34
|
|
|
|10
|-
|Main Contactor LS Switch
|Negative lead from main contactor
|33
|
|
|
|16
|-
|enable relay
|switches enable relay
|32
|16
|42
|18
|31
|-
|Neg Contactor LS Switch
|Negative lead from negative contactor
|31
|
|
|
|13
|-
|CANEXTH
|Can 1 High
|28
|27
|14
|5
|1
|-
|CANEXTL
|Can 1 Low
|27
|11
|15
|11
|2
|-
|T15
|Ignition 12V in
|15
|
|
|
|4
|-
|proximity pilot
|pp for charge port
|
|29
|
|
|
|-
|control pilot
|cp for charge port
|
|30
|
|
|
|}
[[File:Leaf Inverter connections.png|left|thumb|818x818px|Leaf Inverter terminal layout and physical values for signals]]

[[File:Leaf PDM Connections.png|thumb|1120x1120px|Leaf PDM connector pinout and physical values. This seems to apply to 2013-2017 Leaf. Check what you have before blindly making any connections.]]

[[File:PDM PINOUT.png|thumb|737x737px]]

[[File:Leafbattery36.png|thumb|638x638px]]
[[File:Nissan-leaf-gen3-inverter-connector.jpg|alt=Gen3 Nissan leaf inverter pinout|thumb|Gen3 Nissan leaf inverter pinout]]

[[Chademo with Zombieverter|Chademo to Zombiverter:]]
[[File:Zombie-leaf-wiring-gen3.jpg|alt=Nissan Leaf gen 3 to Zombie wiring diagram|thumb|Nissan Leaf gen 3 to Zombie wiring diagram]]
Details can be found on a [[Chademo with Zombieverter|dedicated page.]] 
chademo connector:

HV contactor coil + pin 2 to GP 12v input

HV contactor coil - pin 10

pin 1 to ground

CAN H pin 8 to CAN EXT 3 H

CAN L pin 9 to CAN EXT 3 L

pin 4 to GP out

File:Zombie-leaf-wiring-gen3.jpg

2025-10-02T19:04:09Z

Landsi:

Basic wiring diagram of Zombieverter to gen 3 Nissan leaf inverter

File:Nissan-leaf-gen3-inverter-connector.jpg

2025-10-02T18:39:35Z

Landsi:

The pinout of the gen 3 nissan leaf inverter connector

File:Leaf-inverter-gen3-connector.png

2025-10-02T18:24:29Z

Landsi:

This image shows the pin-out of the Nissan leaf gen 3 inverter connector

Leaf stack with zombiverter

2025-02-02T21:31:00Z

Landsi: /* Wiring */ Added link to chademo zombie page

<nowiki>*</nowiki>this page is a work in progress and may not be fully accurate or up to date.

=== Setting up a leaf stack with the zombiverter VCU ===
The full leaf stack ( motor/inverter, pdm (charger, dcdc, hvjb)) can be controlled with the zombieverter VCU.

All you need is 12v+, enable, and CANbus.

''As of software release [https://github.com/damienmaguire/Stm32-vcu/releases/tag/2.20a V2.20A,] the IVT shunt used for UDC data is no longer required for precharge.''

The leaf Inverter itself can supply UDC data for precharge (set the Shunt Type = 0)
== Wiring ==
[[File:Zombi-leaf-wiringv3.jpg|thumb|568x568px]]
=== Wiring the zombiverter to the leaf harness ===
===== Pinout =====
{| class="wikitable"
! colspan="2" |Description
!Zombieverter Pin
!PDM pin
!inverter pin
|-
|
|
|
|
|
|-
| +12V
|Permanent 12v+
|56
|18
|46, 48
|-
|Gnd
|permanent 12v -
|55
|pdm case
|47, 49
|-
|Fwd signal
|Forward
|54
|
|
|-
|Rev signal
|Reverse
|53
|
|
|-
|momentary 12V
|Start signal
|52
|
|
|-
|Brake signal
|Brake Input
|49
|
|
|-
| +5V
|Throttle
|48
|
|
|-
|Throttle signal 1
|Throttle signal 1
|47
|
|
|-
|Throttle signal 2
|Throttle signal 2
|46
|
|
|-
|Throttle Gnd
|Throttle Gnd
|45
|
|
|-
|Precharge Contactor LS Switch
|Negative lead from precharge contactor
|34
|
|
|-
|Main Contactor LS Switch
|Negative lead from main contactor
|33
|
|
|-
|enable relay
|switches enable relay
|32
|16
|42
|-
|Neg Contactor LS Switch
|Negative lead from negative contactor
|31
|
|
|-
|CANEXTH
|Can 1 High
|28
|27
|14
|-
|CANEXTL
|Can 1 Low
|27
|11
|15
|-
|T15
|Ignition 12V in
|15
|
|
|-
|proximity pilot
|pp for charge port
|
|29
|
|-
|control pilot
|cp for charge port
|
|30
|
|}

[[File:Leaf inverter pinout.jpg|left|thumb|735x735px|leaf inverter connector ]]
[[File:PDM PINOUT.png|thumb|737x737px]]

[[File:Zombie 56 connector.jpg|center|thumb|999x999px]]

[[Chademo with Zombieverter|Chademo to Zombiverter:]]

Details can be found on a [[Chademo with Zombieverter|dedicated page.]] 
chademo connector:

HV contactor coil + pin 2 to GP 12v input

HV contactor coil - pin 10

pin 1 to ground

CAN H pin 8 to CAN EXT 3 H

CAN L pin 9 to CAN EXT 3 L

pin 4 to GP out

Zombieverter programing

2025-02-02T11:59:46Z

Landsi: /* Software update */ added hint about external board power option during flashing

>Use this bootloader: https://github.com/jsphuebner/stm32-CANBootloader

'''GD variant:'''

''Status as of November 20 2021''

''Early boards fitted with the GigaDevices '''GD32F107''' aka "GD chip" require different firmware routines than '''STM32F107''' equipped boards. See this [https://openinverter.org/forum/viewtopic.php?p=33758#p33758 Zombieverter VCU Support Thread forum post]''

''The GigaDevices `[https://www.gigadevice.com/products/microcontrollers/gd32/arm-cortex-m3/connectivity-line/gd32f107-series/ GD32F107] was chosen as an alternative to the ST equivalent due to microchip shortages during the COVID-19 pandemic. A specific branch of firmware code for the GD32F107 variant is found here: https://github.com/damienmaguire/Stm32-vcu/tree/GD_Zombie However development of this variant was abandoned shortly after it's release.''

''As of this writing , The [https://github.com/damienmaguire/Stm32-vcu/tree/GD_Zombie GD_Zombie] branch has fallen behind and substantially diverged from the primary code base. It has been suggested that work needs to be done to make the present firmware chip agnostic via detection routines. See this [https://openinverter.org/forum/viewtopic.php?p=34220#p34220 Zombieverter Development Thread forum post]. As of this writing that work has yet to be undertaken and remains to be organized and completed. And issue has be devoted to tracking this progress here: [https://github.com/damienmaguire/Stm32-vcu/issues/21 Issue #21]''

Here is a link to a post with a pre compiled bin and hex for the GD_Zombie created by Damien on the 23/11/21; [https://openinverter.org/forum/viewtopic.php?p=34264#p34264 ZombieVerter VCU Support - Page 9 - openinverter forum] This is based on the 16/6/21 code it is '''not''' an update. Ensure you rename the binaries to stm32_vcu.xxx to ensure no wifi issues.

''UPDATE November 23 2021''

''Updated information about the necessary edits to make to the STM32 based firmware have been posted in a [https://openinverter.org/forum/viewtopic.php?p=34264#p34264 forum post here.] In order to get the firmware to compile and run on the '''GD32F107''' you must make the following changes:''

''In the file "'''anain.cpp'''" @ line 68:''

''<code>68 - // adc_start_conversion_regular(ADC1); // Comment out for GD MCU</code>In the file'' ''"'''stm32_can.cpp'''" @ starting at line 305 modify as follows :''

''<code>305 - gpio_set_mode(GPIO_BANK_CAN2_RE_RX, GPIO_MODE_INPUT, GPIO_CNF_INPUT_PULL_UPDOWN, GPIO_CAN2_RE_RX);</code>''

''<code>306 - gpio_set(GPIO_BANK_CAN2_RE_RX, GPIO_CAN2_RE_RX);</code>''

''<code>307 - // Configure CAN pin: TX.-</code>''

''<code>308 - gpio_set_mode(GPIO_BANK_CAN2_RE_TX, GPIO_MODE_OUTPUT_50_MHZ, GPIO_CNF_OUTPUT_ALTFN_PUSHPULL, GPIO_CAN2_RE_TX);</code>''

If you properly clone the repository with '''git''' on the command line that looks like this;

<code>git clone --recurse-submodules git@github.com:damienmaguire/Stm32-vcu.git</code>

That recursively pulls in copies of '''''libopeninv''''', etc and tracks them... Hence your file-path should look like

<code>./Stm32-vcu/libopeninv/src/</code>

within the '''''libopeninv''''' src (source) directory you will find '''''anain.cpp''''' and '''''stm32_can.cpp'''''

Make the above changes to these files for the '''GigaDevices GD32F107'''.
==Software update==
As supplied, both the ESP8266 (the wifi plug-in board) and the STM32 (main MPU) are pre-loaded.

The "UART Update" field on the GUI can be given a '''stm32_vcu.bin''' file to update the firmware. Note that at this time, loading via Windows 10 is suspect and may lock you out of the board. Ubuntu works best.

'''Unless you have a specific reason not to, end users should use a released version from: https://github.com/damienmaguire/Stm32-vcu/releases'''.

By using the ST-Link V2 in-circuit loader, '''.hex''' files can be sent to the board to initialize a fresh STM32 MCU, or if it can't be loaded via the bootloader.

'''Unless you have a specific reason not to, end users should use a released version from: https://github.com/damienmaguire/Stm32-vcu/releases'''.

The connections needed to use the ST-Link loader are shown below (the red wire provides power to the chip. If the vcu is powered by it’s 12v pins instead, the red wire can be omitted):[[File:0B35D4F9-BA64-46E7-A570-A0CE1D619D63.jpg|none|thumb]]
===Initializing an ISA Shunt===
Under Comms in the web interface, there is now an ISAMode option. By default its in "Normal" (Off on Rev 2). If you want to initialize a new shunt, connect it up, power on the shunt and vcu, select "Init" (On on Rev 2), hit save parameters to flash. Power cycle the vcu and shunt at same time (they should be on same 12v feed anyway). The shunt will initialize. Select ISAMode "normal" (Off on Rev 2), save to flash again and reboot again. The shunt should now be up and running. If the shunt doesn't initialise correctly, separate the shunt and VCU supplies and power cycle the VCU two or three seconds after the shunt power is cycled. This has fixed an initialise issue for a number of ISA shunts and possibly requires a VCU code fix that delays the initialising for a few seconds to allow the shunt to power up.

ZombieVerter VCU

2025-02-02T11:52:28Z

Landsi: Front outlander drive unit is also supported - edited

[[File:Zombie model.png|thumb|614x614px|Zombiverter VCU board]]
==== An open-source EV conversion VCU (vehicle control unit) for controlling salvaged EV components! ====
* '''[https://openinverter.org/forum/viewtopic.php?f=3&t=1277 Development thread]'''
* [https://github.com/damienmaguire/Stm32-vcu/releases '''latest stable software release''']
* '''[https://github.com/damienmaguire/Stm32-vcu github repo]'''
* '''[https://www.evbmw.com/index.php/evbmw-webshop/vcu-boards/zombieverter-vcu-built fully built VCU boards]'''
* '''[https://www.evbmw.com/index.php/evbmw-webshop/vcu-boards/zombie-vcu partially-built VCU boards]'''
==Introduction ==
Modern EV conversion projects often look to reuse salvaged parts from OEM vehicles, such as the motors, batteries and chargers.

The issue is that each part, and manufacture, use different methods of control and communication. Even when the methods of control are decoded, you are left with having to develop some sort of VCU to run the devices. These devices often talk different "languages", such as CANBUS, LINBUS, sync serial, PWM, etc

Instead of making custom boards for every device that's been decoded, why not just make a general purpose VCU (vehicle control unit) with lots of different types of inputs and outputs?

introducing: the "Zombieverter" VCU

'''''a general purpose EV conversion VCU.'''''

With a large array of inputs/outputs, control logic, and a web interface for configuration and data logging. The Zombieverter is a powerful, flexible and customizable VCU well suited for EV conversions. its also an open source project!

==== The Zombieverter supports popular salvaged EV parts such as: ====

* Nissan leaf motor, PDM/OBC, and batteries
* Mitsubishi outlander hybrid front & rear drive unit, and OBC (on board charger)
* Lexus gs450H and gs300H hybrid gearbox's
* chademo and ccs fast charging
* and more!

==== The Zombieverter features the following: ====

==== hardware: ====

* on board WIFI
* 3x High side PWM drivers
* 5x low side outputs
* 3x input pins (pull to ground only)
* 3x CANbus interfaces
* Linbus
* sync serial interface
* OBD-II interface
* etc

==== Software: ====

* web based user interface
* contactor control
* charger control
* charge timer
* motor(inverter) control
* heater control
* water pump control
* coolant fan control
* throttle mapping
* motor regen
* cruise control(?)
* BMS limits
* IVT shunt initialization
* data logging and graphing
* etc
=== Currently supported OEM hardware: ===
<nowiki>*</nowiki>this list is always growing and changing, not everything is fully tested and verified
* [[Nissan leaf motors|Nissan Leaf Gen1/2/3 inverter/motor via CAN]]
* Nissan Leaf Gen2(and 3?) PDM (Charger and DCDC)
*[[BMW I3 Fast Charging LIM Module|CCS DC fast charge via BMW i3 LIM]] - type 2 + type 1
* [[Chademo with Zombieverter|Chademo dc fast charging]]
* [[Lexus GS450h Drivetrain|Lexus GS450h inverter / gearbox via sync serial]]
* Lexus GS300h inverter/ gearbox via sync serial
* Toyota Prius/Yaris/Auris Gen 3 inverters via sync serial
* 1998-2005 BMW 3-series (E46) CAN support
* 1996-2003 BMW 5-series (E39) CAN support
* 2001-2008 BMW 7-series (E65) CAN Support
* BMW E9x CAN support
* Mid-2000s VAG CAN support
* subaru CAN support
*[[Chevrolet Volt Water Heater|Opel Ampera / Chevy Volt 6.5kw cabin heater]]
*[[:Category:Mitsubishi|Mitsubishi outlander motors/inverter]]
*[https://citini.com/product/evs-charge-port-controller/ EVS-Charge Port Controller]
*Foccci ccs faster charger controller
*VAG/VW PTC water heater via lin
*VAG/VW cabin heater via lin
*Mitsubishi outlander OBC (charger/dcdc)
*and more

== Assembling the VCU ==
Looking to build a Zombieverter VCU your self or the kit is missing hardware?

* [[Zombiverter hardware]] page for additional build instructions

* [https://github.com/damienmaguire/Stm32-vcu github with PCB, schematic, pinouts, etc]

''the enclosure and header are required if you did not order a [https://www.evbmw.com/index.php/evbmw-webshop/vcu-boards/zombieverter-vcu-built '''fully built board''']''

VCU boards from the webshop, '''''come pre-programed''''' and '''do not require any additional septs taken to work'''.

for programming a blank board see: [[zombiverter programing]]
===The enclosure kit options:===

# [https://www.aliexpress.com/item/32857771975.html?spm=a2g0s.9042311.0.0.39f24c4dWOmGPE Enclosure Kit with Header, connector and pins]<ref>https://www.aliexpress.com/item/32857771975.html?spm=a2g0s.9042311.0.0.39f24c4dWOmGPE (Backup: [https://web.archive.org/web/20220524004318/https://www.aliexpress.com/item/32857771975.html Web Archive])</ref>
#[https://www.aliexpress.com/item/32822692950.html Connector and pins]<ref>https://de.aliexpress.com/item/32822692950.html (Backup: [https://web.archive.org/web/20221119203700/https://www.aliexpress.us/item/2251832636378198.html?gatewayAdapt=glo2usa4itemAdapt&_randl_shipto=US Web Archive])</ref>
#[https://www.aliexpress.com/item/1005003512474442.html Prewired connector] <ref>https://www.aliexpress.com/item/1005003512474442.html (Backup: [http://web.archive.org/web/20221120105651/https://www.aliexpress.us/item/3256803326159690.html?gatewayAdapt=glo2usa4itemAdapt&_randl_shipto=US Web Archive])</ref>

The original connectors are from aptiv (delphi):

* [https://www.aptiv.com/en/solutions/connection-systems/catalog/item?id=13669859_en aptive 56pin connector]
* [https://www.aptiv.com/en/solutions/connection-systems/catalog/item?id=33511394_en aptive 56pin header]
* [https://www.tti.com/content/ttiinc/en/apps/part-detail.html?partsNumber=210S048&mfgShortname=FCA&productId=161404611 Removal tool for connector terminals: Manufacturer: Aptiv (formerly Delphi)] Part Number: 210S048

=== videos on assembly, powering up, updating, etc: ===
https://www.youtube.com/watch?v=geZuIbGHh30&list=PLh-aHjjWGgLVCsAqaCL6_jmn_QqhVlRiG

https://www.youtube.com/watch?v=_JRa_uFyVkY&list=PLh-aHjjWGgLUWaetAmShkv6gmvk7vLaHd

== Wiring ==
[[File:Zombie 56 connector.jpg|thumb|512x512px|zombieverter pinout from https://github.com/damienmaguire/Stm32-vcu/blob/master/Hardware/Zombie/ZombieVerter_V1%20-%20Schematic.pdf]][[File:ZombieVerter VCU V1 cable side pinout2.jpg|thumb|alt=|VCU pinout diagram |513x513px]]each device requires different wiring setups, settings and power requirements.

<nowiki>*</nowiki>cross referencing OEM wiring diagrams is highly recommended

'''wiring the zombieverter with:'''

* [[GS450H with zombieverter]]
* [[Leaf stack with zombiverter]]
* [[Tesla SDU with Zombieverter]]

=== Power wiring: ===
The Zombieverter requires permanent 12v.

This is so that it can mange charging, timers, and monitor systems when the car is at rest.

The average draw, at idle, is 150 mA.

* pin 55 to 12v- ground
* pin 56 to 12v+ positive

The Zombieverter controls power/ "ignition" signals to other devices (inverters, chargers, and dcdc converters) when required. This is done by triggering a external 12v relay. '''''Low-side switching'', meaning that it pulls to ground.'''

* pin 32 to ground pin on a 12v relay
* relay positive pin to 12v+
* 1 of the relays switch pin to 12v+

This effectively provides a switched 12v supply, controlled by the Zombieverter.

Used to switch "enable" mode to devices via :

* Leaf inverter enable pin
* Leaf PDM enable pin
* Mitsubisihi OBC enable pin

=== Contactor wiring: ===
The Zombieveter manages the Negative, Positive and PreCharge contactors in a ev conversion.

This is done based off a series of voltage measurements (UDC), this voltage value (UDC) can be supplied from a variety of sources:

* ISA IVT shunt
* nissan leaf inverter
* bmw SBOX
* etc

''with out a proper UDC measurement, the zombieverter '''will fail precharge and never go into run mode.'''''

'''The contactor control pins on the Zombieverter are ''low-side switching'', meaning that they pull to ground.'''

The positive leads from the contactors need to be connected to 12v+ and the ground leads to:

* pin 31 for the negative contactor
* pin 33 for the positive contactor
* pin 34 for the pre-charge contactor

=== Throttle pedal wiring: ===
The Zombieverter supports dual-channel throttle, this redundancy is for safety incase one channel fails or drops out. Its highly recommended to use dual channel throttle.

single channel is an option.

Connect the following to the Zombieverter pins:

* pin 45 to throttle grounds
* pin 46 to throttle channel 2
* pin 47 to throttle channel 1
* pin 48 to throttle positives

=== Start, Run, and Direction wiring: ===
The zombieverter requires 2 inputs to get into "drive" mode. '''These pins need to be ''pulled high'' (connected to 12v +)'''

* pin 15 to "on" switched input (key switched to "on")
* pin 52 to "start" momentary input (momentary key switched "ignition")

==== Forward and Reverse: ====
These pins need to be ''pulled high'' (connected to 12v +)

* pin 53 reverse
* pin 54 forward

=== Input/output pins: ===
The Zombieverter has a number of selectable input/output pins that can be used for a number of functions. These pins are:

Low side Outputs.

*GP Out 3
*GP Out 2
* Neg Contactor switch/GP Out 1
*Trans SL1- (If not using the GS450H)
*TransSL2- (If not using the GS450H)

'''*Low side output connect to ground when activated.'''

The low side outputs in Zombie are ideal for switching relays, such as for coolant pumps.

High side PWM.

*PWM 3
*PWM 2
*PWM 1
*Pump PWM - Limited to GS450 Oil pump pwm or tacho pwm output

These are high side 12v outputs, usually for controlling gauges or auxiliary items than need a pwm signals.

'''*not suitable for controlling relays.'''

Ground Input pins

These pins pull down to ground only. '''Do not connect any voltage to these pins.'''

PB1

PB2

PB3

=== Pin functions: ===
''Note: While the web interface will allow you to select input pins or output pins, some will not actually work.''

''example: a input switch wired but set to negContactor''
*ChaDemoAIw - '''OUTPUT''' - activates when Chademo charger handshake initiates
*OBCEnable - '''OUTPUT''': activates as part of the ExtCharger module
*HeaterEnable - '''OUTPUT''': activates only in run mode and when coolant pump is on*
*RunIndication - '''OUTPUT''': activates when zombie is in run mode
* WarnIndication - '''OUTPUT:''' activates when a error occurs with the zombieverter
*CoolantPump - '''OUTPUT''': activates during precharge, usually used for coolant pumps
*NegContactor - '''OUTPUT''': activates when the negative contactor needs to be closed. ie precharge, run, charge mode, etc
*BrakeLight - '''OUTPUT''': activates when a set brake light on threshold value is met
*ReverseLight - '''OUTPUT''': activates when reverse direction is selected
*CoolingFan - '''OUTPUT''': activates when FanTemp setpoint is reached
*HVActive - '''OUTPUT''': activates when contactors are closed and VCU is in run or charge mode
*BrakeVacPump '''DIGITAL OUTPUT''': activates when BrakeVacSensor threshold value is met
*CpSpoof - '''PWM OUTPUT''': used to spoof CP signal to OBC when using a charging interface such as FOCCCI or I3LIM
*GS450Hpump - '''PWM OUTPUT''': used to run GS450H oil pump
*HeatReq - '''DIGITAL INPUT'''
*HVRequest - '''DIGITAL INPUT''' - starts precharge cycle and puts VCU into charge mode
*ProxPilot - '''ANALOGUE INPUT''' - detects when charge cable is plugged in
*BrakeVacSensor - '''ANALOGUE INPUT''' - vacuum sensor input, use for triggering BrakeVacPump '''DIGITAL OUTPUT'''
*PWMTim3 -

==== Proximity Pilot====
This analogue input used to detect a charging cable is plugged in.
[[File:ZombiePP.png|none|thumb]]
A resistor to the 5v needs to be connected to the analogue in pin, 330 ohms in the spec, and R5 needs to be another resistor between analogue in pin and ground. Type 1 connectors should be a 2.7k ohm resistor and type 2 should be 4.7k ohm. Note the charging port may already have this resistor installed.

Open up the Zombie UI and choose ProxPilot for the function of the analogue in pin. Then start plotting PPVal and then plug in, you can then use this to select your PPThreshold. Bare in mind the resistance will vary on the cable plugged in depending on the Amps it can supply.

https://www.youtube.com/watch?v=U3c4V8vMb6k Video here for the setup and demonstration.

== Initial start-up and testing ==

=== powering up and connecting to the web interface: ===

'''The following is required:'''

# fully built Zombieverter VCU
# 2 wires for power
# 12v power supply
# computer/ tablet for accessing the web interface

'''How to access the web interface:'''

# provide stable 12v power to pins 55, 56 on the zombieverter
# the on-board LED light "acty" should be now flashing
# using your computer, connect to the zombieverters WIFI access point. '''SSID: "inverter" or "zom_vcu"'''
# '''password is: inverter123'''
# in a web browser navigate to: '''192.168.4.1'''
# the openinverter web interface should now load!

'''NOTE:''' Recent units have a new wifi module that isn't automatically assigning an IP via DHCP. See [https://openinverter.org/forum/viewtopic.php?f=5&t=2001 this thread] for details, and if you can help resolve the issue. Until then, you need to manually assign an IP of 192.168.4.2 (anything other than 192.168.4.1 on the 192.168.4.0/24 subnet) to your device.

===Configuration:===
<nowiki>*</nowiki>work in progress*

[[Zombieverter Parameters and Spot Values|full list and overview of Zombieverter Parameters and Spot Values]]

==== basic parameters and spot values: ====

==== throttle: ====
You should see values '''pot''' change as the pedal is pressed.

* '''potmin''' should be set just above where your off-throttle position is
* '''potmax''' just below the value seen at maximum travel
* Same for '''pot2min''' and '''pot2max'''

The resulting in a 0-100 '''potnom''' value.

* '''throtmin''' is the minimum (most negative) allowed '''''potnom''''' at all times
* '''throtmax''' is the maximum (most positive) allowed '''''potnom''''' request in forward
* '''throtramp''' is how much '''potnom''' ramps up with the pedal pushed ('''potnom''' change per %/10ms)
* '''throtramprpm''' stops applying '''throtramp''' above a set motor rpm
* '''revlim''' is a rev limiter

==== Contactors: ====
A set HV battery voltage value is required to run the precharge and main contactors.

The voltage is measured using the UDC value. which is supplied from the '''shuntType:'''

* '''ISA'''
* '''SBOX'''
* '''VAG'''
* '''LEAF'''

these voltage(UDC) levels are set with the following parameters:

* '''udcmin''' is the minimum battery voltage derate
* '''udclim''' is maximum battery voltage derate
* '''udcsw''' is Voltage point at which precharge is considered finished, and the main contactor will close.

'''forward/reverse:'''

input options:

* '''switch'''
* '''button'''
* '''switchReversed'''
* '''buttomReversed'''

==== inverter: ====

==== charger: ====

----
* Apply the '''Start''' 12V signal for a short time. The pre-charge relay should turn on, and the voltage available at the inverter and the U1 input of the ISA shunt should quickly rise. If the '''udc''' reading goes above '''udcsw''' within 5 seconds then the main contactor(s) should close. If all is well, '''invstat''' should now be "on", '''opmode''' should be "run".

''If you do not see a good value at udc, it may be that your external shunt is not connected properly or is not initialised.''

''If you do not see a good value at Invudc, it may be that the inverter is not powered, or the communication signals are not correctly wired.''

''if the status stays at "PRECHARGE" then you possibly didn't hold the start signal on for long enough!''

==Software==

<nowiki>*</nowiki>VCU boards from the webshop, '''''come pre-programed''''' and '''do not require any additional septs taken to work'''.

for programming a blank board see: [[zombiverter programing]]
==== Initializing an ISA Shunt: ====

# wire the ISA shunt to 12v+ and canbus input.
# under shunt can in the web interface, select the canbus the shunt is connected to
# hit save parameters to flash.
# Under Comms in the web interface, select ISAMode option. By default its set to "Normal" (Off)
# select "Init"
# hit save parameters to flash
# Power cycle the vcu and shunt at same time (they should be on same 12v feed anyway).
# The shunt will initialize.
# Select ISAMode "normal"
# save to flash again
# reboot the VCU

The shunt should now be up and running.

If the shunt doesn't initialize correctly, separate the shunt and VCU power supply, and power cycle the VCU two or three seconds after the shunt power is cycled. This has fixed an initialize issue for a number of ISA shunts.

== Parameters ==
[[Zombieverter Parameters and Spot Values|page with zombieverter parameters and their value ranges, ZV pinmap etc.]]

Source: https://www.youtube.com/watch?v=wjlucUWX_lc

==Troubleshooting ==

===Serial Connection===
If you're having trouble connecting using the serial interface, note that the parameters are 115200 8-N-2, which is different from the conventional 115200 8-N-1.

=== Recovering the Zombieverter from a failed update ===
if the zombieverter fails in the middle of a software update and the Web User Interface is reporting "firmware: null" it's possible you'll need to re-flash the firmware, and bootloader via an STLink.

# Firstly, download the bootloader and latest zombieverter firmware from here <ref>https://github.com/damienmaguire/Stm32-vcu/releases/</ref> and here <ref>https://github.com/jsphuebner/tumanako-inverter-fw-bootloader/releases</ref> as .hex files, this ensures you don't need to know the address of the file and avoids user error when flashing via STLink (I used a cheap STLink v2 clone without issue but it seems there is a mix of experiences with them).
# Download STMCubeProgrammer (other STM flashing softwares are available but the following instructions are based on what has worked for me).
# Upgrade the firmware on your STLink dongle using STMCubeProgrammer (I'm not sure if this is 100% necessary but seems prudent).
# Connect the Clock (SWclk), Gnd and Data (SWDio) of your STLink to the Zombieverter test points (near to the STM32 chip, they are labelled C, G, D) as well as 12V and Gnd to the Zombieverter main power pins and ensure your STMCubeprogrammer is able to connect to it, I also disconnected the wifi board just incase.
# Perform a "full chip erase", then reflash the latest bootloader and firmware hex files.
# Remove your STLink from the zombieverter, connect the wifi board and check connectivity.
# Begin Zombieverter-ing.

==References==
<references />
[[Category:Inverter]]
[[Category:VCU]]
[[Category:ZombieVerter]]