#sensor #power #teleinfo


A library to parse teleinfo stream from french meters

2 releases

0.1.1 Jul 20, 2022
0.1.0 Mar 2, 2020

#690 in Parser implementations

WTFPL license

918 lines

teleinfo_nom: a wannabe comprehensive teleinfo parser in nom

Build Status Crates.io


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.


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.


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.


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(&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();


~33K SLoC