ocpp_rs 0.2.4

# OCPP-RS

OCPP-RS is a Rust library for implementing the Open Charge Point Protocol (OCPP) in Rust.    
    
it currently supports OCPP 1.6.    

[Documentation](https://docs.rs/ocpp_rs/latest/ocpp_rs/)

- Full implementation of OCPP 1.6 Protocol
- Currently most feature complete implementation of OCPP 1.6 in rust
- Batteries included, serialization and deserialization is provided [here](https://docs.rs/ocpp_rs/latest/ocpp_rs/v16/parse/index.html)
- No_std, should work fine on embedded devices that allow heap allocation [with a global allocator](https://docs.rust-embedded.org/book/collections/#using-alloc)
- Inspired by a [python ocpp library](https://github.com/mobilityhouse/ocpp)


## Usage
In Cargo.toml, add the following dependency:
```toml
[dependencies]
ocpp-rs = "^0.2"
```

# Particularities
Since the original OCPP 1.6 protocol does not contain a type field for `CallResult`, when parsing `CallResult`lt, you need to handle
Special cases where JSON payloads are ambiguous, like empty objects like: ```{}```, these might get serialized as a `EmptyResponse` instead of the variant
you are waiting for like `GetConfiguration`.

Look at this file to see how to properly handle `CallResults`: [`example`](example/src/main.rs)

## Example
Receiving a payload from a client:
```rust
use ocpp_rs::v16::parse::{self, Message};
use ocpp_rs::v16::call::{Action, Call};

// Example incoming message
let incoming_text = "[2, \"19223201\", \"BootNotification\", { \"chargePointVendor\": \"VendorX\", \"chargePointModel\": \"SingleSocketCharger\" }]";
let incoming_message = parse::deserialize_to_message(incoming_text);
if let Ok(Message::Call(call)) = incoming_message {
    match call.payload {
        Action::BootNotification(_boot_notification) => {
            // Do something with boot_notification
        }
        _ => {
            // Handle other actions
        }
    }
}
```

Sending a payload to a client:
```rust
let response = Message::CallResult(CallResult::new(
    "1234".to_string(),
    ResultPayload::StartTransaction(call_result::StartTransaction {
        transaction_id: 0,
        id_tag_info: IdTagInfo {
            status: ocpp_rs::v16::enums::ParsedGenericStatus::Accepted,
            expiry_date: None,
            parent_id_tag: None,
        },
    }),
));

let json = parse::serialize_message(&response)?;
println!("Sending to client: {}", json);
```

## Contributing
Contributions are welcome! Common steps to contribute:
- Fork the repository and create a new branch.
- Make your changes or improvements.
- Open a pull request with a clear description.
- When adding/changing code, add/modify tests for what you have worked on. 

Help is wanted to add more tests and fuzzing tests (e.g., using OSS-Fuzz), so feel free to jump in!

## Roadmap
- OCPP 2.1 implementation is planned, no ETA, help needed.