View source for Adapter V2 manual

The V2 adapter is designed to make convenient for users to connect wires of e-bike/e-scooters to the VESC. Combine with Ubox V2 or Ubox single, We can easily to build an e-bike/e-scooter.

[[File:Adapter V2 real picture.jpg|300x300px]]

Size: 63 x 53 x 12.5 mm

This manual is based on Ubox V2, for the other VESCs, the conceptions are the same.
==Features==
#Horn, head light, turn light, brake & rear light, and reverse light support.
#High, middle, low, 3 level throttle support.
#Motor reverse and cruise support.
#Buzzer to prompt turn, reverse and settings.
#Support both hall brake and mechanical brake input.
#Support centered(bidirectional) throttle.
#Two / one wheel drive support.
#Power limit mode for compliant to the local regulations.

==Wiring==
[[File:Ewheel ADC adapter V2 with detail port name.jpg]]

* Mechanical brake, light, horn, reverse and cruise are actually switches, we don't need to distinguish the two wires of each switch.
* The turn left/right switch and throttle level switch, they usually has three wires,  the '''neutral''' '''wire''' is the one which can be switched on/off to  other wires, so if you are not sure the wire orders, use a multimeter to test them to find the neutral  wire first, then know what the rest two wires are.
* Usually, hand bar throttle or thumb throttle have three wires: '''black, red, green, corresponding to GND, 5V, throttle output'''.
* Users can also use these type of throttles to make ADC(analog) brake, in Adapter V2, the '''ADC brake''' signal is transferred to VESC's ADC2 pin.
* The second VESC ADC PORT is for two wheel drive config, '''if you have one wheel drive only, connect MAIN PORT  to VESC'''. 
* Adapter need a 5V and 12V power source, the 5V is get from VESC ADC port, users need to connect a 12V power source to adapter's 12V socket, for Ubox V2 connect to its FAN socket. 
* The rear and brake light, usually comes with three wires in common ground connection mode, the two lights share one GND. '''Connect the positive(anode) wire of rear light to 12V, and brake light's to Brake light+, and their negative(cathode) wire to GND.''' 
*The other lights and horn are low side switched, so connect the '''positive(anode) wire to the '12V' pin''', and the '''negative(cathode) wire to the pin with a '-' suffix'''. 
*For '''Ubox single 75V''', the extra NRF port is not available, if the cruise and reverse functions are not needed,  the TX and RX pin from the 8 pin port can connect to VESC Bluetooth by pick out the wires from the cable.
* 

== On board switch and potentiometers ==
[[File:Switch and potentiometers of adapter V2.jpg|400x400px]]

The potentiometers are '''increase clockwise''' and '''decrease counterclockwise'''.

=== Throttle and brake power supply ===
If your throttle can only accept 3.3V supply, set the ‘HALL VDD’ switch to '3.3V' side. Otherwise set it to '5V'. The ADC brake port shares this supply too.

=== Throttle potentiometers ===
Adapter V2 supports three level throttles, the High level is equal to the throttle handle in put. The middle and low is scaled from throttle handle in put according to the 'THR M' and 'THR L' potentiometer's positions. The scale range is from 0 to 100%. 

'''If you are not''' connect a three level throttle switch to adapter,  the default throttle level is '''Middle''', so adjust the 'THR M' to meet your requirement. 

=== Brake potentiometer ===
When trigger the mechanical brake, adapter V2 will assist it with regenerative brake automatically, the regenerative brake strength is according to the 'BRK' potentiometer, from 0 to 100%. 

== Mode configuring ==
Adapter V2 has 3 mode configurations: '''2/1 wheel drive mode switching,''' '''power limit mode on/off, and unidirectional / bidirectional throttle switching'''.

===Two/one wheel drive mode switching===
Hold both the right and left brake handles then power on the system, the adapter will toggle the 2/1 drive mode, after the switching, the buzzer will ring '''once for one wheel mode''', and '''twice for two wheel mode'''. Release both left and right brake.

