Terus ke kandungan
solat.my

Home Assistant

Integrasi Waktu Solat Malaysia untuk Home Assistant

Custom component ini memaparkan waktu solat Malaysia terus dalam Home Assistant. Anda boleh gunakannya untuk automasi azan, papan pemuka, paparan TV Skrin Solat, pencetus kalendar dan tukar zon tanpa restart. Versi semasa: 1.0.15.

Ciri-ciri

  • 26 entiti dibuat secara automatik, termasuk sensor waktu solat, tarikh Hijri, arah kiblat, kalendar solat, zon, pemain media azan dan butang uji azan
  • Semua 59 zon JAKIM di seluruh Malaysia. Zon dipilih terlebih dahulu daripada lokasi rumah Home Assistant anda
  • Tukar zon bila-bila masa, dan semua sensor dikemas kini serta-merta tanpa restart
  • Jadual setahun disimpan dalam cakera. Waktu solat terus berfungsi walaupun solat.my tidak dapat dihubungi
  • Boleh tambah lebih daripada satu peranti, contohnya "Rumah" dan "Pejabat"
  • Tetapan melalui UI, tidak perlu edit YAML
  • Pilih mod pengumuman azan: suara TTS Google Translate atau rakaman MP3 sendiri
  • Enam blueprint automasi sedia import: azan harian, azan Jumaat, peringatan Imsak, peringatan sebelum solat, jeda dan sambung, serta azan berbilang bilik
  • Skrin Solat: kad paparan penuh untuk TV dan kiosk, dengan kiraan detik tempatan dan kawalan latar dari halaman peranti
  • Muat turun diagnostik dari halaman integrasi, dan notis Repairs jika kemas kini gagal lebih 30 minit

Pemasangan

DisyorkanMelalui HACS
  1. 1Buka repositori ini dalam HACS dengan butang di bawah, atau dalam HACS pergi ke menu tiga titik → Custom repositories, tambah URL ini dan pilih kategori Integration:
    https://github.com/mysolat/homeassistant
    Buka dalam HACS
  2. 2Cari “Waktu Solat Malaysia” dalam HACS dan klik Download
  3. 3Restart Home Assistant
Pemasangan Manual
  1. 1Muat turun atau klon repositori dari GitHub
  2. 2Salin folder custom_components/solat_my/ ke dalam direktori config/custom_components/
  3. 3Restart Home Assistant

Konfigurasi

  1. 1Pergi ke Settings → Devices & Services → Add Integration, atau klik butang ini: Mula tetapan dalam Home Assistant
  2. 2Cari “Waktu Solat Malaysia”
  3. 3Masukkan Nama Peranti, contohnya Waktu Solat. Nama ini jadi prefix bagi ID entiti.
  4. 4Semak zon anda, contohnya SGR01 — Selangor. Zon dipilih terlebih dahulu daripada lokasi rumah Home Assistant anda. Lokasi itu dihantar sekali ke solat.my, dibundarkan kepada kira-kira 1 km. Anda boleh pilih zon lain.
  5. 5Klik Submit. Semua 26 entiti akan terus muncul.
Untuk tukar zon kemudian, ubah entiti Zon di halaman peranti. Semua sensor dikemas kini serta-merta, tanpa restart.

Entiti yang Dibuat

Sensor Waktu Solat
ID EntitiNamaKeterangan
sensor.waktu_solat_imsakImsakWaktu Imsak (timestamp)
sensor.waktu_solat_subuhSubuhWaktu Subuh (timestamp)
sensor.waktu_solat_syurukSyurukWaktu Syuruk (timestamp)
sensor.waktu_solat_dhuhaDhuhaWaktu Dhuha (timestamp)
sensor.waktu_solat_zohorZohorWaktu Zohor (timestamp)
sensor.waktu_solat_asarAsarWaktu Asar (timestamp)
sensor.waktu_solat_maghribMaghribWaktu Maghrib (timestamp)
sensor.waktu_solat_isyakIsyakWaktu Isyak (timestamp)
sensor.waktu_solat_tarikh_hijriTarikh HijriTarikh Hijri, nama bulan dalam bahasa Melayu
sensor.waktu_solat_waktu_solat_seterusnyaWaktu Solat SeterusnyaWaktu solat seterusnya, dengan kiraan detik. Selepas Isyak: Subuh esok
sensor.waktu_solat_waktu_solat_semasaWaktu Solat SemasaWaktu solat yang sedang berjalan
sensor.waktu_solat_arah_kiblatArah KiblatArah kiblat zon dalam darjah dari utara benar, bukan utara magnet kompas telefon
Entiti Konfigurasi
ID EntitiNamaKeterangan
select.waktu_solat_zonZonZon semasa. Tukar zon ini untuk kemas kini semua sensor serta-merta.
select.waktu_solat_pemain_media_azanPemain Media AzanPemain media yang memainkan azan
select.waktu_solat_mod_pengumuman_azanMod Pengumuman Azantts (Google Translate) atau audio (rakaman MP3)
number.waktu_solat_kelantangan_azanKelantangan AzanKelantangan azan (0.0–1.0)
text.waktu_solat_fail_audio_azanFail Audio AzanNama fail azan, dipisahkan dengan koma
text.waktu_solat_fail_audio_azan_subuhFail Audio Azan SubuhNama fail azan Subuh, dipisahkan dengan koma
text.waktu_solat_fail_doa_selepas_azanFail Doa Selepas AzanNama fail audio doa selepas azan
select.waktu_solat_skrin_warna_latarSkrin Warna LatarWarna latar Skrin Solat: forest, midnight, slate, burgundy atau indigo
select.waktu_solat_skrin_paparan_latarSkrin Paparan LatarPapar atau sembunyikan imej latar Skrin Solat (on / off)
number.waktu_solat_skrin_kejelasan_latarSkrin Kejelasan LatarKejelasan imej latar Skrin Solat (0–100)
text.waktu_solat_skrin_imej_latarSkrin Imej LatarImej /local/... pilihan yang menggantikan latar asal
select.waktu_solat_skrin_format_masaSkrin Format MasaFormat masa Skrin Solat: 24h atau 12h
Butang
ID EntitiNamaKeterangan
button.waktu_solat_uji_main_azanUji Main AzanMainkan fail pertama Fail Audio Azan sekarang pada Pemain Media Azan, tanpa menunggu waktu solat
button.waktu_solat_uji_henti_azanUji Henti AzanHentikan Pemain Media Azan
Kalendar
ID EntitiNamaKeterangan
calendar.waktu_solat_kalendar_solatKalendar SolatSubuh, Zohor, Asar, Maghrib dan Isyak sebagai acara kalendar. Setiap acara bermula pada waktu solat dan dipaparkan selama 10 minit

Contoh Papan Pemuka

Panduan Papan Pemuka
Papan pemuka kad terbina dalam, tanpa HACS (YAML)

Buka papan pemuka → ikon pensel → tiga titik → Raw configuration editor, kemudian tampal blok ini. Ia menggantikan semua paparan sedia ada. Untuk kekalkan paparan lama, tampal paparan ini sahaja di bawah views: anda.

views:
  - title: Waktu Solat
    path: waktu-solat
    type: sections
    max_columns: 3
    sections:
      # Section 1: now and next
      - type: grid
        cards:
          - type: heading
            heading: Waktu Solat
            icon: mdi:mosque
            badges:
              - type: entity
                entity: sensor.waktu_solat_tarikh_hijri
                show_state: true
          - type: tile
            entity: sensor.waktu_solat_waktu_solat_seterusnya
            name: Seterusnya
            state_content:
              - state
              - time_24h
              - countdown
            grid_options:
              columns: 12
          - type: tile
            entity: sensor.waktu_solat_waktu_solat_semasa
            name: Semasa
            grid_options:
              columns: 6
          - type: tile
            entity: calendar.waktu_solat_kalendar_solat
            name: Kalendar
            grid_options:
              columns: 6
      # Section 2: today's times
      - type: grid
        cards:
          - type: heading
            heading: Hari ini
            icon: mdi:clock-outline
          - type: entities
            entities:
              - entity: sensor.waktu_solat_imsak
                name: Imsak
                format: time
              - entity: sensor.waktu_solat_subuh
                name: Subuh
                format: time
              - entity: sensor.waktu_solat_syuruk
                name: Syuruk
                format: time
              - entity: sensor.waktu_solat_dhuha
                name: Dhuha
                format: time
              - entity: sensor.waktu_solat_zohor
                name: Zohor
                format: time
              - entity: sensor.waktu_solat_asar
                name: Asar
                format: time
              - entity: sensor.waktu_solat_maghrib
                name: Maghrib
                format: time
              - entity: sensor.waktu_solat_isyak
                name: Isyak
                format: time
      # Section 3: azan settings and test buttons
      - type: grid
        cards:
          - type: heading
            heading: Tetapan azan
            icon: mdi:bullhorn
          - type: tile
            entity: select.waktu_solat_zon
            grid_options:
              columns: 12
          - type: tile
            entity: select.waktu_solat_pemain_media_azan
            grid_options:
              columns: 12
          - type: tile
            entity: number.waktu_solat_kelantangan_azan
            features:
              - type: numeric-input
                style: slider
            grid_options:
              columns: 12
          - type: tile
            entity: select.waktu_solat_mod_pengumuman_azan
            features:
              - type: select-options
            grid_options:
              columns: 12
          - type: tile
            entity: button.waktu_solat_uji_main_azan
            grid_options:
              columns: 6
          - type: tile
            entity: button.waktu_solat_uji_henti_azan
            grid_options:
              columns: 6
          - type: entities
            title: Fail audio
            entities:
              - text.waktu_solat_fail_audio_azan
              - text.waktu_solat_fail_audio_azan_subuh
              - text.waktu_solat_fail_doa_selepas_azan

Skrin Solat

Kad paparan penuh untuk TV dan kiosk, jenis kad custom:solat-my-skrin-solat-card. Integrasi ini sendiri menghidangkan kad itu, jadi tiada sumber papan pemuka perlu ditambah. Letak kad dalam paparan Panel. Tukar warna, imej dan format masa latar melalui entiti Skrin di halaman peranti. Kad ini tidak mengawal audio azan. Contoh YAML ada dalam Panduan Papan Pemuka.

Blueprint Automasi

Panduan Blueprint

Klik Import untuk buka blueprint dalam Home Assistant anda. Kemudian pergi ke Settings → Automations & Scenes → Create Automation → Use Blueprint dan pilih sensor serta pemain media anda.

Contoh Automasi Azan

Panduan Automasi
Azan Harian (YAML)
alias: "Azan Harian"
description: "Play azan for all prayer times via solat.my integration"
mode: single
triggers:
  - trigger: time
    at: sensor.waktu_solat_subuh
    id: subuh
  - trigger: time
    at: sensor.waktu_solat_zohor
    id: zohor
  - trigger: time
    at: sensor.waktu_solat_asar
    id: asar
  - trigger: time
    at: sensor.waktu_solat_maghrib
    id: maghrib
  - trigger: time
    at: sensor.waktu_solat_isyak
    id: isyak
