Toshiba home AC control

I think I can confirm that. I just talked to the AC guy again. He said that for 5 units I鈥檓 planning I鈥檇 need 5 WiFi modules. Apparently it鈥檚 plug&play by a cable, apparently the cable you utilised as well (as what I see from the photo). I鈥檒l make the assumption the protocol will be the same and I鈥檒l figure it out by doing some testing. First it鈥檚 the long wait until they have time to build it in. (3,5 months!!)

I have a multisplit outdoor unit with 3 indoor units, Each AC has a module, it also looks like the WiFi modules are ESP based so maybe its also possible to flash them with a custom firmware in the future

I do have the same AC (with the wireless adapter) and I am having the same problem. Therefore I tried to reverse-engineer the app.

I started by downloading the APK from - I used the oldest version as it was the smallest and so I assumed was the easiest to start with.
The APK is basically a zip file that holds the android application - usually a .tex file where the java code needs to be extracted. In this case the app uses assemblies - meaning there are like 100 .dll files that are used as a library.
Those can be easily copied and looked into using tools like ILSpy (Releases 路 icsharpcode/ILSpy 路 GitHub) or dnSpy (Releases 路 dnSpy/dnSpy 路 GitHub).
I noted that there is a SmartAC.dll which seems to handle most of the logic and the communication of the app.
In this dll I also found out about the propertyStore on the phone which holds some mapping information about the connected ACs (see later).

Here are my findings so far:

The app uses two interfaces:

  1. a normal HTTP API to get the current state of the AC and stuff like pairing and programmSettings
  2. a MQTT (or better an AMQPS) interface to update the current state (like change temperature or modes)

I made a small PHP script that is able to connect to the HTTP API and get some basic informations - see here: Toshiba AC API Client - Get status and settings from Toshiba AC Services (used e.g. in RAS-18PKVSG-E + RAS-18PAVSG-E + WIFI Adapter RB-N103S-G) 路 GitHub

The the problem with the AMQPS interface is, that I can鈥檛 find a working client. I tried it with py-amqp without success.

The AMQPS connection seems to be opened to:

whereas XXXXX is your deviceId.

I have extract that part directly from my phone propertyStore using adb.
basically you install android studio, connect your phone to your PC, start the app, start the debugger and run:

adb shell
cat /data/user/0/com.toshibatctc.SmartAC/files/.config/.isolated-storage/PropertyStore.forms

this did work for me on a non-rooted phone and gave me an output similar to this:

@ArrayOfKeyValueOfstringanyTyp9       i)[email protected]@
  Key锟[email protected]:string    a锟[email protected]@
  [email protected]:string  a[email protected]@
  Key锟[email protected]:string a锟[email protected]@
  Key锟[email protected]:string a锟紷[email protected]@
  Key锟   [email protected]锟絘:int a锟紷[email protected]
  Key锟[email protected]锟
a:dateTime      a锟>锟
菁\[email protected]@
  Key锟[email protected]锟絘:base64Binary     a锟[email protected]@
  [email protected]:string    a锟'[email protected]@
  [email protected]:string        a锟[email protected]@
  Key锟[email protected]:string     a锟,oxx8=

From here I extracted:

  • the UserName
  • a ConsumerID (which is the same when using the HTTP API)
  • the HostName: (which differs from the http api)
  • my DeviceID (which included my Username and is used for the amqps connection)
  • and a SharedAceeskey (yes it has this typo)

