From dbdea8aa588433c394323df44a49e6573a304899 Mon Sep 17 00:00:00 2001 From: Ekhorn Date: Thu, 18 Dec 2025 17:09:38 +0100 Subject: [PATCH 1/3] Add timezone information --- docs/user-guide/agents-protocols/simulator.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/user-guide/agents-protocols/simulator.md b/docs/user-guide/agents-protocols/simulator.md index c70a071..be3f645 100644 --- a/docs/user-guide/agents-protocols/simulator.md +++ b/docs/user-guide/agents-protocols/simulator.md @@ -18,6 +18,7 @@ For attributes linked to this agent, the following describes the supported agent | `type` | Agent type | Text (Must be `SimulatorAgentLink`) | Y | | `replayData` | A dataset of values that should be replayed (i.e. written to the linked attribute) in a continuous loop | [SimulatorReplayDatapoint[]](https://github.com/openremote/openremote/blob/master/model/src/main/java/org/openremote/model/simulator/SimulatorReplayDatapoint.java) | N | | `schedule` | When defined overwrites the default 24h dataset length and how it is replayed. | [SimulatorProtocol.Schedule](https://github.com/openremote/openremote/blob/master/agent/src/main/java/org/openremote/agent/protocol/simulator/SimulatorProtocol.java) | N | +| `timezone` | The timezone the Simulator should follow when replaying the dataset. | [TimeZone](https://github.com/openremote/openremote/blob/master/agent/src/main/java/org/openremote/agent/protocol/simulator/SimulatorAgentLink.java) | N | ## Additional info Attributes linked to this agent that are written to will follow a route through the system as if it came from a remote service. @@ -31,3 +32,6 @@ Attributes linked to this agent that have a `replayData` field in their Agent Li ### Schedule The schedule can be set to occur only once when only a start- (and end) date are defined, or as a recurring event following the [RFC 5545 RRULE](https://datatracker.ietf.org/doc/html/rfc5545#section-3.3.10) format. If not provided defaults to every 24 hours. + +### Timezone +The timezone parameter allows the replay data to follow any specified timezone. Upon adding a new SimulatorAgentLink the timezone parameter will be added with the users' timezone. If not specified will fall back to UTC. From a7b38c34282b0229ad86c0f0d9ac2ae59faf5ffd Mon Sep 17 00:00:00 2001 From: Ekhorn Date: Thu, 18 Dec 2025 18:30:22 +0100 Subject: [PATCH 2/3] Add new simulator UI documentation --- .../agents-protocols/img/simulator-chart.png | Bin 0 -> 51918 bytes .../img/simulator-scheduler-occurr.png | Bin 0 -> 18813 bytes .../img/simulator-scheduler-recurr.png | Bin 0 -> 42538 bytes docs/user-guide/agents-protocols/simulator.md | 19 ++++++++++++++++-- .../agents-protocols/img/simulator-chart.png | Bin 0 -> 51918 bytes .../img/simulator-scheduler-occurr.png | Bin 0 -> 18813 bytes .../img/simulator-scheduler-recurr.png | Bin 0 -> 42538 bytes .../user-guide/agents-protocols/simulator.md | 19 ++++++++++++++++-- 8 files changed, 34 insertions(+), 4 deletions(-) create mode 100644 docs/user-guide/agents-protocols/img/simulator-chart.png create mode 100644 docs/user-guide/agents-protocols/img/simulator-scheduler-occurr.png create mode 100644 docs/user-guide/agents-protocols/img/simulator-scheduler-recurr.png create mode 100644 versioned_docs/version-1.12.0/user-guide/agents-protocols/img/simulator-chart.png create mode 100644 versioned_docs/version-1.12.0/user-guide/agents-protocols/img/simulator-scheduler-occurr.png create mode 100644 versioned_docs/version-1.12.0/user-guide/agents-protocols/img/simulator-scheduler-recurr.png diff --git a/docs/user-guide/agents-protocols/img/simulator-chart.png b/docs/user-guide/agents-protocols/img/simulator-chart.png new file mode 100644 index 0000000000000000000000000000000000000000..661c86564ac4e948906d85aad088c09ce34bd96d GIT binary patch literal 51918 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 literal 0 HcmV?d00001 diff --git a/docs/user-guide/agents-protocols/img/simulator-scheduler-occurr.png b/docs/user-guide/agents-protocols/img/simulator-scheduler-occurr.png new file mode 100644 index 0000000000000000000000000000000000000000..0573c6c7dfad3ac92c9cb4d18627c725e816f92e GIT binary patch literal 18813 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 literal 0 HcmV?d00001 diff --git a/docs/user-guide/agents-protocols/simulator.md b/docs/user-guide/agents-protocols/simulator.md index be3f645..07d45ad 100644 --- a/docs/user-guide/agents-protocols/simulator.md +++ b/docs/user-guide/agents-protocols/simulator.md @@ -15,7 +15,6 @@ For attributes linked to this agent, the following describes the supported agent | Field | Description | Value type | Required | | ------------- | ------------- | ------------- | ------------- | -| `type` | Agent type | Text (Must be `SimulatorAgentLink`) | Y | | `replayData` | A dataset of values that should be replayed (i.e. written to the linked attribute) in a continuous loop | [SimulatorReplayDatapoint[]](https://github.com/openremote/openremote/blob/master/model/src/main/java/org/openremote/model/simulator/SimulatorReplayDatapoint.java) | N | | `schedule` | When defined overwrites the default 24h dataset length and how it is replayed. | [SimulatorProtocol.Schedule](https://github.com/openremote/openremote/blob/master/agent/src/main/java/org/openremote/agent/protocol/simulator/SimulatorProtocol.java) | N | | `timezone` | The timezone the Simulator should follow when replaying the dataset. | [TimeZone](https://github.com/openremote/openremote/blob/master/agent/src/main/java/org/openremote/agent/protocol/simulator/SimulatorAgentLink.java) | N | @@ -25,13 +24,29 @@ Attributes linked to this agent that are written to will follow a route through The `has predicted data points` configuration item will cause the dataset of the current and next occurrence to be inserted as predicted data points alongside the normally scheduled data points. +![](img/simulator-chart.png) + If the `replayData` contains data points scheduled after the default 24 hours or the recurrence rule, the data points will be ignored. ### Simulator Replay Datapoints Attributes linked to this agent that have a `replayData` field in their Agent Link will cause the values within to be replayed over a 24h period in a continuous loop, unless a schedule is configured. Each `SimulatorReplayDatapoint` value must have a `timestamp` (seconds offset from midnight `00:00` in the system time of the machine that hosts the manager) and a `value`, this value will then be written to the attribute at the specified seconds offset from midnight each day. ### Schedule -The schedule can be set to occur only once when only a start- (and end) date are defined, or as a recurring event following the [RFC 5545 RRULE](https://datatracker.ietf.org/doc/html/rfc5545#section-3.3.10) format. If not provided defaults to every 24 hours. +The schedule can be set to occur only once by selecting "Plan an occurrence". This will allow a period to be specified where within the data will be replayed. Any datapoints specified to be replayed after the end date are ignored. + +![](img/simulator-scheduler-occurr.png) + +The dataset can also be replayed recurringly by selecting "Plan a repeating occurrence". In addition to the period options this allows a frequency to be specified and how the repeating occurrence ends. + +The `frequency` defines how often the replay data is replayed. The frequency can be set to replay the dataset every `minute`, `hour`, `day`, `week`, `month` or `year`. By increasing the number alongside the selected frequency the `interval` the frequency will change to run every few `minutes`, `hours`, `days`, `weeks`, `months` or `years`. Besides the interval and frequency, the dataset can also be replayed on certain days of the week when selected. + +The `repeating occurrence ending` can be specified to stop at a certain date and time or set end after a certain amount of occurrences. + +These options follow the [RFC 5545 RRULE](https://datatracker.ietf.org/doc/html/rfc5545#section-3.3.10) specification. + +![](img/simulator-scheduler-recurr.png) + +If the schedule is not provided it defaults to every 24 hours. ### Timezone The timezone parameter allows the replay data to follow any specified timezone. Upon adding a new SimulatorAgentLink the timezone parameter will be added with the users' timezone. If not specified will fall back to UTC. diff --git a/versioned_docs/version-1.12.0/user-guide/agents-protocols/img/simulator-chart.png b/versioned_docs/version-1.12.0/user-guide/agents-protocols/img/simulator-chart.png new file mode 100644 index 0000000000000000000000000000000000000000..661c86564ac4e948906d85aad088c09ce34bd96d GIT binary patch literal 51918 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 literal 0 HcmV?d00001 diff --git a/versioned_docs/version-1.12.0/user-guide/agents-protocols/img/simulator-scheduler-occurr.png b/versioned_docs/version-1.12.0/user-guide/agents-protocols/img/simulator-scheduler-occurr.png new file mode 100644 index 0000000000000000000000000000000000000000..0573c6c7dfad3ac92c9cb4d18627c725e816f92e GIT binary patch literal 18813 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 literal 0 HcmV?d00001 diff --git a/versioned_docs/version-1.12.0/user-guide/agents-protocols/simulator.md b/versioned_docs/version-1.12.0/user-guide/agents-protocols/simulator.md index c70a071..7dc8d79 100644 --- a/versioned_docs/version-1.12.0/user-guide/agents-protocols/simulator.md +++ b/versioned_docs/version-1.12.0/user-guide/agents-protocols/simulator.md @@ -15,7 +15,6 @@ For attributes linked to this agent, the following describes the supported agent | Field | Description | Value type | Required | | ------------- | ------------- | ------------- | ------------- | -| `type` | Agent type | Text (Must be `SimulatorAgentLink`) | Y | | `replayData` | A dataset of values that should be replayed (i.e. written to the linked attribute) in a continuous loop | [SimulatorReplayDatapoint[]](https://github.com/openremote/openremote/blob/master/model/src/main/java/org/openremote/model/simulator/SimulatorReplayDatapoint.java) | N | | `schedule` | When defined overwrites the default 24h dataset length and how it is replayed. | [SimulatorProtocol.Schedule](https://github.com/openremote/openremote/blob/master/agent/src/main/java/org/openremote/agent/protocol/simulator/SimulatorProtocol.java) | N | @@ -24,10 +23,26 @@ Attributes linked to this agent that are written to will follow a route through The `has predicted data points` configuration item will cause the dataset of the current and next occurrence to be inserted as predicted data points alongside the normally scheduled data points. +![](img/simulator-chart.png) + If the `replayData` contains data points scheduled after the default 24 hours or the recurrence rule, the data points will be ignored. ### Simulator Replay Datapoints Attributes linked to this agent that have a `replayData` field in their Agent Link will cause the values within to be replayed over a 24h period in a continuous loop, unless a schedule is configured. Each `SimulatorReplayDatapoint` value must have a `timestamp` (seconds offset from midnight `00:00` in the system time of the machine that hosts the manager) and a `value`, this value will then be written to the attribute at the specified seconds offset from midnight each day. ### Schedule -The schedule can be set to occur only once when only a start- (and end) date are defined, or as a recurring event following the [RFC 5545 RRULE](https://datatracker.ietf.org/doc/html/rfc5545#section-3.3.10) format. If not provided defaults to every 24 hours. +The schedule can be set to occur only once by selecting "Plan an occurrence". This will allow a period to be specified where within the data will be replayed. Any datapoints specified to be replayed after the end date are ignored. + +![](img/simulator-scheduler-occurr.png) + +The dataset can also be replayed recurringly by selecting "Plan a repeating occurrence". In addition to the period options this allows a frequency to be specified and how the repeating occurrence ends. + +The `frequency` defines how often the replay data is replayed. The frequency can be set to replay the dataset every `minute`, `hour`, `day`, `week`, `month` or `year`. By increasing the number alongside the selected frequency the `interval` the frequency will change to run every few `minutes`, `hours`, `days`, `weeks`, `months` or `years`. Besides the interval and frequency, the dataset can also be replayed on certain days of the week when selected. + +The `repeating occurrence ending` can be specified to stop at a certain date and time or set end after a certain amount of occurrences. + +These options follow the [RFC 5545 RRULE](https://datatracker.ietf.org/doc/html/rfc5545#section-3.3.10) specification. + +![](img/simulator-scheduler-recurr.png) + +If the schedule is not provided it defaults to every 24 hours. From a552b568bb992cd582dd5e12472d996a30affe7e Mon Sep 17 00:00:00 2001 From: Ekhorn Date: Fri, 19 Dec 2025 11:31:07 +0100 Subject: [PATCH 3/3] Fix grammar --- docs/user-guide/agents-protocols/simulator.md | 6 +++--- .../version-1.12.0/user-guide/agents-protocols/simulator.md | 6 +++--- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/user-guide/agents-protocols/simulator.md b/docs/user-guide/agents-protocols/simulator.md index 07d45ad..9d17b76 100644 --- a/docs/user-guide/agents-protocols/simulator.md +++ b/docs/user-guide/agents-protocols/simulator.md @@ -32,15 +32,15 @@ If the `replayData` contains data points scheduled after the default 24 hours or Attributes linked to this agent that have a `replayData` field in their Agent Link will cause the values within to be replayed over a 24h period in a continuous loop, unless a schedule is configured. Each `SimulatorReplayDatapoint` value must have a `timestamp` (seconds offset from midnight `00:00` in the system time of the machine that hosts the manager) and a `value`, this value will then be written to the attribute at the specified seconds offset from midnight each day. ### Schedule -The schedule can be set to occur only once by selecting "Plan an occurrence". This will allow a period to be specified where within the data will be replayed. Any datapoints specified to be replayed after the end date are ignored. +The schedule can be set to occur only once by selecting "Plan an occurrence". This will allow a period to be specified where the data will be replayed. Any datapoints specified to be replayed after the end date are ignored. ![](img/simulator-scheduler-occurr.png) The dataset can also be replayed recurringly by selecting "Plan a repeating occurrence". In addition to the period options this allows a frequency to be specified and how the repeating occurrence ends. -The `frequency` defines how often the replay data is replayed. The frequency can be set to replay the dataset every `minute`, `hour`, `day`, `week`, `month` or `year`. By increasing the number alongside the selected frequency the `interval` the frequency will change to run every few `minutes`, `hours`, `days`, `weeks`, `months` or `years`. Besides the interval and frequency, the dataset can also be replayed on certain days of the week when selected. +The `frequency` defines how often the replay data is replayed. The frequency can be set to replay the dataset every `minute`, `hour`, `day`, `week`, `month` or `year`. By increasing the number alongside the selected frequency (the `interval`), the frequency will change to run every few `minutes`, `hours`, `days`, `weeks`, `months` or `years`. Besides the interval and frequency, the dataset can also be replayed on certain days of the week when selected. -The `repeating occurrence ending` can be specified to stop at a certain date and time or set end after a certain amount of occurrences. +The `repeating occurrence ending` can be specified to stop at a certain date and time or set to end after a certain amount of occurrences. These options follow the [RFC 5545 RRULE](https://datatracker.ietf.org/doc/html/rfc5545#section-3.3.10) specification. diff --git a/versioned_docs/version-1.12.0/user-guide/agents-protocols/simulator.md b/versioned_docs/version-1.12.0/user-guide/agents-protocols/simulator.md index 7dc8d79..c0b5dcf 100644 --- a/versioned_docs/version-1.12.0/user-guide/agents-protocols/simulator.md +++ b/versioned_docs/version-1.12.0/user-guide/agents-protocols/simulator.md @@ -31,15 +31,15 @@ If the `replayData` contains data points scheduled after the default 24 hours or Attributes linked to this agent that have a `replayData` field in their Agent Link will cause the values within to be replayed over a 24h period in a continuous loop, unless a schedule is configured. Each `SimulatorReplayDatapoint` value must have a `timestamp` (seconds offset from midnight `00:00` in the system time of the machine that hosts the manager) and a `value`, this value will then be written to the attribute at the specified seconds offset from midnight each day. ### Schedule -The schedule can be set to occur only once by selecting "Plan an occurrence". This will allow a period to be specified where within the data will be replayed. Any datapoints specified to be replayed after the end date are ignored. +The schedule can be set to occur only once by selecting "Plan an occurrence". This will allow a period to be specified where the data will be replayed. Any datapoints specified to be replayed after the end date are ignored. ![](img/simulator-scheduler-occurr.png) The dataset can also be replayed recurringly by selecting "Plan a repeating occurrence". In addition to the period options this allows a frequency to be specified and how the repeating occurrence ends. -The `frequency` defines how often the replay data is replayed. The frequency can be set to replay the dataset every `minute`, `hour`, `day`, `week`, `month` or `year`. By increasing the number alongside the selected frequency the `interval` the frequency will change to run every few `minutes`, `hours`, `days`, `weeks`, `months` or `years`. Besides the interval and frequency, the dataset can also be replayed on certain days of the week when selected. +The `frequency` defines how often the replay data is replayed. The frequency can be set to replay the dataset every `minute`, `hour`, `day`, `week`, `month` or `year`. By increasing the number alongside the selected frequency (the `interval`), the frequency will change to run every few `minutes`, `hours`, `days`, `weeks`, `months` or `years`. Besides the interval and frequency, the dataset can also be replayed on certain days of the week when selected. -The `repeating occurrence ending` can be specified to stop at a certain date and time or set end after a certain amount of occurrences. +The `repeating occurrence ending` can be specified to stop at a certain date and time or set to end after a certain amount of occurrences. These options follow the [RFC 5545 RRULE](https://datatracker.ietf.org/doc/html/rfc5545#section-3.3.10) specification.