localthings

Product Introduction

1. Definition: Localthings is a custom Home Assistant integration designed specifically to discover, connect, and control Samsung smart appliances directly over a local home network. Functioning as a local integration within the Home Automation ecosystem, it establishes device communication using the Open Connectivity Foundation (OCF) specification, CoAP over DTLS (Datagram Transport Layer Security) with X.509 client certificates, and HTTP interfaces for older firmware versions.
2. Core Value Proposition: Localthings exists to eliminate absolute reliance on external cloud services and internet connectivity for smart home appliance management. By leveraging direct local network routing, it ensures that smart home networks remain fully private, highly responsive, operational during internet outages, and independent of Samsung's cloud infrastructure after the initial setup handshake.

Main Features

1. Local CoAP over DTLS Communication: Localthings talks directly to each Samsung appliance on the local subnet using Constrained Application Protocol (CoAP, RFC 7252) encapsulated within an encrypted DTLS session backed by X.509 client certificates. It utilizes CoAP Observe (RFC 7641) for real-time push updates from appliances that support them, and block-wise transfer (RFC 7959) for handling large device responses without relying on cloud servers.
2. Declarative Appliance Mapping Engine: The integration uses a robust table-driven mapping architecture that translates OCF resources reported by appliances (such as oic.d.washer or specific device namespaces) into standard Home Assistant entities. With a test suite validating these tables against dozens of real-world device captures, adding new models or capabilities typically requires configuration table updates rather than fundamental protocol rewrites.
3. Multi-Interface Discovery and Setup UI: Built completely around Home Assistant's native UI config flow, Localthings automatically discovers appliance types and models via IP address input or DHCP discovery tracking. It natively handles standard OCF endpoints alongside legacy local interfaces like HTTPS on TCP port 8888 for older Samsung appliances (circa 2018–2022) requiring device tokens and pre-shared certificates.

Problems Solved

1. Pain Point: Cloud dependency, high latency, privacy vulnerabilities, and complete loss of appliance control during internet outages or cloud service deprecations associated with smart home ecosystems.
2. Target Audience: Home Assistant enthusiasts, privacy-conscious smart home users, local-first automation architects, and advanced tech hobbyists managing Samsung smart appliances.
3. Use Cases: Operating washing machines, refrigerators, air conditioners, and ovens locally while blocking internet access via firewall rules; maintaining responsive automations and energy monitoring during internet service disruptions; safeguarding household telemetry data from external cloud loggers.

Unique Advantages

1. Strengths & Limitations (Pros & Cons):
   • Pros: Complete local-first operation with zero ongoing cloud communication after initial setup; rapid push-based updates; broad device coverage spanning air conditioners, washers, dryers, and ovens; robust diagnostics sanitization ensuring user privacy when reporting capability gaps.
   • Cons: Requires initial setup via IP address (and sometimes manual credential imports or token generation on legacy TCP 8888 units); brief disconnects or Wi-Fi signal drops require local network stability; energy monitoring on specific older boards (like DA_WM_TP2_20_COMMON) depends on appliance-side reachability to Samsung servers.
2. Key Alternatives & Differentiation:
   • Official SmartThings Integration: Unlike the default Home Assistant SmartThings integration, which relies entirely on cloud-to-cloud webhooks and internet access, Localthings operates completely locally over the LAN without cloud accounts.
   • Custom SmartThings MQTT/API Bridges: While other third-party bridges require running external Docker containers or maintaining complex script configurations, Localthings functions as a native HACS custom component with integrated UI config flows and declarative state translation.

Frequently Asked Questions (FAQ)

1. Question? Does Localthings require an internet connection to control Samsung appliances after setup? Direct Answer: No. After the initial setup process—which contacts Samsung's servers once to read a public identifier—Localthings operates entirely locally over your home network and never contacts Samsung servers again, allowing full control even without internet access.
2. Question? How do I install Localthings in Home Assistant? Direct Answer: Localthings can be installed easily via HACS (Home Assistant Community Store) by searching for "Localthings" under Integrations and downloading it, or manually by copying the custom_components/localthings/ directory into your Home Assistant configuration folder and restarting the system.
3. Question? What Samsung appliances are supported by the Localthings integration? Direct Answer: Localthings supports a wide variety of Samsung smart appliances compatible with the SmartThings app, including air conditioners, refrigerators, washers, dryers, dishwashers, ovens, robot vacuums, air purifiers, and cooktops, with most 2022 and newer models working out of the box alongside select legacy units utilizing TCP port 8888.
4. Question? What should I do if an appliance's IP address changes on my home network? Direct Answer: For appliances that report their Wi-Fi MAC address, Home Assistant's DHCP discovery automatically updates the IP address. For other appliances, you can navigate to Settings > Devices & Services, select "Reconfigure" on the integration entry, and input the new IP address to preserve your entities, history, and automations.