IBA Tunnelflight Integration (Indoor Skydiving)

BruceH5200 · May 17, 2025, 4:09pm

IBA Tunnelflight Integration for Home Assistant

A custom integration that connects to the International Bodyflight Association (IBA) website and displays your indoor skydiving data in Home Assistant.

Features

Display your IBA membership status
Show flight skills (Static, Dynamic, and Formation levels)
Track total flight time
Monitor payment and currency expiry dates
Support for multiple IBA accounts in one Home Assistant instance
Log flight time directly from Home Assistant
Search for tunnels using a dynamic database

Installation

HACS Installation (Recommended)

Make sure you have HACS installed
Add this repository as a custom repository in HACS:
- Go to HACS → Integrations
- Click the three dots in the top right corner
- Select “Custom repositories”
- Add the URL: https://github.com/B-Hartley/tunnelflight
- Select “Integration” as the category
Click “Download” on the IBA Tunnelflight integration
Restart Home Assistant

Manual Installation

Create the directory structure in your Home Assistant configuration directory:
```
custom_components/tunnelflight/translations/
```
Copy these files to the tunnelflight directory:
- __init__.py
- api.py
- binary_sensor.py
- config_flow.py
- const.py
- logbook_service.py
- manifest.json
- sensor.py
- services.yaml
- And en.json to the translations subdirectory
Restart Home Assistant

Configuration

Go to Settings → Devices & Services → Add Integration
Search for “IBA Tunnelflight” and follow the setup process
Enter your IBA username and password
Optionally, provide a custom name for the integration

The integration verifies your credentials before completing the setup.

Available Entities

Each IBA account will create the following entities:

Sensors

sensor.iba_[username]: Main sensor showing membership status
sensor.iba_[username]_total_flight_time: Total flight time
sensor.iba_[username]_last_flight: Date of last flight
sensor.iba_[username]_static_level: Static flying level
sensor.iba_[username]_dynamic_level: Dynamic flying level
sensor.iba_[username]_formation_level: Formation flying level

Binary Sensors

binary_sensor.iba_[username]_flyer_currency: Flyer currency status with expiry date
binary_sensor.iba_[username]_payment_status: Payment status with expiry date

Services

The integration provides services that allow you to interact with your IBA account.

tunnelflight.log_flight_time

This service allows you to add new flight time entries to your Tunnelflight logbook directly from Home Assistant.

Parameters

Parameter	Type	Required	Description
tunnel_id	int	Yes	The ID of the tunnel where you flew
time	int	Yes	Flight time in minutes (1-120)
comment	string	No	Optional comment for the entry
entry_date	datetime	No	The date of the flight (defaults to current time)

Example Service Call

service: tunnelflight.log_flight_time
data:
  tunnel_id: 248  # Basingstoke iFLY
  time: 10  # 10 minutes of flight time
  comment: "Great session with Coach John"
  # entry_date is optional, defaults to current time

tunnelflight.find_tunnels

This service allows you to search for wind tunnels by name, city, or country. The results will be displayed as a persistent notification in Home Assistant.

Parameters

Parameter	Type	Required	Description
search_term	string	No	Search term to look for in tunnel name or city
country	string	No	Filter results by country
list_countries	boolean	No	Set to true to list all available countries with tunnels

Example Service Call

service: tunnelflight.find_tunnels
data:
  search_term: "manchester"
  country: "united kingdom"

To see a list of all available countries with wind tunnels:

service: tunnelflight.find_tunnels
data:
  list_countries: true

If you don't provide any parameters, the service will list all available tunnels.

## Finding Tunnel IDs

Instead of using hard-coded tunnel IDs, you can use the `tunnelflight.find_tunnels` service to dynamically search for tunnel information. This service will display a notification with matching tunnels and their IDs.

