#nullable enable
namespace Sharp7.Rx;
public static class S7ErrorCodes
{
///
/// This list is not exhaustive and should be considered work in progress.
///
private static readonly HashSet notDisconnectedErrorCodes =
[
0x000000, // OK
0xC00000, // CPU: Item not available
0x900000 // CPU: Address out of range
];
private static readonly IReadOnlyDictionary additionalErrorTexts = new Dictionary
{
{0xC00000, "This happens when the DB does not exist."},
{0x900000, "This happens when the DB is not long enough."},
{
0x40000, """
This can happen when the cpu MPI address or rack is wrong, the DB is "optimized", or "PUT/GET communication" is not enabled.
See https://snap7.sourceforge.net/snap7_client.html#target_compatibility.
"""
}
};
///
/// Some error codes indicate connection lost, in which case, the driver tries to reestablish connection.
/// Other error codes indicate a user error, like reading from an unavailable DB or exceeding
/// the DBs range. In this case the driver should not consider the connection to be lost.
///
public static bool AssumeConnectionLost(int errorCode) =>
!notDisconnectedErrorCodes.Contains(errorCode);
public static string? GetAdditionalErrorText(int errorCode) =>
additionalErrorTexts.GetValueOrDefault(errorCode);
}