teleinfo-nom

A library to parse teleinfo stream from french meters

3 unstable releases

0.2.1 May 29, 2023
0.1.1 Jul 20, 2022
0.1.0 Mar 2, 2020

#1661 in Parser implementations

23 downloads per month

WTFPL license

75KB
1K SLoC

teleinfo_nom: a wannabe comprehensive teleinfo parser in nom

[Build Status] Crates.io

Purpose

This crate aims at parsing data from a teleinfo bus from french power meters. Information for the data format is available in french for linky and older meters. This crate parses only personal customers or small business contracts (blue contract).

If you need a smaller crate you can use teleinfo-parser.

Status

The crate allows to access all field from a legacy or standard message. It includes helper functions to get values from the message like current tarif indices or return the matcing indices for legacy contract. The mode of the message is autodetected.

Todo

Getting the same info for standard messages than legacy for billing indices will need more information but could be done. Parsing of binary fields could be easily done like STGE fields in standard mode.

Usage

use std::fs::File;
extern crate teleinfo_nom;
// Could be a serial port with serialport crate
let mut stream = File::open("assets/stream_standard_raw.txt").unwrap();
let (remain, msg1) = teleinfo_nom::get_message_buf(&mut stream, "".to_string()).unwrap();
let current_indices = msg1.get_billing_indices();
let current_values = msg1.get_values(current_indices);
for (index,value) in current_values.into_iter() {
  match value {
    Some(val) => println!("store {}: {} in database", index, val),
    None => (),
  }
}
let (remain, msg2) = teleinfo_nom::get_message(&mut stream, remain).unwrap();

Dependencies

~2MB
~37K SLoC