Using another APP (Packet Capture I was able to read out the communication from the app to the server - unfortunatelly this amqps seems to be some kind of binary protocol and a single on/off request, results in multible queue entries like this:

IoThub-methodname: smmobile

So far I found out that data is just a string of all attributes as 2-byte hex-values concationated - where ff means that it did not change. Position 9+10 - like above - is reserved for the air swing mode and 31 means its off. 41 would swing it vertically.
In the HTTP API this data/payload is named ACStateDataForProgram - in my example it has the value: 31421a3131640010197ffe0b00001002010000 - 31 鈥 means currently off, 42 鈥 is cooling mode, 1a 鈥 is hex for 26 degrees target temperature and so on鈥

So - I really hope someone with more experience using amqps will pick it up from here and we can somehow get a working integration out of this.


very interesting discovery, I will try your script on my installation asap
this works very well, putting out some information

because I wanted to have the firmware I have postponed the firmware update since the airco鈥檚 got installed, I鈥檝e now managed to get the firmware with help of your script, in the file there are some mentions of MQTT, I will report back when I have better information

I鈥檝e dumped the firmwarefile ota_0000_3201.bin onto wetransfer if it is of any interest for you:
fyi I have the Toshiba RB-N104S-G, it seems to be based on Realtek Ameba RTL8195A platform

1 Like

I started to port the script to python and prepare a home-assistant integration:

(currently only the works - the rest is scaffolded from home-assistant)

the plan is to use the daily scheduler to send start and stop events to the AC unit. this may not be the best (or even the right) way, but until someone figures out how to do it correctly this could be sufficient.

foreseeable downsides:

  • the device will not react immediatly to any changes - it will be necessary to post status updates with at least one minute (probably more) lead time.
  • you will not be able to use the scheduler as intended, due to the updates made to it.

I just stumbled over this thread. :slight_smile:

I鈥檓 not an owner of a Toshiba unit, but in another corner here in this forum, there is a group of people working on an ESPHome component for Midea A/Cs. :slight_smile: As we started to put a list of all manufacturers (label) together, I noticed that someone is using the ESPHome component for Midea in combination with a Toshiba A/C.

Would someone of you check, if your A/Cs would work with this component? Maybe there is already a working component for the integration in HA. :slight_smile:

Here is the thread with some pics and instructions:

And here is the thread with the list of working devices:

1 Like

Hello everyone, i also got a ras-b13n4kvrg-e installed today, unfortunately my dad bought the wrong model so now i鈥檓 stuck with this smartish yet stilish AC.
Anyway i鈥檝e got the app up and running on a rooted phone if it can be of any help (especially to @h4de5).
I also setup the google home link, but it鈥檚 very embarassing, it exposes only the on/off status to google home :face_with_raised_eyebrow:
I even tried @h4de5鈥檚 and it works flawlessly.

All this to say that I, my AC and my phone are at your disposal!

What kind of wifi-module is in the A/C?
if it is a OSK-102 or OSK-103 probably the ESPhome solution would work for you, as i noticed two other Toshibe A/C鈥檚 are confirmed working allready馃槈

It does require some diy work, but it is not difficult, and would cost around 鈧7.50

Unfortunately my model has integrated wifi module and no port USB at all and also no reachable serial without voiding the warranty, so the cloud-interfacing option is the only way in my case.

Unfortunately I鈥檓 in the same boat with my Toshiba Haori, which also has the integrated wifi module :expressionless:

1 Like

I鈥檝e opened the AC and the module is a WRE-T00BJ10, it has no USB at all but a 6pin connector with just 4 wires connected to it. Any guesses?

Hard to guess鈥
might be +5v / tx / tx / gnd but could be anything鈥.

a small update here:

I added some more example code. it is possible to update the scheduler now.

Beware: the example code will reset the program for the current day, activate all ACs for 5 minutes and turn them off again afterwards.

the updated program is also shown within the app, but, at least mine, is not turned on automatically yet.

Hello Everyone,

My first time on this forum.

I have set up a Toshiba AC system with this wifi controlled system you are talking about, in our offices.

However i have trouble connecting the module to our wifi network, as we have a firewall that prevents all 鈥渇oreign鈥 connections. My IT department is asking me what web port have they got to open to make it work?

I鈥檝e been frantically searching online and haven鈥檛 found any hope鈥 until i came across this forum.

Anyone coud help me on that one?

Thanks a lot.

hello and welcome.
the wifi adapter is making an connection to the outside: to port 8883 and uses a tls encrypted amqp protocol.
your app is also connecting to that server, so normally no direct connection is necessary. unless maybe during pairing. if the company wifi is too restrictive i would take a second mobile phone open an wifi hotspot with the same credentials and do the initial pairing there.

good luck.

the code should be used in home assistant or separately?
how does it work?

@h4de5 I have digged a bit into AMQP connection. I鈥檝e managed to capture some decrypted communication in wireshark (with mitmproxy) but it stops working when establishing AMQP communication. It seems like we have multiple levels of encapsulation. Firts TLS connection is established with, then websocket is created:

Hypertext Transfer Protocol
    GET /$iothub/websocket HTTP/1.1\r\n
    Connection: Upgrade\r\n
    Upgrade: websocket\r\n
    Sec-WebSocket-Version: 13\r\n
    Sec-WebSocket-Key: ######
    Sec-WebSocket-Protocol: AMQPWSB10\r\n
    [Full request URI:$iothub/websocket]
    [HTTP request 1/1]
    [Response in frame: 1822]

Server accepts websocket communication:

Hypertext Transfer Protocol
    HTTP/1.1 101 Switching Protocols\r\n
    Upgrade: websocket\r\n
    Server: Microsoft-HTTPAPI/2.0\r\n
    Sec-WebSocket-Protocol: AMQPWSB10\r\n
    Connection: Upgrade\r\n
    Sec-WebSocket-Accept: ######
    Date: Fri, 20 Aug 2021 12:16:45 GMT\r\n
    [HTTP response 1/1]
    [Time since request: 0.033266349 seconds]
    [Request in frame: 1821]
    [Request URI:$iothub/websocket]

This should create websocket with protocol AMQPWSB10 which is AMQP version 1.0. Unfortunately at this stage my connection is breaking - mitmproxy has some problem handling this further.

As this is MS Azure AMQP API this may help: GitHub - Azure/azure-uamqp-python: AMQP 1.0 client library for Python, but I haven鈥檛 tried it yet.

@h4de5 I have mannaged to connect to AMQP and I鈥檓 receiving state change notifications for my AC.

I鈥檝e done this with azure-iot-device python package and following code: Toshiba Home AC AMQP connection 路 GitHub. You have to fill your device id and shared key.

When I change something on my AC it generates output similar to this:

Method handler
{'sourceId': '######', 'messageId': '######', 'targetId': ['######'], 'cmd': 'CMD_FCU_FROM_AC', 'payload': {'data': '30ffffffffffffffffffffffffffffffffffff'}, 'timeStamp': '21:44:55.5649670'}

Now I need to add encoder/decoder for state of AC and try to control it from python.

Can we use your script to generate device id and shared key or this is something we can only read from android property store?

unfortunatelly I did not find another way to get those ids.

@Didier3L the script needs to run stand alone at the moment, even it was planed to be integrated into HA. but for the whole 鈥渋dea鈥 to use the scheduler to send updates to the AC: this did not turn out to be working. so think I鈥檒l retire that again.

but I will definitelly have a look into the AMQP setup asap.

I just tried it too - and I do get updates from the API - can you prepare a script which will send something to the API server?

example data:

turn off:
{鈥榮ourceId鈥: 鈥榵xxx鈥, 鈥榤essageId鈥: 鈥0000000090鈥, 鈥榯argetId鈥: [鈥榶yyyyy鈥橾, 鈥榗md鈥: 鈥楥MD_FCU_TO_AC鈥, 鈥榩ayload鈥: {鈥榙ata鈥: 鈥31ffffffffffffffffffffffffffffffffffff鈥檥, 鈥榯imeStamp鈥: 鈥0061217209鈥檥

turn on and change fanspeed to low:
{鈥榮ourceId鈥: 鈥榵xxx鈥, 鈥榤essageId鈥: 鈥0000000090鈥, 鈥榯argetId鈥: [鈥榶yyyyy鈥橾, 鈥榗md鈥: 鈥楥MD_FCU_TO_AC鈥, 鈥榩ayload鈥: {鈥榙ata鈥: 鈥30ffff20ffffffffffffffffffffffffffffff鈥檥, 鈥榯imeStamp鈥: 鈥0061217209鈥檥

timeStamp: current timestamp converted to hex + two leading zeros


example fan speed settings (and for a little more see in github code)

quiet = 0x1F,
low = 0x20,
lowPlus = 33,
medium = 34,
mediumPlus = 35,
high = 36

here you can see what those positions actually means - while ff always declare not to change any settings for this function:

# see: SmartAC.Services.MQTTServices.MqttSendCmdJson

_operationStatus = "ff";
_mode = "ff";
_temp = "ff";
_fanSpeed = "ff";
_airSwing = "ff";
_powerSelection = "ff";
_meritFeature = "ff";
_pure = "ff";
_indoorTemp = "ff";
_outdoorTemp = "ff";
_errorCode = "ff";
_timerType = "ff";
_relativeHours = "ff";
_relativeMins = "ff";
_selfCleaning = "ff";
_ledStatus = "ff";
_schedulerStatus = "ff";
_utcHours = "ff";
_utcMins = "ff";

return _operationStatus + _mode + _temp + _fanSpeed + _airSwing + _powerSelection + _meritFeature + _pure + _indoorTemp + _outdoorTemp + _errorCode + _timerType + _relativeHours + _relativeMins + _selfCleaning + _ledStatus + _schedulerStatus + _utcHours + _utcMins;