IEC60870.ASDU (ExIEC60870 v0.1.0)

Application Service Data Unit (ASDU) shared by IEC 60870-5-101 and IEC 60870-5-104. Matches cs101_asdu.c in lib60870-C.

Supports:

Discrete IOA encoding (is_sequence: false, SQ = 0)
Compact sequential IOA encoding (is_sequence: true, SQ = 1)
Configurable COT (1 or 2 bytes), CA (1 or 2 bytes), IOA (1, 2, or 3 bytes)
Strict VSQ and single-object type validation matching lib60870-C

Summary

Functions

add_object(asdu, io, params \\ %AppLayerParameters{})

Adds an Information Object to the ASDU, validating type consistency, single-object constraints, sequence address continuity (SQ=1), and maximum ASDU byte size. Matches CS101_ASDU_addInformationObject in cs101_asdu.c.

decode(bin, params \\ %AppLayerParameters{})

Decodes an ASDU binary buffer into %IEC60870.ASDU{} according to AppLayerParameters. Performs strict header and VSQ bounds checks matching CS101_ASDU_createFromBufferEx.

encode(asdu, params \\ %AppLayerParameters{})

Encodes an %IEC60870.ASDU{} into binary according to AppLayerParameters.

encode!(asdu, params \\ %AppLayerParameters{})

Encodes an ASDU and raises on error.

new(type_id, opts)

Creates a new ASDU. Supports both ASDU.new(type_id, kw_opts) and ASDU.new(cot, ca, kw_opts).

new(cot, ca, opts)

Types

t()

@type t() :: %IEC60870.ASDU{
  ca: non_neg_integer(),
  cot: IEC60870.Types.COT.name() | IEC60870.Types.COT.code(),
  is_negative: boolean(),
  is_sequence: boolean(),
  is_test: boolean(),
  oa: non_neg_integer(),
  objects: [IEC60870.InformationObject.t()],
  raw_payload: nil | binary(),
  type_id: nil | IEC60870.Types.TypeID.name() | IEC60870.Types.TypeID.code()
}