The principle of 2 wheel drive is to copy the control signal from main ESC to the second ESC. In order to implement this function, the CAN bus connection of two ESCS need to set off, for Ubox, please refer:  [[The power button of Ubox#The click button configuration]].

===Power limit mode===
Hold both the left brake handle and the throttle handle bar, then power on the system, the adapter will toggle the power limited/unlimited mode, after the switching, the buzzer will ring '''three times''' to indicate the mode change, release the throttle and left brake.

The principle of Power limit mode is to scale the throttle handle bar's input to the L level, ignores the H, M, L state. So set the L level to meet your local regulations.

'''When power on, the buzzer will ring to prompt the power limit mode state:'''

'''Ring one time ---- Limited mode.'''

'''Ring three times ---- Unlimited mode.''' 

=== Unidirectional / centered(bidirectional) throttle switching ===
Hold both the left brake handle and the throttle handle bar, then power on the system, wait the buzzer ring '''three times, then still hold throttle and left brake 3 more seconds,''' until the buzzer '''again to ring 6 times''', release the throttle and  left brake.

The difference between unidirectional / centered(bidirectional) mode is, in unidirectional mode, the throttle output to ESC is as same as input throttle, in centered mode, if the brake not triggered, it is acting like unidirectional mode; if the brake handle is triggered, it will replace the throttle output with the brake signal from the brake input.

==Setup in VESC tool==
Before setup control logic to the VESC, we need to setup motor's FOC first. The following contents are based on VESC tool PC edition. 

For 2/1 switch-able configuration, the setup is a little more complicated. 

The Ubox has a internal 2.4G receiver, in this application, we can disable receiver, by click the button 9 times after the Ubox powered on and the button LED solid. 
=== Two wheel drive mode only ===
If you want  2 wheel drive mode only, you can config the two ESC of Ubox into CAN mode, let the control signals relay through the CAN bus. We can let the wizard to finish the input setup.

1.After Ubox power on, and button LED solid, click the button 6 times, then wait 1 second, the internal CAN bus connection is on.

2.Plug in the ADC cable only from adapter's main socket to ESCA's socket.

3.Set you throttle handle bar's H-M-L switch to H position.

4.Then use a USB cable plug into ESCA, on the VESC tool PC edition:

[[File:Setup_input.jpg|300x300px]]

[[File:Welcome_to_input_setup_wizard.jpg|300x300px]]

[[File:Multiple_vescs.jpg|300x300px]]

[[File:Choose_app.jpg|300x300px]]

[[File:Adc_mapping.jpg|alt=Adc mapping|300x300px]]

In this step, pull the throttle and the brake handles, to let the ESC learn the input signal. If you don't have handle for brake, switch the brake mode switch to 'SW' mode, then use a screw to adjust the 'BRK' potentiometer to fulfill the ADC CH2 learning.

[[File:Adc configuration.jpg|300x300px]]

[[File:Conclusion.jpg|300x300px]]

[[File:Set up adc mode.jpg|300x300px]]

Go to APP Settings->General->APP to Use, set it to '''ADC'''.

[[File:Write app configuration.jpg|300x300px]]

Click Write app configuration, to save configuration to ESC.

Finished, to check if all the controls are working correctly.

=== Two/one wheel drive switch-able ===
If you want a switch-able system, you  need to separate two ESCS from CAN bus, let them working alone. And set each of them one by one.

#After Ubox power on, and button LED solid, click the button 7 times, then wait 1 second, the internal CAN bus connection is off.
#Plug in an ADC cable from adapter's main socket to ESCA's socket.
#Plug in another ADC cable from adapter's second socket to ESCB's socket.
#Set you throttle handle bar's H-M-L switch to H position.
#Then use a USB cable plug into ESCA, setup ESCA first.
On the VESC tool PC edition:

[[File:Set up adc mode.jpg|300x300px]]

<br style="clear:both;">1.Click connect.

2.Read out APP configuration.

3.Goto APP Settings->General->APP to Use, set it to '''ADC'''.

Then

[[File:Setup adc control type.jpg|300x300px]]

<br style="clear:both;">Go to APP Settings->General->ADC->General->Control Type set it to '''Current Reverse ADC2 Brake Button'''.

Then

[[File:Setup adc mapping.jpg|300x300px]]

<br style="clear:both;">1.Goto APP Settings->General->ADC->Mapping page.

2.Set mode to '''Current Reverse ADC2 Brake Button'''.

3.Click '''Reset min and max'''.

4.Click '''RTAPP''' (real time app data).

5.In this step, pull the throttle and the brake handles, to let the ESC learn the input signal. If you don't have handle for brake, switch the brake mode switch to 'SW' mode, then use a screw to adjust the 'BRK' potentiometer to fulfill the ADC CH2 learning.

6.Click Apply.

7.Click Write app configuration, to save configuration to ESC.

[[File:Write app configuration.jpg|300x300px]]

ESCA is finished, click disconnect, connect the USB cable to ESCB, do the above config for the ESCB.

When two ESCs are finished, to check if both ESCA and ESCB are working correctly.

=== Centered throttle ===
Centered throttle setting is similar to above two modes, except we need to choose the '<nowiki/>'''Current No Reverse Brake Center'''<nowiki/>' mode instead of ''''Current Reverse ADC2 Brake Button'''<nowiki/>'.

==Concludes and explains==

# The reverse function is mapped on to the RX pin of VESC's ADC & UART socket. And the cruise function onto the TX pin. So  we suggested to '''use ADC only mode instead of ADC and UART mode'''. This is a link to illustrate the mapping of TX RX pins: https://vesc-project.com/node/600 
#Reverse or Cruise function used in escooter via ewheel ADC adapter:
##if you're using adapter v1, then the adapter is connected in ESCA's ADC&UART socket, and paralle the RX(or TX) and GND pin out for the reverse/cruise function applicaiton in the same ESCA side.  
##if you're using adapter v2, has reverse port already in adapter v2, no need any above wiring in ubox v2.  
# There are many ADC control mode in the VESC, the most flexible mode is '''Current Reverse ADC2 Brake Button,''' it supports cruise, reverse, and ADC brake, if you want a button brake, you can let the brake input connect to a button with the other pin of the button  connected to  VDD (3.3V).
#For UBox's power button click function, please refer: [[The power button of Ubox|The power button of Ubox.]] 
#On Ubox dual, the two/one wheel drive switching can also be achieved by Ubox's power button to turn on/off its internal CAN bus connection.
#For the ignite key and voltage meter of Ubox V2, please refer: [[The CAN-IN and IGNITE socket of Ubox V2|The CAN-IN and IGNITE socket of Ubox V2.]]
#

==Caution and limits==

# Since our solution is based on open source VESC, users should fully understand the risks of open source projects. This article only describes the possibility of this build method, and is not responsible for the damage and accidents caused by user themselves.
# This product is for DIY purpose, so we only offer a very limited warranty.
==FAQ==

==See also==
[[Main Page]]