Important Notes:

• Using this integration causes the MG/SAIC mobile app to shut down, as per API requirements, since only one device can be connected at a time. Logging into the mobile app causes this integration to disconnect and fail to set up.
• This Integration has only been tested on a MG Marvel R model. Please provide feedback on sensors and information for other vehicles.

1. Ensure that HACS is installed.

2. Go to HACS

3. On the top right menu select "Custom repositories"

4. On the "Repository" field put the URL https://github.com/ad-ha/mg-saic-ha. On the "Category" select "Integration" and click "ADD"

5. Search for "MG SAIC" and download the repository.

6. Restart Home Assistant.

1. Download the latest release from the MG SAIC Custom Integration GitHub repository.
2. Unzip the release and copy the mg_saic directory to custom_components in your Home Assistant configuration directory.
3. Restart Home Assistant.

1. Go to Configuration -> Integrations.
2. Click on the "+ Add Integration" button.
3. Search for "MG SAIC" and follow the instructions to set up the integration.
4. Select your type of account (email or phone), enter the details and select your region (EU, Asia, China)
5. Once connected to the API, a list of available VINs associated with your account will be shown. Select the vehicle that you want to integrate and finish the process.

You may add additional vehicles by following the same steps as above.

The MG/SAIC Custom Integration provides the following sensors and binary sensors:

• Brand
• Model
• Model Year
• Mileage
• Fuel Level
• Fuel Range
• EV SOC
• Electric Range
• Battery Voltage
• HVAC Status
• Interior Temperature
• Exterior Temperature

• Front Left Tyre Pressure
• Front Right Tyre Pressure
• Rear Left Tyre Pressure
• Rear Right Tyre Pressure

• Charging Status
• Charging Voltage
• Charging Current
• Charging Power
• Estimated Range After Charging
• Charging Current Limit
• Charging Target SOC
• Charging Duration
• Remaining Charging Time
• Added Electric Range
• Power Usage Since Last Charge
• Mileage Since Last Charge

• Driver Door
• Passenger Door
• Rear Left Door
• Rear Right Door
• Bonnet Status
• Boot Status

• Driver Window
• Passenger Window
• Rear Left Window
• Rear Right Window
• Sun Roof Status

• Lock Status
• Charging Gun Status

0.1.0
- Refactor code to work with data coordinator
- Revised mechanics for connection with API and data retrieval
- Update saic-python-client-ng requirements to version 0.2.3
- Added new sensors for charging data
- Renamed and revised sensor data and info
- Revise config_flow to allow login with phone and email
- Initial implementation of services (some services still not available, but are implemented as a proof of concept). _Feedback on this will be helpful_
- Change update interval to 5 minutes once charging is detected
- Refactor API responses and values as needed. Charging sensors only display data if Charging is Active, otherwise 0 will be displayed
- Fuel Level, Fuel Range, EV State of Charge and Electric Range are vehicle dependent. Add logic to determine the vehicle type and show sensors accordingly.

0.0.2
- Revised mechanics for connection with API
- Added new sensors (Brand, Model and MY)
- Rename sensors based on Brand and Model
- Rename sensors to have them grouped by type (windows, doors, tyres...)
- Revise config_flow (_login with phone still not working and unavailable_)
- Initial trialing for charging details 

0.0.1
- Initial release

• Implement initial services for Locks action, AC control and ancillary services.
• Implement charging detection and corresponding sensors.
• Check API details for energy usage and stats, adding additional sensors.
• Check implementation against other EV/PHEV models.
• Add possibility to display metric or imperial data, including tyres' pressure.

Contributions are welcome! If you have any suggestions or find any issues, please open an issue or a pull request.

This integration was made possible thanks to the saic-ismart-client-ng repository and its developers/contributors.

This project is licensed under the MIT License. See the LICENSE file for details.

THIS PROJECT IS NOT IN ANY WAY ASSOCIATED WITH OR RELATED TO THE SAIC MOTOR OR ANY OF ITS SUBSIDIARIES. The information here and online is for educational and resource purposes only and therefore the developers do not endorse or condone any inappropriate use of it, and take no legal responsibility for the functionality or security of your devices.