diff --git a/src/Gjallar/Gjallar.csproj b/src/Gjallar/Gjallar.csproj
index eb219de..494d85a 100644
--- a/src/Gjallar/Gjallar.csproj
+++ b/src/Gjallar/Gjallar.csproj
@@ -10,6 +10,7 @@
+
diff --git a/src/Gjallar/Program.cs b/src/Gjallar/Program.cs
index f37213a..3b8e686 100644
--- a/src/Gjallar/Program.cs
+++ b/src/Gjallar/Program.cs
@@ -2,11 +2,15 @@ using System.Buffers;
using System.Diagnostics;
using System.Globalization;
using System.IO.Compression;
+using System.Net;
+using System.Net.Sockets;
using System.Net.WebSockets;
using System.Runtime.InteropServices;
using System.Text;
using System.Text.Json;
using CultMath;
+using GameCult.Networking;
+using MessagePack;
var config = GjallarConfig.Parse(args);
using var renderer = new GjallarRenderer(config);
@@ -25,7 +29,10 @@ internal sealed record GjallarConfig(
int Height,
string FontPath,
string MousePath,
- string SpecimenText)
+ string SpecimenText,
+ string IdunnRudpHealth,
+ string IdunnDaemon,
+ string IdunnHealthContract)
{
public static GjallarConfig Parse(IReadOnlyList args) => new(
StringArg(args, "--fb", "/dev/fb0"),
@@ -40,7 +47,10 @@ internal sealed record GjallarConfig(
IntArg(args, "--height", 0),
StringArg(args, "--font", ""),
StringArg(args, "--mouse", "/dev/input/mice"),
- ResolveSpecimenText(args));
+ ResolveSpecimenText(args),
+ StringArg(args, "--idunn-rudp-health", Environment.GetEnvironmentVariable("GJALLAR_IDUNN_RUDP_HEALTH") ?? ""),
+ StringArg(args, "--idunn-daemon", Environment.GetEnvironmentVariable("GJALLAR_IDUNN_DAEMON") ?? "nightwing-gjallar"),
+ StringArg(args, "--idunn-health-contract", Environment.GetEnvironmentVariable("GJALLAR_IDUNN_HEALTH_CONTRACT") ?? "gjallar.cultnet-rudp-framebuffer-composition-health"));
private static string StringArg(IReadOnlyList args, string name, string fallback)
{
@@ -103,6 +113,13 @@ internal sealed class GjallarRenderer : IDisposable
private string cursorStatus = "not-started";
private string cursorError = "";
private string lastClick = "";
+ private DateTimeOffset lastHealthPublishAttemptAt = DateTimeOffset.MinValue;
+ private string idunnRudpPublishStatus = "disabled";
+ private string idunnRudpPublishError = "";
+ private string idunnRudpPublishEndpoint = "";
+ private string idunnRudpPublishObservedAt = "";
+ private readonly object idunnRudpPublishLock = new();
+ private bool idunnRudpPublishInFlight;
public GjallarRenderer(GjallarConfig config)
{
@@ -702,6 +719,7 @@ internal sealed class GjallarRenderer : IDisposable
: FrameDocument.VisibleGutterRows(sceneCache.GutterRibbon, frames, sceneCache.MarqueeTape)
.Select(static row => Sample(row, 160))
.ToArray();
+ QueueIdunnRudpHealthIfDue(status, frames, measuredFps, started);
var document = new
{
schema = "gamecult.gjallar.frame.v1",
@@ -767,6 +785,15 @@ internal sealed class GjallarRenderer : IDisposable
lastClick = statusLastClick,
},
cultMathNative = Voronoi.NativeAvailable,
+ idunnRudpHealth = new
+ {
+ endpoint = idunnRudpPublishEndpoint,
+ daemon = config.IdunnDaemon,
+ contract = config.IdunnHealthContract,
+ status = idunnRudpPublishStatus,
+ error = idunnRudpPublishError,
+ observedAtUtc = idunnRudpPublishObservedAt,
+ },
paintMs = Math.Round(paintMs, 2),
timings = new
{
@@ -780,6 +807,72 @@ internal sealed class GjallarRenderer : IDisposable
File.WriteAllText(config.StatusPath, JsonSerializer.Serialize(document, StatusJson), Encoding.UTF8);
}
+ private void QueueIdunnRudpHealthIfDue(string status, int frames, double measuredFps, DateTimeOffset observedAt)
+ {
+ if (string.IsNullOrWhiteSpace(config.IdunnRudpHealth))
+ {
+ idunnRudpPublishStatus = "disabled";
+ return;
+ }
+
+ if (lastHealthPublishAttemptAt != DateTimeOffset.MinValue &&
+ observedAt - lastHealthPublishAttemptAt < TimeSpan.FromSeconds(5))
+ {
+ return;
+ }
+
+ var state = string.Equals(status, "rendered", StringComparison.Ordinal) ? "healthy" : "active";
+ var detail = $"Gjallar framebuffer {status}; frames={frames}; catalogProviders={latestCatalogProviders}; composedProviders={latestComposedProviders}; fps={Math.Round(measuredFps, 2)}; receive={lastReceiveStatus}";
+ var health = new IdunnDaemonHealthRecord
+ {
+ DaemonId = config.IdunnDaemon,
+ State = state,
+ Detail = detail,
+ ObservedAt = observedAt.ToString("O", CultureInfo.InvariantCulture),
+ HealthContract = config.IdunnHealthContract,
+ PublicationSource = "daemon-published",
+ Transport = "cultnet.transport.rudp.v0",
+ };
+
+ lock (idunnRudpPublishLock)
+ {
+ if (idunnRudpPublishInFlight)
+ {
+ return;
+ }
+
+ idunnRudpPublishInFlight = true;
+ lastHealthPublishAttemptAt = observedAt;
+ idunnRudpPublishEndpoint = config.IdunnRudpHealth;
+ idunnRudpPublishObservedAt = health.ObservedAt;
+ idunnRudpPublishStatus = "publishing";
+ idunnRudpPublishError = "";
+ }
+
+ _ = Task.Run(() =>
+ {
+ try
+ {
+ IdunnRudpHealthPublisher.Publish(config.IdunnRudpHealth, health);
+ lock (idunnRudpPublishLock)
+ {
+ idunnRudpPublishStatus = "published";
+ idunnRudpPublishError = "";
+ idunnRudpPublishInFlight = false;
+ }
+ }
+ catch (Exception error)
+ {
+ lock (idunnRudpPublishLock)
+ {
+ idunnRudpPublishStatus = "publish-error";
+ idunnRudpPublishError = error.Message;
+ idunnRudpPublishInFlight = false;
+ }
+ }
+ });
+ }
+
private static ColorBgra ToBgra(Color32 color) => new(color.r, color.g, color.b);
private static string Sample(string value, int maxLength) =>
@@ -2203,6 +2296,90 @@ internal sealed class ToneBatch(int resolutionY, int frameIndex)
}
}
+[MessagePackObject(AllowPrivate = true)]
+internal sealed class IdunnDaemonHealthRecord
+{
+ [Key(0)] public string DaemonId { get; set; } = "nightwing-gjallar";
+ [Key(1)] public string State { get; set; } = "active";
+ [Key(2)] public string Detail { get; set; } = "";
+ [Key(3)] public string ObservedAt { get; set; } = "";
+ [Key(4)] public string HealthContract { get; set; } = "gjallar.cultnet-rudp-framebuffer-composition-health";
+ [Key(5)] public string PublicationSource { get; set; } = "daemon-published";
+ [Key(6)] public string Transport { get; set; } = "cultnet.transport.rudp.v0";
+}
+
+internal static class IdunnRudpHealthPublisher
+{
+ private const uint ConnectionId = 0x1d0d0001;
+
+ public static void Publish(string endpoint, IdunnDaemonHealthRecord health)
+ {
+ var remote = ParseEndpoint(endpoint);
+ using var socket = new Socket(AddressFamily.InterNetwork, SocketType.Dgram, ProtocolType.Udp);
+ socket.Bind(new IPEndPoint(IPAddress.Any, 0));
+ socket.ReceiveTimeout = 100;
+ using var transport = new CultNetRudpSocketTransportConnection(new CultNetRudpSocketTransportOptions
+ {
+ RuntimeId = "gjallar",
+ Socket = socket,
+ Mode = CultNetRudpSocketMode.Client,
+ RemoteEndPoint = remote,
+ ConnectionId = ConnectionId,
+ InitialSequence = 1,
+ ResendDelayMs = 100,
+ });
+
+ if (!transport.ConnectAndWait(Array.Empty(), TimeSpan.FromSeconds(2), TimeSpan.FromMilliseconds(20)))
+ {
+ throw new TimeoutException($"timed out connecting Gjallar RUDP health publisher to {endpoint}");
+ }
+
+ var observedAt = string.IsNullOrWhiteSpace(health.ObservedAt)
+ ? DateTimeOffset.UtcNow.ToString("O", CultureInfo.InvariantCulture)
+ : health.ObservedAt;
+ health.ObservedAt = observedAt;
+ var message = new CultNetDocumentPutRawMessage
+ {
+ MessageId = $"gjallar-health:{health.DaemonId}:{observedAt.Replace(':', '-')}",
+ Document = new CultNetRawDocumentRecord
+ {
+ SchemaId = "idunn.daemon_health",
+ RecordKey = health.DaemonId,
+ StoredAt = observedAt,
+ PayloadEncoding = "messagepack",
+ Payload = MessagePackSerializer.Serialize(health, CultNetSchemaMessageSerialization.Options),
+ SourceRuntimeId = "gjallar",
+ SourceRole = "daemon-health-publisher",
+ Tags = ["cultnet.transport.rudp.v0"],
+ },
+ };
+ transport.SendSchema(CultNetSchemaMessageSerialization.Serialize(message));
+ }
+
+ private static IPEndPoint ParseEndpoint(string value)
+ {
+ var trimmed = value.Trim();
+ var separator = trimmed.LastIndexOf(':');
+ if (separator <= 0 || separator == trimmed.Length - 1)
+ {
+ throw new ArgumentException($"Idunn RUDP endpoint must be host:port, got '{value}'.", nameof(value));
+ }
+
+ var host = trimmed[..separator].Trim('[', ']');
+ var portText = trimmed[(separator + 1)..];
+ if (!int.TryParse(portText, NumberStyles.Integer, CultureInfo.InvariantCulture, out var port) ||
+ port <= 0 || port > 65535)
+ {
+ throw new ArgumentException($"Idunn RUDP endpoint port is invalid: {portText}", nameof(value));
+ }
+
+ var addresses = Dns.GetHostAddresses(host);
+ var address = addresses.FirstOrDefault(static candidate => candidate.AddressFamily == AddressFamily.InterNetwork) ??
+ throw new ArgumentException($"Idunn RUDP endpoint host has no IPv4 address: {host}", nameof(value));
+ return new IPEndPoint(address, port);
+ }
+}
+
internal readonly record struct ColorBgra(byte R, byte G, byte B)
{
public static readonly ColorBgra Black = new(0, 0, 0);