Feature: Advanced UI

[lydiazcheng]

This PR implements

1. all use cases in Advance UI including,

• Set Display Message
• Get Display Message
• Clear a Display Message
• Show EV Driver Running / Final Total Cost During / After Charging Show EV Driver-specific Tariff Information
• Update Tariff Information During Transaction
• Configure Fallback Tariff Information & Total Cost Message (Covered by Set Variable, no need to implement)

2. a Tariff workaround which supports calculate total cost

Local tests

Use wscat to test display messages related as well as show specific tariff use cases. Use EVerest for other use cases.

Set Display Message

1. send a invalid request body contains invalid value in field “language“ from postman

{
  "message": {
    "id": 0,
    "priority": "AlwaysFront",
    "endDateTime": "2024-04-01T00:00:00.000Z",
    "message": {
        "format": "ASCII",
        "language": "sth??",
        "content": "This is a test message."
    }
  }
}

2. returns not success and the error message

{
    "success": false,
    "payload": "Language shall be specified as RFC-5646 tags, example: US English is: en-US."
}

3. send a valid set display message req without start date time
4. the start date time is auto generated in the request and charger receive it
   
5. send a response from the charger. Then if the status is accepted, citrine sends a get all display messages request to the charger.
   

Get Display Message

1. send a request from postman and received by the charger
   
2. send NotifyDisplayMessagesRequest from charger
   [2, "e328fcbf-aa7d-4057-9117-e180b184a210", "NotifyDisplayMessages", {"requestId": 1, "messageInfo":[{"id":1,"priority":"AlwaysFront","endDateTime":"2024-04-01T00:00:00.000Z","startDateTime":"2024-03-28T19:08:08.519Z","message":{"format":"ASCII","content":"This is a test message."},"display":{"name":"MonitoringCtrlr"}},{"id":2,"priority":"NormalCycle","startDateTime":"2024-03-28T19:08:08.519Z","endDateTime":"2024-04-01T00:00:00.000Z","message":{"format":"ASCII","content":"This is a test message."},"display":{"name":"MonitoringCtrlr"}}]}]
3. charger receive the response
   
4. the messages are stored in db
   

Clear a Display Message

1. send a clear request from postman and charger receive it
   
2. send a accepted response from the charger
   
3. citrine marks all active = true messages on this charger to false in db and send a get all messages req
   
   

Show EV Driver Running Total Cost During Charging

Send CostUpdatedRequest every minute

1. CostUpdatedRequest is sent every 60 seconds
   
   
   
2. cost not send in the TransactionEventResponse when use costUpdateInterval.
   

Alternative scenario: update cost when receiving TransactionEventRequest (eventType=Updated)

after receiving the transaction event, citrine calculates by all meter values of this transaction and return the total cost in response.

Show EV Driver Final Total Cost After Charging

After stop the transaction (EVDisconnected), returns the final cost.

Show EV Driver-specific Tariff Information

charger send a authorize request and then citrine set the tariff info in the response if the id token is accepted. (To simplify the test, I change the code in the handler temporarily to force id token status always to be accepted.)

Update Tariff Information During Transaction

after receiving TransactionEventRequest (eventType = Updated) , citrine should check if there is updated tariff and send it back to charger. Since we don’t have such a case, I currently just print a log here.

Create/Find/Delete Tariff

1. create new tariffs using the data endpoint and store in db
   
   
2. get tariffs using unit(KWH)
   
3. get tariff using station id (cp001)
   
4. get tariff by id (3)
   
5. delete a tariff by id (3)
   

[thanaParis]

Good start! There are some changes I'd like; see review comments.

[lydiazcheng]

Good start! There are some changes I'd like; see review comments.

Thanks a lot Thana! The feedback is very helpful! I updated the code. Pls let me know if there are any further comments.

[lydiazcheng]

Local test on partial use cases:

Update cost interval

Show specific tariff

[thanaParis]

Looks good!