mirror of https://github.com/lumapu/ahoy.git
Browse Source
# Conflicts: # tools/esp8266/app.cpp # tools/esp8266/hmInverters.h # tools/esp8266/hmSystem.h * added missing filespull/21/head
lumapu
2 years ago
11 changed files with 913 additions and 565 deletions
Binary file not shown.
|
After Width: | Height: | Size: 62 KiB |
|
After Width: | Height: | Size: 32 KiB |
Binary file not shown.
@ -0,0 +1,45 @@ |
|||
# Getting Started with an ESP8266 |
|||
|
|||
Wire Connections |
|||
|
|||
```ditaa |
|||
+-----------+ +-----------+ |
|||
| ESP8266 |--colour--| nRF24L01+ | |
|||
| | | | |
|||
| GND |---black--|[GND] | |
|||
| +3.3V |----red---| VCC | |
|||
| D4 |---grey---| CE | |
|||
| D8 |--purple--| CSN | |
|||
| D5 |---blue---| SCK | |
|||
| D7 |---green--| MOSI | |
|||
| D6 |---brown--| MISO | |
|||
| D3 |--yellow--| IRQ | |
|||
+-----------+ +-----------+ |
|||
``` |
|||
|
|||
 |
|||
|
|||
Fritzing diagrams & schematics |
|||
* [AhoyMiles_bb.png](./AhoyMiles_bb.png) |
|||
* [AhoyMiles_schem.png](./AhoyMiles_schem.png) |
|||
* [AhoyMiles.fzz](./AhoyMiles.fzz) |
|||
|
|||
Libraries to be installed in Arduino IDE: |
|||
* RF24 |
|||
* TimeLib |
|||
|
|||
Verify & Compile |
|||
* Connect to WiFi Network `ESP AHOY` |
|||
* Use password `esp_8266` |
|||
* Connect to Network settings |
|||
|
|||
Setup |
|||
* WiFi |
|||
* Enter SSID `mynetwork` |
|||
* Enter Password `mypassword` |
|||
* Device Host Name |
|||
* Enter Device Name `esp-ahoy` |
|||
* General |
|||
* Hoymiles Address (e.g. 114173123456) `11:41:73:12:34:56` |
|||
* [x] Reboot device after successful save |
|||
Save |
|||
@ -0,0 +1,122 @@ |
|||
#ifndef __HM_DEFINES_H__ |
|||
#define __HM_DEFINES_H__ |
|||
|
|||
#include "debug.h" |
|||
#include <cstdint> |
|||
|
|||
// units
|
|||
enum {UNIT_V = 0, UNIT_A, UNIT_W, UNIT_WH, UNIT_KWH, UNIT_HZ, UNIT_C, UNIT_PCT}; |
|||
const char* const units[] = {"V", "A", "W", "Wh", "kWh", "Hz", "°C", "%"}; |
|||
|
|||
// field types
|
|||
enum {FLD_UDC = 0, FLD_IDC, FLD_PDC, FLD_YD, FLD_YW, FLD_YT, |
|||
FLD_UAC, FLD_IAC, FLD_PAC, FLD_F, FLD_T, FLD_PCT}; |
|||
const char* const fields[] = {"U_DC", "I_DC", "P_DC", "YieldDay", "YieldWeek", "YieldTotal", |
|||
"U_AC", "I_AC", "P_AC", "Freq", "Temp", "Pct"}; |
|||
|
|||
|
|||
union serial_u { |
|||
uint64_t u64; |
|||
uint8_t b[8]; |
|||
}; |
|||
|
|||
|
|||
// CH0 is default channel (freq, ac, temp)
|
|||
enum {CH0 = 0, CH1, CH2, CH3, CH4}; |
|||
// received command ids, special command CMDFF for calculations
|
|||
enum {CMD01 = 0x01, CMD02, CMD03, CMD82 = 0x82, CMD83, CMD84, CMDFF=0xff}; |
|||
|
|||
enum {INV_TYPE_HM600 = 0, INV_TYPE_HM1200, INV_TYPE_HM400}; |
|||
const char* const invTypes[] = {"HM600", "HM1200 / HM1500", "HM400"}; |
|||
#define NUM_INVERTER_TYPES 3 |
|||
|
|||
typedef struct { |
|||
uint8_t fieldId; // field id
|
|||
uint8_t unitId; // uint id
|
|||
uint8_t ch; // channel 0 - 3
|
|||
uint8_t cmdId; // received command id
|
|||
uint8_t start; // pos of first byte in buffer
|
|||
uint8_t num; // number of bytes in buffer
|
|||
uint16_t div; // divisor
|
|||
} byteAssign_t; |
|||
|
|||
|
|||
/**
|
|||
* indices are built for the buffer starting with cmd-id in first byte |
|||
* (complete payload in buffer) |
|||
* */ |
|||
|
|||
//-------------------------------------
|
|||
// HM400 HM350?, HM300?
|
|||
//-------------------------------------
|
|||
const byteAssign_t hm400assignment[] = { |
|||
{ FLD_UDC, UNIT_V, CH1, CMD01, 3, 2, 10 }, |
|||
{ FLD_IDC, UNIT_A, CH1, CMD01, 5, 2, 100 }, |
|||
{ FLD_PDC, UNIT_W, CH1, CMD01, 7, 2, 10 }, |
|||
{ FLD_YT, UNIT_KWH, CH1, CMD01, 9, 4, 1000 }, |
|||
{ FLD_YD, UNIT_WH, CH1, CMD01, 13, 2, 1000 }, |
|||
{ FLD_UAC, UNIT_V, CH0, CMD01, 15, 2, 10 }, |
|||
{ FLD_F, UNIT_HZ, CH0, CMD82, 1, 2, 100 }, |
|||
{ FLD_PAC, UNIT_W, CH0, CMD82, 3, 2, 10 }, |
|||
{ FLD_IAC, UNIT_A, CH0, CMD82, 7, 2, 100 }, |
|||
{ FLD_T, UNIT_C, CH0, CMD82, 11, 2, 10 } |
|||
}; |
|||
#define HM400_LIST_LEN (sizeof(hm400assignment) / sizeof(byteAssign_t)) |
|||
|
|||
|
|||
//-------------------------------------
|
|||
// HM600, HM700
|
|||
//-------------------------------------
|
|||
const byteAssign_t hm600assignment[] = { |
|||
{ FLD_UDC, UNIT_V, CH1, CMD01, 3, 2, 10 }, |
|||
{ FLD_IDC, UNIT_A, CH1, CMD01, 5, 2, 100 }, |
|||
{ FLD_PDC, UNIT_W, CH1, CMD01, 7, 2, 10 }, |
|||
{ FLD_UDC, UNIT_V, CH2, CMD01, 9, 2, 10 }, |
|||
{ FLD_IDC, UNIT_A, CH2, CMD01, 11, 2, 100 }, |
|||
{ FLD_PDC, UNIT_W, CH2, CMD01, 13, 2, 10 }, |
|||
{ FLD_YW, UNIT_WH, CH0, CMD02, 1, 2, 1 }, |
|||
{ FLD_YT, UNIT_KWH, CH0, CMD02, 3, 4, 1000 }, |
|||
{ FLD_YD, UNIT_WH, CH1, CMD02, 7, 2, 1 }, |
|||
{ FLD_YD, UNIT_WH, CH2, CMD02, 9, 2, 1 }, |
|||
{ FLD_UAC, UNIT_V, CH0, CMD02, 11, 2, 10 }, |
|||
{ FLD_F, UNIT_HZ, CH0, CMD02, 13, 2, 100 }, |
|||
{ FLD_IAC, UNIT_A, CH0, CMD02, 15, 2, 10 }, |
|||
{ FLD_T, UNIT_C, CH0, CMD83, 7, 2, 10 } |
|||
}; |
|||
#define HM600_LIST_LEN (sizeof(hm600assignment) / sizeof(byteAssign_t)) |
|||
|
|||
|
|||
//-------------------------------------
|
|||
// HM1200, HM1500
|
|||
//-------------------------------------
|
|||
const byteAssign_t hm1200assignment[] = { |
|||
{ FLD_UDC, UNIT_V, CH1, CMD01, 3, 2, 10 }, |
|||
{ FLD_IDC, UNIT_A, CH1, CMD01, 5, 2, 100 }, |
|||
{ FLD_PDC, UNIT_W, CH1, CMD01, 9, 2, 10 }, |
|||
{ FLD_YD, UNIT_WH, CH1, CMD02, 5, 2, 1 }, |
|||
{ FLD_YT, UNIT_KWH, CH1, CMD01, 13, 4, 1000 }, |
|||
{ FLD_UDC, UNIT_V, CH2, CMD02, 9, 2, 10 }, |
|||
{ FLD_IDC, UNIT_A, CH2, CMD01, 7, 2, 100 }, |
|||
{ FLD_PDC, UNIT_W, CH2, CMD01, 11, 2, 10 }, |
|||
{ FLD_YD, UNIT_WH, CH2, CMD02, 7, 2, 1 }, |
|||
{ FLD_YT, UNIT_KWH, CH2, CMD02, 1, 4, 1000 }, |
|||
{ FLD_IDC, UNIT_A, CH3, CMD02, 11, 2, 100 }, |
|||
{ FLD_PDC, UNIT_W, CH3, CMD02, 15, 2, 10 }, |
|||
{ FLD_YD, UNIT_WH, CH3, CMD03, 11, 2, 1 }, |
|||
{ FLD_YT, UNIT_KWH, CH3, CMD03, 3, 4, 1000 }, |
|||
{ FLD_IDC, UNIT_A, CH4, CMD02, 13, 2, 100 }, |
|||
{ FLD_PDC, UNIT_W, CH4, CMD03, 1, 2, 10 }, |
|||
{ FLD_YD, UNIT_WH, CH4, CMD03, 13, 2, 1 }, |
|||
{ FLD_YT, UNIT_KWH, CH4, CMD03, 7, 4, 1000 }, |
|||
{ FLD_UAC, UNIT_V, CH0, CMD03, 15, 2, 10 }, |
|||
{ FLD_IAC, UNIT_A, CH0, CMD84, 7, 2, 100 }, |
|||
{ FLD_PAC, UNIT_W, CH0, CMD84, 3, 2, 10 }, |
|||
{ FLD_F, UNIT_HZ, CH0, CMD84, 1, 2, 100 }, |
|||
{ FLD_PCT, UNIT_PCT, CH0, CMD84, 9, 2, 10 }, |
|||
{ FLD_T, UNIT_C, CH0, CMD84, 11, 2, 10 } |
|||
}; |
|||
#define HM1200_LIST_LEN (sizeof(hm1200assignment) / sizeof(byteAssign_t)) |
|||
|
|||
|
|||
|
|||
#endif /*__HM_DEFINES_H__*/ |
|||
@ -0,0 +1,143 @@ |
|||
#ifndef __HM_INVERTER_H__ |
|||
#define __HM_INVERTER_H__ |
|||
|
|||
#include "hmDefines.h" |
|||
|
|||
template <class RECORDTYPE=float> |
|||
class Inverter { |
|||
public: |
|||
uint8_t id; // unique id
|
|||
char name[MAX_NAME_LENGTH]; // human readable name, eg. "HM-600.1"
|
|||
uint8_t type; // integer which refers to inverter type
|
|||
byteAssign_t* assign; // type of inverter
|
|||
uint8_t listLen; // length of assignments
|
|||
serial_u serial; // serial number as on barcode
|
|||
serial_u radioId; // id converted to modbus
|
|||
uint8_t channels; // number of PV channels (1-4)
|
|||
RECORDTYPE *record; // pointer for values
|
|||
|
|||
Inverter() { |
|||
getAssignment(); |
|||
toRadioId(); |
|||
record = new RECORDTYPE[listLen]; |
|||
memset(record, 0, sizeof(RECORDTYPE) * listLen); |
|||
} |
|||
|
|||
~Inverter() { |
|||
// TODO: cleanup
|
|||
} |
|||
|
|||
uint8_t getPosByChFld(uint8_t channel, uint8_t fieldId) { |
|||
uint8_t pos = 0; |
|||
for(; pos < listLen; pos++) { |
|||
if((assign[pos].ch == channel) && (assign[pos].fieldId == fieldId)) |
|||
break; |
|||
} |
|||
return (pos >= listLen) ? 0xff : pos; |
|||
} |
|||
|
|||
const char *getFieldName(uint8_t pos) { |
|||
return fields[assign[pos].fieldId]; |
|||
} |
|||
|
|||
const char *getUnit(uint8_t pos) { |
|||
return units[assign[pos].unitId]; |
|||
} |
|||
|
|||
uint8_t getChannel(uint8_t pos) { |
|||
return assign[pos].ch; |
|||
} |
|||
|
|||
uint8_t getCmdId(uint8_t pos) { |
|||
return assign[pos].cmdId; |
|||
} |
|||
|
|||
void addValue(uint8_t pos, uint8_t buf[]) { |
|||
uint8_t ptr = assign[pos].start; |
|||
uint8_t end = ptr + assign[pos].num; |
|||
uint16_t div = assign[pos].div; |
|||
|
|||
uint32_t val = 0; |
|||
do { |
|||
val <<= 8; |
|||
val |= buf[ptr]; |
|||
} while(++ptr != end); |
|||
|
|||
record[pos] = (RECORDTYPE)(val) / (RECORDTYPE)(div); |
|||
} |
|||
|
|||
RECORDTYPE getValue(uint8_t pos) { |
|||
return record[pos]; |
|||
} |
|||
|
|||
private: |
|||
void toRadioId(void) { |
|||
radioId.u64 = 0ULL; |
|||
radioId.b[4] = serial.b[0]; |
|||
radioId.b[3] = serial.b[1]; |
|||
radioId.b[2] = serial.b[2]; |
|||
radioId.b[1] = serial.b[3]; |
|||
radioId.b[0] = 0x01; |
|||
} |
|||
|
|||
void getAssignment(void) { |
|||
if(INV_TYPE_HM600 == type) { |
|||
listLen = (uint8_t)(HM600_LIST_LEN); |
|||
assign = (byteAssign_t*)hm600assignment; |
|||
channels = 2; |
|||
} |
|||
else if(INV_TYPE_HM1200 == type) { |
|||
listLen = (uint8_t)(HM1200_LIST_LEN); |
|||
assign = (byteAssign_t*)hm1200assignment; |
|||
channels = 4; |
|||
} |
|||
else if(INV_TYPE_HM400 == type) { |
|||
listLen = (uint8_t)(HM400_LIST_LEN); |
|||
assign = (byteAssign_t*)hm400assignment; |
|||
channels = 1; |
|||
} |
|||
else { |
|||
listLen = 0; |
|||
channels = 0; |
|||
assign = NULL; |
|||
} |
|||
} |
|||
}; |
|||
|
|||
|
|||
/**
|
|||
* To calculate values which are not transmitted by the unit there is a generic |
|||
* list of functions which can be linked to the assignment. |
|||
* The special command 0xff (CMDFF) must be used. |
|||
*/ |
|||
|
|||
typedef float (*func_t)(Inverter<> *); |
|||
typedef struct { |
|||
uint8_t funcId; // unique id
|
|||
func_t func; // function pointer
|
|||
} calcFunc_t; |
|||
|
|||
static float calcYieldTotalCh0(Inverter<> *iv) { |
|||
if(NULL != iv) { |
|||
float yield[iv->channels]; |
|||
for(uint8_t i = 1; i <= iv->channels; i++) { |
|||
uint8_t pos = iv->getPosByChFld(i, FLD_YT); |
|||
//yield[i-1] = iv->getValue(iv)
|
|||
} |
|||
} |
|||
return 1.0; |
|||
} |
|||
|
|||
static float calcYieldDayCh0(Inverter<> *iv) { |
|||
return 1.0; |
|||
} |
|||
|
|||
enum {CALC_YT_CH0 = 0, CALC_YD_CH0}; |
|||
|
|||
const calcFunc_t calcFunctions[] = { |
|||
{ CALC_YT_CH0, &calcYieldTotalCh0 }, |
|||
{ CALC_YD_CH0, &calcYieldDayCh0 } |
|||
}; |
|||
|
|||
|
|||
#endif /*__HM_INVERTER_H__*/ |
|||
Loading…
Reference in new issue