/kwh_to_won

한국전력 전기요금 계산기 (가정용)

Primary LanguagePython

전기요금계산 센서 (가정용) for HomeAssistant

주요기능

  • 전기요금 계산 센서
    • 전기 사용량을 사용요금으로 계산
    • 가정용저압, 고압 지원
    • 대가족할인 및 복지할인 계산 지원
    • 하계요금 지원
    • 슈퍼유저요금 지원
  • 예상사용량 센서
  • 예상사용요금 센서

한전 전기요금 자료 링크


스크린샷

kwh2won
screen1-0.jpg screen1-2.jpg screen1-3.jpg screen1-4.jpg


설치

  • 수동설치 또는 HACS를 이용해 설치를 할수 있습니다.

수동

  • HA 설치 경로 아래 custom_components에 kwh_to_won폴더 안의 전체 파일을 복사해줍니다.
    <config directory>/custom_components/kwh_to_won/
  • Home-Assistant 를 재시작합니다

HACS

  • Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.
    • HACS > Integretions > 우측상단 메뉴 > Custom repositories 선택
      • https://github.com/dugurs/kwh_to_won 주소 입력, Category에 'integration' 선택 후, 저장
    • HACS > Integretions 메뉴 선택 후, kwh_to_won 검색하여 설치

사용

통합구성요소 추가

  • Open your Home Assistant instance and start setting up a new integration.
    • 설정 > 기기및서비스 > 통합구성요소 추가하기 > kwh_to_won 검색하여 추가
  • 월간 전기 사용량 센서는 다음과 같은 속성이어야 합니다.
    • unit_of_measurement: kWh, device_class: energy, state_class: total_increasing
  • 전월 전기 사용량 센서는 다음과 같은 속성이어야 합니다.
    • unit_of_measurement: kWh, device_class: energy, state_class: total
  • 예상 전기 사용량 센서는 다음과 같은 속성이어야 합니다.
    • unit_of_measurement: kWh, device_class: energy, state_class: total

생성되는 센서

  • 통합구성요소 추가시 이름을 test로 했다면 다음과 같은 3개의 센서가 생성됩니다.
    • sensor.test_kwhto_won 전기요금 센서
    • sensor.test_kwhto_forecast 예상 사용량 센서
    • sensor.test_kwhto_forecast_won 예상 전기요금 센서
  • 전월 사용량, 전전월 사용량 센서를 입력 했다면 다름과 같은 센서가 추가로 생성 됩니다.
    • sensor.test_kwhto_won_prev 전월 전기요금 센서
    • sensor.test_kwhto_won_prev2 전전월 전기요금 센서
  • 보정계수를 0보다 크게 설정하면 다름과 같은 1개의 센서가 추가로 생성 됩니다.
    • sensor.test_kwhto_kwh 전기사용량 센서
    • 보정계수 = 실제(검침)사용량 / 측정(센서)사용량

월간 누적 사용량 센서 및 전월 사용량 센서

  • 검침일에 맞줘 카운팅되는 월간 누적 사용량 센서가 있어야 합니다.
  • 없다면 아래와같이 utility_meter를 이용해 만들어줘야 합니다.

# 매달 11일 0시 0분에 리셋 (검침 시작일 11일)
utility_meter:
  xxxx_energy_monthly:
    source: sensor.xxxx_energy
    cycle: monthly
    offset:
      days: 10

  • 전월 사용량 센서는 다음과 같이 만들수 있습니다. template 
template:
  - sensor:
      - name: "xxxx_energy_prev_monthly"
        unique_id: xxxx_energy_prev_monthly
        state: "{{ state_attr('sensor.xxxx_energy_monthly','last_period') |round(1) }}"
        unit_of_measurement: kWh
        device_class: energy
        attributes:
          state_class: total

  • 전전월 사용량 센서는 전월 사용량 센서를 이용해 다름과 같이 만들수 있습니다.
template:
  - sensor:
    - trigger:
        - platform: state
          entity_id: sensor.xxxx_energy_prev_monthly
      sensor:
        - name: xxxx_energy_prev2_monthly
          unique_id: "xxxx_energy_prev2_monthly"
          unit_of_measurement: kWh
          state: "{{ trigger.from_state.state }}"
          device_class: energy
          attributes:
            state_class: total

또는

input_number:
  xxxx_energy_prev2_monthly:
    name: "전기 전전월 사용량"
    unit_of_measurement: "kWh"
    icon: mdi:conuter
    min: 0
    max: 9999
    step: 0.01
    mode: box

automation:
  - id: '1713958xxxxxx'
    alias: xxxx_energy_prev2_monthly
    description: '전기 전전월 사용량'
    trigger:
    - platform: state
      entity_id:
      - sensor.xxxx_energy_prev_monthly
    condition:
    - condition: template
      value_template: '{{ trigger.to_state.state|float(0) > 0 and trigger.from_state.state|float(0) > 0 }}'
    action:
    - service: input_number.set_value
      data:
        value: '{{ trigger.from_state.state }}'
      target:
        entity_id: input_number.xxxx_energy_prev2_monthly
    mode: single

  • Wh단위를 kWh로 변경하는 방법.
