(homebridge-samsung-aircon-8888 <= This name triggers npm spam check...)
Due to the last-minute renaming of the module when being published to npm, some places, including this instruction, still had the old name stated. If you see the name "homebridge-samsung-aircon-8888" and you have the module installed from npm, please update them accordingly. This includes, you need specify the localtion for the cert when running the python script, and do not blindly follow the sample config file. I will update them in another day.
This is a Homebridge plugin for Samsung Smart Air Conditioner with Port 8888. If you have your Samsung AC working over Port 2878, please check out this project.
This allows you to control your Samsung air conditioner with HomeKit and Siri.
Tested with AJ009MBADEC, should work with all AJ***MBADEC models.
Make sure that you have Node and npm installed.
npm install -g homebridgeIf you encounter permission issue, you may need do this with sudo and --unsafe-perm:
sudo npm install -g homebridge --unsafe-perm
If you are on Raspberry or Debian system, and wish to use systemd to run homebridge so that it is persisted, please refer to this reference.
npm install -g homebridge-samsung-smart-airconPlease apply sudo and / or --unsafe-perm if you encounter any permission error.
jq is a command-line JSON parse tool. You need install jq first.
On Mac, if you have brew installed:
brew install jqOn Linux (Raspberry Pi etc.), you may try apt-get:
apt-get install jqIt is highly recommended to assign a static IP to your AC. If you have not done so, please do this via your home router, and restart your AC (cut off power, not via remote only) or router thereafter, to make sure that your AC does have the static IP you have assigned to.
cd to your installed node_modules/homebridge-samsung-aircon-8888, and you will find a Server8889.py script.
From the folder:
python Server8889.pyNote that this scripts needs the cert ac14k_m.pem, which is in the plugin folder as well. It assumes that your plugin is installed at /usr/local/lib/node_modules/homebridge-samsung-aircon-8888. If in any case that the path of your installed module is different, you need feed it with the correct path:
python Server8889.py /my-absolute-path-to/ac14k_m.pemIf successful, a server will run and listen to the response from your AC. Open a new Terminal / Shell window, and type in as follows. Please do not hit enter to execute this first.
curl -k -H "Content-Type: application/json" -H "DeviceToken: xxxxxxxxxxx" --cert /usr/local/lib/node_modules/homebridge-samsung-aircon-8888/ac14k_m.pem --insecure -X POST https://192.168.1.xxx:8888/devicetoken/requestPlease replace the IP address to your AC's static IP. If you have your cert elsewhere, please replace the cert path too.
Turn off your AC, and then hit enter to run the script. Then turn on your AC again.
Return to the Shell window that is running the python script. You should see the following:
----- Request Start ----->
/devicetoken/response
Host: 192.168.1.xxx:8889
Accept: */*
X-API-Version : v1.0.0
Content-Type: application/json
Content-Length: 28
{"DeviceToken":"xxxxxxxx"}
<__main__.RequestHandler instance at 0x......>
<----- Request End -----
Please note down the DeviceToken value. This is your AC token.
If you are on Mac, simply double click to install it.
If you are on Linux:
sudo mkdir /usr/share/ca-certificates/local
sudo cp /usr/lib/node_modules/homebridge-samsung-smart-aircon/ac14k_m.pem /usr/share/ca-certificates/local/
sudo update-ca-certificates| Note that if on Ubuntu, you may need copy to /usr/local/share/ca-certificates instead and rename the file to ac14k_m.crt, before update-ca-certificates.
Usually, you may find your Homebridge config file at ~/.homebridge/config.json.
You may refer to the config-sample.json in this project folder as reference.
{
// Homebridge and other configs...
"accessories": [{
"accessory": "SamsungSmartAirConditioner", // do not change this
"name": "My Aircon",
"ip": "192.168.1.x", // AC's static IP
"token": "A1B2C3D4E5F", // the token
"patchCert": "/usr/local/lib/node_modules/homebridge-samsung-aircon-8888/ac14k_m.pem",
"userAllowedMode": "cool" // 'both','heat', 'cool'
}]
}
Accepted value: 'both', 'heat', 'cool'.
While this AC technically supports both heating and cooling, Samsung has made specific models for some countries, and may have either heating or cooling disabled (even though the disabled mode can still be found on the official remote control, it's not functioning). Also, some parts of the world need not one of these modes.
Based on your AC model and your living place, you may wish to set this value to 'heat' to allow heating only, or 'cool' to allow cooling only, or 'both'.
Please note that due to Homekit limitation, this may not be perfect.
At current stage, homekit HeaterCooler does not have an option for these modes.
While this is not really an AC function, adjusting them is actually setting the target temperature. There are no separate thresholds for this AC. (and Homekit HeaterCooler does not support TargetTemperature directly. Thermostat supports it, but it does not have some other functions...)
Switching between swinging and fixed modes is fine. The "Rotation Speed" is actually to adjust the wind level, which ranges from 1 to 4.
Support for filter health has been added, though I am not sure how to see it in Apple's Home app. Its status is accessible via Siri. You may see this information if you use Home 3 app.
Resetting filter status function is yet to add.
This project is forked from cicciovo/homebridge-samsung-airconditioner and rewritten in Typescript.
The Typescipt part uses homebridge-tesla as reference, as well as for some utils methods.