r701/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 r701 = R701::connect("127.0.0.1:5005").await.unwrap();
       let mut record_stream = r701.into_record_iter().await.unwrap();
       let mut id = 0;
   
       println!("No\tMchn\tEnNo\t\tName\t\tMode\tIOMd\tDateTime\t");
       while let Some(record) = record_stream.next().await {
           let record = record.unwrap();
           let name = match r701.get_name(record.employee_id).await.unwrap() {
               Some(Ok(name)) => name,
               Some(Err(error)) => String::from_utf8_lossy(error.as_bytes()).into_owned(),
               None => 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"),
           );
   
           id += 1;
       }
   }