Skip to content

Plugin real time

Martin Pihrt edited this page Oct 13, 2026 · 1 revision

Real Time and NTP time

Synchronizes system time with NTP and supported I2C real-time clocks.

At a glance

Item Value
Version 1.0.1
Category Hardware, displays and outputs
Author Martin Pihrt
License GPL-3.0
OSPy 3.0.211 or newer
Python 3.8 or newer
Permissions network, i2c, subprocess, system
Hardware platforms: raspberry_pi; interfaces: i2c; I²C: 0x68
Dependencies None
Python/OS packages smbus / python3-smbus (required)
Interfaces Mobile API v1
Source Open the plug-in directory

What it is for

Synchronizes system time with NTP and supported I2C real-time clocks.

How it works and how to configure it

Tested in Python 3+

The plug-in includes a plugin.json manifest and reports its worker, NTP configuration, latest NTP and RTC values, synchronization cycle and errors through the OSPy system health interface.

When is enabled synchronization RTC Time and NTP time, system time adjusted every hour from NTP server (is posible) or RTC time (if exists). Time from NTP server is saved to real time DS 1307 (on I2C bus 0x68) as HW time.

RTC Clocks:

  • DS1307, MCP79400, DS3231, PCF8563.

Plugin setup

  • Check Use real time DS1307: If checked use real time plugin is enabled.

  • Check Use NTP time: If checked use NTP time Time is adjusting every hour from NTP server.

  • Primary NTP server IP adress: Type IP adress or name for NTP server.

  • Secondary NTP server IP adress: Type IP adress or name for NTP server.

  • NTP port: Type port for NTP server (default is 123).

  • Status: Status window from the plugin.

The hardware should be connected as follows:

Visit Martin Pihrt's blog. for more information.

Note: For this plugin neaded enabled I2C bus and SMBus in system.

In-app help and settings notes

The following notes are generated from the help page shipped with this plug-in. Field names are also explained directly in the OSPy settings page.

When is enabled synchronization RTC Time and NTP time, system time adjusted every hour from NTP server (is posible) or RTC time (if exists). Time from NTP server is saved to real time DS 1307 as HW time.

NTP servers in Czech Republic NTP NTP servers in World NTP

DS1307 Real time

Connected via interface

On the main OSPy board by pihrt.com is already installed this RTC circuit.

Related links and diagrams

schematics

Support

Check OSPy → Diagnostics first and remove passwords, tokens, private addresses and other secrets before sharing logs. Report reproducible plug-in problems in the OSPy-plugins issue tracker.

Back to the plug-in catalog

Clone this wiki locally