# 27 Kaco

### Overview

This protocol is meant to be used by inverters that convert the DC power generated by the photovoltaic (PV) modules into AC power and feed this into the power grid.

<p class="callout info">This protocol handles serial communication parameters (baudrate, databits, stopbits, etc.) automatically.</p>

### Configuration

##### Kaco parameters for *Device* tab

<table border="1" id="bkmrk-parameter-type-descr-1" style="height: 526px; width: 815px;"><tbody><tr style="height: 38px;"><td class="align-center" rowspan="2" style="height: 101px; width: 97.1007px;">**Parameter**  
  
</td><td class="align-center" rowspan="2" style="height: 101px; width: 65.0521px;">**Type**  
  
</td><td class="align-center" rowspan="2" style="height: 101px; width: 340.399px;">**Description**  
  
</td><td class="align-center" rowspan="2" style="height: 101px; width: 71.0417px;">**Required  
</td><td class="align-center" rowspan="2" style="height: 101px; width: 104.08px;">**Default value**

(when not specified)

</td><td class="align-center" colspan="2" style="height: 38px; width: 131.215px;">**Range**

</td></tr><tr style="height: 63px;"><td class="align-center" style="height: 63px; width: 65.5903px;">Min

</td><td class="align-center" style="height: 63px; width: 65.625px;">Max

</td></tr><tr style="height: 35px;"><td style="height: 35px; width: 97.1007px;">name</td><td style="height: 35px; width: 65.0521px;">string </td><td style="height: 35px; width: 340.399px;">User-friendly device name</td><td style="height: 35px; width: 71.0417px;">Yes</td><td style="height: 35px; width: 104.08px;"></td><td style="height: 35px; width: 65.5903px;"> </td><td style="height: 35px; width: 65.625px;"></td></tr><tr style="height: 35px;"><td style="height: 35px; width: 97.1007px;">description</td><td style="height: 35px; width: 65.0521px;">string</td><td style="height: 35px; width: 340.399px;">Description of a device</td><td style="height: 35px; width: 71.0417px;">No</td><td style="height: 35px; width: 104.08px;"></td><td style="height: 35px; width: 65.5903px;"> </td><td style="height: 35px; width: 65.625px;"></td></tr><tr style="height: 29px;"><td style="height: 29px; width: 97.1007px;">device\_alias</td><td style="height: 29px; width: 65.0521px;">string</td><td style="height: 29px; width: 340.399px;">Alphanumeric string to identify a device</td><td style="height: 29px; width: 71.0417px;">Yes</td><td style="height: 29px; width: 104.08px;"> </td><td style="height: 29px; width: 65.5903px;"> </td><td style="height: 29px; width: 65.625px;"> </td></tr><tr style="height: 46px;"><td style="height: 46px; width: 97.1007px;">enable</td><td style="height: 46px; width: 65.0521px;">boolean</td><td style="height: 46px; width: 340.399px;">Enabling/disabling of a device</td><td style="height: 46px; width: 71.0417px;">No</td><td style="height: 46px; width: 104.08px;">1</td><td style="height: 46px; width: 65.5903px;">0</td><td style="height: 46px; width: 65.625px;">1</td></tr><tr style="height: 35px;"><td style="height: 35px; width: 97.1007px;">protocol</td><td style="height: 35px; width: 65.0521px;">string</td><td style="height: 35px; width: 340.399px;">Protocol to be used.</td><td style="height: 35px; width: 71.0417px;">Yes</td><td style="height: 35px; width: 104.08px;"> </td><td colspan="2" style="height: 35px; width: 131.215px;">Kaco