Example:
```yaml
service: tunnelflight.find_tunnels
data:
  search_term: "manchester"

This will show a notification with details about Manchester iFLY, including its ID that you can use in the log_flight_time service.

Some common tunnel IDs for reference:

225: Milton Keynes iFLY
242: Manchester iFLY
248: Basingstoke iFLY
245: Seattle iFLY
264: Downunder iFLY (Australia)
250: Toronto - Oakville iFLY

Skill Levels and Attributes

The skill sensors provide rich data about your IBA certification levels:

Attribute	Description
`state`	The numeric level (0, 1, 2, etc.)
`status`	Status: “Passed”, “Not Passed”, or “Pending”
`raw_value`	Raw value from IBA website (e.g., “Yes”, “No”, “Level 2”)
`pending`	Whether the certification is pending (true/false)
`level1`	Status of the prerequisite Level1 certification
`level1_pending`	Whether Level1 is pending

Dashboard Examples

Basic Card

type: entities
title: Indoor Skydiving
entities:
  - entity: sensor.iba_username
    name: Membership Status
  - entity: sensor.iba_username_total_flight_time
    name: Total Flight Time
  - entity: sensor.iba_username_last_flight
    name: Last Flight
  - entity: binary_sensor.iba_username_flyer_currency
    name: Flyer Currency
    secondary_info: attribute
    secondary_info_attribute: expiry_date
  - entity: binary_sensor.iba_username_payment_status
    name: Payment Status
    secondary_info: attribute
    secondary_info_attribute: expiry_date

Skills Card

type: glance
title: Flying Skills
entities:
  - entity: sensor.iba_username_static_level
    name: Static
    icon: mdi:alpha-s-circle
  - entity: sensor.iba_username_dynamic_level
    name: Dynamic
    icon: mdi:alpha-d-circle
  - entity: sensor.iba_username_formation_level
    name: Formation
    icon: mdi:alpha-f-circle

Log Flight Time Card

type: entities
title: Log Flight Time
entities:
  - entity: input_select.tunnelflight_tunnel
    name: Tunnel
  - entity: input_number.tunnelflight_flight_time
    name: Flight Time
  - entity: input_text.tunnelflight_comment
    name: Comment
  - type: button
    name: Log Flight Time
    tap_action:
      action: call-service
      service: tunnelflight.log_flight_time
      service_data:
        tunnel_id: >-
          {% set tunnel = states('input_select.tunnelflight_tunnel') %}
          {% if '(' in tunnel and ')' in tunnel %}
            {{ tunnel.split('(')[1].split(')')[0] }}
          {% else %}
            248
          {% endif %}
        time: "{{ states('input_number.tunnelflight_flight_time') | int }}"
        comment: "{{ states('input_text.tunnelflight_comment') }}"

Required configuration for the card above:

# Add to your configuration.yaml
input_select:
  tunnelflight_tunnel:
    name: Tunnel
    options:
      - Basingstoke iFLY (248)
      - Manchester iFLY (242)
      - Milton Keynes iFLY (225)
    initial: Basingstoke iFLY (248)
    icon: mdi:fan

input_number:
  tunnelflight_flight_time:
    name: Flight Time
    initial: 10
    min: 1
    max: 120
    step: 1
    mode: slider
    unit_of_measurement: min

input_text:
  tunnelflight_comment:
    name: Comment
    initial: ''

Conditional Card with Skill Status

type: conditional
conditions:
  - entity: sensor.iba_username_static_level
    state_not: "0"
card:
  type: markdown
  content: >
    ## Static Level {{ states('sensor.iba_username_static_level') }}
    
    Status: {{ state_attr('sensor.iba_username_static_level', 'status') }}

Automations

Payment Expiry Notification

- alias: IBA Payment Expiring Soon
  trigger:
    - platform: numeric_state
      entity_id: binary_sensor.iba_username_payment_status
      attribute: days_remaining
      below: 30
  action:
    - service: notify.mobile_app
      data:
        title: "IBA Payment Expiring Soon"
        message: "Your IBA payment expires in {{ state_attr('binary_sensor.iba_username_payment_status', 'days_remaining') }} days ({{ state_attr('binary_sensor.iba_username_payment_status', 'expiry_date') }})"

Currency Expiry Notification

- alias: IBA Currency Expiring Soon
  trigger:
    - platform: numeric_state
      entity_id: binary_sensor.iba_username_flyer_currency
      attribute: days_remaining
      below: 30
  action:
    - service: notify.mobile_app
      data:
        title: "IBA Currency Expiring Soon"
        message: "Your IBA currency expires in {{ state_attr('binary_sensor.iba_username_flyer_currency', 'days_remaining') }} days ({{ state_attr('binary_sensor.iba_username_flyer_currency', 'expiry_date') }})"

Log Weekly Flight Time

- alias: Log Weekly Tunnel Session
  trigger:
    - platform: time
      at: "20:00:00"
  condition:
    - condition: time
      weekday:
        - fri
  action:
    - service: tunnelflight.log_flight_time
      data:
        tunnel_id: 248  # Basingstoke iFLY
        time: 30
        comment: "Weekly training session"

Find Tunnel and Log Time

- alias: Find and Log Tunnel Time
  sequence:
    - service: tunnelflight.find_tunnels
      data:
        search_term: "{{ search_term }}"
    - delay:
        seconds: 5
    - service: tunnelflight.log_flight_time
      data:
        tunnel_id: "{{ tunnel_id }}"
        time: "{{ time }}"
        comment: "{{ comment }}"

Multiple Accounts

The integration supports multiple IBA accounts. Each account creates its own set of entities with the username included in the entity ID to avoid conflicts.

For example, if you have accounts for “bruceh” and “sarahh”, you’ll get:

sensor.iba_bruceh_total_flight_time
sensor.iba_sarahh_total_flight_time

Troubleshooting

Enable Debug Logging

Add this to your configuration.yaml file:

logger:
  default: info
  logs:
    custom_components.tunnelflight: debug

Common Issues

Authentication errors: Verify your IBA username and password
Missing data: The integration may not be able to find some data on the IBA website
Incorrect skill levels: Use the raw_value attribute to see what the IBA website is reporting
Service errors: If you get errors using services, check the logs for details

Privacy and Security

This integration stores your IBA credentials in Home Assistant’s configuration and uses them to log in to the IBA website. Your credentials are not sent anywhere else.

Credits

This integration is an independent community project and is not affiliated with or endorsed by the International Bodyflight Association.

Spiro · May 17, 2025, 4:21pm

I had a go at indoor skydiving. Now I know I won’t be blown away in a hurricane.

nickrout · May 19, 2025, 9:17am

I never knew such a thing existed. I am blown away.