Brisbane-Bin-Day-Sensor

KO | EN

gitlite — search

#python #react #golang #machine-learning #rust #docker #nodejs #java #awesome #kubernetes #awesome-list #vue #ios #open-source

Brisbane-Bin-Day-Sensor

(★ 9)

Brisbane waste bin and kerbside collection day sensors with GUI configuration

Brisbane-Bin-Day-Sensor 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Brisbane Bin Day Sensor

This project creates two new Home Assistant binary sensors that provide details of bin collections in the Brisbane City Council area.  One sensor is for the "normal" (or optionally green bin) week while the other is for the recycle (yellow bin) week.  Two sensors are used to enable the creation of alerts in Home Assistant with names specific to the weeks.

If desired, a third optional sensor can be created for the annual kerbside collections which can also be used for alerts.

Multiple properties can be configured by adding additional services, each with their own sensor name and settings.

While most Councils provide details of their waste collection schedules via their Open Data portals there is no consistency or standards in how the data is structured (especially when it comes to the recycle week determination).  Therefore, it is not possible to create a generic sensor but you are welcome to fork this code and customize it for your particular Council.

## Installation (HACS) - Recommended
1. Click the button below to open the repository in HACS:

[![Open your Home Assistant instance and open a repository inside the HACS dialog.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=mark1foley&repository=Brisbane-Bin-Day-Sensor&category=integration)

2. Click **Download**.
3. Restart Home Assistant.

## Installation (Manual)
1. Download this repository as a ZIP (green button, top right) and unzip the archive
2. Copy `/custom_components/bne_wc` to your `<config_dir>/custom_components/` directory
   * You will need to create the `custom_components` folder if it does not exist
   * On Hassio the final location will be `/config/custom_components/bne_wc`
   * On Hassbian the final location will be `/home/homeassistant/.homeassistant/custom_components/bne_wc`

## Configuration

All configuration is GUI based.

![screenshot](https://raw.githubusercontent.com/mark1foley/Brisbane-Bin-Day-Sensor/main/Configuration.png)

1. Click the button below to start setup:

[![Open your Home Assistant instance and start setting up a new integration.](https://my.home-assistant.io/badges/config_flow_start.svg)](https://my.home-assistant.io/redirect/config_flow_start/?domain=bne_wc)

2. Select your *Suburb* then click **Submit**.
3. Select your *Street* then click **Submit**.
4. Select your *House Number*, optionally set a *Sensor Name* (defaults to "Brisbane Bin Day"), choose if you would like a Kerbside Collection Sensor, and set any other preferences, then click **Submit**.

You should then see details of the service created.

### Adding a Second Property

To monitor a second property, click **Add Service** and repeat the configuration steps above, giving the new service a distinct *Sensor Name* (e.g. "Mum's Place") so the sensors are easy to tell apart.

### Reconfiguring an Existing Service

To update settings for an existing service (sensor name, icons, alert hours etc):

1. Go to **Settings -> Devices & Services -> Brisbane Bin Day Sensor**
2. Use the *Kebab* (3 Dots) menu and select **Reconfigure**

### Changing the Collection Address

To change the collection address for an existing service:

1. Remove the existing service using the *Kebab* (3 Dots) menu
2. Click **Add Service** to add the new address

## Upgrading from v2.1.x

The `street` sensor attribute has been renamed to `street_name` to be consistent with the Brisbane Open Data API. If you have any automations or templates referencing the `street` attribute you will need to update them to use `street_name`.

## Sensor

The integration creates binary sensors with the name specified during configuration (default: "Brisbane Bin Day") with the following attributes.

- **name** (*String*): As specified in the configuration. The "recycle" week sensor has the suffix " (Recycle)"
- **Property Number** (*Integer*): As specified in the configuration
- **Alert Hours** (*Integer*): As specified in the configuration
- **Suburb** (*String*): Name of suburb returned from the Open Data website for the specified property
- **Street Name** (*String*): Name of street, road etc returned from the Open Data website for the specified property
- **House Number** (*String*): Lot/street number returned from the Open Data website for the specified property
- **Collection Day** (*String*): Collection day name (MONDAY, TUESDAY etc) for the specified property
- **Collection Zone** (*String*): Collection zone for the specified property. Used to determine which extra bin to put out for the next collection
- **Next Collection Date** (*DateTime*): Date and time of the next collection for the specified property
- **Extra Bin** (*String*): Name of the extra bin to be put out for the next collection (either 'Yellow/Recycle' or 'Green/Garden')
- **Due In** (*Integer*): Number of hours until the next collection for the specified property
- **Recycle Week**: true/false to indicate if this is the "recycle" week sensor
- **icon** (*String*): As specified in the configuration, or default of mdi:trash-can
- **friendly_name** (*String*): As specified in the configuration

## Kerbside Sensor

If configured, the integration creates a sensor with the name specified in the configuration with the following attributes.

- **name** (*String*): As specified in the configuration. The kerbside sensor has the suffix " (Kerbside)"
- **Next Kerbside Collection Date** (*DateTime*): Date and time of the day kerbside items will actually be collected
- **Next Kerbside On Footpath Date** (*DateTime*): Date and time of the day kerbside items need to be on the footpath ready for collection
- **Kerbside Due In** (*Integer*): Number of hours until kerbside items need to be on the footpath for the specified property
- **Kerbside Alert Hours** (*Integer*): As specified in the configuration
- **icon** (*String*): As specified in the configuration, or default of mdi:truck
- **friendly_name** (*String*): As specified in the configuration

The state of the sensor will be set to 'off' unless the 'Kerbside Due In' attribute is less than or equal to the 'Kerbside Alert Hours' when it will be set to 'on'. The state will return to 'off' when the 'Kerbside Due In' attribute reaches 0. Note that 'Kerbside Due In' is calculated relative to the 'Next Kerbside On Footpath Date' and not the 'Next Kerbside Collection Date'.

## Alerts

Home Assistant alerts that use notifications can be set up to monitor the state of the sensors. Here are some examples.

```yaml
  take_the_bin_out:
    name: Take the bin out (red bin only)
    entity_id: binary_sensor.brisbane_bin_day
    state: "on"
    repeat: 1
    can_acknowledge: false
    skip_first: false
    message: "Take the bin out (+ {{ state_attr('binary_sensor.brisbane_bin_day', 'extra_bin') }})!!!"
    notifiers:
      - persistent_notification
```

```yaml
  take_the_recycle_bin_out:
    name: Take the bins out (red + yellow bin)
    entity_id: binary_sensor.brisbane_bin_day_recycle
    state: "on"
    repeat: 60
    can_acknowledge: false
    skip_first: false
    notifiers:
      - persistent_notification
```

```yaml
  take_the_kerbside_collection_out:
    name: Take the kerbside collection items out
    entity_id: binary_sensor.brisbane_bin_day_kerbside
    state: "on"
    repeat: 60
    can_acknowledge: false
    skip_first: false
    notifiers:
      - persistent_notification
```

## Reporting an Issue

1. Go to Settings->Devices and services->Brisbane Bin Day Sensor
2. Use the *Kebab* (3 Dots) menu in the upper right-hand corner to enable debug logging
3. Verify you're still having the issue
4. File an issue in this Github Repository containing your HA log (Developer section > Info > Load Full Home Assistant Log)
   * You can paste your log file at pastebin https://pastebin.com/ and submit a link.
   * Please include details about your setup (Pi, NUC, etc, docker?, HASSOS?)
   * The log file can also be found at `/<config_dir>/home-assistant.log`

Brisbane-Bin-Day-Sensor

Brisbane-Bin-Day-Sensor 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Brisbane-Bin-Day-Sensor

Brisbane-Bin-Day-Sensor 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README