English | 简体中文 | 繁體中文 | 日本語 | Deutsch | 한국어
Der DS3231 ist eine kostengünstige, extrem genaue I2C-Echtzeituhr (RTC) mit einem integrierten temperaturkompensierten Quarzoszillator (TCXO) und Quarz. Das Gerät verfügt über einen Batterieeingang und behält die genaue Zeitmessung bei, wenn die Hauptstromversorgung des Geräts unterbrochen wird. Die Integration des Kristallresonators verbessert die Langzeitgenauigkeit des Geräts und reduziert die Stückzahl in einer Fertigungslinie. Der DS3231 ist in kommerziellen und industriellen Temperaturbereichen erhältlich und wird in einem 16-Pin-300-mil-SO-Gehäuse angeboten.
LibDriver DS3231 ist ein voll funktionsfähiger Treiber von ds3231, der von LibDriver gestartet wurde. Er bietet Zeitablesung, Weckerauslösung, Temperaturmessung, Rechteckwellenausgabe und andere Funktionen. LibDriver ist MISRA-konform.
/src enthält LibDriver DS3231-Quelldateien.
/interface enthält die plattformunabhängige Vorlage LibDriver DS3231 IIC.
/test enthält den Testcode des LibDriver DS3231-Treibers und dieser Code kann die erforderliche Funktion des Chips einfach testen.
/example enthält LibDriver DS3231-Beispielcode.
/doc enthält das LibDriver DS3231-Offlinedokument.
/Datenblatt enthält DS3231-Datenblatt.
/project enthält den allgemeinen Beispielcode für Linux- und MCU-Entwicklungsboards. Alle Projekte verwenden das Shell-Skript, um den Treiber zu debuggen, und die detaillierten Anweisungen finden Sie in der README.md jedes Projekts.
/misra enthält die Ergebnisse des LibDriver MISRA Code Scans.
Verweisen Sie auf eine plattformunabhängige IIC-Schnittstellenvorlage und stellen Sie Ihren Plattform-IIC-Treiber fertig.
Fügen Sie das Verzeichnis /src, den Schnittstellentreiber für Ihre Plattform und Ihre eigenen Treiber zu Ihrem Projekt hinzu. Wenn Sie die Standardbeispieltreiber verwenden möchten, fügen Sie das Verzeichnis /example zu Ihrem Projekt hinzu.
Sie können auf die Beispiele im Verzeichnis /example zurückgreifen, um Ihren eigenen Treiber zu vervollständigen. Wenn Sie die Standardprogrammierbeispiele verwenden möchten, erfahren Sie hier, wie Sie diese verwenden.
#include "driver_ds3231_basic.h"
uint8_t res;
ds3231_time_t time;
int16_t raw;
float s;
res = ds3231_basic_init();
if (res != 0)
{
return 1;
}
...
res = ds3231_basic_get_temperature((int16_t *)&raw, (float *)&s);
if (res != 0)
{
(void)ds3231_basic_deinit();
return 1;
}
ds3231_interface_debug_print("ds3231: temperature is %0.2fC.\n", s);
...
mode = DS3231_ALARM1_MODE_ONCE_A_SECOND;
time.am_pm = DS3231_AM;
time.date = data;
time.format = DS3231_FORMAT_24H;
time.hour = hour;
time.minute = minute;
time.month = month;
time.second = second;
time.week = week;
time.year = year;
res = ds3231_basic_set_time(&time);
if (res != 0)
{
(void)ds3231_basic_deinit();
return 1;
}
...
res = ds3231_basic_get_time(&time);
if (res != 0)
{
(void)ds3231_basic_deinit();
return 1;
}
if (time.format == DS3231_FORMAT_24H)
{
ds3231_interface_debug_print("ds3231: %04d-%02d-%02d %02d:%02d:%02d %d.\n",
time.year, time.month, time.date,
time.hour, time.minute, time.second, time.week
);
}
else
{
ds3231_interface_debug_print("ds3231: %04d-%02d-%02d %s %02d:%02d:%02d %d.\n",
time.year, time.month, time.date, (time.am_pm == DS3231_AM) ? "AM" : "PM",
time.hour, time.minute, time.second, time.week
);
}
...
(void)ds3231_basic_deinit();
return 0;
#include "driver_ds3231_alarm.h"
uint8_t res;
ds3231_time_t time;
ds3231_alarm1_mode_t mode;
void alarm_receive_callback(uint8_t type)
{
switch (type)
{
case DS3231_STATUS_ALARM_2 :
{
ds3231_alarm_clear_flag(DS3231_ALARM_2);
ds3231_interface_debug_print("ds3231: irq alarm2.\n");
...
break;
}
case DS3231_STATUS_ALARM_1 :
{
ds3231_alarm_clear_flag(DS3231_ALARM_1);
ds3231_interface_debug_print("ds3231: irq alarm1.\n");
...
break;
}
default :
{
...
break;
}
}
}
res = ds3231_alarm_init(alarm_receive_callback);
if (res != 0)
{
return 1;
}
...
res = gpio_interrupt_init();
if (res != 0)
{
(void)ds3231_alarm_deinit();
return 1;
}
...
mode = DS3231_ALARM1_MODE_ONCE_A_SECOND;
time.am_pm = DS3231_AM;
time.date = data;
time.format = DS3231_FORMAT_24H;
time.hour = hour;
time.minute = minute;
time.month = month;
time.second = second;
time.week = week;
time.year = year;
res = ds3231_alarm_set_alarm1(&time, mode);
if (res != 0)
{
(void)ds3231_alarm_deinit();
return 1;
}
...
res = ds3231_alarm_enable(DS3231_ALARM_1);
if (res != 0)
{
(void)ds3231_alarm_deinit();
return 1;
}
...
(void)ds3231_alarm_deinit();
return 0;
#include "driver_ds3231_output.h"
uint8_t res;
res = ds3231_output_init();
if (res != 0)
{
return 1;
}
...
res = ds3231_output_set_square_wave(enable);
if (res != 0)
{
(void)ds3231_output_deinit();
return 1;
}
...
res = ds3231_output_set_32khz_output(enable);
if (res != 0)
{
(void)ds3231_output_deinit();
return 1;
}
...
(void)ds3231_output_deinit();
return 0;
Online-Dokumente: https://www.libdriver.com/docs/ds3231/index.html.
Offline-Dokumente: /doc/html/index.html.
Bitte beachten Sie CONTRIBUTING.md.
Urheberrechte © (c) 2015 - Gegenwart LibDriver Alle Rechte vorbehalten
Die MIT-Lizenz (MIT)
Hiermit wird jeder Person kostenlos die Erlaubnis erteilt, eine Kopie zu erhalten
dieser Software und zugehörigen Dokumentationsdateien (die „Software“) zu behandeln
in der Software ohne Einschränkung, einschließlich, aber nicht beschränkt auf die Rechte
zu verwenden, zu kopieren, zu modifizieren, zusammenzuführen, zu veröffentlichen, zu verteilen, unterzulizenzieren und/oder zu verkaufen
Kopien der Software und Personen, denen die Software gehört, zu gestatten
dazu eingerichtet werden, unter folgenden Bedingungen:
Der obige Urheberrechtshinweis und dieser Genehmigungshinweis müssen in allen enthalten sein
Kopien oder wesentliche Teile der Software.
DIE SOFTWARE WIRD "WIE BESEHEN" BEREITGESTELLT, OHNE JEGLICHE GEWÄHRLEISTUNG, AUSDRÜCKLICH ODER
STILLSCHWEIGEND, EINSCHLIESSLICH, ABER NICHT BESCHRÄNKT AUF DIE GEWÄHRLEISTUNG DER MARKTGÄNGIGKEIT,
EIGNUNG FÜR EINEN BESTIMMTEN ZWECK UND NICHTVERLETZUNG VON RECHTEN DRITTER. IN KEINEM FALL DARF DAS
AUTOREN ODER URHEBERRECHTSINHABER HAFTEN FÜR JEGLICHE ANSPRÜCHE, SCHÄDEN ODER ANDERE
HAFTUNG, OB AUS VERTRAG, DELIKT ODER ANDERWEITIG, ENTSTEHEND AUS,
AUS ODER IM ZUSAMMENHANG MIT DER SOFTWARE ODER DER VERWENDUNG ODER ANDEREN HANDLUNGEN MIT DER
SOFTWARE.
Bitte senden Sie eine E-Mail an [email protected].