Toshiba AC integration into home-assistant.io
You need a supported (or compatible) Toshiba AC device with either a built-in Wifi module or an adapter. See list of compatible devices
- In HACS go to integrations and search for 'Toshiba AC'
- Click
Install - Reboot Home Assistant
- Follow common integration manual
- Download latest release
- Create a folder:
custom_componentsin your home-assistant config directory - Extract content (the folder
toshiba_ac) of the release zip into the newly created directory - Reboot Home Assistant
- Follow common integration manual
- The integration should be available as
Toshiba ACin theAdd integration dialog - You need to enter your Toshiba AC account credentials (same as within the app)
- There is no bounding/registering of new AC units possible with this code - please continue to use the app for this
- Avoid long or complex passwords: Some users report issues with passwords that are too long or contain special characters. If you have trouble setting up, try using a simpler password in the Toshiba app first.
- Use the official app first: Make sure your AC unit is properly set up and working in the official Toshiba app before adding it to Home Assistant.
Most connection problems are caused by Toshiba's cloud service being temporarily unavailable.
Important:
- A single failed setup after a Home Assistant restart is not a bug - the cloud may just be temporarily unreachable
- Do NOT restart Home Assistant repeatedly - this will trigger rate limiting on Toshiba's servers and make things worse
- Best approach: Wait 1-2 hours and try again
If you continue to have issues:
- Enable debug logging (see below)
- Check if the official Toshiba app works
- Wait and retry after some time
Add this to your configuration.yaml to enable detailed logging:
logger:
default: warning
logs:
custom_components.toshiba_ac: debug
toshiba_ac: debug- Home Assistant integration issues: Open an issue here
- API/Device communication issues: Open an issue at the API repository
If your device is compatible with the official Toshiba AC mobile app or Toshiba Home AC Control it has good chances to be supported by this integration. Furthermore it has been tested with the following hardware: List of Supported Devices - feel free to update that list!
⚠️ North America Users: Toshiba distributes their AC devices with a completely different app and system in the US: Toshiba AC NA. This integration will NOT work with North American devices. Instead, try midea-ac-py which may be able to control NA-edition AC units without requiring an account.
- Feature Request in the home-assistant community
- my first draft to communicate with the rest service using an Toshiba API client in PHP
- extended example to retrieve state of the AC unit and update the timeprogram using an Toshiba API client in python
- finally using AMQP interface to send state changes directly in updated python package