Files
pnoker dc2164f46e fix(driver): repair boot, scheduling and registration regressions
a live-stack sweep of all 36 drivers surfaced five sdk-level defects
that left reads dead or the whole fleet unbootable:

- drop the empty spring.main stub in the shared driver profile; the
  boot 4.1 binder rejects null-valued keys and every driver died at
  startup with a bind exception
- rename the schedule enable flag to enable to match what every driver
  application.yml actually spells; with the old enabled key the read
  and custom quartz jobs were silently never scheduled
- treat proto3 zero-versions as unset when reconciling registration
  so a driver restart re-registers instead of failing the optimistic
  lock with 'driver version conflict'
- ignore the driver's own registration event that can be consumed
  before applymetadata finishes instead of logging an error
- initialize jdbc/serial connection maps eagerly: the registration
  event handler invalidates pools and nped on a lazy-null map
- ble: exclude the guava 18 pin dragged in by bluetooth-manager
- kafka: use the starter (boot 4 split autoconfigurations out of the
  bare jar) and read the compose-provided bootstrap variable
- lwm2m: pin californium to the 3.x api leshan m14 needs and
  configure an explicit coap endpoint
- mqtt: replace the orphaned spring-integration gateway with a paho
  publisher so the send path exists again
- boot sweep result: 36/36 drivers start, 0 errors
2026-09-18 09:48:19 +08:00
..
2026-05-26 00:30:11 +08:00

DC3 Driver CoAP

Overview

dc3-driver-coap is the CoAP protocol driver of the IoT DC3 platform. It uses the Eclipse Californium CoAP library to talk to CoAP devices with active request-response communication: the read path performs CoAP GET requests against a resource path and the write path performs CoAP PUT requests.

Module Information

  • Group ID: io.github.pnoker
  • Artifact ID: dc3-driver-coap
  • Driver Name: CoAP Driver

Driver Attributes (Device-level)

Attribute Description
Device Host CoAP device host address
Device Port CoAP device port (default 5683)

Point Attributes

Attribute Description
Read Path CoAP resource path for reading point data
Write Path CoAP resource path for writing point data
Content Format Content format: json, text, cbor, octet-stream

The module application.yml is authoritative for attribute codes, types, default values, scheduling, health, and local buffering. Keep this README aligned when those user-facing settings change.

Prerequisites

A reachable CoAP device (or simulator) exposing the configured resource paths. CoAP commonly uses UDP port 5683.

Running Locally

1. Start Infrastructure and Center Services

make up-db
make up-dev GROUP=core

2. Build and Run

mvn -s .mvn/settings.xml -pl dc3-driver/dc3-driver-coap -am package
java -jar dc3-driver/dc3-driver-coap/target/dc3-driver-coap.jar

Testing

Run the module tests from the repository root:

mvn -s .mvn/settings.xml -pl dc3-driver/dc3-driver-coap -am test
  • dc3-common-driver — Driver SDK for registration, scheduling, and RabbitMQ integration