README.md

Mobile Vikings for Home Assistant

A Home Assistant integration to monitor Mobile Vikings BE services

Features

• View Customer Info such as name and account details.
• Track Loyalty Points: Available, blocked, and pending points.
• Monitor Invoices: Paid invoices, unpaid invoices, and the next expiration date.
• Access subscription details, including:
  • Data Usage: Remaining data and percentage used.
  • Voice Balance: Minutes usage details.
  • SMS Balance: SMS usage details.
  • Out of Bundle Costs.
  • Credit Balance.
  • Subscription Product Information.
  • SIM Alias.

---

Table of Contents

• Mobile Vikings for Home Assistant
  • Features
  • Table of Contents
  • Installation
    • Using HACS (recommended)
    • Manual
  • Available Sensors
    • Account Details
    • Invoices
    • Subscription Details
  • Contributions are welcome!
  • Troubleshooting
    • Enable debug logging
    • Disable debug logging and download logs
  • Screenshots
  • Code origin

Installation

Using HACS (recommended)

Click on this button:

or follow these steps:

1. Simply search for Mobile Vikings in HACS and install it easily.
2. Restart Home Assistant
3. Add the 'Mobile Vikings' integration via HA Settings > 'Devices and Services' > 'Integrations'
4. Provide your Mobile Vikings username and password

Manual

1. Copy the custom_components/mobile_vikings directory of this repository as config/custom_components/mobile_vikings in your Home Assistant instalation.
2. Restart Home Assistant
3. Add the 'Mobile Vikings' integration via HA Settings > 'Devices and Services' > 'Integrations'
4. Provide your Mobile Vikings username and password

This integration will set up the following platforms.

Platform	Description
mobile_vikings	Home Assistant component for Mobile Vikings BE services

Available Sensors

Account Details

Sensor Key	Description	Unit
customer_info	Customer's first name	Text
loyalty_points_available	Available loyalty points	€ (Euro)
loyalty_points_blocked	Blocked loyalty points	€ (Euro)
loyalty_points_pending	Pending loyalty points	€ (Euro)

Invoices

Sensor Key	Description	Unit
paid_invoices	Total paid invoices	Count
unpaid_invoices	Unpaid invoices total amount	€ (Euro)
next_invoice_expiration	Next invoice expiration date	Timestamp

Subscription Details

Sensor Key	Description	Unit
data_balance	Data usage percentage	%
data_remaining	Data remaining	GB
remaining_days	Days left in billing cycle	Days
period_percentage	Billing cycle usage percentage	%
voice_balance	Voice usage percentage	%
sms_balance	SMS usage percentage	%
out_of_bundle_cost	Out-of-bundle cost	€ (Euro)
credit	Available credit balance	€ (Euro)
product_info	Subscription product details	Text/Price
sim_alias	SIM alias	Text

---

Contributions are welcome!

If you want to contribute to this please read the Contribution guidelines

Troubleshooting

Enable debug logging

To enable debug logging, go to Settings -> Devices & Services and then click the triple dots for the Nexxtmove integration and click Enable Debug Logging.

Disable debug logging and download logs

Once you enable debug logging, you ideally need to make the error happen. Run your automation, change up your device or whatever was giving you an error and then come back and disable Debug Logging. Disabling debug logging is the same as enabling, but now you will see Disable Debug Logging. After you disable debug logging, it will automatically prompt you to download your log file. Please provide this logfile.

Screenshots

Code origin

The code of this Home Assistant integration has been written initially by analysing the calls made by the Mobile Vikings website.

The current version uses the MV Api as documented here: https://docs.api.unleashed.be/

I have no link with Mobile Vikings