Device Help - delize/home-assistant-loggamera-integration GitHub Wiki

Device Help

Having problems with a Loggamera device in Home Assistant? This guide helps you get support, whether you're technical or not.

🔍 Quick Device Check

What's Your Situation?

What You See Status Action
✅ Device works perfectly All good! Nothing needed
⚠️ Shows as "Unknown Device" Needs help Get support ⬇️
⚠️ Sensors say "Unknown" Needs mapping Get support ⬇️
❌ Device missing entirely Not supported Get support ⬇️
🔧 Some sensors missing Incomplete Check settings first

Check Settings First

Before requesting help, try enabling disabled sensors:

  1. Settings → Devices & Services → Loggamera
  2. Click your device
  3. Look for greyed-out sensors
  4. Click "Enable" on sensors you want

Many detailed sensors are disabled by default to avoid clutter.

📝 Request Device Support

Step 1: Gather Information

From Home Assistant:

  • Note device names showing as "Unknown"
  • List missing devices you expected to see
  • Check which sensors don't work

From Loggamera Portal:

  • Log into your Loggamera account
  • Note what devices and sensors you see there
  • Compare with Home Assistant

Step 2: Create Support Request

Choose your method:

GitHub Issue (Recommended)

  1. Create New Issue
  2. Fill out template below

GitHub Discussion

  1. Start Discussion
  2. Choose "General" category
  3. Fill out template below

Step 3: Support Request Template

Copy and complete this template:

## Device Support Request

### System Information
- **Home Assistant Version**: [Settings → System → Info]
- **Integration Version**: [HACS or Settings → Devices & Services]
- **Installation Method**: HACS / Manual

### Problem Description
- [ ] Device doesn't appear in Home Assistant
- [ ] Device shows as "Unknown Device"
- [ ] Sensors show as "Unknown"
- [ ] Missing sensors (I see them in Loggamera portal)
- [ ] Other: [describe]

### Device Details
**Device Name**: [What you call it]
**Device Type**: [electricity meter, water meter, temperature sensor, etc.]
**In Loggamera Portal**: [What sensors/data you see on website]
**In Home Assistant**: [What appears, or "nothing"]

### Expected Result
[What you thought you'd see in Home Assistant]

### Additional Info
[Any other relevant details]

### Can Help Test?
- [ ] Yes, I can test fixes
- [ ] No, just notify when ready

🛠️ For Technical Users

If comfortable with commands, provide additional diagnostic info:

Get Diagnostic Information

Using Home Assistant Terminal:

  1. Install "Terminal & SSH" add-on (if needed)
  2. Open Terminal
  3. Run this command:
python3 /config/custom_components/loggamera/tools/test_connection.py YOUR_API_KEY
  1. Copy results to your support request
  2. Replace your real API key with "YOUR_API_KEY_HERE" before sharing

This provides:

  • Complete device discovery information
  • Endpoint testing results
  • Technical details for developers

Advanced Diagnostics

# Complete diagnostic report
python3 /config/custom_components/loggamera/tools/loggamera_diagnostic.py YOUR_API_KEY --verbose

# Organization mapping  
python3 /config/custom_components/loggamera/tools/organization_mapper.py YOUR_API_KEY --format json

# Sensor validation
python3 /config/custom_components/loggamera/tools/validate_sensor_mappings.py

Attach output files to your support request (with sensitive data removed).

📞 What Happens Next

Support Process

  1. Developer reviews your request (1-2 days)
  2. Questions/clarification if needed
  3. Development work (1-7 days depending on complexity)
  4. Testing phase (you may be asked to test)
  5. Release (included in next update)

Timeline Expectations

  • Similar to existing devices: 1-3 days
  • New device types: 1-2 weeks
  • Complex/unique devices: Longer, may need more info

How to Help

  • Be specific about what's wrong
  • Provide screenshots if possible
  • Respond quickly to developer questions
  • Test development versions when ready

🛡️ Privacy Guidelines

Safe to Share

  • Device types and purposes
  • Sensor names and units
  • System versions
  • Problem descriptions
  • Screenshots of device lists

Keep Private

  • Your actual API key → Use "YOUR_API_KEY_HERE"
  • Personal addresses → Use "Main House" instead of "123 Oak St"
  • Specific usage numbers → Focus on functionality issues
  • Organization names with personal info

Example Sanitization

Before: "Kitchen Meter at 123 Oak Street"
After: "Kitchen Meter"

Before: ApiKey: "abc123-real-key-xyz789"
After: ApiKey: "YOUR_API_KEY_HERE"

🎉 Success Examples

Recent Success Stories

"Water meter showing as Unknown"

  • Problem: Device appeared but all sensors said "Unknown"
  • Solution: Developer added WaterMeter sensor mappings
  • Timeline: Fixed in 2 days

"Missing heating system sensors"

  • Problem: HeatMeter device not supported at all
  • Solution: Full HeatMeter support via RawData endpoint
  • Timeline: Implemented in 5 days

"EV charger not working"

  • Problem: ChargingStation showed no useful sensors
  • Solution: Complete ChargingStation sensor mappings added
  • Timeline: Working in 3 days

User Feedback

"I just described what wasn't working and they fixed it in a few days. Much easier than I expected!" - Sarah M.

"My heating sensors were all 'Unknown' but now I can monitor my whole heating system!" - Mike K.

❓ Common Questions

Q: I'm not technical - can I still get help?
A: Absolutely! Just describe what's wrong. No technical knowledge needed.

Q: Does this cost anything?
A: No! The integration is free and open source.

Q: How long will it take?
A: Usually a few days to a week, depending on device complexity.

Q: What if my device is really unusual?
A: Still worth asking! Developers enjoy supporting new device types.

Q: Can I help if I'm not a programmer?
A: Yes! You can test fixes and provide feedback on functionality.

🔄 After Getting Help

When Fixed

  1. Update integration via HACS
  2. Restart Home Assistant
  3. Check device - should work properly now
  4. Leave feedback on your original request

Pay It Forward

  • Help others with similar devices
  • Share your experience in discussions
  • Test new features when available

Remember: Your device information helps improve the integration for everyone! Don't hesitate to ask for help. 🚀

Related Guides: