updated manual and readme

Updated manual to v2.20
SmartEVSE · Feb 11, 2021 · 76c2ad9 · 76c2ad9
1 parent a36f3db
commit 76c2ad9
Show file tree

Hide file tree

Showing 15 changed files with 199 additions and 457 deletions.
diff --git a/README.md b/README.md
@@ -1,12 +1,193 @@
-SmartEVSE v2
+SmartEVSE
 =========
 
-Version 2 uses a PIC 18F26K22 microcontroller, Graphic 128x64 LCD.
-for compiling, MPLAB X IDE is used together with the XC8 compiler.
+Smart Electric Vehicle Charge Controller
 
-set XC8 linker memory model settings to: double 32 bit, float 32 bit
-    extended instruction set is not used on XC8
-
-- SmartEVSE2.X folder contains the sourcecode for the PIC microcontroller
-- eagle folder holds the pcb layouts (eagle 6.6)
-- manual folder has the latest manual.
+![Image of SmartEVSE](/pictures/SmartEVSEv2.jpg)
+
+# What is it?
+
+It's a open source EVSE (Electric Vehicle Supply Equipment). It supports 1-3 phase charging, fixed charging cable or charging socket. Locking actuator support (3 different types). And it can directly drive a mains contactor for supplying power to the EV. It features a display from which all module parameters can be configured.<br>
+Up to 8 modules can be connected together to charge up to eight EV's from one mains connection without overloading it.<br>
+The mains connection can be monitored by the (optional) sensorbox or a modbus kWh meter. This allows smart charging.
+Communication between the SmartEVSE(s) / Sensorbox or kWh meters is done over RS485(modbus).
+
+The project consists of two parts:
+- Smart EVSE controller
+- Sensorbox
+
+# Features
+
+- Fits into a standard DIN rail enclosure.
+- Measures the current consumption of other appliances, and automatically lowers or increases the charging current to the EV. (sensorbox required)
+- The load balancing feature let's you connect up to 8 SmartEVSE's to one mains supply.
+- Switched 230VAC output, for contactor/relay.
+- Powered RS485 communication bus for sensorbox / Modbus kWh Meters.
+- Can be used with fixed cable, or socket and charging cable.
+- Automatically selects current capacity of the connected cable (13/16/32A)
+- Locking actuator support, locks the charging cable in the socket, automatically unlocks on a power failure.
+- RFID reader support, restrict the use of the charging station to max 20 RFID cards.
+- An optional modbus kWh meter will measure power and charged energy, and display this on the LCD.
+- Built-in temperature sensor.
+- All module parameters can be configured using the display and buttons.
+- Setup can also be done through serial CLI.
+- Firmware upgradable through serial bootloader. 
+
+New V2.20 features are:
+- Added EVMETER and EVADR option to the menu. Use a modbus kWh meter to measure the charged energy.
+- Added charged energy to the LCD (Smart/Solar mode)
+- Uses condensed characters on the LCD, so the 'i' will not use the same space as the 'w'
+- Increased the nr of nodes to 7.
+- Added RFID reader option. Learn up to 20 RFID cards.
+
+# The Sensorbox
+
+The Sensorbox should be placed where the Mains connection enters the building. Usually just after the kWh meter, this way it will be able to measure the total current per phase and send this information to the SmartEVSE.
+
+In order to measure the current, Current transformers are used. Clip them around the L1,L2 and L3 wires, and plug the other end into the sensorbox.
+
+![Image of Sensorbox](/pictures/sensorbox.jpg)
+
+# Configuring the SmartEVSE
+
+The SmartEVSE has a display, which shows the charging status, and if smart mode is used, also the measured current per phase.
+It is possible to configure all settings using the built-in menu.
+
+Three buttons below the display are used for navigating the menu.
+
+Hold the center button for 2 seconds to enter the menu.
+You can now use the left and right buttons to go to the different menu options. 
+
+Pressing the center button, selects the option, and allows you change the value (for example change the charging current)
+
+![Image of Menu](/pictures/SmartEVSEv2_mode_smart.jpg)
+
+# Building the EVSE
+
+In order to build a complete EVSE (charging station)
+you will need:
+
+- SmartEVSE.
+- 4 pole NO Contactor rated for the max charging current. (for example Hager ESC440 or ISKRA IKA432-40)
+- Fixed charging cable or socket with locking solenoid.
+- Enclosure with DIN rail. 
+- Terminal blocks (Wago TOPJOB S)
+
+The EVSE needs to be protected with a circuit breaker and residual-current circuit breaker, usually located near or in the distribution board.
+
+# Purchase the SmartEVSE
+
+You can buy a complete assembled SmartEVSEv2 [here](http://www.stegen.com/en/ev-products/66-smart-evse-controller.html)<br>
+Information on how to compile and setup the controller can be found on the [smartevse.nl](http://www.smartevse.nl) website.
+
+**The assembled SmartEVSE v2 modules come pre-programmed with the latest firmware (v2.20), and are fully tested!**
+
+# Predefined electric meters
+
+- Sensorbox (1)
+- PHOENIX CONTACT EEM-350-D-MCB (2)
+- Finder 7E.78.8.400.0212 (3)
+- Eastron SDM630 (4)
+- ABB B23 212-100 (5)
+- Custom (6)
+
+# Modbus
+
+Baudrate is 9600bps 8N1 (8bit, no parity bit, one stop bit).
+All registers are 16 bit unsigned integers.
+Address depends on the Load Balancing configuration:
+
+Load Balancing | Modbus Address
+--- | ---
+Disabled | 0x00
+Master | 0x01
+Node 1 | 0x02
+Node 2 | 0x03
+... | ...
+
+Broadcast to all SmartEVSE with address 0x09.
+
+## Register for internal SmartEVSE communication
+
+### Register 0x000*: Broadcast Chargecurrent or Error
+
+Register | Access | Description | Unit | Values
+--- | --- | --- | --- | ---
+0x01 | W | Broadcast ChargeCurrent | 0.1 A | Charge Current (0 A = no current available)
+0x02 | W | Broadcast Error | Bit | 1:LESS_6A / 2:NO_COMM / 4:TEMP_HIGH / 8:NO_CURRENT / 16:RCD / 32:NO_SUN
+
+Register 0x01 is written to every 2 seconds by the Master, and holds the Charge Current per Node EVSE. A total of 4 words (8 bytes) are written, One word per EVSE(0-3).<br>
+Register 0x02 is written to only if an error occurred.<br>
+Use function code 0x10 (Preset Multiple Registers), and broadcast address 0x09 to use this feature.<br>
+
+### Register 0x008*: Ack State change
+
+Register | Access | Description | Unit | Values
+--- | --- | --- | --- | ---
+0x0082 | W | Ack State A->B | 0.1 A | Charge Current (0 A = no current available)
+0x0083 | W | Ack State B->C | 0.1 A | Charge Current (0 A = no current available)
+
+Register 0x82 and 0x83 are written by the Master to tell the Node that it recognised a state change request.<br>
+If ok, the value of the register contains the initial chargecurrent (usually 6.0 A)<br>
+Use function code 0x06 (Preset Single Register) to write to these registers.<br>
+
+## Register for external devices
+
+### Register 0x00A*: Current state
+
+Register | Access | Description | Unit | Values
+--- | --- | --- | --- | ---
+0x00A0 | R/W | State | | A-D (EVSE State), E-H (A-D Waiting for Balance Master)
+0x00A1 | R/W | Error | Bit | 1:LESS_6A / 2:NO_COMM / 4:TEMP_HIGH / 8:Unused / 16:RCD / 32:NO_SUN
+0x00A2 | R | Maximum charging current | A |
+0x00A3 | R | Minimum charging current | A |
+0x00A4 | R | Number of used phases (Not implemented) | | 0:Undetected / 1 - 3
+0x00A5 | R | Real charging current (Not implemented) | 0.1 A |
+0x00A6 | R/W | Charging current | 0.1 A | 6 - 80
+0x00A7 | R/W | Access bit | | 0:No Access / 1:Access
+0x00A8 | R/W | EVSE mode (without saving) | | 0:Normal / 1:Smart / 2:Solar
+
+### Register 0x00C*: Individual configuration
+
+Register | Access | Description | Unit | Values
+--- | --- | --- | --- | ---
+0x00C0 | R/W | Configuration | | 0:Socket / 1:Fixed Cable
+0x00C1 | R/W | Load Balance (Also address of the device ) | | 0:Disabled / 1:Master / 2-4:Node
+0x00C2 | R/W | MIN Charge Current the EV will accept | A | 6 - 16
+0x00C3 | R/W | MAX Charge Current for this EVSE | A | 6 - 80
+0x00C4 | R/W | Cable lock | | 0:Disable / 1:Solenoid / 2:Motor
+0x00C5 | R/W | Surplus energy start Current | A | 1 - 16
+0x00C6 | R/W | Stop solar charging at 6A after this time | min | 0:Disable / 1 - 60
+0x00C7 | R/W | External Switch on pin SW | | 0:Disabled / 1:Access Push-Button / 2:Access Switch / 3:Smart-Solar Push-Button / 4:Smart-Solar Switch
+0x00C8 | R/W | Residual Current Monitor on pin RCM | | 0:Disabled / 1:Enabled
+0x00C9 | R/W | Allow grid power when solar charging | A | 0 - 6
+0x00CA | R/W | Use RFID reader | | 0:Disabled / 1:Enabled
+0x00CB | R/W | Type of EV electric meter | | *
+0x00CC | R/W | Address of EV electric meter | | 10 - 247
+
+### Register 0x00E*: System configuration (same on all Load Balancing SmartEVSE)
+
+Register | Access | Description | Unit | Values
+--- | --- | --- | --- | ---
+0x00E0 | R/W | EVSE Circuit max Current | A | 10 - 160
+0x00E1 | R/W | EVSE mode | | 0:Normal / 1:Smart / 2:Solar
+0x00E2 | R/W | Max Mains Current | A | 10 - 200
+0x00E3 | R/W | CT calibration value | 0.01 | Multiplier
+0x00E4 | R/W | Type of Mains electric meter | | *
+0x00E5 | R/W | Address of Mains electric meter | | 10 - 247
+0x00E6 | R/W | What does Mains electric meter measure | | 0:Mains (Home+EVSE+PV) / 1:Home+EVSE
+0x00E7 | R/W | Type of PV electric meter | | *
+0x00E8 | R/W | Address of PV electric meter | | 10 - 247
+0x00E9 | R/W | Byte order of custom electric meter | | 0:LBF & LWF / 1:LBF &  HWF / 2:HBF & LWF / 3:HBF & HWF
+0x00EA | R/W | Register for Current (A) of custom electric meter | | 0 - 65530
+0x00EB | R/W | Divisor for Current (A) of custom electric meter | 10<sup>x</sup> | 0 - 7
+0x00EC | R/W | Register for Voltage (V) of custom electric meter | | 0 - 65530
+0x00ED | R/W | Divisor for Voltage (V) of custom electric meter | 10<sup>x</sup> | 0 - 7
+0x00EE | R/W | Register for Power (W) of custom electric meter | | 0 - 65534
+0x00EF | R/W | Divisor for Power (W) of custom electric meter | 10<sup>x</sup> | 0 - 7 /
+0x00F0 | R/W | Register for Energy (kWh) of custom electric meter | | 0 - 65534
+0x00F1 | R/W | Divisor for Energy (kWh) of custom electric meter | 10<sup>x</sup> | 0 - 7
+0x00F2 | R/W | Grid type to which the Sensorbox is connected | | 0:4Wire / 1:3Wire
+0x00F3 | R/W | Data type of custom electric meter | | 0:Integer / 1:Double
+
+ * Number in brackets in section "Predefined electric meters"
diff --git a/SmartEVSE2.X/EVSE.c b/SmartEVSE2.X/EVSE.c
@@ -636,20 +636,20 @@ void BlinkLed(void) {
         if (LedUpdate) {
             if (Error & (RCD_TRIPPED | CT_NOCOMM) ) {
                 LedCount += 20;                                                 // Very rapid flashing, RCD tripped or no Serial Communication.
-                if (LedCount > 128) LedPwm = 255;                               // LED 50% of time on, full brightness
+                if (LedCount > 128) LedPwm = ERROR_LED_BRIGHTNESS;              // LED 50% of time on, full brightness
                 else LedPwm = 0;
             } else {                                                            // Waiting for Solar power or enough current to start charging
                 LedCount += 2;                                                  // Slow blinking.
-                if (LedCount > 230) LedPwm = 255;                               // LED 10% of time on, full brightness
+                if (LedCount > 230) LedPwm = WAITING_LED_BRIGHTNESS;            // LED 10% of time on, full brightness
                 else LedPwm = 0;
             }
 
             LedUpdate = 0;
           }
     } else if (Access_bit == 0) LedPwm = 0;                                     // No Access, LED off
-    else if (State == STATE_A) LedPwm = 40;                                     // STATE A, LED on (dimmed)
+    else if (State == STATE_A) LedPwm = STATE_A_LED_BRIGHTNESS;                 // STATE A, LED on (dimmed)
     else if (State == STATE_B) {
-        LedPwm = 255;                                                           // STATE B, LED on (full brightness)
+        LedPwm = STATE_B_LED_BRIGHTNESS;                                        // STATE B, LED on (full brightness)
         LedCount = 128;                                                         // When switching to STATE C, start at full brightness
     } else if (State == STATE_C && LedUpdate)                                   // STATE C, LED fades in/out
     {

diff --git a/SmartEVSE2.X/EVSE.h b/SmartEVSE2.X/EVSE.h
@@ -132,6 +132,11 @@
 #define Test_IO 64
 #define BL_FLASH 128
 
+#define STATE_A_LED_BRIGHTNESS 40
+#define STATE_B_LED_BRIGHTNESS 255
+#define ERROR_LED_BRIGHTNESS 255
+#define WAITING_LED_BRIGHTNESS 255
+
 #define SOLENOID_LOCK   {LATAbits.LATA4 = 1;LATAbits.LATA5 = 0;}
 #define SOLENOID_UNLOCK {LATAbits.LATA4 = 0;LATAbits.LATA5 = 1;}
 #define SOLENOID_OFF    {LATAbits.LATA4 = 1;LATAbits.LATA5 = 1;}                // both outputs 12V