Skip to content

Commit

Permalink
Merge pull request #232 from jay-oswald/docs-more-hacs-steps
Browse files Browse the repository at this point in the history
adding more hacs steps to docs
  • Loading branch information
meatpiHQ authored Oct 16, 2024
2 parents f7586e0 + 056da6e commit 77b42d7
Show file tree
Hide file tree
Showing 3 changed files with 20 additions and 20 deletions.
40 changes: 20 additions & 20 deletions docs/content/1.home assistant/integration_setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,48 +8,45 @@ WiCAN can be integrated with Home Assistant using the official integration. This

## Integration Device Setup


<img width="373" alt="image" src="https://github.com/user-attachments/assets/3febdd0f-5013-4f70-aadd-dba9fdebf2ec">


![image](/ha/automate.png){width=300}

To connect WiCAN to Home Assistant, you first need to connect it to the same WiFi network as Home Assistant.

1. **Connect to WiCAN Access Point**:
Connect to the device's access point named **WiCAN\_xxxxxxx**. The default password is `@meatpi#`. It is recommended **to change the password** for safety reasons.

2. **Note the mDNS Name**:
1. **Note the mDNS Name**:
In the **Status** tab, take note of the mDNS name. It should look something like `wican_xxxxxxxxxxxx.local`. `xxxxxxxxxxxx` is the device unique ID.

3. **Connect WiCAN to Home WiFi**:
1. **Connect WiCAN to Home WiFi**:
Connect WiCAN to the same WiFi network as Home Assistant. In the WiCAN settings, change the **Mode** to **AP+Station**, and fill in your WiFi SSID and password.

4. **Change the Protocol**:
1. **Change the Protocol**:
Set the **Protocol** to AutoPid.

5. **Submit and Reboot**:
1. **Submit and Reboot**:
Click on the **Submit** button. The device will reboot on its own.

6. **Access WiCAN via mDNS**:
1. **Access WiCAN via mDNS**:
Disconnect from the WiCAN access point, and using your web browser, go to the mDNS name you noted earlier, e.g., `wican_xxxxxxxxxxxx.local`.

7. **Enable Vehicle Specific Settings**:
1. **Enable Vehicle Specific Settings**:
On the webpage, go to the **Automate** tab and enable **Vehicle Specific** settings.

8. **Sync Vehicle Model**:
Press the <img width="17" alt="image" src="https://github.com/user-attachments/assets/6988becc-fb6a-467a-8a5e-6ea83ae3e00c"> button next to **Vehicle Model** to fetch supported vehicle models.
1. **Sync Vehicle Model**:
Press the button next to **Vehicle Model** to fetch supported vehicle models.

9. **Select Vehicle Model**:
1. **Select Vehicle Model**:
Select your vehicle model from the dropdown list.
If your vehicle model is not yet supported, please open an issue on GitHub, and we will walk you through adding support.

10. **Set Cycle Time**:
1. **Set Cycle Time**:
Set the **Cycle Time** in milliseconds. This defines how often WiCAN will request parameters from the ECU.

11. **Destination Topic** (optional):
1. **Destination Topic** (optional):
This field is only used for MQTT communication.

12. **Store and Reboot**:
1. **Store and Reboot**:
Click on the **Store** button, then go to the **About** tab to reboot the device.


Expand All @@ -59,20 +56,23 @@ The WiCAN integration is available through HACS. You can find the integration re

1. **Install the Integration via HACS**:
Add the integration repository link to HACS and install the **WiCAN** integration.
1. Follow the official guide to [add a custom repository](https://www.hacs.xyz/docs/faq/custom_repositories/). The Repository URL is `https://github.com/jay-oswald/ha-wican` and it is an `Integration`
1. Follow the official guide to [download a repository](https://www.hacs.xyz/docs/use/repositories/dashboard/#downloading-a-repository)


2. **Navigate to Integrations**:
1. **Navigate to Integrations**:
In Home Assistant, go to **Settings** > **Devices & Services** > **Integrations**.

3. **Add WiCAN Hub**:
1. **Add WiCAN Hub**:
Click on **Add Integration**, search for **WiCAN**, and select it.

4. **Enter mDNS**:
1. **Enter mDNS**:
Enter the mDNS name that you noted earlier (`wican_xxxxxxxxxxxx.local`) to connect the WiCAN device.

After completing these steps, WiCAN will be connected to Home Assistant, and you will be able to monitor the available car parameters directly from the Home Assistant interface.


<img width="899" alt="image" src="https://github.com/user-attachments/assets/c778fc1c-2929-4b4c-b661-f6a788200f32">
![example](/ha/example.png)



Binary file added docs/public/ha/automate.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/public/ha/example.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 77b42d7

Please sign in to comment.