r701/README.md

R701 🕰️

A reverse-engineered library to communicate with the R701 by I.P.S. Informatica, written in Rust

If you want to read about this reverse engineering attempt, check out https://nicolabelluti.me/series/attendance-reader/.

Library Usage

1. Add the library to you project:

   cargo add r701 --git https://git.nicolabelluti.me/nicolabelluti/r701.git
   

2. Use the library in you project:

   This library is async and built on tokio; add it to your own [dependencies] (e.g. tokio = { version = "1", features = ["rt-multi-thread", "macros"] }) to run the example below.

   use r701::R701;
   use tokio_stream::StreamExt;
   
   #[tokio::main]
   async fn main() {
       let mut r701 = R701::connect("127.0.0.1:5005").await.unwrap();
   
       let records = r701
           .into_record_iter()
           .await
           .unwrap()
           .collect::<Vec<_>>()
           .await;
   
       println!("No\tMchn\tEnNo\t\tName\t\tMode\tIOMd\tDateTime\t");
       for (id, record) in records.iter().rev().enumerate() {
           let record = record.as_ref().unwrap();
           let name = r701
               .get_name(record.employee_id)
               .await
               .unwrap()
               .unwrap_or(format!("user #{}", record.employee_id));
   
           println!(
               "{:0>6}\t{}\t{:0>9}\t{: <10}\t{}\t{}\t{}",
               id + 1,
               1,
               record.employee_id,
               name,
               35,
               record.clock as u8,
               record.datetime.format("%Y/%m/%d  %H:%M:%S"),
           );
       }
   }