forked from lincomatic/open_evse
-
Notifications
You must be signed in to change notification settings - Fork 9
/
Copy pathopen_evse.h
1406 lines (1184 loc) · 41.2 KB
/
open_evse.h
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
// -*- C++ -*-
/*
* Open EVSE Firmware
*
* This file is part of Open EVSE.
* Open EVSE is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 3, or (at your option)
* any later version.
* Open EVSE is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
* You should have received a copy of the GNU General Public License
* along with Open EVSE; see the file COPYING. If not, write to the
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
// UK/EU specific settings (by OpenEnergyMonitor):
// - Disable AUTOSVCLEVEL (autodetection is designed for split-phase)
// - Charging level default to L2
// - Set MAX_CURRENT_CAPACITY_L2 32 (European Limit)
// - Add '.EU' to version number
// - Enable LCD Re-draw every couple of min (required for EMC/CE)
#pragma once
#define OPEN_EVSE
#include <avr/wdt.h>
#include <avr/pgmspace.h>
#include <avr/eeprom.h>
#include <pins_arduino.h>
#include "./Wire.h"
#include "avrstuff.h"
#include "i2caddr.h"
#if defined(ARDUINO) && (ARDUINO >= 100)
#include "Arduino.h"
#else
#include "WProgram.h" // shouldn't need this but arduino sometimes messes up and puts inside an #ifdef
#endif // ARDUINO
#define setBits(flags,bits) (flags |= (bits))
#define clrBits(flags,bits) (flags &= ~(bits))
#ifndef VERSION
#define VERSION "D7.1.3"
#endif // !VERSION
#include "Language_default.h" //Default language should always be included as bottom layer
typedef unsigned long time_t;
//Language preferences: Add your custom languagefile here. See Language_default.h for more info.
//#include "Language_norwegian.h"
//-- begin features
//#define OCPP
// support V6 hardware
#define OEV6
#ifdef OEV6
#define RELAY_PWM
#define RELAY_HOLD_DELAY_TUNING // enable Z0
#endif // OEV6
// auto detect L1/L2
//#define AUTOSVCLEVEL
// show disabled tests before POST
#define SHOW_DISABLED_TESTS
// current measurement
#define AMMETER
// Enable three-phase energy calculation
// Note: three-phase energy will always be calculated even if EV is only using singe-phase. Ony enable if always charging 3-phase EV and aware of this limitation.
//#define THREEPHASE
// charging access control - if defined, enables RAPI G4/S4 commands
// to enable/disable charging function
// if AUTH_LOCK_REG/IDX are also defined (see below), then a hardware pin is
// used to control access, rather than RAPI
// defining AUTH_LOCK enables locking functionality
// AUTH_LOCK = 1 -> default to locked, automatically lock whenever transition to state A
// AUTH_LOCK = 0 -> only locks when RAPI command sent to lock
//#define AUTH_LOCK 1
// serial remote api
#define RAPI
// RAPI over serial
#define RAPI_SERIAL
// RAPI $WF support
#define RAPI_WF
// RAPI $AN support
#define RAPI_BTN
// RAPI over I2C
//#define RAPI_I2C
// enable sending of RAPI commands
//#define RAPI_SENDER
// EVSE must call state transition function for permission to change states
//#define STATE_TRANSITION_REQ_FUNC
// enable watchdog timer
#define WATCHDOG
// auto detect ampacity by PP pin resistor
// #define PP_AUTO_AMPACITY
#ifdef PP_AUTO_AMPACITY
#define STATE_TRANSITION_REQ_FUNC
#include "AutoCurrentCapacityController.h"
extern AutoCurrentCapacityController g_ACCController;
#endif
// charge for a specified amount of time and then stop
#define TIME_LIMIT
// support Mennekes (IEC 62196) type 2 locking pin
// #define MENNEKES_LOCK
// Support for Nick Sayer's OpenEVSE II board, which has alternate hardware for ground check/stuck relay check and a voltmeter for L1/L2.
//#define OPENEVSE_2
#ifdef OPENEVSE_2
// If the AC voltage is > 150,000 mV, then it's L2. Else, L1.
#define L2_VOLTAGE_THRESHOLD (150000)
#define VOLTMETER
// 35 ms is just a bit longer than 1.5 cycles at 50 Hz
#define VOLTMETER_POLL_INTERVAL (35)
// This is just a wild guess
// #define VOLTMETER_SCALE_FACTOR (266) // original guess
//#define DEFAULT_VOLT_SCALE_FACTOR (262) // calibrated for Craig K OpenEVSE II build
#define DEFAULT_VOLT_SCALE_FACTOR (298) // calibrated for lincomatic's OEII
// #define VOLTMETER_OFFSET_FACTOR (40000) // original guess
//#define DEFAULT_VOLT_OFFSET (46800) // calibrated for Craig K OpenEVSE II build
#define DEFAULT_VOLT_OFFSET (12018) // calibrated for lincomatic's OEII
#endif // OPENEVSE_2
// GFI support
#define GFI
// If you loop a wire from the third GFI pin through the CT a few times and then to ground,
// enable this. ADVPWR must also be defined.
#define GFI_SELFTEST
// behavior specified by UL
// 1) if enabled, POST failure will cause a hard fault until power cycled.
// disabled, will retry POST continuously until it passes
// 2) if enabled, any a fault occurs immediately after charge is initiated,
// hard fault until power cycled. Otherwise, do the standard delay/retry sequence
#define UL_COMPLIANT
#ifdef UL_COMPLIANT
#define ADVPWR
#define GFI
// if enabled, do GFI self test before closing relay
#define UL_GFI_SELFTEST
#define GFI_SELFTEST
#endif //UL_COMPLIANT
#define TEMPERATURE_MONITORING // Temperature monitoring support
//#define HEARTBEAT_SUPERVISION // Heartbeat Supervision support
#ifdef AMMETER
// if OVERCURRENT_THRESHOLD is defined, then EVSE will hard fault in
// the event that the EV is pulling more current than it's allowed to
// declare overcurrent when charging amps > pilot amps + OVERCURRENT_THRESHOLD
#define OVERCURRENT_THRESHOLD 5 // A
// go to error state overcurrent by OVERCURRENT_THRESHOLD amps
// for OVERCURRENT_TIMEOUT ms
#define OVERCURRENT_TIMEOUT 5000UL // ms
// if there's no accurate voltmeter, hardcode voltages
#ifndef MV_FOR_L1
#define MV_FOR_L1 120000L // conventional for North America
#endif
#ifndef MV_FOR_L2
#define MV_FOR_L2 240000L // conventional for North America
// #define MV_FOR_L2 230000L // conventional for most of the world
#endif
// kWh Recording feature depends upon #AMMETER support
// comment out KWH_RECORDING to have the elapsed time and time of day displayed on the second line of the LCD
#define KWH_RECORDING
#ifdef KWH_RECORDING
// stop charging after a certain kWh reached
#define CHARGE_LIMIT
// update interval in ms - code assumes that current/voltage are constant
// during this interval
#define KWH_CALC_INTERVAL_MS (250UL)
#include "EnergyMeter.h"
#endif // KWH_RECORDING
#endif //AMMETER
//Adafruit RGBLCD (MCP23017) - can have RGB or monochrome backlight
#define RGBLCD
//select default LCD backlight mode. can be overridden w/CLI/RAPI
#define BKL_TYPE_MONO 0
#define BKL_TYPE_RGB 1
#define DEFAULT_LCD_BKL_TYPE BKL_TYPE_RGB
//#define DEFAULT_LCD_BKL_TYPE BKL_TYPE_MONO
// Adafruit LCD backpack in I2C mode (MCP23008)
//#define I2CLCD
// Support PCF8574* based I2C backpack using F. Malpartida's library
// https://bitbucket.org/fmalpartida/new-liquidcrystal/downloads
// *requires* I2CLCD enabled and RGBLCD disabled
//#define I2CLCD_PCF8574
#ifdef I2CLCD_PCF8574
#define I2CLCD
#undef RGBLCD
#endif // I2CLCD_PCF8574
// Advanced Powersupply... Ground check, stuck relay, L1/L2 detection.
#define ADVPWR
// valid only if ADVPWR defined - for rectified MID400 chips which block
// half cycle (for ground check on both legs)
#define SAMPLE_ACPINS
// single button menus (needs LCD enabled)
// connect an SPST-NO button between pin defined by BTN_REG/BTN_IDX and GND or enable ADAFRUIT_BTN to use the
// select button of the Adafruit RGB LCD
// How to use 1-button menu
// Long press activates menu
// When within menus, short press cycles menu items, long press selects and exits current submenu
#define BTN_MENU
// take out basic setup stuff that the user really shouldn't be changing,
// which can be set via RAPI/WiFi module.. reclaims a lot of code space
#define NOSETUP_MENU
// When not in menus, short press instantly stops the EVSE - another short press resumes. Long press activates menus
// also allows menus to be manipulated even when in State B/C
#define BTN_ENABLE_TOGGLE
#ifdef BTN_MENU
// use Adafruit RGB LCD select button
#ifdef RGBLCD
#define ADAFRUIT_BTN
#endif // RGBLCD
#endif // BTN_MENU
// Option for RTC and DelayTime
// REQUIRES HARDWARE RTC: DS1307 or DS3231 connected via I2C
#define RTC // enable RTC & timer functions
#ifdef RTC
// Option for Delay Timer - GoldServe
#define DELAYTIMER
#if defined(DELAYTIMER) && defined(BTN_MENU)
#define DELAYTIMER_MENU
#endif
#else // !RTC
// this weird error comes out if RTC not defined, due to a bug in g++
//D:\git\open_evse\firmware\open_evse\open_evse.ino: In function 'ProcessInputs'//:
//
//open_evse:2384: error: unable to find a register to spill in class 'NO_REGS'
//
// }
//
// ^
//
//open_evse:2384: error: this is the insn:
//
//(insn 884 881 887 135 (set (mem:QI (post_dec:HI (reg/f:HI 32 __SP_L__)) [0 S1// A8])
//
//// (subreg:QI (reg/f:HI 1065) 1)) C:\Users\Geek\AppData\Local\Temp\arduino_build_853681\sketch\rapi_proc.cpp:418 1 {pushqi1}
#define GPPBUGKLUDGE
#endif // RTC
#ifdef OCPP
#define AUTH_LOCK 1
#define RAPI_SERIAL
#endif // OCPP
// if defined, this pin goes HIGH when the EVSE is sleeping, and LOW otherwise
//#define SLEEP_STATUS_REG &PINB
//#define SLEEP_STATUS_IDX 4
#ifdef AUTH_LOCK
// AUTH_LOCK_REG/IDX - use an input pin to control AUTH_LOCK instead of
// manual function calls
// digital pin is configured as input with internal pull-up enabled
// EVSE is locked when input HIGH and unlocked when input LOW
//#define AUTH_LOCK_REG &PINC
//#define AUTH_LOCK_IDX 2
#endif // AUTH_LOCK
// for stability testing - shorter timeout/higher retry count
//#define GFI_TESTING
// phase and frequency correct PWM 1/8000 resolution
// when not defined, use fast PWM -> 1/250 resolution
#define PAFC_PWM
// glynhudson reports that LCD gets corrupted by EMC testing during CE
// certification.. redraw display periodically when enabled
#define PERIODIC_LCD_REFRESH_MS 120000UL
// when closing DC relay set to HIGH for m_relayCloseMs, then
// switch to m_relayHoldPwm
// ONLY WORKS PWM-CAPABLE PINS!!!
// use Arduino pin number PD5 = 5, PD6 = 6
//#define RELAY_PWM
#define DEFAULT_RELAY_CLOSE_MS 25
#define DEFAULT_RELAY_HOLD_PWM 75 // (0-255, where 0=0%, 255=100%
// enables RAPI $Z0 for tuning PWM (see rapi_proc.h for $Z0 syntax)
// PWM parameters written to/loaded from EEPROM
//#define RELAY_HOLD_DELAY_TUNING // enable Z0
//-- end features
#ifndef DEFAULT_LCD_BKL_TYPE
#define DEFAULT_LCD_BKL_TYPE BKL_TYPE_MONO
#endif
#if defined(RGBLCD) || defined(I2CLCD)
#define LCD16X2
//If LCD is not defined, undef BTN_MENU - requires LCD
#else
#undef BTN_MENU
#endif // RGBLCD || I2CLCD
#if defined(OPENEVSE_2) && !defined(ADVPWR)
#error INVALID CONFIG - OPENEVSE_2 implies/requires ADVPWR
#endif
#if defined(UL_COMPLIANT) && !defined(GFI_SELFTEST)
#error INVALID CONFIG - GFI SELF TEST NEEDED FOR UL COMPLIANCE
#endif
#if defined(GFI_SELFTEST) && !defined(GFI)
#error INVALID_CONFIG - GFI NEEDED FOR GFI SELF TEST
#endif
// for testing print various diagnostic messages to the UART
//#define SERDBG
//
// begin functional tests
//
//
// for debugging ONLY - turns off all safety checks
//#define NOCHECKS
// DO NOT USE FT_xxx. FOR FUNCTIONAL TESTING ONLY
//
// Test for GFI fault lockout
// immediately GFI fault when entering STATE C -> should hard fault
// there will be a delay of a few seconds before the fault because we
// need to loop to cause the GFI fault
// right after GFI fault generated, will flash Closing/Relay on LCD
// -> should hard GFCI fault instantly when relay closes
//#define FT_GFI_LOCKOUT
// Test for auto reclose after GFI fault. Attach EVSIM in STATE C
// 10 sec after charging starts will induce fault. 1 minute after fault
// induced, should clear the fault and resume normal operation
//#define FT_GFI_RETRY
//
// test delay between start of sleep mode and opening relay
// connect EV and put into charging state C
// relay should open after pilot goes back to state B or higher
// or after 3 sec, whichever happens first
// LCD will display SLEEP OPEN/THRESH if opened due to EV response
// or SLEEP OPEN/TIMEOUT if due to timeout
//
//#define FT_SLEEP_DELAY
//
// endurance test
// alternate state B 9 sec/state C 1 sec forever
// top line displays cycle count
// bottom line displays ac pin state
//#define FT_ENDURANCE
// just read AC pins and display on line 1
//#define FT_READ_AC_PINS
//
// end functional tests
//
//-- begin configuration
// WARNING: ALL DELAYS *MUST* BE SHORTER THAN THIS TIMER OR WE WILL GET INTO
// AN INFINITE RESET LOOP
#define WATCHDOG_TIMEOUT WDTO_2S
#define LCD_MAX_CHARS_PER_LINE 16
#define TMP_BUF_SIZE ((LCD_MAX_CHARS_PER_LINE+1)*2)
// n.b. DEFAULT_SERVICE_LEVEL is ignored if ADVPWR defined, since it's autodetected
#define DEFAULT_SERVICE_LEVEL 2 // 1=L1, 2=L2
// current capacity in amps
#define DEFAULT_CURRENT_CAPACITY_L1 12
#define DEFAULT_CURRENT_CAPACITY_L2 32
// minimum allowable current in amps
#define MIN_CURRENT_CAPACITY_J1772 6
// maximum allowable current in amps
#define MAX_CURRENT_CAPACITY_L1 16 // J1772 Max for L1 on a 20A circuit = 16, 15A circuit = 12
#define MAX_CURRENT_CAPACITY_L2 32 // J1772 Max for L2 = 80
//J1772EVSEController
#define CURRENT_PIN 0 // analog current reading pin ADCx
#define PILOT_PIN 1 // analog pilot voltage reading pin ADCx
#define PP_PIN 2 // PP_READ - ADC2
#ifdef VOLTMETER
// N.B. Note, ADC2 is already used as PP_PIN so beware of potential clashes
// voltmeter pin is ADC2 on OPENEVSE_2
#define VOLTMETER_PIN 2 // analog AC Line voltage voltmeter pin ADCx
#endif // VOLTMETER
#ifdef OPENEVSE_2
// This pin must match the last write to CHARGING_PIN, modulo a delay. If
// it is low when CHARGING_PIN is high, that's a missing ground.
// If it's high when CHARGING_PIN is low, that's a stuck relay.
// Auto L1/L2 is done with the voltmeter.
#define ACLINE1_REG &PIND // OpenEVSE II has only one AC test pin.
#define ACLINE1_IDX 3
#define CHARGING_REG &PIND // OpenEVSE II has just one relay pin.
#define CHARGING_IDX 7 // OpenEVSE II has just one relay pin.
#else // !OPENEVSE_2
// TEST PIN 1 for L1/L2, ground and stuck relay
#define ACLINE1_REG &PIND
#define ACLINE1_IDX 3
// TEST PIN 2 for L1/L2, ground and stuck relay
#define ACLINE2_REG &PIND
#define ACLINE2_IDX 4
#define V6_CHARGING_PIN 5
#define V6_CHARGING_PIN2 6
// digital Relay trigger pin
#define CHARGING_REG &PINB
#define CHARGING_IDX 0
// digital Relay trigger pin for second relay
#define CHARGING2_REG &PIND
#define CHARGING2_IDX 7
//digital Charging pin for AC relay
#define CHARGINGAC_REG &PINB
#define CHARGINGAC_IDX 1
// obsolete LED pin
//#define RED_LED_REG &PIND
//#define RED_LED_IDX 5
// obsolete LED pin
//#define GREEN_LED_REG &PINB
//#define GREEN_LED_IDX 5
#endif // OPENEVSE_2
// N.B. if PAFC_PWM is enabled, then pilot pin can be PB1 or PB2
// if using fast PWM (PAFC_PWM disabled) pilot pin *MUST* be PB2
#define PILOT_REG &PINB
#define PILOT_IDX 2
#ifdef MENNEKES_LOCK
// requires external 12V H-bridge driver such as Polulu 1451
#define MENNEKES_LOCK_STATE EVSE_STATE_B // lock in State B
//#define MENNEKES_LOCK_STATE EVSE_STATE_C // lock in State C
//D11 - MOSI
#define MENNEKES_LOCK_PINA_REG &PINB
#define MENNEKES_LOCK_PINA_IDX 3
//D12 - MISO
#define MENNEKES_LOCK_PINB_REG &PINB
#define MENNEKES_LOCK_PINB_IDX 4
#include "MennekesLock.h"
#endif // MENNEKES_LOCK
#define SERIAL_BAUD 115200
// EEPROM offsets for settings
#define EOFS_CURRENT_CAPACITY_L1 0 // 1 byte
#define EOFS_CURRENT_CAPACITY_L2 1 // 1 byte
#define EOFS_FLAGS 2 // 2 bytes
// EEPROM offsets for Delay Timer function - GoldServe
#define EOFS_TIMER_FLAGS 4 // 1 byte
#define EOFS_TIMER_START_HOUR 5 // 1 byte
#define EOFS_TIMER_START_MIN 6 // 1 byte
#define EOFS_TIMER_STOP_HOUR 7 // 1 byte
#define EOFS_TIMER_STOP_MIN 8 // 1 byte
// AMMETER stuff
#define EOFS_CURRENT_SCALE_FACTOR 9 // 2 bytes
#define EOFS_AMMETER_CURR_OFFSET 11 // 2 bytes
#define EOFS_KWH_ACCUMULATED 13 // 4 bytes
// fault counters
#define EOFS_GFI_TRIP_CNT 17 // 1 byte
#define EOFS_NOGND_TRIP_CNT 18 // 1 byte
#define EOFS_STUCK_RELAY_TRIP_CNT 19 // 1 byte
#define EOFS_VOLT_OFFSET 20 // 4 bytes
#define EOFS_VOLT_SCALE_FACTOR 24 // 2 bytes
#define EOFS_THRESH_AMBIENT 26 // 2 bytes
#define EOFS_THRESH_IR 28 // 2 bytes
// for I2C RAPI
#define EOFS_LOCAL_I2C_ADDR 30 // 1 byte
//
// for DUOSHARE
//
// for shared power pool
#define EOFS_GROUP_CURRENT_CAPACITY 31 // 1 byte
// non-volatile flags
#define EOFS_DUO_NVFLAGS 32 // 1 byte
#define EOFS_DUO_SHARED_AMPS 33 // 1 byte
//
// Reserved for HEARTBEAT_SUPERVISION (3 Bytes)
//
// Duration in seconds:
#define EOFS_HEARTBEAT_SUPERVISION_INTERVAL 34 // 2 bytes (zero if infinite)
// Fallback Current in quarter Amperes:
#define EOFS_HEARTBEAT_SUPERVISION_CURRENT 36 // 1 byte
#define EOFS_RELAY_CLOSE_MS 37 // 1 byte
#define EOFS_RELAY_HOLD_PWM 38 // 1 byte
#define EOFS_MAX_HW_CURRENT_CAPACITY 511 // 1 byte
// must stay within thresh for this time in ms before switching states
#define DELAY_STATE_TRANSITION 250
// must transition to state A from contacts closed in < 100ms according to spec
// but Leaf sometimes bounces from 3->1 so we will debounce it a little anyway
#define DELAY_STATE_TRANSITION_A 25
// for ADVPWR
#define GROUND_CHK_DELAY 1000 // delay after charging started to test, ms
#define STUCK_RELAY_DELAY 1000 // delay after charging opened to test, ms
#define RelaySettlingTime 250 // time for relay to settle in post, ms
// for SAMPLE_ACPINS - max number of ms to sample
#define AC_SAMPLE_MS 20 // 1 cycle @ 60Hz = 16.6667ms @ 50Hz = 20ms
// V6 has PD7 tied to ground
#define V6_ID_REG D
#define V6_ID_IDX 7
#ifdef GFI
#define GFI_INTERRUPT 0 // interrupt number 0 = PD2, 1 = PD3
// interrupt number 0 = PD2, 1 = PD3
#define GFI_REG &PIND
#define GFI_IDX 2
#ifdef GFI_SELFTEST
// pin is supposed to be wrapped around the GFI CT 5+ times
#define GFITEST_REG &PIND
#define GFITEST_IDX 6
// V6 GFI test pin PB0
#define V6_GFITEST_REG &PINB
#define V6_GFITEST_IDX 0
#define GFI_TEST_CYCLES 60
// GFI pulse should be 50% duty cycle
#define GFI_PULSE_ON_US 8333 // 1/2 of roughly 60 Hz.
#define GFI_PULSE_OFF_US 8334 // 1/2 of roughly 60 Hz.
#endif
#endif // GFI
#ifdef GFI_TESTING
#define GFI_TIMEOUT ((unsigned long)(15*1000))
#define GFI_RETRY_COUNT 255
#else // !GFI_TESTING
#define GFI_TIMEOUT ((unsigned long)(5*60000)) // 15*60*1000 doesn't work. go figure
// number of times to retry tests before giving up. 255 = retry indefinitely
#define GFI_RETRY_COUNT 6
#endif // GFI_TESTING
// for RGBLCD
#define RED 0x1
#define YELLOW 0x3
#define GREEN 0x2
#define BLUE 0x4
#define TEAL 0x6
#define VIOLET 0x5
#define WHITE 0x7
#if defined(RGBLCD) || defined(I2CLCD)
// Using LiquidTWI2 for both types of I2C LCD's
// see http://blog.lincomatic.com/?p=956 for installation instructions
#include "./Wire.h"
#ifdef I2CLCD_PCF8574
#include "./LiquidCrystal_I2C.h"
#define LCD_I2C_ADDR 0x27
#else
#ifdef RGBLCD
#define MCP23017 // Adafruit RGB LCD (PANELOLU2 is now supported without additional define)
#else
#define MCP23008 // Adafruit I2C Backpack
#endif
#include "./LiquidTWI2.h"
#define LCD_I2C_ADDR 0x20 // for adafruit shield or backpack
#endif // I2CLCD_PCF8574
#endif // RGBLCD || I2CLCD
// button sensing pin
#define BTN_REG &PINC
#define BTN_IDX 3
#define BTN_PRESS_SHORT 50 // ms
#define BTN_PRESS_LONG 500 // ms
#define BTN_PRESS_VERYLONG 10000
#ifdef RTC
// Default start/stop timers for un-initialized EEPROMs.
// Makes it easy to compile in default time without need to set it up the first time.
#define DEFAULT_START_HOUR 0x00 //Start time: 00:05
#define DEFAULT_START_MIN 0x05
#define DEFAULT_STOP_HOUR 0x06 //End time: 6:55
#define DEFAULT_STOP_MIN 0x37
#endif // RTC
// for J1772.ReadPilot()
// 1x = 114us 20x = 2.3ms 100x = 11.3ms
#define PILOT_LOOP_CNT 100
#ifdef AMMETER
// This multiplier is the number of milliamps per A/d converter unit.
// First, you need to select the burden resistor for the CT. You choose the largest value possible such that
// the maximum peak-to-peak voltage for the current range is 5 volts. To obtain this value, divide the maximum
// outlet current by the Te. That value is the maximum CT current RMS. You must convert that to P-P, so multiply
// by 2*sqrt(2). Divide 5 by that value and select the next lower standard resistor value. For the reference
// design, Te is 1018 and the outlet maximum is 30. 5/((30/1018)*2*sqrt(2)) = 59.995, so a 56 ohm resistor
// is called for. Call this value Rb (burden resistor).
// Next, one must use Te and Rb to determine the volts-per-amp value. Note that the readCurrent()
// method calculates the RMS value before the scaling factor, so RMS need not be taken into account.
// (1 / Te) * Rb = Rb / Te = Volts per Amp. For the reference design, that's 55.009 mV.
// Each count of the A/d converter is 4.882 mV (5/1024). V/A divided by V/unit is unit/A. For the reference
// design, that's 11.26. But we want milliamps per unit, so divide that into 1000 to get 88.7625558. Round near...
//#define DEFAULT_CURRENT_SCALE_FACTOR 106 // for RB = 47 - recommended for 30A max
//#define DEFAULT_CURRENT_SCALE_FACTOR 184 // for RB = 27 - recommended for 50A max
// Craig K, I arrived at 213 by scaling my previous multiplier of 225 down by the ratio of my panel meter reading of 28 with the OpenEVSE uncalibrated reading of 29.6
// then upped the scale factor to 220 after fixing the zero offset by subtracing 900ma
//#define DEFAULT_CURRENT_SCALE_FACTOR 220 // for RB = 22 - measured by Craig on his new OpenEVSE V3
// NOTE: setting DEFAULT_CURRENT_SCALE_FACTOR TO 0 will disable the ammeter
// until it is overridden via RAPI
//#define DEFAULT_CURRENT_SCALE_FACTOR 220 // Craig K, average of three OpenEVSE controller calibrations
#ifdef OPENEVSE_2
#define DEFAULT_CURRENT_SCALE_FACTOR 186 // OpenEVSE II with a 27 Ohm burden resistor, after a 2-point calibration at 12.5A and 50A
#else
#define DEFAULT_CURRENT_SCALE_FACTOR 220 // OpenEVSE v2.5 and v3 with a 22 Ohm burden resistor (note that the schematic may say 28 Ohms by mistake)
#endif
// subtract this from ammeter current reading to correct zero offset
#ifdef OPENEVSE_2
#define DEFAULT_AMMETER_CURRENT_OFFSET 230 // OpenEVSE II with a 27 Ohm burden resistor, after a 2-point calibration at 12.5A and 50A
#else
#define DEFAULT_AMMETER_CURRENT_OFFSET 0 // OpenEVSE v2.5 and v3 with a 22 Ohm burden resistor. Could use a more thorough calibration exercise to nails this down.
#endif
// The maximum number of milliseconds to sample an ammeter pin in order to find three zero-crossings.
// one and a half cycles at 50 Hz is 30 ms.
#define CURRENT_SAMPLE_INTERVAL 35
// Once we detect a zero-crossing, we should not look for one for another quarter cycle or so. 1/4 // cycle at 50 Hz is 5 ms.
#define CURRENT_ZERO_DEBOUNCE_INTERVAL 5
#endif // AMMETER
#ifdef TEMPERATURE_MONITORING
#define MCP9808_IS_ON_I2C // Use the MCP9808 connected to I2C
//#define TMP007_IS_ON_I2C // Use the TMP007 IR sensor on I2C
#define TEMPERATURE_DISPLAY_ALWAYS 0 // Set this flag to 1 to always show temperatures on the bottom line of the 16X2 LCD
// Set to it 0 to only display when temperatures become elevated
// #define TESTING_TEMPERATURE_OPERATION // Set this flag to play with very low sensor thresholds or to evaluate the code.
// Leave it commented out instead to run with normal temperature thresholds.
// Temperature thresholds below are expressed as 520 meaning 52.0C to save from needing floating point library
// Keep any adjustments that you make at least 2C apart, giving things some hysterisis. (example is 580 is 3C apart from 550)
// The RESTORE_AMPERAGE value must be lower than the THROTTLE_DOWN value
// The THROTTLE_DOWN value must be lower than the SHUTDOWN value
// The SHUTDOWN value must be lower than the PANIC value
#ifndef TESTING_TEMPERATURE_OPERATION
// normal oerational thresholds just below
// This is the temperature in the enclosure where we tell the car to draw 1/2 amperage.
#ifdef OPENEVSE_2
#define TEMPERATURE_AMBIENT_THROTTLE_DOWN 650
#else
#define TEMPERATURE_AMBIENT_THROTTLE_DOWN 650
#endif
// If the OpenEVSE responds nicely to the lower current drawn and temperatures in the enclosure
// recover to this level we can kick the current back up to the user's original amperage setting.
#ifdef OPENEVSE_2
#define TEMPERATURE_AMBIENT_RESTORE_AMPERAGE 620
#else
#define TEMPERATURE_AMBIENT_RESTORE_AMPERAGE 620
#endif
// This is the temperature in the enclosure where we tell the car to draw 1/4 amperage or 6A is minimum.
#ifdef OPENEVSE_2
#define TEMPERATURE_AMBIENT_SHUTDOWN 680
#else
#define TEMPERATURE_AMBIENT_SHUTDOWN 680
#endif
// At this temperature gracefully tell the EV to quit drawing any current, and leave the EVSE in
// an over temperature error state. The EVSE can be restart from the button or unplugged.
// If temperatures get to this level it is advised to open the enclosure to look for trouble.
#ifdef OPENEVSE_2
#define TEMPERATURE_AMBIENT_PANIC 710
#else
#define TEMPERATURE_AMBIENT_PANIC 710
#endif
#define TEMPERATURE_INFRARED_THROTTLE_DOWN 650 // This is the temperature seen by the IR sensor where we tell the car to draw 1/2 amperage.
#define TEMPERATURE_INFRARED_RESTORE_AMPERAGE 600 // If the OpenEVSE responds nicely to the lower current drawn and temperatures in the enclosure
// recover to this level we can kick the current back up to the user's original amperage setting.
#define TEMPERATURE_INFRARED_SHUTDOWN 700 // This is the temperature in the enclosure where we tell the car to draw 1/4 amperage or 6A is minimum.
#define TEMPERATURE_INFRARED_PANIC 750 // At this temperature gracefully tell the EV to quit drawing any current, and leave the EVSE in
// an over temperature error state. The EVSE can be restart from the button or unplugged.
// If temperatures get to this level it is advised to open the enclosure to look for trouble.
#else //TESTING_TEMPERATURE_OPERATION
// Below are good values for testing purposes at room temperature with an EV simulator and no actual high current flowing
#define TEMPERATURE_AMBIENT_THROTTLE_DOWN 290 // This is the temperature in the enclosure where we tell the car to draw 1/2 amperage.
#define TEMPERATURE_AMBIENT_RESTORE_AMPERAGE 270 // If the OpenEVSE responds nicely to the lower current drawn and temperatures in the enclosure
// recover to this level we can kick the current back up to the user's original amperage setting.
#define TEMPERATURE_AMBIENT_SHUTDOWN 310 // This is the temperature in the enclosure where we tell the car to draw 1/4 amperage or 6A is minimum.
#define TEMPERATURE_AMBIENT_PANIC 330 // At this temperature gracefully tell the EV to quit drawing any current, and leave the EVSE in
// an over temperature error state. The EVSE can be restart from the button or unplugged.
// If temperatures get to this level it is advised to open the enclosure to look for trouble.
#define TEMPERATURE_INFRARED_THROTTLE_DOWN 330 // This is the temperature seen by the IR sensor where we tell the car to draw 1/2 amperage.
#define TEMPERATURE_INFRARED_RESTORE_AMPERAGE 270 // If the OpenEVSE responds nicely to the lower current drawn and temperatures in the enclosure
// recover to this level we can kick the current back up to the user's original amperage setting.
#define TEMPERATURE_INFRARED_SHUTDOWN 360 // This is the temperature in the enclosure where we tell the car to draw 1/4 amperage or 6A is minimum.
#define TEMPERATURE_INFRARED_PANIC 400 // At this temperature gracefully tell the EV to quit drawing any current, and leave the EVSE in
// an over temperature error state. The EVSE can be restart from the button or unplugged.
// If temperatures get to this level it is advised to open the enclosure to look for trouble.
#endif // TESTING_TEMPERATURE_OPERATION
#endif // TEMPERATURE_MONITORING
// how long to show each disabled test on LCD
#define SHOW_DISABLED_DELAY 1500
//-- end configuration
typedef union union4b {
int8_t i8;
uint8_t u8;
int16_t i16;
uint16_t u16;
int32_t i32;
uint32_t u32;
unsigned u;
int i;
} UNION4B,*PUNION4B;
//-- begin class definitions
#ifdef WATCHDOG
#define WDT_RESET() wdt_reset() // pat the dog
#define WDT_ENABLE() wdt_enable(WATCHDOG_TIMEOUT)
#else
#define WDT_RESET()
#define WDT_ENABLE()
#endif // WATCHDOG
// OnboardDisplay.m_bFlags
#define OBDF_MONO_BACKLIGHT 0x01
#define OBDF_AMMETER_DIRTY 0x80
#define OBDF_UPDATE_DISABLED 0x40
// OnboardDisplay::Update()
#define OBD_UPD_NORMAL 0
#define OBD_UPD_FORCE 1 // update even if no state transition
#define OBD_UPD_HARDFAULT 2 // update w/ hard fault
class OnboardDisplay
{
#ifdef RED_LED_REG
DigitalPin pinRedLed;
#endif
#ifdef GREEN_LED_REG
DigitalPin pinGreenLed;
#endif
#if defined(RGBLCD) || defined(I2CLCD)
#ifdef I2CLCD_PCF8574
LiquidCrystal_I2C m_Lcd;
#else
LiquidTWI2 m_Lcd;
#endif // I2CLCD_PCF8574
#endif // defined(RGBLCD) || defined(I2CLCD)
uint8_t m_bFlags;
char m_strBuf[LCD_MAX_CHARS_PER_LINE+1];
unsigned long m_LastUpdateMs;
int8_t updateDisabled() { return m_bFlags & OBDF_UPDATE_DISABLED; }
void MakeChar(uint8_t n, PGM_P bytes);
public:
OnboardDisplay();
void Init();
void SetGreenLed(uint8_t state) {
#ifdef GREEN_LED_REG
pinGreenLed.write(state);
#endif
}
void SetRedLed(uint8_t state) {
#ifdef RED_LED_REG
pinRedLed.write(state);
#endif
}
#ifdef LCD16X2
void LcdBegin(int x,int y) {
#ifdef I2CLCD
#ifndef I2CLCD_PCF8574
m_Lcd.setMCPType(LTI_TYPE_MCP23008);
#endif
m_Lcd.begin(x,y);
m_Lcd.setBacklight(HIGH);
#elif defined(RGBLCD)
m_Lcd.setMCPType(LTI_TYPE_MCP23017);
m_Lcd.begin(x,y,2);
m_Lcd.setBacklight(WHITE);
#endif // I2CLCD
}
void LcdPrint(const char *s) {
m_Lcd.print(s);
}
void LcdPrint_P(PGM_P s);
void LcdPrint(int y,const char *s);
void LcdPrint_P(int y,PGM_P s);
void LcdPrint(int x,int y,const char *s);
void LcdPrint_P(int x,int y,PGM_P s);
void LcdPrint(int i) {
m_Lcd.print(i);
}
void LcdSetCursor(int x,int y) {
m_Lcd.setCursor(x,y);
}
void LcdClearLine(int y) {
m_Lcd.setCursor(0,y);
for (uint8_t i=0;i < LCD_MAX_CHARS_PER_LINE;i++) {
m_Lcd.write(' ');
}
m_Lcd.setCursor(0,y);
}
void LcdClear() {
m_Lcd.clear();
}
void LcdWrite(uint8_t data) {
m_Lcd.write(data);
}
void LcdMsg(const char *l1,const char *l2);
void LcdMsg_P(PGM_P l1,PGM_P l2);
void LcdSetBacklightType(uint8_t t,uint8_t update=OBD_UPD_FORCE) { // BKL_TYPE_XXX
#ifdef RGBLCD
if (t == BKL_TYPE_RGB) m_bFlags &= ~OBDF_MONO_BACKLIGHT;
else m_bFlags |= OBDF_MONO_BACKLIGHT;
Update(update);
#endif // RGBLCD
}
uint8_t IsLcdBacklightMono() {
#ifdef RGBLCD
return (m_bFlags & OBDF_MONO_BACKLIGHT) ? 1 : 0;
#else
return 1;
#endif // RGBLCD
}
void LcdSetBacklightColor(uint8_t c) {
#ifdef RGBLCD
if (IsLcdBacklightMono()) {
if (c) c = WHITE;
}
m_Lcd.setBacklight(c);
#endif // RGBLCD
}
#ifdef RGBLCD
uint8_t readButtons() { return m_Lcd.readButtons(); }
#endif // RGBLCD
#endif // LCD16X2
#ifdef AMMETER
void SetAmmeterDirty(uint8_t tf) {
if (tf) m_bFlags |= OBDF_AMMETER_DIRTY;
else m_bFlags &= ~OBDF_AMMETER_DIRTY;
}
int8_t AmmeterIsDirty() { return (m_bFlags & OBDF_AMMETER_DIRTY) ? 1 : 0; }
#endif // AMMETER
void DisableUpdate(int8_t on) {
if (on) m_bFlags |= OBDF_UPDATE_DISABLED;
else m_bFlags &= ~OBDF_UPDATE_DISABLED;
}
int8_t UpdatesDisabled() { return (m_bFlags & OBDF_UPDATE_DISABLED) ? 1 : 0; }
void Update(int8_t updmode=OBD_UPD_NORMAL); // OBD_UPD_xxx
};
#ifdef GFI
#include "Gfi.h"
#endif // GFI
#ifdef TEMPERATURE_MONITORING
#include "./MCP9808.h" // adding the ambient temp sensor to I2C
#include "./Adafruit_TMP007.h" // adding the TMP007 IR I2C sensor
#define TEMPERATURE_NOT_INSTALLED -2560 // fake temp to return when hardware not installed
#define TEMPMONITOR_UPDATE_INTERVAL 1000ul
// TempMonitor.m_Flags
#define TMF_OVERTEMPERATURE 0x01
#define TMF_OVERTEMPERATURE_SHUTDOWN 0x02
#define TMF_BLINK_ALARM 0x04
#define TMF_OVERTEMPERATURE_LOGGED 0x08
class TempMonitor {
uint8_t m_Flags;
unsigned long m_LastUpdate;
public:
#ifdef MCP9808_IS_ON_I2C
MCP9808 m_tempSensor;
#endif //MCP9808_IS_ON_I2C
#ifdef TMP007_IS_ON_I2C
Adafruit_TMP007 m_tmp007;
#endif //TMP007_IS_ON_I2C
#ifdef TEMPERATURE_MONITORING_NY
int16_t m_ambient_thresh;
int16_t m_ir_thresh;
int16_t m_TMP007_thresh;
#endif //TEMPERATURE_MONITORING_NY
// these three temperatures need to be signed integers
int16_t m_MCP9808_temperature; // 230 means 23.0C Using an integer to save on floating point library use
int16_t m_DS3231_temperature; // the DS3231 RTC has a built in temperature sensor
int16_t m_TMP007_temperature;
TempMonitor() {}
void Init();
void Read();
void SetBlinkAlarm(int8_t tf) {
if (tf) m_Flags |= TMF_BLINK_ALARM;
else m_Flags &= ~TMF_BLINK_ALARM;
}
int8_t BlinkAlarm() { return (m_Flags & TMF_BLINK_ALARM) ? 1 : 0; }
void SetOverTemperature(int8_t tf) {
if (tf) m_Flags |= (TMF_OVERTEMPERATURE|TMF_OVERTEMPERATURE_LOGGED);
else m_Flags &= ~TMF_OVERTEMPERATURE;
}
int8_t OverTemperature() { return (m_Flags & TMF_OVERTEMPERATURE) ? 1 : 0; }
void SetOverTemperatureShutdown(int8_t tf) {
if (tf) m_Flags |= (TMF_OVERTEMPERATURE_SHUTDOWN|TMF_OVERTEMPERATURE_LOGGED);
else m_Flags &= ~TMF_OVERTEMPERATURE_SHUTDOWN;
}
int8_t OverTemperatureShutdown() { return (m_Flags & TMF_OVERTEMPERATURE_SHUTDOWN) ? 1 : 0; }