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
- 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:Buka dalam HACS
https://github.com/mysolat/homeassistant - 2Cari “Waktu Solat Malaysia” dalam HACS dan klik Download
- 3Restart Home Assistant
Pemasangan Manual
- 1Muat turun atau klon repositori dari GitHub
- 2Salin folder
custom_components/solat_my/ke dalam direktoriconfig/custom_components/ - 3Restart Home Assistant
Konfigurasi
- 1Pergi ke Settings → Devices & Services → Add Integration, atau klik butang ini: Mula tetapan dalam Home Assistant
- 2Cari “Waktu Solat Malaysia”
- 3Masukkan Nama Peranti, contohnya
Waktu Solat. Nama ini jadi prefix bagi ID entiti. - 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. - 5Klik Submit. Semua 26 entiti akan terus muncul.
Entiti yang Dibuat
Sensor Waktu Solat
| ID Entiti | Nama | Keterangan |
|---|---|---|
sensor.waktu_solat_imsak | Imsak | Waktu Imsak (timestamp) |
sensor.waktu_solat_subuh | Subuh | Waktu Subuh (timestamp) |
sensor.waktu_solat_syuruk | Syuruk | Waktu Syuruk (timestamp) |
sensor.waktu_solat_dhuha | Dhuha | Waktu Dhuha (timestamp) |
sensor.waktu_solat_zohor | Zohor | Waktu Zohor (timestamp) |
sensor.waktu_solat_asar | Asar | Waktu Asar (timestamp) |
sensor.waktu_solat_maghrib | Maghrib | Waktu Maghrib (timestamp) |
sensor.waktu_solat_isyak | Isyak | Waktu Isyak (timestamp) |
sensor.waktu_solat_tarikh_hijri | Tarikh Hijri | Tarikh Hijri, nama bulan dalam bahasa Melayu |
sensor.waktu_solat_waktu_solat_seterusnya | Waktu Solat Seterusnya | Waktu solat seterusnya, dengan kiraan detik. Selepas Isyak: Subuh esok |
sensor.waktu_solat_waktu_solat_semasa | Waktu Solat Semasa | Waktu solat yang sedang berjalan |
sensor.waktu_solat_arah_kiblat | Arah Kiblat | Arah kiblat zon dalam darjah dari utara benar, bukan utara magnet kompas telefon |
Entiti Konfigurasi
| ID Entiti | Nama | Keterangan |
|---|---|---|
select.waktu_solat_zon | Zon | Zon semasa. Tukar zon ini untuk kemas kini semua sensor serta-merta. |
select.waktu_solat_pemain_media_azan | Pemain Media Azan | Pemain media yang memainkan azan |
select.waktu_solat_mod_pengumuman_azan | Mod Pengumuman Azan | tts (Google Translate) atau audio (rakaman MP3) |
number.waktu_solat_kelantangan_azan | Kelantangan Azan | Kelantangan azan (0.0–1.0) |
text.waktu_solat_fail_audio_azan | Fail Audio Azan | Nama fail azan, dipisahkan dengan koma |
text.waktu_solat_fail_audio_azan_subuh | Fail Audio Azan Subuh | Nama fail azan Subuh, dipisahkan dengan koma |
text.waktu_solat_fail_doa_selepas_azan | Fail Doa Selepas Azan | Nama fail audio doa selepas azan |
select.waktu_solat_skrin_warna_latar | Skrin Warna Latar | Warna latar Skrin Solat: forest, midnight, slate, burgundy atau indigo |
select.waktu_solat_skrin_paparan_latar | Skrin Paparan Latar | Papar atau sembunyikan imej latar Skrin Solat (on / off) |
number.waktu_solat_skrin_kejelasan_latar | Skrin Kejelasan Latar | Kejelasan imej latar Skrin Solat (0–100) |
text.waktu_solat_skrin_imej_latar | Skrin Imej Latar | Imej /local/... pilihan yang menggantikan latar asal |
select.waktu_solat_skrin_format_masa | Skrin Format Masa | Format masa Skrin Solat: 24h atau 12h |
Butang
| ID Entiti | Nama | Keterangan |
|---|---|---|
button.waktu_solat_uji_main_azan | Uji Main Azan | Mainkan fail pertama Fail Audio Azan sekarang pada Pemain Media Azan, tanpa menunggu waktu solat |
button.waktu_solat_uji_henti_azan | Uji Henti Azan | Hentikan Pemain Media Azan |
Kalendar
| ID Entiti | Nama | Keterangan |
|---|---|---|
calendar.waktu_solat_kalendar_solat | Kalendar Solat | Subuh, Zohor, Asar, Maghrib dan Isyak sebagai acara kalendar. Setiap acara bermula pada waktu solat dan dipaparkan selama 10 minit |
Contoh Papan Pemuka
Panduan Papan PemukaPapan 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_azanSkrin 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 BlueprintKlik 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.
- Import →
azan_harianAzan untuk lima waktu solat, dengan pengumuman dan doa
- Import →
azan_jumaatAzan Jumaat pada waktu Zohor hari Jumaat
- Import →
peringatan_imsakPeringatan pada waktu Imsak
- Import →
peringatan_sebelum_solatPeringatan sebelum waktu solat pilihan
- Import →
azan_jeda_sambungJeda pembesar suara yang sedang main, mainkan azan dan doa, kemudian sambung semula
- Import →
azan_multi_roomAzan pada beberapa pembesar suara serentak
Contoh Automasi Azan
Panduan AutomasiAzan 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: musicPencetus 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 →