Home

Awesome

IBS-Sensor-Library

Hella IBS 200 X Lead-Battery Sensor (Gen 1) via LIN Bus (Local Interconnect Network)

A IBS 200X sensors overserves the charge and health state of a Lead-Battery. Data can be read out via LIN Interface, and this can easily be done with this library.

You can provide a LIN Interface object to the IBS Sensor object, wich is used to read and write on the bus. Therefore you can plug additional physical sensors on the LIN Line and accordingly link additional devices on the software side to the LIN Interface.

dependencies

The LIN Interface utilizes a Hardware Serial (UART) of an ESP32. To make the code reusable, I provided a separate Library: https://github.com/mestrode/Lin-Interface-Library

I've used a TJA1020 Transceiver on hardware side. The chip contains a statemachine, which needs to be controlled before you will be able to read or write data. To keep things easy, I created a derived class which consider the statemachine every time using the bus: https://github.com/mestrode/Lin-Transceiver-Library

example

This small example utilizes the hardware serial (UART) number 2 of an ESP32.

// LIN Bus Interface provided viy TJA1020
#include "TJA1020.hpp"
// IBS Batterie Sensor
#include "IBS_Sensor.hpp"

#define LIN_SERIAL_SPEED LIN_BAUDRATE_IBS_SENSOR /* Required by IBS Sensor */
#define lin_NSLP_Pin 32

// utilize the TJA1020 by using UART2 for writing and reading Frames
Lin_TJA1020 LinBus(2, LIN_SERIAL_SPEED, lin_NSLP_Pin); // UART_nr, Baudrate, /SLP

// Hella IBS 200x "Sensor 2"
IBS_Sensor BatSensor(2);

void setup()
{
    // tell the BatSensor object which LinBus to be used
    BatSensor.LinBus = &LinBus;
}

void showSensorData() {
    // read data from sensor (method request data by using several
    // Lin-Frames)
    BatSensor.readFrames();

    // may you using a Bus-Transceiver which should go to sleep after 
    // transmission (depends on your HW)
    LinBus.setMode(LinBus.Sleep);

    // use received data
    Serial.printf("Calibration done: %d &\n",
                               BatSensor.CalibrationDone);
    Serial.printf("Voltage: %.3f Volt\n", BatSensor.Ubat);
    Serial.printf("Current: %.3f Ampere\n", BatSensor.Ibat);
    Serial.printf("State of Charge: %.1f %\n", BatSensor.SOC);
    Serial.printf("State of Health: %.1f &\n", BatSensor.SOH);
    Serial.printf("Available Capacity: %.1f &\n", BatSensor.Cap_Available);
}

There are mode data provided by the sensor, than shown in this small example.

limitations

The manufacturer says the sensor will need aperiod of ~3h without current goint in or out of the battery to be calibratet (see CalibrationDone flag).

Not all Bytes and Frames are known to be interpreted, yet. But it's enough to use the sensor in an unrestricted way.

E.g. the main panel writes a configuration frame whose function is not known. But I decided to do configuration thinks like the mfg does.

Consider the Cap_Available tells you the theoretical available capacity. But the technology of lead batterys is limited, so you can use only ~50% of the labled capacity. Deeper discharge will damage the battery further.

configuration of sensor

May you want to configure the sensor once to your specific battery. Do not configure your sensor on every startup. This is also not needed, cause the data is stored in the sensor. Actually you will only need to configure the sensor once, until you changed your battery physically (with different properties).

    // configure sensor and provide Battery Type (AGM) and labeled capacity in Ah
    BatSensor.writeConfiguration(BatSensor.BAT_TYPE_AGM, 180);

This will write three configuration Frames. The function for two of them is known. Anyway, I decided to write also the third, unknown frame since the original panel does this, too.

hardware

Productside of manufacturer

Outdated links (Webarchive?)

In the meanwhile there is a second generation available.

Pinning of connector

Connector Housing (2 pin MCON-1.2 LL type)

The connector housing has coding A. If the mirrored version is available, it is recommended to use it. If the mirrored version is not available, you can consider using a cutter.If available, try the mirrored version, if not available, try a cutter.

Single crimp pin

For single crimp pins compatible with the MCON-1.2 LL type connector, you can use:

Single wire seal

A suitable single wire seal, especially for small wires, can be:

Safety

Please ensure safety by following the user's manual provided by the manufacturer. Additionally, it is advisable to include a fuse between the battery's positive pole and the 12V pin of the sensor for added protection.

See Also

This library was created with contributions and additional information from various sources. Special thanks to the contributors!