Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

[#1582] CoAP endpoints in Ditto gateway #1588

Draft
wants to merge 1 commit into
base: master
Choose a base branch
from
Draft

[#1582] CoAP endpoints in Ditto gateway #1588

wants to merge 1 commit into from

Conversation

thjaeckle
Copy link
Member

Initial draft of CoAP support in Ditto gateway:

  • provides (currently unsecure, plain UDP) CoAP endpoint
  • providing equivalent CoAP resources as the HTTP resources:
    • /things, /policies, /whoami
      • and all of the existing subresources of the above, see HTTP API
    • supporting verbs: GET, PUT, POST, DELETE, PATCH, IPATCH
    • managed to re-use the complete code for the Ditto HTTP routes without the need to do an additional network "hop" to HTTP
  • providing "observe" functionality for watching changes of resources:
    • managed to use existing "Server Sent Event" functionality for getting change notifications
    • including all of the features of SSE, field selectors, extra fields, etc.
    • managed to "prolong" existing observe-sessions when client observes again after "max-age" with the same "CoAP token"
    • "unobserve" cancels the backend subscription for changes

Open TODOs:

  • configuration of all Californium CoAP related settings (e.g. max payload sizes, timeouts, etc.)
  • coaps - CoAP via DTLS and different authentication types (PSK, Certificates)
  • ensure receiving Ditto "messages" (from inbox/outbox) works via "CoAP observe"
  • cancel observe streaming sessions once 1 or 2 "observe" prolongements from a client were missed
  • ensure timeout handling works, e.g. if Ditto takes too long for a request to answer
  • check/fix threading in the added DittoCoapResourceFacade - is single threaded enough? probably not
  • register the DittoCoapServer in CoordinatedShutdown
  • resolving open TODOs in code
  • provide unit tests
  • provide system-tests testing with a CoAP client
  • add documentation

Eventually resolves: #1582

@thjaeckle thjaeckle mentioned this pull request Feb 28, 2023
Open
@thjaeckle thjaeckle force-pushed the feature/coap-endpoints branch 2 times, most recently from 11f6a3b to ada64ab Compare February 28, 2023 20:31
@thjaeckle
[#1582] initial draft of CoAP support in Ditto gateway:
d3c1c6b 
* provides (unsecure, plain UDP) CoAP endpoint
* providing equivalent CoAP resources as the HTTP resources:
   * /things, /policies, /whoami
   * supporting verbs: GET, PUT, POST, DELETE, PATCH, IPATCH
* providing "observe" functionality for watching changes of resources

Signed-off-by: Thomas Jaeckle <ditto@jaeckles.de>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers
No reviews
Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.

Provide CoAP endpoint in Ditto's gateway, providing the Ditto HTTP API via CoAP
1 participant
@thjaeckle