SmartVan Inclinometer Quick Start Guide

Powering the device

  1. Connect the device to a power supply (5V - 32V).
  2. You should see a red LED indicator. It will blink every second to indicate that the module is powered on and disconnected from Wi-Fi.
  3. If the device has never been connected to Wi-Fi before, it will immediately create its own access point.

Note: do not supply any voltage exceeding 3volts to either of the input terminals.

Configuring Wifi

When you power on the device for the first time wifi indicator will blink every second until it is connected to a network. To connect the device to your network you must first connect to the access point created by device itself.

  1. First on your phone / computer open your Wi-Fi settings and scan for local networks.
  2. Look for an access point named inclinometer-xxxxx and connect to it.
  3. Once connected to the device's access point, open a web browser and go to 1.2.3.4.
  4. The Wi-Fi setup page will load, displaying available networks.
  5. Select the Wi-Fi network that your Home Assistant hub is connected to and enter the password.
  6. Click Connect. The device will then stop serving its access point and attempt to connect to your selected wifi network.
  7. Your laptop or tablet will then disconnect from the device and reconnect back to your original wifi network and the device hotspot will no longer be visible.
  8. To check if the connection was successful, visit inclinometer-xxxxxx.local in your browser where you will see information about he device and some config options

Check for updates

Once the device has connected to your wifi and is connected to the internet, go to the System tab and check for updates to ensure you have the latest firmware.

Adopting Device in HomeAssistant

In order for the device to be discovered in HomeAssistant you must first install the SmartVan.io integration

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

Automatic Discovery

  1. Home Assistant will detect the device on the network and notify you that it is available for adoption.
  2. Open the Notifications section from the sidebar.
  3. Click Check it out, which will take you to the Devices & Services page.
  4. Locate the device under Discovered, then click Configure.
  5. In the dialog, click Submit.
  6. You will be prompted to assign the device to an area—choose any location you prefer.

Manual Adoption

  1. Go to Settings > Devices & Services.
  2. Click Add Integration (bottom right corner).
  3. Search for SmartVan.
  4. In the Host field, enter the ip address or hostname of your device and click Submit.
  5. Assign the device to an area of your choice.

Installing custom card

Using HACS (Recommended)

  1. Ensure you have HACS (Home Assistant Community Store) installed.
  2. Click on the install link below

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

Manual Installation

  1. Download the card files from the provided link.
  2. Place them in your Home Assistant www folder.
  3. Add a reference to the card in lovelace resources.

Adding the custom card to your dashboard

  1. Navigate to your Home Assistant dashboard.Click Edit Dashboard.
  2. Click Add Card and select the SmartVan card.
  3. Configure the card settings as needed.
  4. Click Save to finalize the setup.

Config paramaters

Enable

Toggle Inclinometer

As the name suggests, this is to disable/enable the inclinometer. Due to the frequency of the pitch and roll updates, the module should be disabled to avoid unessesary updates in HomeAssistant.

Pitch

Adjusted Pitch Angle

Pitch angle of inclinometer with offset compensation applied. When parked up and level press the calibration button to set this offset value.

Actual Pitch Angle

The pitch angle of the inclinometer without any compensation applied

Roll

Adjusted Roll Angle

Roll angle of inclinometer with offset compensation applied. When parked up and level press the calibration button to set this offset value.

Actual Roll Angle

The roll angle of the inclinometer without any compensation applied

Calibrate Pitch

Calibrate pitch

Press this when the van is parked up on flat ground to set the adjusted pitch angle to 0.

Reset Pitch Calibration

Press to reset the calibration and clear any pitch offset compensation.

Pitch adjustment angle

When the pitch calibration button is pressed, an offset value is stored in this entity. It can be adjusted manually if needed.

Calibrate Roll

Calibrate Roll

Press this when the van is parked up on flat ground to set the adjusted roll angle to 0.

Reset Roll Calibration

Press to reset the calibration and clear any roll offset compensation.

Roll Adjustment Angle

When the roll calibration button is pressed, an offset value is stored in this entity. It can be adjusted manually if needed.

Orientation

Orientation

The orientation of the device (with respect to the image of the vehicle in each corner).

Note that within the inclinometer card you can also flip the orientation

There are 4 options:

Option 1 - Flat
Option 2 - Upright
Option 3- Upright Sideways
Option 4 - Flat Sideways