MyTNB Integration for Home Assistant

A Home Assistant custom integration to monitor your Tenaga Nasional Berhad (TNB) smart meter energy usage and costs.

Features

• Monitor energy usage (kWh) from your TNB smart meter
• Monitor energy costs (MYR)
• Automatic updates every 30 minutes
• Configurable via Home Assistant UI
• Supports HACS installation

Installation

HACS (Recommended)

1. Install HACS if you haven't already
2. Go to HACS → Integrations
3. Click the three dots menu (⋮) → Custom repositories
4. Add this repository URL: https://github.com/feiming/homeassistant-MyTNB
5. Select category: Integration
6. Click Add
7. Search for "MyTNB" in HACS and install it
8. Restart Home Assistant

Manual Installation

1. Copy the mytnb folder from custom_components/mytnb to your Home Assistant custom_components directory:

   <config>/custom_components/mytnb/
   

2. Restart Home Assistant
3. Add the integration via Settings → Devices & Services → Add Integration

Configuration

1. Go to Settings → Devices & Services → Add Integration
2. Search for "Tenaga Nasional" or "MyTNB"
3. Enter your MyTNB account credentials:
   • Username: Your MyTNB email address
   • Password: Your MyTNB password
   • Smart Meter URL: The full URL to your smart meter page (found in your MyTNB account dashboard)

Finding Your Smart Meter URL

1. Log in to MyTNB
2. Navigate to Account Management → Smart Meter
3. Copy the full URL from your browser's address bar (it should look like: https://myaccount.mytnb.com.my/AccountManagement/SmartMeter/Index/TRIL?caNo=...)
4. Paste it into the Smart Meter URL field during setup

Sensors

The integration creates the following sensors:

• sensor.energy_usage: Total energy consumption in kWh (state class: total_increasing)
• sensor.energy_cost: Total energy cost in MYR (state class: total_increasing)

Both sensors:

• Update every 30 minutes
• Show data from the last 7 days
• Include attributes: sdpudcid, metric, view, granularity

Troubleshooting

Authentication Errors

If you encounter authentication errors:

• Verify your username and password are correct
• Ensure your Smart Meter URL is the complete URL including all query parameters
• Check that you can log in to the MyTNB website manually
• Try logging out and back in to MyTNB website to refresh your session

Connection Errors

If you see connection errors:

• Check your internet connection
• Verify the Smart Meter URL is correct and accessible
• Check Home Assistant logs for more details

No Data

If sensors show "unknown" or no data:

• Wait a few minutes for the first update (up to 30 minutes)
• Check Home Assistant logs for API errors
• Verify your smart meter is active and reporting data on the MyTNB website

Development

This integration was converted from a standalone Python script (get_smartmeter_data.py) into a Home Assistant custom integration.

Project Structure

homeassistant-MyTNB/
├── custom_components/
│   └── mytnb/
│       ├── __init__.py          # Integration setup
│       ├── manifest.json         # Integration metadata
│       ├── config_flow.py       # UI configuration flow
│       ├── sensor.py            # Sensor platform
│       ├── api.py               # MyTNB API client
│       ├── const.py             # Constants
│       ├── strings.json         # UI strings
│       └── translations/        # Translation files
├── hacs.json                    # HACS metadata
├── info.md                      # HACS info page
└── README.md                    # This file

Support

For issues and feature requests, please visit the GitHub repository.

License

See LICENSE file for details.