2019-01-28 21:47:44 +01:00
|
|
|
|
/* NOTE:
|
|
|
|
|
The IF482 Generator needs an high precise 1 Hz clock signal which cannot be
|
|
|
|
|
acquired in suitable precision on the ESP32 SoC itself. Additional clocking
|
|
|
|
|
hardware is required, ususally the clock signal is generated by external RTC or
|
2019-01-29 09:04:31 +01:00
|
|
|
|
GPS which can generate a precise time pulse signal (+/- 2ppm).
|
|
|
|
|
|
|
|
|
|
In this example code we use a Maxim DS3231 RTC chip, and configure the chips's
|
|
|
|
|
interrupt output pin as clock. The clock signal triggers an interrupt on the
|
|
|
|
|
ESP32, which controls the realtime output of IF482 telegram. This is why code in
|
2019-01-28 21:47:44 +01:00
|
|
|
|
IF482.cpp depends on code in RTCTIME.cpp.
|
|
|
|
|
*/
|
2019-01-25 22:49:26 +01:00
|
|
|
|
|
2019-01-28 21:47:44 +01:00
|
|
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
|
|
|
|
|
|
|
|
/*
|
2019-01-26 12:32:58 +01:00
|
|
|
|
IF482 Generator to control clocks with IF482 telegram input (e.g. BÜRK BU190)
|
2019-01-20 22:39:26 +01:00
|
|
|
|
|
2019-01-29 09:04:31 +01:00
|
|
|
|
|
2019-01-26 12:32:58 +01:00
|
|
|
|
Example IF482 telegram: "OAL160806F170400"
|
2019-01-20 22:39:26 +01:00
|
|
|
|
|
|
|
|
|
IF482 Specification:
|
2019-01-26 12:32:58 +01:00
|
|
|
|
http://www.mobatime.com/fileadmin/user_upload/downloads/TE-112023.pdf
|
|
|
|
|
|
|
|
|
|
The IF 482 telegram is a time telegram, which sends the time and date
|
|
|
|
|
information as ASCII characters through the serial interface RS 232 or RS 422.
|
|
|
|
|
|
|
|
|
|
Communication parameters:
|
|
|
|
|
|
|
|
|
|
Baud rate: 9600 Bit/s
|
|
|
|
|
Data bits 7
|
|
|
|
|
Parity: even
|
|
|
|
|
Stop bit: 1
|
|
|
|
|
Jitter: < 50ms
|
|
|
|
|
|
|
|
|
|
Interface : RS232 or RS422
|
|
|
|
|
|
|
|
|
|
Synchronization: Telegram ends at the beginning of the second
|
|
|
|
|
specified in the telegram
|
|
|
|
|
|
|
|
|
|
Cycle: 1 second
|
|
|
|
|
|
|
|
|
|
Format of ASCII telegram string:
|
|
|
|
|
|
|
|
|
|
Byte Meaning ASCII Hex
|
|
|
|
|
1 Start of telegram O 4F
|
|
|
|
|
2 Monitoring* A 41
|
|
|
|
|
3 Time-Season** W/S/U/L 57 or 53
|
|
|
|
|
4 Year tens 0 .. 9 30 .. 39
|
|
|
|
|
5 Year unit 0 .. 9 30 .. 39
|
|
|
|
|
6 Month tens 0 or 1 30 or 31
|
|
|
|
|
7 Month unit 0 .. 9 30 .. 39
|
|
|
|
|
8 Day tens 0 .. 3 30 .. 33
|
|
|
|
|
9 Day unit 0 .. 9 30 .. 39
|
|
|
|
|
10 Day of week*** 1 .. 7 31 .. 37
|
|
|
|
|
11 Hours tens 0 .. 2 30 .. 32
|
|
|
|
|
12 Hours unit 0 .. 9 30 .. 39
|
|
|
|
|
13 Minutes tens 0 .. 5 30 .. 35
|
|
|
|
|
14 Minutes unit 0 .. 9 30 .. 39
|
|
|
|
|
15 Seconds tens 0 .. 5 30 .. 35
|
|
|
|
|
16 Seconds unit 0 .. 9 30 .. 39
|
|
|
|
|
17 End of telegram CR 0D
|
|
|
|
|
|
|
|
|
|
*) Monitoring:
|
|
|
|
|
With a correctly received time in the sender unit, the ASCII character 'A' is
|
|
|
|
|
issued. If 'M' is issued, this indicates that the sender was unable to receive
|
|
|
|
|
any time signal for over 12 hours (time is accepted with ‘A’ and ‘M’).
|
|
|
|
|
|
|
|
|
|
**) Season:
|
|
|
|
|
W: Standard time,
|
|
|
|
|
S: Season time,
|
|
|
|
|
U: UTC time (not supported by all systems),
|
|
|
|
|
L: Local Time
|
|
|
|
|
|
|
|
|
|
***) Day of week:
|
|
|
|
|
not evaluated by model BU-190
|
2019-01-25 22:49:26 +01:00
|
|
|
|
|
2019-01-20 22:39:26 +01:00
|
|
|
|
*/
|
2019-01-28 21:47:44 +01:00
|
|
|
|
///////////////////////////////////////////////////////////////////////////////
|
2019-01-20 22:39:26 +01:00
|
|
|
|
|
2019-02-08 22:19:44 +01:00
|
|
|
|
#ifdef HAS_IF482
|
|
|
|
|
|
2019-01-20 22:39:26 +01:00
|
|
|
|
#include "if482.h"
|
|
|
|
|
|
|
|
|
|
// Local logging tag
|
|
|
|
|
static const char TAG[] = "main";
|
|
|
|
|
|
2019-01-27 18:19:25 +01:00
|
|
|
|
HardwareSerial IF482(2); // use UART #2 (note: #1 may be in use for serial GPS)
|
2019-01-25 22:49:26 +01:00
|
|
|
|
|
2019-02-16 15:02:07 +01:00
|
|
|
|
// called by timepulse interrupt to ticker out DCF signal
|
|
|
|
|
void IF482_Pulse(time_t startTime) {
|
|
|
|
|
IF482.print(IF482_Frame(startTime + 1)); // if482 telegram for next second
|
|
|
|
|
}
|
2019-01-25 22:49:26 +01:00
|
|
|
|
|
2019-02-16 15:02:07 +01:00
|
|
|
|
String IF482_Frame(time_t startTime) {
|
2019-02-02 09:15:31 +01:00
|
|
|
|
|
2019-02-16 15:02:07 +01:00
|
|
|
|
time_t t = myTZ.toLocal(startTime);
|
2019-02-07 23:05:26 +01:00
|
|
|
|
char mon, buf[14], out[IF482_FRAME_SIZE];
|
2019-01-25 22:49:26 +01:00
|
|
|
|
|
|
|
|
|
switch (timeStatus()) { // indicates if time has been set and recently synced
|
2019-01-27 18:19:25 +01:00
|
|
|
|
case timeSet: // time is set and is synced
|
2019-01-26 18:49:53 +01:00
|
|
|
|
mon = 'A';
|
2019-01-25 22:49:26 +01:00
|
|
|
|
break;
|
|
|
|
|
case timeNeedsSync: // time had been set but sync attempt did not succeed
|
2019-01-26 18:49:53 +01:00
|
|
|
|
mon = 'M';
|
2019-01-25 22:49:26 +01:00
|
|
|
|
break;
|
|
|
|
|
default: // time not set, no valid time
|
2019-01-26 18:49:53 +01:00
|
|
|
|
mon = '?';
|
2019-01-25 22:49:26 +01:00
|
|
|
|
break;
|
|
|
|
|
} // switch
|
|
|
|
|
|
2019-02-04 21:42:44 +01:00
|
|
|
|
// do we have confident time/date?
|
2019-02-16 15:02:07 +01:00
|
|
|
|
if (timeStatus() == timeSet)
|
2019-02-04 21:42:44 +01:00
|
|
|
|
snprintf(buf, sizeof(buf), "%02u%02u%02u%1u%02u%02u%02u", year(t) - 2000,
|
2019-01-27 18:19:25 +01:00
|
|
|
|
month(t), day(t), weekday(t), hour(t), minute(t), second(t));
|
2019-02-04 21:42:44 +01:00
|
|
|
|
else
|
|
|
|
|
snprintf(buf, sizeof(buf), "000000F000000"); // no confident time/date
|
2019-01-25 22:49:26 +01:00
|
|
|
|
|
2019-02-04 21:42:44 +01:00
|
|
|
|
// output IF482 telegram
|
|
|
|
|
snprintf(out, sizeof(out), "O%cL%s\r", mon, buf);
|
2019-02-04 20:02:30 +01:00
|
|
|
|
ESP_LOGD(TAG, "IF482 = %s", out);
|
2019-01-25 22:49:26 +01:00
|
|
|
|
return out;
|
|
|
|
|
}
|
|
|
|
|
|
2019-02-12 23:59:08 +01:00
|
|
|
|
// calculate serial tx time from IF482 serial settings
|
2019-02-16 15:02:07 +01:00
|
|
|
|
TickType_t tx_Ticks(unsigned long baud, uint32_t config, int8_t rxPin,
|
|
|
|
|
int8_t txPins) {
|
2019-02-10 16:43:24 +01:00
|
|
|
|
|
|
|
|
|
uint32_t datenbits = ((config & 0x0c) >> 2) + 5;
|
2019-02-12 23:59:08 +01:00
|
|
|
|
uint32_t stopbits = ((config & 0x20) >> 5) + 1;
|
2019-02-10 16:43:24 +01:00
|
|
|
|
return pdMS_TO_TICKS(
|
2019-02-12 23:59:08 +01:00
|
|
|
|
round(((1 + datenbits + stopbits) * IF482_FRAME_SIZE * 1000.0 / baud)));
|
2019-02-10 16:43:24 +01:00
|
|
|
|
}
|
|
|
|
|
|
2019-01-20 22:39:26 +01:00
|
|
|
|
#endif // HAS_IF482
|