pysamsung-dplug 0.1.0__tar.gz

pysamsung_dplug-0.1.0/.gitignore

@@ -0,0 +1,6 @@
+dist/
+build/
+*.egg-info/
+__pycache__/
+*.pyc
+.venv/

pysamsung_dplug-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 porech
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pysamsung_dplug-0.1.0/PKG-INFO

@@ -0,0 +1,82 @@
+Metadata-Version: 2.4
+Name: pysamsung-dplug
+Version: 0.1.0
+Summary: Async client for old Samsung air conditioners using the DPLUG/AC14K protocol (TLS, port 2878)
+Project-URL: Homepage, https://github.com/porech/pysamsung-dplug
+Project-URL: Issues, https://github.com/porech/pysamsung-dplug/issues
+Author: porech
+License: MIT
+License-File: LICENSE
+Keywords: 2878,ac14k,air conditioner,dplug,home assistant,hvac,samsung
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Home Automation
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# pysamsung-dplug
+
+Async Python client for **old Samsung air conditioners** that speak the legacy
+**DPLUG / AC14K** protocol over TLS on **port 2878** (Wi-Fi modules such as
+`SWL-B70F`, used by the AR\*\*HSFS generation, ~2013–2015).
+
+These units were dropped by SmartThings. This library lets you control them
+locally again — no cloud. It is the protocol layer used by the
+[`samsung_ac_dplug`](https://github.com/porech/samsung_ac_dplug) Home Assistant
+integration, but works standalone.
+
+## Features
+
+- Mutual-TLS handshake with the bundled Samsung client certificate (legacy
+  TLS 1.0 / weak ciphers handled for you).
+- Token acquisition (`GetToken`), authentication (`AuthToken`).
+- Read full device state (`DeviceState`) and send commands (`DeviceControl`).
+- Auto-discover the device id (`DeviceList`) and a passive `async_probe()`.
+
+## Install
+
+```bash
+pip install pysamsung-dplug
+```
+
+## Usage
+
+```python
+import asyncio
+from samsung_dplug import SamsungAcClient, build_ssl_context
+
+async def main():
+    ctx = build_ssl_context()                      # uses the bundled certificate
+    client = SamsungAcClient("192.168.1.53", token="xxxxxxxx-....", ssl_context=ctx)
+    state = await client.async_get_state()
+    print("Power:", state["AC_FUN_POWER"], "Room:", state["AC_FUN_TEMPNOW"])
+    await client.async_set("AC_FUN_POWER", "On")
+
+asyncio.run(main())
+```
+
+### Getting a token
+
+The unit only issues a token at **power-on** (a physical proof-of-access step):
+
+```python
+client = SamsungAcClient("192.168.1.53", ssl_context=ctx)
+# turn the unit OFF, call this, then turn it ON within ~30 s:
+token = await client.async_get_token()
+```
+
+> `build_ssl_context()` does blocking file I/O; inside async frameworks run it in
+> an executor (e.g. Home Assistant: `await hass.async_add_executor_job(build_ssl_context)`).
+
+## Protocol notes
+
+Reverse-engineered from the official *Smart Air Conditioner* app and live
+devices. The unit greets with `DPLUG-1.x`, requires mutual TLS, and uses an
+XML request/response protocol. The DUID equals the Wi-Fi module MAC without
+separators. See the Home Assistant integration repo for the full write-up,
+including the undocumented `APConnectionConfig` Wi-Fi provisioning command.
+
+## License
+
+MIT

pysamsung_dplug-0.1.0/README.md

@@ -0,0 +1,65 @@
+# pysamsung-dplug
+
+Async Python client for **old Samsung air conditioners** that speak the legacy
+**DPLUG / AC14K** protocol over TLS on **port 2878** (Wi-Fi modules such as
+`SWL-B70F`, used by the AR\*\*HSFS generation, ~2013–2015).
+
+These units were dropped by SmartThings. This library lets you control them
+locally again — no cloud. It is the protocol layer used by the
+[`samsung_ac_dplug`](https://github.com/porech/samsung_ac_dplug) Home Assistant
+integration, but works standalone.
+
+## Features
+
+- Mutual-TLS handshake with the bundled Samsung client certificate (legacy
+  TLS 1.0 / weak ciphers handled for you).
+- Token acquisition (`GetToken`), authentication (`AuthToken`).
+- Read full device state (`DeviceState`) and send commands (`DeviceControl`).
+- Auto-discover the device id (`DeviceList`) and a passive `async_probe()`.
+
+## Install
+
+```bash
+pip install pysamsung-dplug
+```
+
+## Usage
+
+```python
+import asyncio
+from samsung_dplug import SamsungAcClient, build_ssl_context
+
+async def main():
+    ctx = build_ssl_context()                      # uses the bundled certificate
+    client = SamsungAcClient("192.168.1.53", token="xxxxxxxx-....", ssl_context=ctx)
+    state = await client.async_get_state()
+    print("Power:", state["AC_FUN_POWER"], "Room:", state["AC_FUN_TEMPNOW"])
+    await client.async_set("AC_FUN_POWER", "On")
+
+asyncio.run(main())
+```
+
+### Getting a token
+
+The unit only issues a token at **power-on** (a physical proof-of-access step):
+
+```python
+client = SamsungAcClient("192.168.1.53", ssl_context=ctx)
+# turn the unit OFF, call this, then turn it ON within ~30 s:
+token = await client.async_get_token()
+```
+
+> `build_ssl_context()` does blocking file I/O; inside async frameworks run it in
+> an executor (e.g. Home Assistant: `await hass.async_add_executor_job(build_ssl_context)`).
+
+## Protocol notes
+
+Reverse-engineered from the official *Smart Air Conditioner* app and live
+devices. The unit greets with `DPLUG-1.x`, requires mutual TLS, and uses an
+XML request/response protocol. The DUID equals the Wi-Fi module MAC without
+separators. See the Home Assistant integration repo for the full write-up,
+including the undocumented `APConnectionConfig` Wi-Fi provisioning command.
+
+## License
+
+MIT

pysamsung_dplug-0.1.0/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "pysamsung-dplug"
+version = "0.1.0"
+description = "Async client for old Samsung air conditioners using the DPLUG/AC14K protocol (TLS, port 2878)"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.11"
+authors = [{ name = "porech" }]
+keywords = ["samsung", "air conditioner", "hvac", "dplug", "ac14k", "2878", "home assistant"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Topic :: Home Automation",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/porech/pysamsung-dplug"
+Issues = "https://github.com/porech/pysamsung-dplug/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/samsung_dplug"]
+artifacts = ["*.pem", "py.typed"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/samsung_dplug", "README.md", "LICENSE"]

pysamsung_dplug-0.1.0/src/samsung_dplug/__init__.py

@@ -0,0 +1,22 @@
+"""pysamsung-dplug: async client for old Samsung air conditioners (DPLUG / port 2878)."""
+from .client import (
+    DEFAULT_PORT,
+    AuthError,
+    SamsungAcClient,
+    SamsungAcError,
+    async_probe,
+    build_ssl_context,
+    default_cert_path,
+)
+
+__all__ = [
+    "SamsungAcClient",
+    "SamsungAcError",
+    "AuthError",
+    "build_ssl_context",
+    "async_probe",
+    "default_cert_path",
+    "DEFAULT_PORT",
+]
+
+__version__ = "0.1.0"

pysamsung_dplug-0.1.0/src/samsung_dplug/ac14k_m.pem

@@ -0,0 +1,131 @@
+Bag Attributes
+    friendlyName: ac14k_m
+    localKeyID: 54 69 6D 65 20 31 34 35 35 34 39 32 33 35 32 36 39 36 
+Key Attributes: <No Attributes>
+-----BEGIN PRIVATE KEY-----
+MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQDeXvhcsqRFWfQt
+Qr2TGW+ePJzrKQVNOZmCGFXrBmOKa2gcZvXqDe71upkCmbXxDZbsqU1nFox6WtKy
+za+JE1EaWIjVFV/D0hnnF+CA56851rFjAx7YYVtd9TwJYV1lSfJaQBU/ecUys0SX
+lKZJtjIoJ/PyLREE79TjOqTxXMXnDpiAt3oiwApZMweJ5z2QViqtRepkI33GDgYc
+LzamIengSG6WZkEUr2roY0il4aVXf3IRVRX+5cJ2L5462kFPKm/UnrXrSsrLwbF9
+ltSlNA8FgpHN3d9ZyqB3MB46oGYyxYYU7a+/R3RAx0joNfVPFe8riQXQcoNEgalb
+c8f7N4HPAgMBAAECggEABL80QA5UMWLNMpYlI9m8Jz2V//MdONvM6hkI5H57a34F
+d+2+vCNWAYrdL1AGsUGgAidPDq9NimMb8lMvtxZhedV//kR5id2XTfaVhUrs06hA
+myN66hWR9LyCbpTUgJAGi2Soz3US/5USFsZGknZANdk8fOP3ZAqWmc8rrDdVxivg
+Z3qjiqgIZg24XsZmnK/QJejP4FLMqm6YUouH//u9xSKvTwkg89qxvygW9xNBNfi/
+LrBHip/k8LnynKRE2odQWt74HcTjbZW4rxXrJ0tqDSIh8bUB23mRjFh1k4aKXnz3
+Y/CDsfxvAutVi85/zyxYaIT6daP+PxvywwgjVhYHIQKBgQDyMxmGdi5kk3ePv0lM
+lC28gVNhgKfhsXL8xIzcd/UM3eEK4baA+AKI9p6ifZ8g90NUJGuHxCp8/9yOKcmk
+tY5toE45nH4fH9Z3j9NtWHMhXJDGWV+DjeiWmshbUqd7/OoIl1vig1npQqX+PXJR
+pwDHnjkQbkyum4k8/IruHx813wKBgQDrCqK0rBkMaarr5eyOJ9BxhCej8i5kCzm7
+XSaNgXtpBIQ4Y4r412M2JWaSLnDxlAc0iUhNGnIn4zkEP2HzX5JU4Yto9YAlRZnu
+NQSvuVgyLiBCbS7WrRAlsNpTeCU3m+c5QNXBzBlHCiTdw3WS4bINOftsB3xnlJ+D
+y/0YZozSEQKBgQCgWV5z3Dh40/0bSVyA+7WQENsgOWpsjOwBFyvfJvgxLZC5gJgw
+qIIdJZH/KEY7MBj+UyJx/1jV6xudb2MVzjHeuHwxvj7t4kk+XRVwVlfa5YrgFvma
+glBTrWQquf0ypE5Zo8PsomPbgAmf2hSepH9qqYFENJJGI6lnnBdq8WXbZwKBgQCR
+p3ye5At9wrnWCB0pFwk4X4JFOd5/xukW8CnlBTmaId9iJmXHwYpM0q6Wpkr9mhNA
+/lYc2eemSkxaEoE71Z0UFtVSzNiFwHUcxiRKVVyPdEAvigO9q2/XO5qAoXLG3ElV
+FJWizD1Z5bJk7yycQlsZkTX6g0UX12VmwnHsvhhEUQKBgF0AVToAk+/OPxlA3N4A
+Xn624Ktxzy/58NSLUfQ57AtL2zivoJzfmhUwgYkPsp+63Wklpcq7X7Q2NB7WscC4
+rICqHxNow/KSzwuR6L3u/kewvlsrgTIM2Pp//+QdTK9GGU3HHAZKaNiB8m20k1Bs
+NTANFxBk7alY0G7ZUhuzWkg6
+-----END PRIVATE KEY-----
+Bag Attributes
+    friendlyName: ac14k_m
+    localKeyID: 54 69 6D 65 20 31 34 35 35 34 39 32 33 35 32 36 39 36 
+subject=/C=KR/O=Samsung Electronics/CN=AC14K_M/emailAddress=AC14K_M@samsung.com
+issuer=/C=KR/O=Samsung Electronics/CN=RemoteAccessCA(CE)
+-----BEGIN CERTIFICATE-----
+MIIDmzCCAoOgAwIBAgIBCTANBgkqhkiG9w0BAQUFADBIMQswCQYDVQQGEwJLUjEc
+MBoGA1UECgwTU2Ftc3VuZyBFbGVjdHJvbmljczEbMBkGA1UEAwwSUmVtb3RlQWNj
+ZXNzQ0EoQ0UpMCIYDzE5NjAwMTAxMDAwMDAwWhgPMjA2MDAxMDEwMDAwMDBaMGEx
+CzAJBgNVBAYTAktSMRwwGgYDVQQKExNTYW1zdW5nIEVsZWN0cm9uaWNzMRAwDgYD
+VQQDFAdBQzE0S19NMSIwIAYJKoZIhvcNAQkBFhNBQzE0S19NQHNhbXN1bmcuY29t
+MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA3l74XLKkRVn0LUK9kxlv
+njyc6ykFTTmZghhV6wZjimtoHGb16g3u9bqZApm18Q2W7KlNZxaMelrSss2viRNR
+GliI1RVfw9IZ5xfggOevOdaxYwMe2GFbXfU8CWFdZUnyWkAVP3nFMrNEl5SmSbYy
+KCfz8i0RBO/U4zqk8VzF5w6YgLd6IsAKWTMHiec9kFYqrUXqZCN9xg4GHC82piHp
+4EhulmZBFK9q6GNIpeGlV39yEVUV/uXCdi+eOtpBTypv1J6160rKy8GxfZbUpTQP
+BYKRzd3fWcqgdzAeOqBmMsWGFO2vv0d0QMdI6DX1TxXvK4kF0HKDRIGpW3PH+zeB
+zwIDAQABo3MwcTAdBgNVHQ4EFgQUXzEjosLzA6xbR1KAqnmAp3BNM6MwHwYDVR0j
+BBgwFoAU/12TkC/BOF7xDaZZWJ+DGN6nMxcwDAYDVR0TBAUwAwEB/zAhBgNVHREE
+GjAYggtzYW1zdW5nLmNvbYIJbG9jYWxob3N0MA0GCSqGSIb3DQEBBQUAA4IBAQBW
+0mStlbdvrHqDJ+KOKVf0C/y9FKTODqo/6/wJNZeZ+8ezPza4nFq70MwQYTpSbZhz
+5w8bQP9fwSAoa2Vki8ZwcSd85Vi2tHz9O4C7d7zBA3FU8AL3NoEMFv6OGWGPnTY5
+mG/Hn+LxuwQddlysfbRDds1LBY8DBUJNAmIeeWqA5Eg8DW6xJUwHeXUElJpSXHW6
+XGvpWgAhXqoIf6TirdCrPY6+IzV/FcuVtBDGi+JoxgrMfMLgLEVjeSY96DJinHgZ
+RT0FkA5e06Z+fqHh9Btu+aed+kuGSmya/A5wStOkGeKEbezbbN2gtW07lN6VxX3J
+OCgygA+hmnBVnRDA8Jzu
+-----END CERTIFICATE-----
+Bag Attributes
+    friendlyName: CN=RemoteAccessCA(CE),O=Samsung Electronics,C=KR
+subject=/C=KR/O=Samsung Electronics/CN=RemoteAccessCA(CE)
+issuer=/C=KR/O=Samsung Electronics/CN=CECA
+-----BEGIN CERTIFICATE-----
+MIIDUTCCAjmgAwIBAgIBADANBgkqhkiG9w0BAQUFADA6MQswCQYDVQQGEwJLUjEc
+MBoGA1UECgwTU2Ftc3VuZyBFbGVjdHJvbmljczENMAsGA1UEAwwEQ0VDQTAiGA8x
+OTYwMDEwMTAwMDAwMFoYDzIwNjAwMTAxMDAwMDAwWjBIMQswCQYDVQQGEwJLUjEc
+MBoGA1UECgwTU2Ftc3VuZyBFbGVjdHJvbmljczEbMBkGA1UEAwwSUmVtb3RlQWNj
+ZXNzQ0EoQ0UpMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAtatz9GvV
+qbV395Whnad9MC9TEOiXuwnw37QHvQUwOTFgc6AenX5SORfb4UTw+0ApFNba9DlY
+Xx/K9E5b5DGasDVGGTn+z+6MPB7GuAjkP+WSRwHMjrHRNqrBOr1YJUw3SIbMkRoT
+460k9AD9DQDBORRtGBGwcBw6BvdasA+/L3Q63aJ7pDoj3qxocdcgk/zFq0OrxFDL
+PMTL7a+a9DS8G10K73XGgES0RBwwhlXXVuLUprD6RgbeLHFsPpIq5vzzEpAYMCF6
+vkZKjDGEW7JVTgUu0E37niN3NQv1gIXlJusDH6RWfFQxENZsdFkT/l+kTuY283Ga
+2Ei1HsW3Xpt88QIDAQABo1AwTjAdBgNVHQ4EFgQU/12TkC/BOF7xDaZZWJ+DGN6n
+MxcwHwYDVR0jBBgwFoAURwF9jkihypJa2u6zRwKrZwRlACswDAYDVR0TBAUwAwEB
+/zANBgkqhkiG9w0BAQUFAAOCAQEAZkjxN4O92e1RTaXx1mpazyT98sJVl46R51s1
+CTPq35HVfTiBOAu0C5MR6a9vIIFJScy5h69VN4OwDDbMhe/k3m6EfAutlL7lRrre
+OT853HJahxdavzaXJ7tcrI/yDJI0X5GbQ8W74mmDt2/5rXsaB+h+NrToGqf6Hvf/
+m7ZhUnCAt0hhLmltxTVYS25s9KoiIH0rXOb9cqUFsmBMEG2pHWC5AiSc0cXJm+kU
+3z0B2GS+4IjGdVr3FTPzzTXrpqq/X1cIVKAum5WfsFMS0CRvqTVNVwYg52n69T2B
+NPCCEpp9rsIieZ58jsnc506Uc+1Vp+NmBI2A/ecypZxSb6v9gg==
+-----END CERTIFICATE-----
+Bag Attributes
+    friendlyName: CN=CECA,O=Samsung Electronics,C=KR
+subject=/C=KR/O=Samsung Electronics/CN=CECA
+issuer=/C=KR/O=Samsung Electronics/CN=ROOTCA
+-----BEGIN CERTIFICATE-----
+MIIDRTCCAi2gAwIBAgIBBDANBgkqhkiG9w0BAQUFADA8MQswCQYDVQQGEwJLUjEc
+MBoGA1UECgwTU2Ftc3VuZyBFbGVjdHJvbmljczEPMA0GA1UEAwwGUk9PVENBMCIY
+DzE5NjAwMTAxMDAwMDAwWhgPMjA2MDAxMDEwMDAwMDBaMDoxCzAJBgNVBAYTAktS
+MRwwGgYDVQQKDBNTYW1zdW5nIEVsZWN0cm9uaWNzMQ0wCwYDVQQDDARDRUNBMIIB
+IjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAtv1WJJ7tTs/aa1ZZRjMPPLeb
+n/Ev0Y28CSBj/6P031/veZSg/2z65QZUvPjv8MZnIgNoMpxMGbPPO4Dxj+QJthBk
+WydWRPguPyE+w3U4SdayZXWpLZTpKfHco3CklFwEqZtG/wTxHD1oOvtT0e2g5c79
+hNQt9lQ4Wwzqa3MvQd0JyeB4syy2zRLo5NjJZl1BVn2oTt4xGCjjtAXtAqqHEbEf
+pcvB3hPdIpFe6M8zuN22kROKaQ5i4XP4CyEpbFlgKRcWBGQFX3I5f5TdD3Yw1Ril
+OLLL9wFsJ+iWLka9tAIcJKCNOf48p7aXm6COFwmjtCNu4wjQozwi6cycKUgxNQID
+AQABo1AwTjAdBgNVHQ4EFgQURwF9jkihypJa2u6zRwKrZwRlACswHwYDVR0jBBgw
+FoAU7andrmFFrxYM8+93lrn/Fq47sXMwDAYDVR0TBAUwAwEB/zANBgkqhkiG9w0B
+AQUFAAOCAQEATexseQBXSfUR7fFTFxq6aAvHWIN+h3QLeN1sq8KCM4fbdkH3lOUP
+rKW3w1ag62bnJVNjT4xPtzH/DyrqlzQUPTb7S0PfIXt2mu/VURnrmuXidS2grNwv
+eu10gURZaz9N2UZEhY7E80tUZwcjAV+YP8+x3/iRQSrWvcMma/r01eUnwrF4xaE9
+EYtJ/jTRre8MpEH/lg06m+rZf9Lk/yhG6at0YnUAIytThqFV4Cj8T8jBX+KG8BCo
+VyUsFyrO+D6X98gMdTZnLqC1P1iWuxyrOWZTgsf44f5GXzmLqe5KLPvkDb4MywTa
+nXrSOPSkcIgvS6WYw2Rii+e6lfVzqmhAmg==
+-----END CERTIFICATE-----
+Bag Attributes
+    friendlyName: CN=ROOTCA,O=Samsung Electronics,C=KR
+subject=/C=KR/O=Samsung Electronics/CN=ROOTCA
+issuer=/C=KR/O=Samsung Electronics/CN=ROOTCA
+-----BEGIN CERTIFICATE-----
+MIIDRzCCAi+gAwIBAgIBADANBgkqhkiG9w0BAQUFADA8MQswCQYDVQQGEwJLUjEc
+MBoGA1UECgwTU2Ftc3VuZyBFbGVjdHJvbmljczEPMA0GA1UEAwwGUk9PVENBMCIY
+DzE5NjAwMTAxMDAwMDAwWhgPMjA2MDAxMDEwMDAwMDBaMDwxCzAJBgNVBAYTAktS
+MRwwGgYDVQQKDBNTYW1zdW5nIEVsZWN0cm9uaWNzMQ8wDQYDVQQDDAZST09UQ0Ew
+ggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCd67g2hzhbIeSBoFfeqbXi
+tzbO4dCWeCigVfmwEDhR1SDA0MfHOVlFpvuFr3WyFPvQZ0ccNrsTpBs5YieI/jZi
+FYWO0ktbqQorL1CIFqBL9kAF+34BYtpl98PgJ1grLOH5T3GugJA7Irw0plEFmOfs
+IydlUIQHl3oqyMIWPa2nIZ/FGi3hAquEPrvzHZB+QO4c+6tV1WLIaCjn88xkYuwz
+uGYxaqJpnGdqhjZRIuHb2DEZPlP1VGdTTAttno36CyWqeHrSC8fXCSu55Zk+1rbC
+Py/phOJjSyce2qk0IebETAYLCLqU7ABJxUxrolMrP37OB+Kqe4RWovaeMcdcNOOt
+AgMBAAGjUDBOMB0GA1UdDgQWBBTtqd2uYUWvFgzz73eWuf8WrjuxczAfBgNVHSME
+GDAWgBTtqd2uYUWvFgzz73eWuf8WrjuxczAMBgNVHRMEBTADAQH/MA0GCSqGSIb3
+DQEBBQUAA4IBAQBkwK95x8JCAnY0F2bMwG5+7QfY+ci8s8m1ODi3v19HECS6nG9j
+SXgwihEtQ3HqvUler+n7aOeAZlgm+BymM2GvuicveYN/nevIvzlpMOn2L6xU19/H
+zM2eoDVfS49+i/cwoi/A7fcZmIYggZho2UJR/GvKc79g6EAhT7/i5alBZF0enMsA
+9okzakb/aohQE9SzsEHnhVKpGAjvu0/TJK9WwX6mkiIEJY+mzQMWgEeQt6WWIgAb
+gSX9NueH80tpZ9KqFnqnOoLxTAa7k0RPBRwyUO9CDhSnlWIEcsD9sqR2M+niOFnT
+KBHcLDDiEU3llprD8FRV3unYrl0F0B2GGdRk
+-----END CERTIFICATE-----

pysamsung_dplug-0.1.0/src/samsung_dplug/client.py

@@ -0,0 +1,204 @@
+"""Async client for the Samsung 'DPLUG' air-conditioner protocol (TLS, port 2878).
+
+Reverse-engineered from the AC14K / DPLUG-1.x firmware used by older Samsung
+air conditioners with the SWL-Bxxx Wi-Fi modules. Mutual TLS using the public
+Samsung client certificate (bundled ac14k_m.pem), with legacy ciphers enabled.
+"""
+from __future__ import annotations
+
+import asyncio
+import logging
+import re
+import ssl
+from importlib import resources
+
+_LOGGER = logging.getLogger(__name__)
+
+DEFAULT_PORT = 2878
+_TERM = b"\r\n"
+_ATTR_RE = re.compile(r'Attr ID="([^"]*)" Type="([^"]*)" Value="([^"]*)"')
+_DUID_RE = re.compile(r'Device DUID="([^"]*)"')
+_TOKEN_RE = re.compile(r'Token="([^"]*)"')
+
+
+class SamsungAcError(Exception):
+    """Generic protocol error."""
+
+
+class AuthError(SamsungAcError):
+    """Authentication (token) rejected."""
+
+
+def default_cert_path() -> str:
+    """Path to the bundled Samsung client certificate."""
+    return str(resources.files(__package__).joinpath("ac14k_m.pem"))
+
+
+def build_ssl_context(cert_path: str | None = None) -> ssl.SSLContext:
+    """Build the legacy mutual-TLS context. Blocking (file I/O) -> run in executor."""
+    ctx = ssl.SSLContext(ssl.PROTOCOL_TLS_CLIENT)
+    ctx.check_hostname = False
+    ctx.verify_mode = ssl.CERT_NONE
+    ctx.minimum_version = ssl.TLSVersion.TLSv1
+    ctx.set_ciphers("HIGH:!DH:!aNULL:@SECLEVEL=0")
+    ctx.load_cert_chain(cert_path or default_cert_path())
+    return ctx
+
+
+async def async_probe(host: str, ssl_context: ssl.SSLContext, port: int = DEFAULT_PORT) -> bool:
+    """Return True if `host` speaks the DPLUG protocol (used by discovery)."""
+    try:
+        reader, writer = await asyncio.wait_for(
+            asyncio.open_connection(host, port, ssl=ssl_context, server_hostname=host),
+            timeout=8,
+        )
+    except (OSError, asyncio.TimeoutError, ssl.SSLError):
+        return False
+    try:
+        line = await asyncio.wait_for(reader.readuntil(_TERM), 5)
+        return "DPLUG" in line.decode("utf-8", "replace")
+    except Exception:  # noqa: BLE001
+        return False
+    finally:
+        writer.close()
+
+
+class SamsungAcClient:
+    """Short-lived-connection client: connect, auth, do one exchange, close.
+
+    Serialised with a lock so polling and commands never overlap on the device
+    (the module accepts essentially one connection at a time).
+    """
+
+    def __init__(self, host, token=None, ssl_context=None, duid=None, port=DEFAULT_PORT):
+        self._host = host
+        self._port = port
+        self._token = token
+        self._ctx = ssl_context
+        self._duid = duid
+        self._lock = asyncio.Lock()
+
+    @property
+    def duid(self):
+        return self._duid
+
+    async def _readline(self, reader, timeout=5.0):
+        data = await asyncio.wait_for(reader.readuntil(_TERM), timeout)
+        return data.decode("utf-8", "replace").strip()
+
+    async def _connect(self):
+        reader, writer = await asyncio.wait_for(
+            asyncio.open_connection(
+                self._host, self._port, ssl=self._ctx, server_hostname=self._host
+            ),
+            timeout=10,
+        )
+        greeting = await self._readline(reader)
+        if "DPLUG" not in greeting:
+            writer.close()
+            raise SamsungAcError(f"Unexpected greeting: {greeting!r}")
+        return reader, writer
+
+    async def _authenticate(self, reader, writer):
+        line = await self._readline(reader)
+        if "InvalidateAccount" not in line:
+            line = await self._readline(reader)
+        writer.write(
+            f'<Request Type="AuthToken"><User Token="{self._token}"/></Request>'.encode()
+            + _TERM
+        )
+        await writer.drain()
+        for _ in range(4):
+            line = await self._readline(reader)
+            if 'Type="AuthToken"' in line and 'Status="Okay"' in line:
+                return
+            if 'Status="Fail"' in line and "Auth" in line:
+                raise AuthError(f"Token rejected: {line}")
+        raise AuthError("No AuthToken Okay received")
+
+    @staticmethod
+    def _parse_state(line: str) -> dict:
+        return {m[0]: m[2] for m in _ATTR_RE.findall(line)}
+
+    async def _read_until(self, reader, needle, timeout=6.0):
+        loop = asyncio.get_running_loop()
+        end = loop.time() + timeout
+        while loop.time() < end:
+            line = await self._readline(reader, timeout=timeout)
+            if needle in line:
+                return line
+        raise SamsungAcError(f"Timeout waiting for {needle}")
+
+    async def async_discover_duid(self):
+        async with self._lock:
+            reader, writer = await self._connect()
+            try:
+                await self._authenticate(reader, writer)
+                writer.write(b'<Request Type="DeviceList"></Request>' + _TERM)
+                await writer.drain()
+                line = await self._read_until(reader, "DeviceList")
+                m = _DUID_RE.search(line)
+                if not m:
+                    raise SamsungAcError(f"No DUID in DeviceList: {line}")
+                self._duid = m.group(1)
+                return self._duid
+            finally:
+                writer.close()
+
+    async def async_get_state(self) -> dict:
+        if not self._duid:
+            await self.async_discover_duid()
+        async with self._lock:
+            reader, writer = await self._connect()
+            try:
+                await self._authenticate(reader, writer)
+                writer.write(
+                    f'<Request Type="DeviceState" DUID="{self._duid}"></Request>'.encode()
+                    + _TERM
+                )
+                await writer.drain()
+                line = await self._read_until(reader, 'Type="DeviceState"')
+                if 'Status="Okay"' not in line:
+                    raise SamsungAcError(f"DeviceState failed: {line}")
+                return self._parse_state(line)
+            finally:
+                writer.close()
+
+    async def async_set(self, attr: str, value: str) -> None:
+        if not self._duid:
+            await self.async_discover_duid()
+        async with self._lock:
+            reader, writer = await self._connect()
+            try:
+                await self._authenticate(reader, writer)
+                cmd = (
+                    f'<Request Type="DeviceControl"><Control CommandID="cmd" '
+                    f'DUID="{self._duid}"><Attr ID="{attr}" Value="{value}" />'
+                    f"</Control></Request>"
+                )
+                writer.write(cmd.encode() + _TERM)
+                await writer.drain()
+                line = await self._read_until(reader, 'Type="DeviceControl"')
+                if 'Status="Okay"' not in line:
+                    raise SamsungAcError(f"Control {attr}={value} failed: {line}")
+            finally:
+                writer.close()
+
+    async def async_get_token(self, power_on_timeout=40.0) -> str:
+        """One-shot token acquisition. User must power the unit ON during the window."""
+        async with self._lock:
+            reader, writer = await self._connect()
+            try:
+                line = await self._readline(reader)
+                if "InvalidateAccount" not in line:
+                    line = await self._readline(reader)
+                writer.write(b'<Request Type="GetToken" />' + _TERM)
+                await writer.drain()
+                await self._read_until(reader, 'Type="GetToken"')  # Ready
+                token_line = await self._read_until(reader, "Token=", timeout=power_on_timeout)
+                m = _TOKEN_RE.search(token_line)
+                if not m:
+                    raise SamsungAcError(f"No token in: {token_line}")
+                return m.group(1)
+            finally:
+                writer.close()