From 84adefa331c4159d432d22840663c38f155cd4c1 Mon Sep 17 00:00:00 2001 From: Erlang/OTP Date: Fri, 20 Nov 2009 14:54:40 +0000 Subject: The R13B03 release. --- lib/megaco/src/binary/megaco_per_encoder.erl | 291 +++++++++++++++++++++++++++ 1 file changed, 291 insertions(+) create mode 100644 lib/megaco/src/binary/megaco_per_encoder.erl (limited to 'lib/megaco/src/binary/megaco_per_encoder.erl') diff --git a/lib/megaco/src/binary/megaco_per_encoder.erl b/lib/megaco/src/binary/megaco_per_encoder.erl new file mode 100644 index 0000000000..596e621c65 --- /dev/null +++ b/lib/megaco/src/binary/megaco_per_encoder.erl @@ -0,0 +1,291 @@ +%% +%% %CopyrightBegin% +%% +%% Copyright Ericsson AB 2000-2009. All Rights Reserved. +%% +%% The contents of this file are subject to the Erlang Public License, +%% Version 1.1, (the "License"); you may not use this file except in +%% compliance with the License. You should have received a copy of the +%% Erlang Public License along with this software. If not, it can be +%% retrieved online at http://www.erlang.org/. +%% +%% Software distributed under the License is distributed on an "AS IS" +%% basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See +%% the License for the specific language governing rights and limitations +%% under the License. +%% +%% %CopyrightEnd% +%% + +%% +%%---------------------------------------------------------------------- +%% Purpose : Handle ASN.1 PER encoding of Megaco/H.248 +%%---------------------------------------------------------------------- + +-module(megaco_per_encoder). + +-behaviour(megaco_encoder). + +-export([encode_message/3, decode_message/3, + decode_mini_message/3, + + encode_transaction/3, + encode_action_requests/3, + encode_action_request/3, + encode_action_reply/3, + + version_of/2]). + +%% Backward compatible functions: +-export([encode_message/2, decode_message/2]). + +-include_lib("megaco/src/engine/megaco_message_internal.hrl"). + +-define(V1_ASN1_MOD, megaco_per_media_gateway_control_v1). +-define(V2_ASN1_MOD, megaco_per_media_gateway_control_v2). +-define(V3_ASN1_MOD, megaco_per_media_gateway_control_v3). +-define(PREV3A_ASN1_MOD, megaco_per_media_gateway_control_prev3a). +-define(PREV3B_ASN1_MOD, megaco_per_media_gateway_control_prev3b). +-define(PREV3C_ASN1_MOD, megaco_per_media_gateway_control_prev3c). + +-define(V1_TRANS_MOD, megaco_binary_transformer_v1). +-define(V2_TRANS_MOD, megaco_binary_transformer_v2). +-define(V3_TRANS_MOD, megaco_binary_transformer_v3). +-define(PREV3A_TRANS_MOD, megaco_binary_transformer_prev3a). +-define(PREV3B_TRANS_MOD, megaco_binary_transformer_prev3b). +-define(PREV3C_TRANS_MOD, megaco_binary_transformer_prev3c). + +-define(BIN_LIB, megaco_binary_encoder_lib). + + +%%---------------------------------------------------------------------- +%% Detect (check/get) message version +%% Return {ok, Version} | {error, Reason} +%%---------------------------------------------------------------------- + +version_of([{version3,v3}|EC], Binary) -> + Decoders = [?V1_ASN1_MOD, ?V2_ASN1_MOD, ?V3_ASN1_MOD], + ?BIN_LIB:version_of(EC, Binary, 1, Decoders); +version_of([{version3,prev3c}|EC], Binary) -> + Decoders = [?V1_ASN1_MOD, ?V2_ASN1_MOD, ?PREV3C_ASN1_MOD], + ?BIN_LIB:version_of(EC, Binary, 1, Decoders); +version_of([{version3,prev3b}|EC], Binary) -> + Decoders = [?V1_ASN1_MOD, ?V2_ASN1_MOD, ?PREV3B_ASN1_MOD], + ?BIN_LIB:version_of(EC, Binary, 1, Decoders); +version_of([{version3,prev3a}|EC], Binary) -> + Decoders = [?V1_ASN1_MOD, ?V2_ASN1_MOD, ?PREV3A_ASN1_MOD], + ?BIN_LIB:version_of(EC, Binary, 1, Decoders); +version_of(EC, Binary) -> + Decoders = [?V1_ASN1_MOD, ?V2_ASN1_MOD, ?V3_ASN1_MOD], + ?BIN_LIB:version_of(EC, Binary, 1, Decoders). + + +%%---------------------------------------------------------------------- +%% Convert a 'MegacoMessage' record into a binary +%% Return {ok, Binary} | {error, Reason} +%%---------------------------------------------------------------------- + +encode_message(EC, + #'MegacoMessage'{mess = #'Message'{version = V}} = MegaMsg) -> + encode_message(EC, V, MegaMsg). + + +%% -- Version 1 -- + +encode_message([{version3,_}|EC], 1, MegaMsg) -> + AsnMod = ?V1_ASN1_MOD, + TransMod = ?V1_TRANS_MOD, + ?BIN_LIB:encode_message(EC, MegaMsg, AsnMod, TransMod, io_list); +encode_message(EC, 1, MegaMsg) -> + AsnMod = ?V1_ASN1_MOD, + TransMod = ?V1_TRANS_MOD, + ?BIN_LIB:encode_message(EC, MegaMsg, AsnMod, TransMod, io_list); + + +%% -- Version 2 -- + +encode_message([{version3,_}|EC], 2, MegaMsg) -> + AsnMod = ?V2_ASN1_MOD, + TransMod = ?V2_TRANS_MOD, + ?BIN_LIB:encode_message(EC, MegaMsg, AsnMod, TransMod, io_list); +encode_message(EC, 2, MegaMsg) -> + AsnMod = ?V2_ASN1_MOD, + TransMod = ?V2_TRANS_MOD, + ?BIN_LIB:encode_message(EC, MegaMsg, AsnMod, TransMod, io_list); + + +%% -- Version 3 -- + +encode_message([{version3,v3}|EC], 3, MegaMsg) -> + AsnMod = ?V3_ASN1_MOD, + TransMod = ?V3_TRANS_MOD, + ?BIN_LIB:encode_message(EC, MegaMsg, AsnMod, TransMod, io_list); +encode_message([{version3,prev3c}|EC], 3, MegaMsg) -> + AsnMod = ?PREV3C_ASN1_MOD, + TransMod = ?PREV3C_TRANS_MOD, + ?BIN_LIB:encode_message(EC, MegaMsg, AsnMod, TransMod, io_list); +encode_message([{version3,prev3b}|EC], 3, MegaMsg) -> + AsnMod = ?PREV3B_ASN1_MOD, + TransMod = ?PREV3B_TRANS_MOD, + ?BIN_LIB:encode_message(EC, MegaMsg, AsnMod, TransMod, io_list); +encode_message([{version3,prev3a}|EC], 3, MegaMsg) -> + AsnMod = ?PREV3A_ASN1_MOD, + TransMod = ?PREV3A_TRANS_MOD, + ?BIN_LIB:encode_message(EC, MegaMsg, AsnMod, TransMod, io_list); +encode_message(EC, 3, MegaMsg) -> + AsnMod = ?V3_ASN1_MOD, + TransMod = ?V3_TRANS_MOD, + ?BIN_LIB:encode_message(EC, MegaMsg, AsnMod, TransMod, io_list). + + +%%---------------------------------------------------------------------- +%% Convert a transaction (or transactions in the case of ack) record(s) +%% into a binary +%% Return {ok, Binary} | {error, Reason} +%%---------------------------------------------------------------------- + +encode_transaction(_EC, 1, _Trans) -> +%% AsnMod = ?V1_ASN1_MOD, +%% TransMod = ?V1_TRANS_MOD, +%% ?BIN_LIB:encode_transaction(EC, Trans, AsnMod, TransMod, +%% io_list); + {error, not_implemented}; +encode_transaction(_EC, 2, _Trans) -> +%% AsnMod = ?V2_ASN1_MOD, +%% TransMod = ?V2_TRANS_MOD, +%% ?BIN_LIB:encode_transaction(EC, Trans, AsnMod, TransMod, +%% io_list); + {error, not_implemented}; +encode_transaction(_EC, 3, _Trans) -> +%% AsnMod = ?V3_ASN1_MOD, +%% TransMod = ?V3_TRANS_MOD, +%% ?BIN_LIB:encode_transaction(EC, Trans, AsnMod, TransMod, +%% io_list); + {error, not_implemented}. + + +%%---------------------------------------------------------------------- +%% Convert a list of ActionRequest record's into a binary +%% Return {ok, DeepIoList} | {error, Reason} +%%---------------------------------------------------------------------- +encode_action_requests(_EC, 1, ActReqs) when is_list(ActReqs) -> +%% AsnMod = ?V1_ASN1_MOD, +%% TransMod = ?V1_TRANS_MOD, +%% ?BIN_LIB:encode_action_requests(EC, ActReqs, +%% AsnMod, TransMod, +%% io_list); + {error, not_implemented}; +encode_action_requests(_EC, 2, ActReqs) when is_list(ActReqs) -> +%% AsnMod = ?V2_ASN1_MOD, +%% TransMod = ?V2_TRANS_MOD, +%% ?BIN_LIB:encode_action_requests(EC, ActReqs, +%% AsnMod, TransMod, +%% io_list); + {error, not_implemented}; +encode_action_requests(_EC, 3, ActReqs) when is_list(ActReqs) -> +%% AsnMod = ?V3_ASN1_MOD, +%% TransMod = ?V3_TRANS_MOD, +%% ?BIN_LIB:encode_action_requests(EC, ActReqs, +%% AsnMod, TransMod, +%% io_list); + {error, not_implemented}. + + +%%---------------------------------------------------------------------- +%% Convert a ActionRequest record into a binary +%% Return {ok, DeepIoList} | {error, Reason} +%%---------------------------------------------------------------------- +encode_action_request(_EC, 1, _ActReq) -> +%% AsnMod = ?V1_ASN1_MOD, +%% TransMod = ?V1_TRANS_MOD, +%% ?BIN_LIB:encode_action_request(EC, ActReq, +%% AsnMod, TransMod, +%% io_list); + {error, not_implemented}; +encode_action_request(_EC, 2, _ActReq) -> +%% AsnMod = ?V2_ASN1_MOD, +%% TransMod = ?V2_TRANS_MOD, +%% ?BIN_LIB:encode_action_request(EC, ActReq, +%% AsnMod, TransMod, +%% io_list); + {error, not_implemented}; +encode_action_request(_EC, 3, _ActReq) -> +%% AsnMod = ?V3_ASN1_MOD, +%% TransMod = ?V3_TRANS_MOD, +%% ?BIN_LIB:encode_action_request(EC, ActReq, +%% AsnMod, TransMod, +%% io_list); + {error, not_implemented}. + + + +%%---------------------------------------------------------------------- +%% Convert a action reply into a deep io list +%% Not yest supported by this binary codec! +%% Return {ok, DeepIoList} | {error, Reason} +%%---------------------------------------------------------------------- + +encode_action_reply(_EC, _V, _AcionReply) -> + {error, not_implemented}. + + +%%---------------------------------------------------------------------- +%% Convert a binary into a 'MegacoMessage' record +%% Return {ok, MegacoMessageRecord} | {error, Reason} +%%---------------------------------------------------------------------- + +decode_message(EC, Binary) -> + decode_message(EC, 1, Binary). + +%% PER does not support partial decode, so this means V1 +decode_message(EC, dynamic, Binary) -> + decode_message(EC, 1, Binary); + + +%% -- Version 1 -- + +decode_message([{version3,_}|EC], 1, Binary) -> + AsnMod = ?V1_ASN1_MOD, + TransMod = ?V1_TRANS_MOD, + ?BIN_LIB:decode_message(EC, Binary, AsnMod, TransMod, io_list); +decode_message(EC, 1, Binary) -> + AsnMod = ?V1_ASN1_MOD, + TransMod = ?V1_TRANS_MOD, + ?BIN_LIB:decode_message(EC, Binary, AsnMod, TransMod, io_list); + +%% -- Version 2 -- + +decode_message([{version3,_}|EC], 2, Binary) -> + AsnMod = ?V2_ASN1_MOD, + TransMod = ?V2_TRANS_MOD, + ?BIN_LIB:decode_message(EC, Binary, AsnMod, TransMod, io_list); +decode_message(EC, 2, Binary) -> + AsnMod = ?V2_ASN1_MOD, + TransMod = ?V2_TRANS_MOD, + ?BIN_LIB:decode_message(EC, Binary, AsnMod, TransMod, io_list); + +%% -- Version 3 -- + +decode_message([{version3,v3}|EC], 3, Binary) -> + AsnMod = ?V3_ASN1_MOD, + TransMod = ?V3_TRANS_MOD, + ?BIN_LIB:decode_message(EC, Binary, AsnMod, TransMod, io_list); +decode_message([{version3,prev3c}|EC], 3, Binary) -> + AsnMod = ?PREV3C_ASN1_MOD, + TransMod = ?PREV3C_TRANS_MOD, + ?BIN_LIB:decode_message(EC, Binary, AsnMod, TransMod, io_list); +decode_message([{version3,prev3b}|EC], 3, Binary) -> + AsnMod = ?PREV3B_ASN1_MOD, + TransMod = ?PREV3B_TRANS_MOD, + ?BIN_LIB:decode_message(EC, Binary, AsnMod, TransMod, io_list); +decode_message([{version3,prev3a}|EC], 3, Binary) -> + AsnMod = ?PREV3A_ASN1_MOD, + TransMod = ?PREV3A_TRANS_MOD, + ?BIN_LIB:decode_message(EC, Binary, AsnMod, TransMod, io_list); +decode_message(EC, 3, Binary) -> + AsnMod = ?V3_ASN1_MOD, + TransMod = ?V3_TRANS_MOD, + ?BIN_LIB:decode_message(EC, Binary, AsnMod, TransMod, io_list). + +decode_mini_message(_EC, _Vsn, _Bin) -> + {error, not_implemented}. -- cgit v1.2.3