OTApp Core Framework

Main OpenThread Application Framework integrating CoAP communication, service discovery, and hardware management. More...

Topics
	Core Definitions & Init
	Core types, global configuration macros, and framework initialization routines.
	Shared Buffer Management
	Thread-safe shared buffer management for the OpenThread Application Framework.
	CoAP Server Core
	Core CoAP infrastructure for request handling, response generation, and resource management.
	CoAP Resource Handlers
	Callback functions handling incoming CoAP requests for specific URI paths.
	CoAP Observe Registry
	Manages the list of remote subscribers (observers) for local resources.
	Dataset Management
	Pre-configured Operational Dataset TLVs for initializing the Thread network.
	Device Naming
	Handles generation and parsing of unique device identifiers for discovery and pairing.
	DNS Service Discovery
	Handles network service browsing, hostname resolution, and initiates the device pairing sequence.
	main API for OpenThread hardware application
	Main API for OpenThread hardware application device driver.
	TLV Message Buffer
	TLV (Type-Length-Value) message serialization/deserialization API.
	Device Pairing
	Manages the list of discovered devices, pairing logic, and URI resource parsing.
	SRP Client Wrapper
	Manages Service Registration Protocol (SRP) for network discoverability.
	NVS Storage Port
	Abstraction layer for persistent data storage (Flash/EEPROM).
	OpenThread Port
	Abstraction layer unifying access to the OpenThread instance across different platforms.
	RTOS Port
	Unified inclusion of FreeRTOS headers for different platforms.

Detailed Description

Main OpenThread Application Framework integrating CoAP communication, service discovery, and hardware management.

This module serves as a comprehensive middleware for IoT devices based on OpenThread. It aggregates all mechanisms necessary for Thread network operation, providing an abstraction layer over the raw OpenThread API and hardware drivers.

Below is a complete breakdown of the modules comprising the framework.

---

1. Core & Infrastructure

Fundamental modules responsible for initialization, data types, and memory management.

• Application Core (ot_app.h)
  • Main initialization loop (otapp_init).
  • Device type definitions (otapp_deviceType_t).
  • Global configuration macros.
• Shared Buffer Manager (ot_app_buffer.h)
  • Statically allocated shared memory (Zero-Copy).
  • Mutex protection against Race Conditions.
• TLV Serializer (ot_app_msg_tlv.h)
  • Lightweight data packing engine (Type-Length-Value) for binary payloads.

---

2. CoAP Communication Stack

CoAP server implementation, request handling, and notifications.

• CoAP Server Engine (ot_app_coap.h)
  • UDP/CoAP server initialization.
  • Response utilities (ACK, ERROR, DATA).
• Resource Handlers (ot_app_coap_uri.h)
  • Device "Business Logic".
  • Handlers for specific paths (e.g., light/on_off, pairing/service).
• Observe Registry (ot_app_coap_uri_obs.h)
  • Subscriber Registry (Server-side).
  • Tracks remote clients listening for device state changes (e.g., light switch events).

---

3. Discovery & Network Identity

Mechanisms allowing devices to find each other on the network and establish trust.

• Device Naming (ot_app_deviceName.h)
  • Unique name generation in Group_Type_EUI64 format.
  • Name parsing for group identification.
• SRP Client (ot_app_srp_client.h)
  • Advertising: Broadcasting device presence (Registration with the Border Router).
  • Lease renewal management.
• DNS Client (ot_app_dns.h)
  • Browsing: Actively searching for other services (_coap._udp) on the network.
  • Resolving hostnames to IPv6 addresses.
• Network Credentials (ot_app_dataset_tlv.h)
  • Storage for network keys (Master Key, PANID) required to join the mesh.

---

4. Pairing Logic

Decision layer managing the list of trusted devices.

• Device Pairing (ot_app_pair.h)
  • Storage of the paired devices list.
  • Rule verification (e.g., checking if a "Switch" is allowed to pair with a "Light").
  • Capabilities Exchange.

---

5. Hardware Abstraction

Interface connecting network logic with physical hardware.

• Device Driver API (ot_app_drv.h)
  • Singleton holding pointers to hardware functions (GPIO, PWM, etc.).
  • Decouples OpenThread code from HAL libraries (STM32/ESP32).

---