Clio Liu
55279ca78f
Adds what the folder was missing for someone picking it up cold.
as-built/ the STruC++ output copied out of the live container - the C++
the PLC is actually executing, plus program.st and the Modbus
buffer config. The running image was made with docker commit
and exists in no registry, so this is the only other copy of
the compiled form.
Verified while copying: the deployed program.st matches
build/wrps.st generated from src/. Identical POU structure,
ZERO differences in non-declaration lines. src/ is genuinely
canonical and the running PLC agrees with it.
VERSIONS.md every version read from the running system, not from
documentation: runtime v4.1.10, STruC++ 0.6.2, Editor
4.2.11, Debian 12, g++ 12.2, pymodbus 3.11.2, CI
Server R1.03. Plus which plugins are enabled -
ethercat is on for no reason - and a v3-vs-v4 table,
since most OpenPLC guidance online is for v3 and the
%MW HR1024 change silently produces wrong data.
GETTING-STARTED.md three questions answered in a page: how to modify the
program, how to stand up a new PLC container from
scratch, how to move this one. Includes the compose
file, the Editor steps that are not generated and are
always missed, and a symptom-to-document table.
89 lines
3.8 KiB
C++
89 lines
3.8 KiB
C++
// SPDX-License-Identifier: GPL-3.0-or-later WITH STruCpp-runtime-exception
|
|
// Copyright (C) 2025 Autonomy / OpenPLC Project
|
|
// This file is part of the STruC++ Runtime Library and is covered by the
|
|
// STruC++ Runtime Library Exception. See COPYING.RUNTIME for details.
|
|
/**
|
|
* STruC++ Runtime - IEC DATE Standard Functions
|
|
*
|
|
* IEC 61131-3 standard functions on the DATE (and LDATE) calendar
|
|
* types. DATE / LDATE are stored as signed days since the Unix epoch
|
|
* (1970-01-01) in `IECVar<DATE_t>` — the same generic per-variable
|
|
* wrapper used for every other elementary type. Codegen emits DATE
|
|
* variables as `IEC_DATE` (the `IECVar<DATE_t>` alias) and the
|
|
* functions below take/return `IEC_DATE` so they're directly callable
|
|
* from generated POU code.
|
|
*
|
|
* Scope: only the standard arithmetic / comparison / round-trip
|
|
* functions. Calendar component accessors (YEAR, MONTH, DAY,
|
|
* DAY_OF_WEEK, DAY_OF_YEAR, …) are intentionally NOT here — those are
|
|
* OSCAT-style extensions and user libraries (OSCAT, codesys-v23
|
|
* stdlib imports, …) ship their own implementations. Providing them
|
|
* here would create overload ambiguity when a project imports such a
|
|
* library.
|
|
*
|
|
* Historical note: an earlier `DateValue<T>` + `IECDateVar<T>` value-
|
|
* class design lived here. Codegen never adopted it (DATE variables
|
|
* were always declared as `IEC_DATE`), so the parallel API was dead
|
|
* from generated code's perspective. Removed in favour of a single
|
|
* IECVar-based surface. See `iec_time.hpp` for the matching note on
|
|
* the TIME family.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <cstdint>
|
|
#include "iec_types.hpp"
|
|
#include "iec_var.hpp"
|
|
#include "iec_traits.hpp"
|
|
|
|
namespace strucpp {
|
|
|
|
// ---------------------------------------------------------------------------
|
|
// Construction helpers
|
|
// ---------------------------------------------------------------------------
|
|
// `DATE_FROM_YMD(2024, 3, 15)` converts a Gregorian (year, month, day)
|
|
// triple into a DATE by way of the Julian Day Number. Branch-free
|
|
// integer arithmetic.
|
|
inline IEC_DATE DATE_FROM_YMD(int year, int month, int day) noexcept {
|
|
const int a = (14 - month) / 12;
|
|
const int y = year + 4800 - a;
|
|
const int m = month + 12 * a - 3;
|
|
const int jdn = day + (153 * m + 2) / 5 + 365 * y + y / 4 - y / 100 + y / 400 - 32045;
|
|
constexpr int UNIX_EPOCH_JDN = 2440588;
|
|
return IEC_DATE(static_cast<DATE_t>(jdn - UNIX_EPOCH_JDN));
|
|
}
|
|
|
|
inline IEC_DATE DATE_FROM_DAYS(int64_t days) noexcept {
|
|
return IEC_DATE(static_cast<DATE_t>(days));
|
|
}
|
|
|
|
inline int64_t DATE_TO_DAYS(IEC_DATE d) noexcept {
|
|
return iec_unwrap(d);
|
|
}
|
|
|
|
// ---------------------------------------------------------------------------
|
|
// Arithmetic
|
|
// ---------------------------------------------------------------------------
|
|
inline IEC_DATE ADD_DATE(IEC_DATE d, int64_t days) noexcept {
|
|
return IEC_DATE(iec_unwrap(d) + static_cast<DATE_t>(days));
|
|
}
|
|
|
|
inline IEC_DATE SUB_DATE(IEC_DATE d, int64_t days) noexcept {
|
|
return IEC_DATE(iec_unwrap(d) - static_cast<DATE_t>(days));
|
|
}
|
|
|
|
inline int64_t DIFF_DATE(IEC_DATE a, IEC_DATE b) noexcept {
|
|
return iec_unwrap(a) - iec_unwrap(b);
|
|
}
|
|
|
|
// ---------------------------------------------------------------------------
|
|
// Comparison
|
|
// ---------------------------------------------------------------------------
|
|
inline bool GT_DATE(IEC_DATE a, IEC_DATE b) noexcept { return iec_unwrap(a) > iec_unwrap(b); }
|
|
inline bool GE_DATE(IEC_DATE a, IEC_DATE b) noexcept { return iec_unwrap(a) >= iec_unwrap(b); }
|
|
inline bool EQ_DATE(IEC_DATE a, IEC_DATE b) noexcept { return iec_unwrap(a) == iec_unwrap(b); }
|
|
inline bool NE_DATE(IEC_DATE a, IEC_DATE b) noexcept { return iec_unwrap(a) != iec_unwrap(b); }
|
|
inline bool LE_DATE(IEC_DATE a, IEC_DATE b) noexcept { return iec_unwrap(a) <= iec_unwrap(b); }
|
|
inline bool LT_DATE(IEC_DATE a, IEC_DATE b) noexcept { return iec_unwrap(a) < iec_unwrap(b); }
|
|
|
|
} // namespace strucpp
|