Add RX8130 RTC Component Documentation (#5315)

* Added RX8130 Component Documentation

RX8130 RTC documentation.

* Corrected file name for RX8130

renamed rx1830.md to rx8130.md

---------

Co-authored-by: Jonathan Swoboda <154711427+swoboda1337@users.noreply.github.com>

Author: Beormund

content/automations/all_actions.md

@@ -23,6 +23,7 @@ title: ""
 - **dfrobot_sen0395:** `reset`, `settings`
 - **display_menu:** `down`, `enter`, `hide`, `left`, `right`, `show`, `show_main`, `up`
 - **ds1307:** `read_time`, `write_time`
+- **rx8130:** `read_time`, `write_time`
 - **esp32_ble_tracker:** `start_scan`, `stop_scan`
 - **event:** `trigger`
 - **ezo_pmp:** `arbitrary_command`, `change_i2c_address`, `clear_calibration`, `clear_total_volume_dosed`, `dose_continuously`, `dose_volume`, `dose_volume_over_time`, `dose_with_constant_flow_rate`, `find`, `pause_dosing`, `set_calibration_volume`, `stop_dosing`

content/components/_index.md

@@ -998,6 +998,7 @@ at the {{< docref "light/fastled" "FastLED Light" >}}.
 {{< imgtable >}}
 "Time Core","components/time/index","clock-outline.svg","dark-invert"
 "DS1307 RTC","components/time/ds1307","clock-outline.svg","dark-invert"
+"RX8130 RTC","components/time/rx8130","clock-outline.svg","dark-invert"
 "GPS Time","components/time/gps","crosshairs-gps.svg","dark-invert"
 "Home Assistant Time","components/time/homeassistant","home-assistant.svg","dark-invert"
 "PCF85063 RTC","components/time/pcf85063","clock-outline.svg","dark-invert"

content/components/time/rx8130.md

@@ -0,0 +1,92 @@
+---
+description: "RX8130 Time Source"
+title: "RX8130 Time Source"
+---
+
+You first need to set up the {{< docref "/components/i2c" "I2C" >}} component.
+
+```yaml
+# Example configuration entry
+time:
+  - platform: rx8130
+    id: rx8130_time
+```
+
+## Configuration variables
+
+- **address** (*Optional*, int): Manually specify the I²C address of the RTC. Defaults to `0x32`.
+- All other options from [Base Time Configuration](#base_time_config).
+
+{{< anchor "rx8130-write_time_action" >}}
+
+## `rx8130.write_time` Action
+
+This [Action](#config-action) triggers a synchronization of the current system time to the RTC hardware.
+
+{{< note >}}
+The RX8130 component will *not* write to the RTC clock if not triggered *explicitly* by this action.
+
+{{< /note >}}
+
+```yaml
+on_...:
+  - rx8130.write_time
+
+  # in case you need to specify the RX8130 id
+  - rx8130.write_time:
+      id: rx8130_time
+```
+
+{{< anchor "rx8130-read_time_action" >}}
+
+## `rx8130.read_time` Action
+
+This [Action](#config-action) triggers a synchronization of the current system time from the RTC hardware.
+
+{{< note >}}
+The RX8130 component will automatically read the RTC clock every 15 minutes by default and synchronize the
+system clock when a valid timestamp is read from the RTC. (The `update_interval` can be changed.)
+This action can be used to trigger *additional* synchronizations.
+
+{{< /note >}}
+
+```yaml
+on_...:
+  - rx8130.read_time
+
+  # in case you need to specify the RX8130 id
+  - rx8130.read_time:
+      id: rx8130_time
+```
+
+{{< anchor "rx8130-config_example" >}}
+
+## Full Configuration Example
+
+In a typical setup, you will have at least one additional time source to synchronize the RTC with. Such an
+external time source might not always be available e.g. due to a limited network connection.
+In order to have a valid, reliable system time, the system should read the RTC once at start and then try to
+synchronize with an external reliable time source.
+When a synchronization to another time source was successful, the RTC can be resynchronized.
+
+```yaml
+esphome:
+  on_boot:
+    then:
+      # read the RTC time once when the system boots
+      rx8130.read_time:
+
+time:
+  - platform: rx8130
+    # repeated synchronization is not necessary unless the external RTC
+    # is much more accurate than the internal clock
+    update_interval: never
+  - platform: homeassistant
+    # instead try to synchronize via network repeatedly ...
+    on_time_sync:
+      then:
+        # ... and update the RTC when the synchronization was successful
+        rx8130.write_time:
+```
+
+## See Also