Arduino Code Snippets for Raw Sensor Communication with Sensirion Liquid Flow Sensors
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
example_00_measurement_LD20
example_01_simple_measurement
example_02_set_resolution
example_03_read_scalefactor_and_unit
example_04_read_product_details
example_05_crc_checksum
example_10_calibration_field
example_11_read_temperature_voltage
example_12_twos_complement
example_13_DIY_flow_meter
AUTHORS
LICENSE
README.md

README.md

Sample Code for Arduino

Summary

The Arduino Platform allows for easy prototyping with endless possibilities. In order to enable our customers to use this platform, we provide sample code for use with Sensiron AG's liquid flow sensors. This application note describes the examples, as well as the main code components used in the examples. It is meant as a starting point for setting up communication with the liquid flow sensors through the I2C interface.

Compatibility

The sample snippets are generally compatible with Sensirion's digital flow sensor portfolio. More specifically:

SLG, SLI, SLS, SLQ-QTxxx, LG16-xxxxD, LS32 and LPG10 series sensors.

Exception: Example_00_Measurement_LD20 only works with the LD20 series sensors based on Sensirion's SF06 chips.

Introduction

This sample code library is aimed at customers who have successfully set up their Arduino and connected their Sensirion liquid flow sensor. Please see the Arduino Quick Start Guide for help in setting up your Arduino and liquid flow sensor. Sensirion provides code examples showcasing the most important use cases of I2C communication with our liquid flow sensors.

Code Examples

Number & Name Description
00 Simple measurement (LD20 only) Reads simple measurement data from the
LD20 sensor series (SF06 flow chip).
01 Simple Measurement Reads simple measurement data from the
sensor.
02 Set Resolution Reads measurement data from the sensor and
changes the resolution.
03 Read Scale Factor and Unit Reads the scale factor and measurement unit
information from the sensor's EEPROM.
04 Read Product Details Reads the product details (serial number and product name).
05 CRC Checksum Reads flow measurement data from the sensor
and calculates the checksum of the
communication for error detection.
10 Calibration Field Describes the necessary steps to change the
calibration field settings.
11 Read Temperature Voltage Demonstrates how to read temperature and
voltage data.
12 Two's Complement Demonstrates how to use the signed datatype
interpretation directly and how to calculate
the two's complement manually.
13 DIY Flow Meter Expands on example 3 to build a stand-alone
flow meter using a graphic LCD.

Prerequisites

In order to initiate the serial communication, Serial.begin(9600) should be used to set the baud rate to 9600. The code examples require the use of the "Wire"-library. This Arduino library contains all the relevant functions for the communication between your Arduino and the I2C device. The provided code examples are all based on this library and typically use the following functions:

Functions Description
Wire.begin() Join I2C bus (address optional for
master).
Wire.beginTransmission(ADDRESS) Initiate a transmission transaction
with the device at ADDRESS
over I2C.
Wire.write(value) Queues bytes for transmission from
master to slave.
Wire.endTransmission() Commit the transmission transaction:
start, send data, stop.
Wire.requestFrom(ADDRESS, LEN) Master requests data (LEN bytes)
from slave at ADDRESS and
store to buffer.
Wire.available() Retrieve the length of the I2C buffer.
Wire.read() Read data from the I2C buffer.

For further details, please refer to Arduino's official Wire Documentation.

Sensor Commands

The following table shows the commands that are typically used for I2C communication. The commands need to be transmitted through the Wire.write(Value) function that is part of Arduino's Wire library for I2C communication.

Command Value Description See Example(s)
USER_REG_W 0xE2 Write user register 10, 11
USER_REG_R 0xE3 Read user register 10, 11
ADV_USER_REG_W 0xE4 Write advanced user register 2
ADV_USER_REG_R 0xE5 Read advanced user register 2
READ_ONLY_REG2_R 0xE9 Read-only register 2 4
TRIGGER_FLOW_MEASUREMENT 0xF1 Trigger a flow measurement All
TRIGGER_TEMP_MEASUREMENT 0xF3 Trigger a temperature measurement 11
TRIGGER_VDD_MEASUREMENT 0xF5 Trigger a supply voltage measurement 11
EEPROM_R 0xFA Read EEPROM 3, 4, 13
SOFT_RESET 0xFE Soft reset All

Two's Complement

The two's complement is a binary number representation. This notation is widely used in computer science to represent both positive and negative integer numbers. To get the two's complement notation of a negative integer, first write the absolute value of that integer in binary representation b = bin(abs(x)). Then invert the binary bit sequence b (i.e. change every 1 into a 0 and every 0 into a 1). Finally, increment the number represented by b by one. Note that all negative numbers will thus carry a 1 in their highest bit.

Example: Represent -5 in 8bit

  1. binary representation of absolute value: b = bin(abs(-5)) -> 0000 0101
  2. invert: b = xor(b, 1111 1111) -> 1111 1010
  3. Increment by one: b = b + 1 -> 1111 1011