template:
  sensor:
    - name: pmm_this_month_energy_kwh
      unique_id: "pmm_this_month_energy_kwh"
      state: "{{ states('sensor.pmm_xx_xx_xx_xx_xx_this_month_energy')|float / 1000 }}"
      unit_of_measurement: kWh
      device_class: energy
      attributes:
        state_class: total_increasing
        last_reset: "{{ state_attr('sensor.pmm_xx_xx_xx_xx_xx_this_month_energy','last_reset') }}"

보완 예정 사항


발견된 문제점

  • 전월 전기요금 센서 생성 후 사용안한으로 변경시 자동제거 안됨(수동삭제 가능)


판올림

Version Date 내용
v0.0.1 2021.12.13 템플릿센서 통합구서요소로 변경
v0.0.2 2021.12.14 할인 설정 지원
v0.0.3 2021.12.15 고압지원
v0.0.4 2021.12.16 오타수정
v0.0.5 2021.12.16 200kwh 이하 할인 금액 변수 누락 수정
v0.0.6 2021.12.18 구성옵션 추가 (재시작시반영), 마그레이션 버전을 고정
v1.0.0 2021.12.20 계산식 수정, 슈퍼사용자요금 추가, 복지할인 하계 구분
v1.1.0 2021.12.21 검침일을 검침시작일로, 센서의 속성지정
v1.1.1 2021.12.22 월이 바뀌었을때 월길이 계산 오류 수정
v1.1.3 2021.12.25 센서 입력에서 센서 선택으로 수정, entitiy_id 접미사 변경으로 마그래이션 불가 (지우고, 다시 등록필요)
v1.1.4 2021.12.25 검침일 선택형으로 수정, 누진계산 오류 수정, 예상 사용량 일수 계산 오류 수정
v1.1.5 2021.12.27 전력량단가를 환경비용요금 적용전단가(개정전단가)로 수정 (af950833님의 제보)
v1.1.6 2021.12.27 누진 계산 오류 수정
v1.1.7 2021.12.27 반올림 오차 수정
v1.1.8 2021.12.28 검침일이 말일일때 일수 계산 오류 수정, 오늘(now)이 갱신되지 않은 오류 수정
v1.1.9 2022.02.13 구성요소 생성, 수정시 값 즉시 반영 수정 (우기네님 소스 참고)
v1.1.10 2022.02.19 전월 사용요금 센서 추가
v1.2.0 2022.02.23 22년 4월 부터 변결될 요금제 적용
- 기후 환경요금 = 7.3 = RPS 5.9 + ETS 0.8 + 석탄발전 감축비용 0.6
- 전력단가 4.9원 인상, 22년 10월 부터 전력단가 4.9원 2차 인상
v1.2.1 2022.02.27 사용월 단가 찾기 방식 변경
v1.2.2 2022.07.04 22년 7-9월 연료비 조정액 +5원으로 확정 반영
복지할인폭 상향 반영(7-9월 한시적) - 보도자료
v1.2.3 2022.07.04 연료비 조정액 산정시점 수정, 대가족요금 계산 오류 수정
v1.2.4 2022.07.10 슈퍼유저 단가 오류 수정
v1.2.5 2022.08.30 보정계수 추가
v1.2.6 2022.09.07 필수사용량공제 폐지 적용, 예측사용량 분단위로 수정 @beowulf
v1.2.7 2022.10.01 10월 단가 인상분 반영
v1.2.8 2023.01.01 1월 단가 인상분 반영
v1.2.9 2023.01.07 비화성화된 엔터티 업데이트 오류 해결 @n-andflash
v1.2.10 2023.02.21 월간센서 선택 방법 entity selector로 수정, 전월센서 state_class가 total_increasing 혹은 measurement 선택 가능
v1.3.1 2023.05.04 HA 2023.5이상 오류 수정
v1.3.2 2023.05.16 단가인상 적용(8원) 5월16일부터 적용 이라 5월분은 오차발생(월단위 계산방식), 취약계층 할인 미반영(예정)
v1.3.3 2023.06.02 취약계층 할인 반영
v1.3.4 2023.06.20 bug fix
v1.4.0 2023.08.05 예상 사용량 센서 선택 옵션 추가
v1.4.1 2023.08.05 예상 사용량 센서 예상 요금 반영(누락 수정)
v1.4.2 2023.08.24 요금동결할인(취약계층 경감액) - 원미만 절사 반영
v1.4.3 2023.08.24 요금 속성 상세 추가, 할인액 초기화 오류 수정
v1.4.4 2023.08.29 전기요금계가 0이하면 부가세,전력기금 0원처리
v1.4.5 2023.08.29 전월,예상 센서 선택에서 입력으로 변경
v1.4.6 2023.09.25 예상사용량센서 입력시 상태 체크 제거 @oukene
v1.4.7 2023.10.02 전전월 사용량 선택 입력 추가
v1.4.8 2024.01.05 HA Core 2025.01 대응
v1.4.9 2024.03.05 HA Core 2025.01 대응
v1.4.10 2024.05.06 HA Core 2025.04 대응

도움