Skip to content

v1.0.0 - Initial Release

Choose a tag to compare

@emanuelbesliu emanuelbesliu released this 25 Feb 14:08

BFT Gate Automation v1.0.0

๐ŸŽ‰ Initial public release of the BFT Home Assistant integration!

โœจ Features

  • ๐Ÿšช Control BFT gates - Open, close, and stop commands
  • ๐Ÿ“Š Real-time status monitoring - Know your gate position at all times
  • ๐Ÿ”„ Automatic state detection - Detects open, closed, moving, and stopped states
  • ๐Ÿ›ก๏ธ Robust error handling - Retry logic for unreliable BFT cloud API
  • ๐ŸŒ SSL/Connection resilience - Handles network issues gracefully
  • โšก Async initialization - Non-blocking startup for Home Assistant
  • โš™๏ธ Configurable - Adjust timeouts and retry counts
  • ๐Ÿงช Test script included - Verify your credentials before deploying

๐Ÿ“ฆ Installation

HACS (Custom Repository)

  1. Open HACS in Home Assistant
  2. Go to Integrations
  3. Click โ‹ฎ โ†’ Custom repositories
  4. Add: https://github.com/emanuelbesliu/homeassistant-bft
  5. Category: Integration
  6. Click Install
  7. Restart Home Assistant

Manual Installation

  1. Download homeassistant-bft-v1.0.0.zip from this release
  2. Extract to your Home Assistant custom_components directory:
    /config/custom_components/bft/
    
  3. Restart Home Assistant

๐Ÿ”ง Configuration

Add to your configuration.yaml:

cover:
  - platform: bft
    covers:
      driveway_gate:
        device: YOUR_DEVICE_NAME        # From BFT app
        username: !secret bft_username
        password: !secret bft_password
        name: Driveway Gate
        timeout: 20                     # Recommended for BFT API
        retry_count: 10                 # Recommended
        skip_initial_update: true       # For faster startup

๐Ÿงช Testing

Run the included test script to verify your credentials:

cd custom_components/bft
export BFT_USERNAME='your@email.com'
export BFT_PASSWORD='your_password'
export BFT_DEVICE='YOUR_DEVICE_NAME'
python3 test_auth.py

๐Ÿ“– Documentation

See README.md for:

  • Detailed configuration options
  • Multiple gate setup
  • Automation examples
  • Troubleshooting guide

โš ๏ธ Known Issues

  1. BFT API reliability - The BFT cloud API can be slow/unreliable. Use higher timeout (20s) and retry count (10) values.
  2. Initial status delay - First update may take 10-30 seconds after restart.
  3. State updates - Polling occurs every 5+ seconds (throttled).

๐Ÿ› Support

โœ… Tested With

  • Home Assistant 2023.1+
  • BFT uControl Cloud API
  • Single and dual gate motors

Full Changelog: https://github.com/emanuelbesliu/homeassistant-bft/commits/v1.0.0