nerves_time_rtc_nxp

<!--
  SPDX-FileCopyrightText: 2020 Connor Rigby
  SPDX-FileCopyrightText: 2020 Frank Hunleth
  SPDX-FileCopyrightText: 2023 Ryota Kinukawa
  SPDX-FileCopyrightText: 2025 Jon Carstens
  SPDX-License-Identifier: CC-BY-4.0
-->

# NervesTime.RTC.NXP

[![Hex version](https://img.shields.io/hexpm/v/nerves_time_rtc_nxp.svg "Hex version")](https://hex.pm/packages/nerves_time_rtc_nxp)
[![Nerves compatibility](https://compatibility.nerves-project.org/badge/nerves_time_rtc_nxp.svg)](https://compatibility.nerves-project.org/packages/nerves_time_rtc_nxp)
[![CircleCI](https://dl.circleci.com/status-badge/img/gh/nerves-time/nerves_time_rtc_nxp/tree/main.svg?style=svg)](https://dl.circleci.com/status-badge/redirect/gh/nerves-time/nerves_time_rtc_nxp/tree/main)
[![REUSE status](https://api.reuse.software/badge/github.com/nerves-time/nerves_time_rtc_nxp)](https://api.reuse.software/info/github.com/nerves-time/nerves_time_rtc_nxp)

NervesTime.RTC implementations for common NXP chips

## Currently supported modules

|model|datasheet|elixir module|
|:---:|---------|-------------|
| PCA8565 | https://www.nxp.com/docs/en/data-sheet/PCA8565.pdf | `NervesTime.RTC.NXP.PCA8565` |
| PCF8563 | https://www.nxp.com/docs/en/data-sheet/PCF8563.pdf | `NervesTime.RTC.NXP.PCF8563` |

## Using

First add this project to your `mix` dependencies:

```elixir
def deps do
  [
    {:nerves_time_rtc_nxp, "~> 0.2.0"}
  ]
end
```

And then update your `:nerves_time` configuration to point to it:

```elixir
config :nerves_time, rtc: NervesTime.RTC.NXP.PCA8565
```

It's possible to override the default I2C bus and address via options:

```elixir
config :nerves_time, rtc: {NervesTime.RTC.NXP.PCA8565, [bus_name: "i2c-2", address:
0x51]}
```

Check the logs for error messages if the RTC doesn't appear to work.