conditions: []
actions:
  # Persistent notification
  - action: persistent_notification.create
    data:
      notification_id: solat_azan
      title: >
        🕋 Waktu Solat —
        {% set tid = trigger.id if trigger is defined else states('sensor.waktu_solat_waktu_solat_semasa') | lower %}
        {% set names = {'subuh': 'Subuh', 'syuruk': 'Syuruk', 'zohor': 'Zohor', 'asar': 'Asar', 'maghrib': 'Maghrib', 'isyak': 'Isyak'} %}
        {{ names.get(tid, 'Zohor') }}
      message: >
        {% set tid = trigger.id if trigger is defined else states('sensor.waktu_solat_waktu_solat_semasa') | lower %}
        {% set names = {'subuh': 'Subuh', 'syuruk': 'Syuruk', 'zohor': 'Zohor', 'asar': 'Asar', 'maghrib': 'Maghrib', 'isyak': 'Isyak'} %}
        {{ now().strftime('%-I:%M %p') }} — Sekarang telah masuk waktu
        {{ names.get(tid, 'Zohor') }} bagi kawasan ini dan kawasan yang sama waktu dengannya.

  # Mobile push notification
  - action: notify.notify
    data:
      title: >
        🕋 Waktu Solat —
        {% set tid = trigger.id if trigger is defined else states('sensor.waktu_solat_waktu_solat_semasa') | lower %}
        {% set names = {'subuh': 'Subuh', 'syuruk': 'Syuruk', 'zohor': 'Zohor', 'asar': 'Asar', 'maghrib': 'Maghrib', 'isyak': 'Isyak'} %}
        {{ names.get(tid, 'Zohor') }}
      message: >
        {% set tid = trigger.id if trigger is defined else states('sensor.waktu_solat_waktu_solat_semasa') | lower %}
        {% set names = {'subuh': 'Subuh', 'syuruk': 'Syuruk', 'zohor': 'Zohor', 'asar': 'Asar', 'maghrib': 'Maghrib', 'isyak': 'Isyak'} %}
        {{ now().strftime('%-I:%M %p') }} — Sekarang telah masuk waktu {{ names.get(tid, 'Zohor') }}.

  # Set volume — skipped if media player does not support it (e.g. TV)
  - if:
      - condition: template
        value_template: >
          {{ state_attr(states('select.waktu_solat_pemain_media_azan'), 'supported_features') | int(0) | bitwise_and(4) > 0 }}
    then:
      - action: media_player.volume_set
        target:
          entity_id: "{{ states('select.waktu_solat_pemain_media_azan') }}"
        data:
          volume_level: "{{ states('number.waktu_solat_kelantangan_azan') | float }}"

  # Announcement — TTS or pre-recorded audio based on user setting
  - choose:
      - conditions:
          - condition: template
            value_template: >
              {{ states('select.waktu_solat_mod_pengumuman_azan') == 'audio' }}
        sequence:
          - action: media_player.play_media
            target:
              entity_id: "{{ states('select.waktu_solat_pemain_media_azan') }}"
            data:
              media:
                media_content_type: audio/mp3
                media_content_id: >
                  {% set tid = trigger.id if trigger is defined else states('sensor.waktu_solat_waktu_solat_semasa') | lower %}
                  media-source://media_source/local/tts/tts_{{ tid }}.mp3
                metadata: {}
          - delay: "00:00:10"
    default:
      - action: tts.google_translate_say
        data:
          entity_id: "{{ states('select.waktu_solat_pemain_media_azan') }}"
          language: id
          message: >
            {% set tid = trigger.id if trigger is defined else states('sensor.waktu_solat_waktu_solat_semasa') | lower %}
            {% set names = {'subuh': 'Subuh', 'syuruk': 'Syuruk', 'zohor': 'Zohor', 'asar': 'Asar', 'maghrib': 'Maghrib', 'isyak': 'Isyak'} %}
            Sekarang telah masuk waktu {{ names.get(tid, 'Zohor') }}.
      - delay: "00:00:10"

  # Play azan audio (random selection from text entity)
  - action: media_player.play_media
    target:
      entity_id: "{{ states('select.waktu_solat_pemain_media_azan') }}"
    data:
      extra:
        title: >
          {% set tid = trigger.id if trigger is defined else states('sensor.waktu_solat_waktu_solat_semasa') | lower %}
          {% set names = {'subuh': 'Subuh', 'syuruk': 'Syuruk', 'zohor': 'Zohor', 'asar': 'Asar', 'maghrib': 'Maghrib', 'isyak': 'Isyak'} %}
          Azan {{ names.get(tid, 'Zohor') }}
        thumb: "https://solat.my/icon-512.png"
      media:
        media_content_type: audio/mp3
        media_content_id: >
          {% set tid = trigger.id if trigger is defined else states('sensor.waktu_solat_waktu_solat_semasa') | lower %}
          {% if tid == 'subuh' %}
            {{ "media-source://media_source/local/azan/" ~ states('text.waktu_solat_fail_audio_azan_subuh').split(', ') | random | trim }}
          {% else %}
            {{ "media-source://media_source/local/azan/" ~ states('text.waktu_solat_fail_audio_azan').split(', ') | random | trim }}
          {% endif %}
        metadata: {}

  # Wait for azan to finish, then play doa
  - choose:
      - conditions:
          - condition: template
            value_template: >
              {% set tid = trigger.id if trigger is defined else states('sensor.waktu_solat_waktu_solat_semasa') | lower %}
              {{ tid == 'subuh' }}
        sequence:
          - delay:
              minutes: 4
              seconds: 30
    default:
      - delay:
          minutes: 2
          seconds: 47

  # Play doa selepas azan
  - action: media_player.play_media
    alias: "Doa Selepas Azan"
    target:
      entity_id: "{{ states('select.waktu_solat_pemain_media_azan') }}"
    data:
      media:
        media_content_id: media-source://media_source/local/azan/doa_selepas_azan.mp3
        media_content_type: audio/mpeg
        metadata:
          title: doa_selepas_azan.mp3
          media_class: music
Pencetus kalendar: peringatan 10 minit sebelum Maghrib (YAML)

Kalendar Solat memulakan satu acara pada setiap waktu solat. Gunakan event: start dengan offset negatif untuk bertindak sebelum waktu solat. Tempoh 10 minit acara itu untuk paparan sahaja, bukan tanda waktu solat tamat.

triggers:
  - trigger: calendar
    event: start
    offset: "-0:10:00"
    entity_id: calendar.waktu_solat_kalendar_solat
conditions:
  - condition: template
    value_template: "{{ trigger.calendar_event.summary == 'Maghrib' }}"
actions:
  - action: notify.notify
    data:
      message: "Maghrib dalam 10 minit."

Kod sumber ada di GitHub. Laporkan masalah atau hantar pull request di sana.

github.com/mysolat/homeassistant →