</td></tr><tr style="height: 35px;"><td style="height: 35px; width: 97.1007px;">scan\_rate\_ms</td><td style="height: 35px; width: 65.0521px;">integer</td><td style="height: 35px; width: 340.399px;">All reads and writes will be executed within the  
timeframe in miliseconds.</td><td style="height: 35px; width: 71.0417px;">No</td><td style="height: 35px; width: 104.08px;">10000</td><td colspan="2" style="height: 35px; width: 131.215px;"></td></tr><tr style="height: 48px;"><td style="height: 48px; width: 97.1007px;">poll\_delay\_ms</td><td style="height: 48px; width: 65.0521px;">integer</td><td style="height: 48px; width: 340.399px;">Minimum time delay in miliseconds to wait  
before sending any data on port.</td><td style="height: 48px; width: 71.0417px;">No</td><td style="height: 48px; width: 104.08px;">200</td><td colspan="2" style="height: 48px; width: 131.215px;"></td></tr><tr style="height: 46px;"><td style="height: 46px; width: 97.1007px;">timeout\_ms</td><td style="height: 46px; width: 65.0521px;">integer</td><td style="height: 46px; width: 340.399px;">Timeout of waiting for incoming request in miliseconds</td><td style="height: 46px; width: 71.0417px;">No</td><td style="height: 46px; width: 104.08px;">2500</td><td style="height: 46px; width: 65.5903px;">0</td><td style="height: 46px; width: 65.625px;">60000</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 97.1007px;">subid</td><td style="height: 29px; width: 65.0521px;">integer</td><td style="height: 29px; width: 340.399px;">Inverter serial number display</td><td style="height: 29px; width: 71.0417px;">No</td><td style="height: 29px; width: 104.08px;">0</td><td style="height: 29px; width: 65.5903px;"> </td><td style="height: 29px; width: 65.625px;"> </td></tr><tr style="height: 29px;"><td style="height: 29px; width: 97.1007px;">ext\_device</td><td style="height: 29px; width: 65.0521px;">boolean</td><td style="height: 29px; width: 340.399px;">0 ­- Inverter is connected directly  
1 -­ Inverter is connected via remote terminal</td><td style="height: 29px; width: 71.0417px;">No</td><td style="height: 29px; width: 104.08px;">0</td><td style="height: 29px; width: 65.5903px;">0</td><td style="height: 29px; width: 65.625px;">1</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 97.1007px;">id</td><td style="height: 29px; width: 65.0521px;">integer</td><td style="height: 29px; width: 340.399px;">Inverter serial number</td><td style="height: 29px; width: 71.0417px;">Yes</td><td style="height: 29px; width: 104.08px;"> </td><td style="height: 29px; width: 65.5903px;"> </td><td style="height: 29px; width: 65.625px;"> </td></tr><tr style="height: 29px;"><td style="width: 97.1007px; height: 29px;">device</td><td style="width: 65.0521px; height: 29px;">string</td><td style="width: 340.399px; height: 29px;">Communication port</td><td style="width: 71.0417px; height: 29px;">Yes</td><td style="width: 104.08px; height: 29px;"> </td><td style="width: 65.5903px; height: 29px;">PORT1</td><td style="width: 65.625px; height: 29px;">PORT2</td></tr></tbody></table>

##### Kaco parameters for *Signals* tab

<table border="1" id="bkmrk-parameter-descriptio-0"><tbody><tr><td>**Parameter**</td><td>**Type**</td><td>**Description**</td><td>**Required**</td><td class="align-center">**Default value**

(when not specified)

</td><td class="align-center" colspan="2">**Range**  
  
  
</td></tr><tr><td>signal\_name</td><td>string

</td><td>User-­friendly signal name

</td><td>Yes</td><td> </td><td></td><td></td></tr><tr><td>device\_alias</td><td>string

</td><td>Device alias from a Devices tab

</td><td>Yes</td><td> </td><td></td><td></td></tr><tr><td>signal\_alias</td><td>string

</td><td>Unique alphanumeric name of the signal to be used

</td><td>Yes</td><td> </td><td></td><td></td></tr><tr><td>enable</td><td>boolean

</td><td>Enabling/disabling of an individual signal

</td><td>No</td><td>1</td><td>0

</td><td>1

</td></tr><tr><td>log</td><td>integer

</td><td>Enable logging in event log

</td><td>No</td><td>0</td><td></td><td></td></tr><tr><td>number\_type</td><td>string</td><td>Type of a number (FLOAT, DOUBLE, DIGITAL, etc.)</td><td>Yes</td><td> </td><td> </td><td> </td></tr><tr><td>job\_todo</td><td>string

</td><td>Tag job as single or multiple comma separated OBIS codes

</td><td>Yes</td><td> </td><td></td><td></td></tr><tr><td>tag\_job\_todo</td><td>string</td><td>Tag sub job</td><td>Yes</td><td> </td><td> </td><td> </td></tr><tr><td>pulse\_short\_time\_ms</td><td>integer</td><td>Time interval for short output pulse to stay  
active</td><td>No</td><td> </td><td> </td><td> </td></tr><tr><td>pulse\_long\_time\_ms</td><td>integer</td><td>Time interval for long output pulse to stay active</td><td>No</td><td> </td><td> </td><td> </td></tr></tbody></table>