2017-07-23 14:04:46 +00:00
|
|
|
#---------------------------------------------------------------------------
|
2016-04-01 22:13:35 +00:00
|
|
|
#
|
|
|
|
# Title : EMESARY inter-object communication
|
|
|
|
#
|
|
|
|
# File Type : Implementation File
|
|
|
|
#
|
|
|
|
# Description : Provides generic inter-object communication. For an object to receive a message it
|
|
|
|
# : must first register with an instance of a Transmitter, and provide a Receive method
|
|
|
|
#
|
|
|
|
# : To send a message use a Transmitter with an object. That's all there is to it.
|
|
|
|
#
|
|
|
|
# References : http://chateau-logic.com/content/emesary-nasal-implementation-flightgear
|
2017-07-23 14:04:46 +00:00
|
|
|
# : http://www.chateau-logic.com/content/class-based-inter-object-communication
|
2016-04-01 22:13:35 +00:00
|
|
|
# : http://chateau-logic.com/content/emesary-efficient-inter-object-communication-using-interfaces-and-inheritance
|
|
|
|
# : http://chateau-logic.com/content/c-wpf-application-plumbing-using-emesary
|
|
|
|
#
|
|
|
|
# Author : Richard Harrison (richard@zaretto.com)
|
|
|
|
#
|
|
|
|
# Creation Date : 29 January 2016
|
|
|
|
#
|
|
|
|
# Version : 4.8
|
|
|
|
#
|
2020-06-05 10:46:54 +00:00
|
|
|
# Copyright © 2016 Richard Harrison Released under GPL V2
|
2016-04-01 22:13:35 +00:00
|
|
|
#
|
2020-06-29 08:49:18 +00:00
|
|
|
#---------------------------------------------------------------------------
|
|
|
|
# Classes in this file:
|
|
|
|
# Transmitter
|
|
|
|
# Notification
|
|
|
|
# Recipient
|
2016-04-01 22:13:35 +00:00
|
|
|
#---------------------------------------------------------------------------*/
|
|
|
|
|
2016-04-09 19:39:57 +00:00
|
|
|
var __emesaryUniqueId = 14; # 0-15 are reserved, this way the global transmitter will be 15.
|
|
|
|
|
2020-06-29 08:49:18 +00:00
|
|
|
# add registry so we can find a transmitter by name in genericEmesaryGlobalTransmitterTransmit
|
|
|
|
var _transmitters = Hash.new("transmitters");
|
|
|
|
|
|
|
|
var _registerTransmitter = func (key, t) {
|
|
|
|
_transmitters.set(key, t);
|
|
|
|
}
|
|
|
|
var getTransmitter = func (key) {
|
|
|
|
return _transmitters.get(key);
|
|
|
|
}
|
|
|
|
|
2016-04-01 22:13:35 +00:00
|
|
|
# Transmitters send notifications to all recipients that are registered.
|
|
|
|
var Transmitter =
|
|
|
|
{
|
|
|
|
ReceiptStatus_OK : 0, # Processing completed successfully
|
|
|
|
ReceiptStatus_Fail : 1, # Processing resulted in at least one failure
|
2020-06-29 08:49:18 +00:00
|
|
|
ReceiptStatus_Abort : 2, # Fatal error, stop processing any further recipients of this message. Implicitly failed.
|
|
|
|
ReceiptStatus_Finished : 3, # Definitive completion - do not send message to any further recipients
|
2016-04-01 22:13:35 +00:00
|
|
|
ReceiptStatus_NotProcessed : 4,# Return value when method doesn't process a message.
|
|
|
|
ReceiptStatus_Pending : 5, # Message sent with indeterminate return status as processing underway
|
|
|
|
ReceiptStatus_PendingFinished : 6,# Message definitively handled, status indeterminate. The message will not be sent any further
|
|
|
|
|
|
|
|
# create a new transmitter. shouldn't need many of these
|
2020-06-29 08:49:18 +00:00
|
|
|
# _ident: string; name of the transmitter, used in debug messages
|
2016-04-01 22:13:35 +00:00
|
|
|
new: func(_ident)
|
|
|
|
{
|
2020-06-29 08:49:18 +00:00
|
|
|
if (!isscalar(_ident)) {
|
|
|
|
logprint(LOG_ALERT, "Transmitter.new: argument must be a scalar!")
|
|
|
|
}
|
2016-04-09 19:39:57 +00:00
|
|
|
__emesaryUniqueId += 1;
|
2020-06-29 08:49:18 +00:00
|
|
|
var new_class = {
|
|
|
|
parents : [Transmitter],
|
|
|
|
Recipients : [],
|
|
|
|
Ident : _ident,
|
|
|
|
Timestamp : nil,
|
|
|
|
MaxMilliseconds : 1,
|
|
|
|
UniqueId: __emesaryUniqueId,
|
|
|
|
};
|
|
|
|
_registerTransmitter(_ident, new_class);
|
2016-04-01 22:13:35 +00:00
|
|
|
return new_class;
|
|
|
|
},
|
2020-06-29 08:49:18 +00:00
|
|
|
|
2019-06-08 08:52:08 +00:00
|
|
|
OverrunDetection: func(max_ms=0){
|
2020-06-29 08:49:18 +00:00
|
|
|
if (isnum(max_ms) and max_ms) {
|
|
|
|
if (me.Timestamp == nil)
|
2019-06-08 08:52:08 +00:00
|
|
|
me.Timestamp = maketimestamp();
|
2020-06-29 08:49:18 +00:00
|
|
|
me.MaxMilliseconds = max_ms;
|
|
|
|
logprint(LOG_INFO, "Set overrun detection ",me.Ident, " to ", me.MaxMilliseconds);
|
|
|
|
return 1;
|
|
|
|
} else {
|
|
|
|
# me.Timestamp = nil;
|
|
|
|
me.MaxMilliseconds = 0;
|
|
|
|
logprint(LOG_INFO, "Disable overrun detection ",me.Ident);
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
},
|
2016-04-01 22:13:35 +00:00
|
|
|
|
|
|
|
# Add a recipient to receive notifications from this transmitter
|
|
|
|
Register: func (recipient)
|
|
|
|
{
|
2020-06-29 08:49:18 +00:00
|
|
|
# not inheriting from Recipient is maybe strange but will not crash
|
|
|
|
if (!isa(recipient, Recipient))
|
|
|
|
{
|
|
|
|
logprint(LOG_INFO, "Transmitter.Register: argument is not a Recipient object");
|
|
|
|
}
|
|
|
|
#not having a Receive function is an error
|
|
|
|
if (!isfunc(recipient["Receive"]))
|
|
|
|
{
|
|
|
|
logprint(DEV_ALERT, "Transmitter.Register: Error, argument has no Receive method!");
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
foreach (var r; me.Recipients)
|
|
|
|
{
|
|
|
|
if (r == recipient) {
|
|
|
|
logprint(DEV_ALERT, "Transmitter.Register: Recipient already registered!");
|
|
|
|
return 1;
|
|
|
|
}
|
|
|
|
}
|
2016-04-01 22:13:35 +00:00
|
|
|
append(me.Recipients, recipient);
|
2020-06-29 08:49:18 +00:00
|
|
|
return 1;
|
2016-04-01 22:13:35 +00:00
|
|
|
},
|
2020-06-29 08:49:18 +00:00
|
|
|
|
2018-07-27 22:33:38 +00:00
|
|
|
DeleteAllRecipients: func
|
|
|
|
{
|
|
|
|
me.Recipients = [];
|
|
|
|
},
|
2020-06-29 08:49:18 +00:00
|
|
|
|
2016-04-01 22:13:35 +00:00
|
|
|
# Stops a recipient from receiving notifications from this transmitter.
|
|
|
|
DeRegister: func(todelete_recipient)
|
|
|
|
{
|
|
|
|
var out_idx = 0;
|
|
|
|
var element_deleted = 0;
|
|
|
|
|
|
|
|
for (var idx = 0; idx < size(me.Recipients); idx += 1)
|
|
|
|
{
|
|
|
|
if (me.Recipients[idx] != todelete_recipient)
|
|
|
|
{
|
|
|
|
me.Recipients[out_idx] = me.Recipients[idx];
|
|
|
|
out_idx = out_idx + 1;
|
|
|
|
}
|
|
|
|
else
|
|
|
|
element_deleted = 1;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (element_deleted)
|
|
|
|
pop(me.Recipients);
|
|
|
|
},
|
|
|
|
|
|
|
|
RecipientCount: func
|
|
|
|
{
|
|
|
|
return size(me.Recipients);
|
|
|
|
},
|
|
|
|
|
|
|
|
PrintRecipients: func
|
|
|
|
{
|
2016-05-16 20:06:48 +00:00
|
|
|
print("Emesary: Recipient list for ",me.Ident,"(",me.UniqueId,")");
|
2016-04-01 22:13:35 +00:00
|
|
|
for (var idx = 0; idx < size(me.Recipients); idx += 1)
|
2016-05-16 20:06:48 +00:00
|
|
|
print("Emesary: Recipient[",idx,"] ",me.Recipients[idx].Ident," (",me.Recipients[idx].UniqueId,")");
|
2016-04-01 22:13:35 +00:00
|
|
|
},
|
|
|
|
|
|
|
|
# Notify all registered recipients. Stop when receipt status of abort or finished are received.
|
|
|
|
# The receipt status from this method will be
|
|
|
|
# - OK > message handled
|
|
|
|
# - Fail > message not handled. A status of Abort from a recipient will result in our status
|
|
|
|
# being fail as Abort means that the message was not and cannot be handled, and
|
|
|
|
# allows for usages such as access controls.
|
2020-06-29 08:49:18 +00:00
|
|
|
# message: hash; Notification passed to the Receive() method of registered recipients
|
2016-04-01 22:13:35 +00:00
|
|
|
NotifyAll: func(message)
|
|
|
|
{
|
2020-06-29 08:49:18 +00:00
|
|
|
if (!isa(message, Notification))
|
|
|
|
{
|
|
|
|
logprint(DEV_ALERT, "Transmitter.NotifyAll: argument must be a Notification!");
|
2018-07-27 22:33:38 +00:00
|
|
|
return Transmitter.ReceiptStatus_NotProcessed;
|
|
|
|
}
|
2019-06-08 08:52:08 +00:00
|
|
|
me._return_status = Transmitter.ReceiptStatus_NotProcessed;
|
|
|
|
me.TimeTaken = 0;
|
2016-04-01 22:13:35 +00:00
|
|
|
foreach (var recipient; me.Recipients)
|
|
|
|
{
|
2016-04-09 19:39:57 +00:00
|
|
|
if (recipient.RecipientActive)
|
2016-04-01 22:13:35 +00:00
|
|
|
{
|
2019-06-08 08:52:08 +00:00
|
|
|
me._rstat = nil;
|
|
|
|
if (me.MaxMilliseconds > 0 and me.Timestamp != nil)
|
|
|
|
me.Timestamp.stamp();
|
|
|
|
|
|
|
|
message.Timestamp = me.Timestamp;
|
|
|
|
call(func {me._rstat = recipient.Receive(message);},nil,nil,nil,var err = []);
|
2018-11-07 00:53:06 +00:00
|
|
|
|
|
|
|
if (size(err)){
|
|
|
|
foreach(var line; err) {
|
|
|
|
print(line);
|
|
|
|
}
|
2020-06-29 08:49:18 +00:00
|
|
|
logprint(LOG_ALERT, "Recipient ",recipient.Ident,
|
|
|
|
" has been removed from transmitter (", me.Ident,
|
|
|
|
") because of the above error");
|
2018-11-07 00:53:06 +00:00
|
|
|
me.DeRegister(recipient);
|
2020-06-29 08:49:18 +00:00
|
|
|
#need to break the foreach due to having modified what its iterating over.
|
|
|
|
return Transmitter.ReceiptStatus_Abort;
|
2018-11-07 00:53:06 +00:00
|
|
|
}
|
2019-06-08 08:52:08 +00:00
|
|
|
if (me.Timestamp != nil) {
|
|
|
|
recipient.TimeTaken = me.Timestamp.elapsedUSec()/1000.0;
|
|
|
|
me.TimeTaken += recipient.TimeTaken;
|
|
|
|
}
|
2016-04-01 22:13:35 +00:00
|
|
|
|
2019-06-08 08:52:08 +00:00
|
|
|
if(me._rstat == Transmitter.ReceiptStatus_Fail)
|
2016-04-01 22:13:35 +00:00
|
|
|
{
|
2019-06-08 08:52:08 +00:00
|
|
|
me._return_status = Transmitter.ReceiptStatus_Fail;
|
2016-04-01 22:13:35 +00:00
|
|
|
}
|
2019-06-08 08:52:08 +00:00
|
|
|
elsif(me._rstat == Transmitter.ReceiptStatus_Pending)
|
2016-04-01 22:13:35 +00:00
|
|
|
{
|
2019-06-08 08:52:08 +00:00
|
|
|
me._return_status = Transmitter.ReceiptStatus_Pending;
|
2016-04-01 22:13:35 +00:00
|
|
|
}
|
2019-06-08 08:52:08 +00:00
|
|
|
elsif(me._rstat == Transmitter.ReceiptStatus_PendingFinished)
|
2016-04-01 22:13:35 +00:00
|
|
|
{
|
2019-06-08 08:52:08 +00:00
|
|
|
return me._rstat;
|
2016-04-01 22:13:35 +00:00
|
|
|
}
|
|
|
|
# elsif(rstat == Transmitter.ReceiptStatus_NotProcessed)
|
|
|
|
# {
|
|
|
|
# ;
|
|
|
|
# }
|
2019-06-08 08:52:08 +00:00
|
|
|
elsif(me._rstat == Transmitter.ReceiptStatus_OK)
|
2016-04-01 22:13:35 +00:00
|
|
|
{
|
2019-06-08 08:52:08 +00:00
|
|
|
if (me._return_status == Transmitter.ReceiptStatus_NotProcessed)
|
|
|
|
me._return_status = me._rstat;
|
2016-04-01 22:13:35 +00:00
|
|
|
}
|
2019-06-08 08:52:08 +00:00
|
|
|
elsif(me._rstat == Transmitter.ReceiptStatus_Abort)
|
2016-04-01 22:13:35 +00:00
|
|
|
{
|
2020-06-29 08:49:18 +00:00
|
|
|
# this is a final results, e.g. no more recipients will be
|
|
|
|
# notified but the result is returned as NotifyAll result.
|
2016-04-01 22:13:35 +00:00
|
|
|
return Transmitter.ReceiptStatus_Abort;
|
|
|
|
}
|
2019-06-08 08:52:08 +00:00
|
|
|
elsif(me._rstat == Transmitter.ReceiptStatus_Finished)
|
2016-04-01 22:13:35 +00:00
|
|
|
{
|
2020-06-29 08:49:18 +00:00
|
|
|
# this is a final results, e.g. no more recipients will be
|
|
|
|
# notified but the result is returned as NotifyAll result.
|
2016-04-01 22:13:35 +00:00
|
|
|
return Transmitter.ReceiptStatus_OK;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
2020-06-29 08:49:18 +00:00
|
|
|
if (me.MaxMilliseconds and me.TimeTaken > me.MaxMilliseconds) {
|
|
|
|
logprint(LOG_WARN, sprintf("Overrun: %s ['%s'] %1.2fms max (%d)",
|
|
|
|
me.Ident, message.NotificationType, me.TimeTaken, me.MaxMilliseconds));
|
2019-06-08 08:52:08 +00:00
|
|
|
foreach (var recipient; me.Recipients) {
|
2020-06-29 08:49:18 +00:00
|
|
|
if (recipient.TimeTaken) {
|
|
|
|
logprint(LOG_WARN, sprintf(" -- Recipient %25s %7.2f ms",
|
|
|
|
recipient.Ident, recipient.TimeTaken));
|
|
|
|
}
|
2019-06-08 08:52:08 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
return me._return_status;
|
2016-04-01 22:13:35 +00:00
|
|
|
},
|
|
|
|
|
|
|
|
# Returns true if a return value from NotifyAll is to be considered a failure.
|
|
|
|
IsFailed: func(receiptStatus)
|
|
|
|
{
|
|
|
|
# Failed is either Fail or Abort.
|
|
|
|
# NotProcessed isn't a failure because it hasn't been processed.
|
|
|
|
if (receiptStatus == Transmitter.ReceiptStatus_Fail or receiptStatus == Transmitter.ReceiptStatus_Abort)
|
|
|
|
return 1;
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
};
|
|
|
|
|
2020-06-05 09:12:30 +00:00
|
|
|
var QueuedTransmitter =
|
|
|
|
{
|
|
|
|
new: func(_ident){
|
|
|
|
var new_class = { parents:[QueuedTransmitter], base:emesary.Transmitter};
|
|
|
|
new_class = emesary.Transmitter.new(_ident);
|
|
|
|
new_class.baseNotifyAll = new_class.NotifyAll;
|
|
|
|
new_class.Q = [];
|
|
|
|
|
|
|
|
new_class.NotifyAll = func(message){
|
|
|
|
append(me.Q, message);
|
|
|
|
return emesary.Transmitter.ReceiptStatus_Pending;
|
|
|
|
};
|
|
|
|
|
|
|
|
new_class.Process = func {
|
|
|
|
foreach (var m ; me.Q)
|
|
|
|
me.baseNotifyAll(m);
|
|
|
|
me.Q = [];
|
|
|
|
return emesary.Transmitter.ReceiptStatus_PendingFinished;
|
|
|
|
};
|
|
|
|
new_class.size = func {
|
|
|
|
return size(me.Q);
|
|
|
|
}
|
|
|
|
return new_class;
|
|
|
|
}
|
|
|
|
};
|
|
|
|
|
2020-06-29 08:49:18 +00:00
|
|
|
|
|
|
|
#---------------------------------------------------------------------------
|
|
|
|
# Notification - base class
|
|
|
|
# By convention a Notification has a type and a value. Derived classes can add
|
|
|
|
# extra properties or methods.
|
|
|
|
#
|
|
|
|
# NotificationType: Notification Type
|
|
|
|
# Ident: Can be an ident, or for simple messages a value that needs transmitting.
|
|
|
|
# IsDistinct: non zero if this message supercedes previous messages of this type.
|
|
|
|
# Distinct messages are usually sent often and self contained
|
|
|
|
# (i.e. no relative state changes such as toggle value)
|
|
|
|
# Messages that indicate an event (such as after a pilot action)
|
|
|
|
# will usually be non-distinct. So an example would be gear/up down
|
|
|
|
# or ATC acknowledgements that all need to be transmitted
|
2016-04-09 19:39:57 +00:00
|
|
|
# The IsDistinct is important for any messages that are bridged over MP as
|
2020-06-29 08:49:18 +00:00
|
|
|
# only the most recently sent distinct message will be transmitted over MP.
|
|
|
|
# Example:
|
|
|
|
# position update, where only current position is relevant -> IsDistinct=1;
|
|
|
|
# 0 = queue all messages for MP bridging
|
|
|
|
# 1 = queue only latest message (replace any old message of same type+ident)
|
|
|
|
#
|
|
|
|
var TypeIdUnspecified = 1;
|
2017-07-23 14:04:46 +00:00
|
|
|
var NotificationAutoTypeId = 1;
|
2016-04-01 22:13:35 +00:00
|
|
|
var Notification =
|
|
|
|
{
|
2017-07-23 14:04:46 +00:00
|
|
|
new: func(_type, _ident, _typeid=0)
|
2016-04-01 22:13:35 +00:00
|
|
|
{
|
2020-06-29 08:49:18 +00:00
|
|
|
if (!isscalar(_type)) {
|
|
|
|
logprint(DEV_ALERT, "Notification.new: _type must be a scalar!");
|
|
|
|
return nil;
|
|
|
|
}
|
|
|
|
if (!isscalar(_ident)) {
|
|
|
|
logprint(DEV_ALERT, "Notification.new: _ident is not scalar but ", typeof(_ident));
|
|
|
|
return nil;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (_typeid == 0) {
|
|
|
|
NotificationAutoTypeId += 1;
|
|
|
|
# IDs >= 16 are reserved; see http://wiki.flightgear.org/Emesary_Notifications
|
|
|
|
if (NotificationAutoTypeId == 16) {
|
|
|
|
logprint(LOG_ALERT, "Notification: AutoTypeID limit exceeded: "~NotificationAutoTypeId);
|
|
|
|
return nil;
|
|
|
|
}
|
2017-07-23 14:04:46 +00:00
|
|
|
_typeid = NotificationAutoTypeId;
|
|
|
|
}
|
2020-06-29 08:49:18 +00:00
|
|
|
|
|
|
|
var new_class = {
|
|
|
|
parents: [Notification],
|
|
|
|
NotificationType: _type,
|
|
|
|
Ident: _ident,
|
|
|
|
IsDistinct: 1, #1: MP bridge only latest notification
|
|
|
|
FromIncomingBridge: 0,
|
|
|
|
Callsign: nil,
|
|
|
|
TypeId: _typeid, # used in MP bridged
|
|
|
|
};
|
2016-04-01 22:13:35 +00:00
|
|
|
return new_class;
|
|
|
|
},
|
2020-06-29 08:49:18 +00:00
|
|
|
|
|
|
|
setType: func(_type) {
|
|
|
|
if (!isscalar(_type)) {
|
|
|
|
logprint(DEV_ALERT, "Notification.new: _type must be a scalar!");
|
|
|
|
return nil;
|
|
|
|
}
|
|
|
|
me.NotificationType = _type;
|
|
|
|
return me;
|
|
|
|
},
|
|
|
|
|
|
|
|
setIdent: func(_ident) {
|
|
|
|
if (!isscalar(_ident)) {
|
|
|
|
logprint(DEV_ALERT, "Notification.new: _ident is not scalar but ", typeof(_ident));
|
|
|
|
return nil;
|
|
|
|
}
|
|
|
|
me.Ident = _ident;
|
|
|
|
return me;
|
|
|
|
},
|
|
|
|
|
|
|
|
GetBridgeMessageNotificationTypeKey: func {
|
|
|
|
return me.NotificationType~"."~me.Ident;
|
|
|
|
},
|
2016-04-01 22:13:35 +00:00
|
|
|
};
|
|
|
|
|
2020-06-29 08:49:18 +00:00
|
|
|
#---------------------------------------------------------------------------
|
|
|
|
# Recipient - base class for receiving notifications.
|
|
|
|
#
|
|
|
|
# You have to implement the Receive method
|
|
|
|
# The Receive method must return a sensible ReceiptStatus_* code
|
2016-04-01 22:13:35 +00:00
|
|
|
var Recipient =
|
|
|
|
{
|
|
|
|
new: func(_ident)
|
|
|
|
{
|
|
|
|
if (_ident == nil or _ident == "")
|
|
|
|
{
|
|
|
|
_ident = id(new_class);
|
2020-06-29 08:49:18 +00:00
|
|
|
logprint(LOG_WARN, "Emesary Error: Ident required when creating a recipient, defaulting to ", _ident);
|
2016-04-01 22:13:35 +00:00
|
|
|
}
|
2016-04-09 19:39:57 +00:00
|
|
|
__emesaryUniqueId += 1;
|
2020-06-29 08:49:18 +00:00
|
|
|
var new_class = {
|
|
|
|
parents: [Recipient],
|
|
|
|
Ident: _ident,
|
|
|
|
RecipientActive: 1,
|
|
|
|
UniqueId: __emesaryUniqueId,
|
2016-04-01 22:13:35 +00:00
|
|
|
};
|
|
|
|
return new_class;
|
|
|
|
},
|
2020-06-29 08:49:18 +00:00
|
|
|
|
|
|
|
Receive: func(notification)
|
|
|
|
{
|
|
|
|
logprint(DEV_ALERT, "Emesary Error: Receive function not implemented in recipient ", me.Ident);
|
|
|
|
return Transmitter.ReceiptStatus_NotProcessed;
|
|
|
|
},
|
|
|
|
|
|
|
|
setReceive: func(f)
|
|
|
|
{
|
|
|
|
if (isfunc(f)) { me.Receive = f; }
|
|
|
|
else { logprint(DEV_ALERT, "Recipient.addReceive: argument must be a function!"); }
|
|
|
|
return me;
|
|
|
|
},
|
2016-04-01 22:13:35 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
#
|
2020-06-29 08:49:18 +00:00
|
|
|
# Instantiate a Global Transmitter, this is a convenience and a known starting point.
|
|
|
|
# Generally most classes will use this transmitters, however other transmitters
|
|
|
|
# can be created and merely use the global transmitter to discover each other.
|
2016-04-01 22:13:35 +00:00
|
|
|
var GlobalTransmitter = Transmitter.new("GlobalTransmitter");
|
2016-04-09 19:39:57 +00:00
|
|
|
|
2016-04-16 13:13:33 +00:00
|
|
|
#
|
2020-06-05 10:46:54 +00:00
|
|
|
# Base method of transferring all numeric based values.
|
|
|
|
# Using the same techinque as base64 - except this is base248 because we can use a much wider range of characters.
|
2020-06-29 08:49:18 +00:00
|
|
|
#
|
2016-04-16 13:13:33 +00:00
|
|
|
var BinaryAsciiTransfer =
|
2016-04-09 19:39:57 +00:00
|
|
|
{
|
2020-06-29 08:49:18 +00:00
|
|
|
#excluded chars 32 (<space>), 33 (!), 35 (#), 36($), 126 (~), 127 (<del>)
|
|
|
|
alphabet :
|
|
|
|
chr(1) ~chr(2) ~chr(3) ~chr(4) ~chr(5) ~chr(6) ~chr(7) ~chr(8) ~chr(9)
|
|
|
|
~chr(10)~chr(11)~chr(12)~chr(13)~chr(14)~chr(15)~chr(16)~chr(17)~chr(18)~chr(19)
|
|
|
|
~chr(20)~chr(21)~chr(22)~chr(23)~chr(24)~chr(25)~chr(26)~chr(27)~chr(28)~chr(29)
|
|
|
|
~chr(30)~chr(31) ~chr(34)
|
|
|
|
~"%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}"
|
|
|
|
~chr(128)~chr(129)
|
|
|
|
~chr(130)~chr(131)~chr(132)~chr(133)~chr(134)~chr(135)~chr(136)~chr(137)~chr(138)~chr(139)
|
|
|
|
~chr(140)~chr(141)~chr(142)~chr(143)~chr(144)~chr(145)~chr(146)~chr(147)~chr(148)~chr(149)
|
|
|
|
~chr(150)~chr(151)~chr(152)~chr(153)~chr(154)~chr(155)~chr(156)~chr(157)~chr(158)~chr(159)
|
|
|
|
~chr(160)~chr(161)~chr(162)~chr(163)~chr(164)~chr(165)~chr(166)~chr(167)~chr(168)~chr(169)
|
|
|
|
~chr(170)~chr(171)~chr(172)~chr(173)~chr(174)~chr(175)~chr(176)~chr(177)~chr(178)~chr(179)
|
|
|
|
~chr(180)~chr(181)~chr(182)~chr(183)~chr(184)~chr(185)~chr(186)~chr(187)~chr(188)~chr(189)
|
|
|
|
~chr(190)~chr(191)~chr(192)~chr(193)~chr(194)~chr(195)~chr(196)~chr(197)~chr(198)~chr(199)
|
|
|
|
~chr(200)~chr(201)~chr(202)~chr(203)~chr(204)~chr(205)~chr(206)~chr(207)~chr(208)~chr(209)
|
|
|
|
~chr(210)~chr(211)~chr(212)~chr(213)~chr(214)~chr(215)~chr(216)~chr(217)~chr(218)~chr(219)
|
|
|
|
~chr(220)~chr(221)~chr(222)~chr(223)~chr(224)~chr(225)~chr(226)~chr(227)~chr(228)~chr(229)
|
|
|
|
~chr(230)~chr(231)~chr(232)~chr(233)~chr(234)~chr(235)~chr(236)~chr(237)~chr(238)~chr(239)
|
|
|
|
~chr(240)~chr(241)~chr(242)~chr(243)~chr(244)~chr(245)~chr(246)~chr(247)~chr(248)~chr(249)
|
|
|
|
~chr(250)~chr(251)~chr(252)~chr(253)~chr(254)~chr(255),
|
2020-06-05 10:46:54 +00:00
|
|
|
# base248: powers of 2 (i.e. po2(x) = f(248 ^ x);
|
|
|
|
# 0 based list so the first item is really[1]; i.e. 124 which is 248/2 as po2 is the magnitude excluding sign
|
|
|
|
po2: [1, 124, 30752, 7626496, 1891371008, 469060009984, 116326882476032, 28849066854055936],
|
|
|
|
|
2017-07-23 14:04:46 +00:00
|
|
|
_base: 248,
|
|
|
|
spaces: " ",
|
|
|
|
empty_encoding: chr(1)~chr(1)~chr(1)~chr(1)~chr(1)~chr(1)~chr(1)~chr(1)~chr(1)~chr(1)~chr(1),
|
2020-06-05 10:46:54 +00:00
|
|
|
encodeNumeric : func(_num,length,factor)
|
2016-04-09 19:39:57 +00:00
|
|
|
{
|
2020-06-05 10:46:54 +00:00
|
|
|
#print(BinaryAsciiTransfer.po2[1]);
|
|
|
|
var irange = int(BinaryAsciiTransfer.po2[length] / factor);
|
|
|
|
var scale = int(irange / factor);
|
|
|
|
#print("EC ",irange, " sc=",scale);
|
|
|
|
var num = int(_num / factor);
|
|
|
|
if (num < -scale) num = -scale;
|
|
|
|
else if (num > scale) num = scale;
|
|
|
|
|
|
|
|
num = int(num + irange);
|
|
|
|
|
2016-04-16 13:13:33 +00:00
|
|
|
if (num == 0)
|
2017-07-23 14:04:46 +00:00
|
|
|
return substr(BinaryAsciiTransfer.empty_encoding,0,length);
|
2016-04-16 13:13:33 +00:00
|
|
|
var arr="";
|
2017-11-18 00:51:08 +00:00
|
|
|
|
2017-07-23 14:04:46 +00:00
|
|
|
while (num > 0 and length > 0) {
|
|
|
|
var num0 = num;
|
2020-06-05 10:46:54 +00:00
|
|
|
num = int(num / BinaryAsciiTransfer._base);
|
2017-07-23 14:04:46 +00:00
|
|
|
rem = num0-(num*BinaryAsciiTransfer._base);
|
2016-04-16 13:13:33 +00:00
|
|
|
arr =substr(BinaryAsciiTransfer.alphabet, rem,1) ~ arr;
|
2017-07-23 14:04:46 +00:00
|
|
|
length -= 1;
|
2016-04-16 13:13:33 +00:00
|
|
|
}
|
2017-07-23 14:04:46 +00:00
|
|
|
if (length>0)
|
|
|
|
arr = substr(BinaryAsciiTransfer.spaces,0,length)~arr;
|
2016-04-16 13:13:33 +00:00
|
|
|
return arr;
|
2016-04-09 19:39:57 +00:00
|
|
|
},
|
2017-07-23 14:04:46 +00:00
|
|
|
retval : {value:0, pos:0},
|
2020-06-05 10:46:54 +00:00
|
|
|
decodeNumeric : func(str, length, factor, pos)
|
2016-04-09 19:39:57 +00:00
|
|
|
{
|
2020-06-05 10:46:54 +00:00
|
|
|
var irange = int(BinaryAsciiTransfer.po2[length]/factor);
|
2020-06-29 08:49:18 +00:00
|
|
|
var power = length-1;
|
2017-07-23 14:04:46 +00:00
|
|
|
BinaryAsciiTransfer.retval.value = 0;
|
|
|
|
BinaryAsciiTransfer.retval.pos = pos;
|
2017-11-18 00:51:08 +00:00
|
|
|
|
2017-07-23 14:04:46 +00:00
|
|
|
while (length > 0 and power > 0) {
|
|
|
|
var c = substr(str,BinaryAsciiTransfer.retval.pos,1);
|
|
|
|
if (c != " ") break;
|
|
|
|
power = power -1;
|
|
|
|
length = length-1;
|
|
|
|
BinaryAsciiTransfer.retval.pos = BinaryAsciiTransfer.retval.pos + 1;
|
|
|
|
}
|
|
|
|
while (length >= 0 and power >= 0) {
|
|
|
|
var c = substr(str,BinaryAsciiTransfer.retval.pos,1);
|
|
|
|
# spaces are used as padding so ignore them.
|
|
|
|
if (c != " ") {
|
|
|
|
var cc = find(c,BinaryAsciiTransfer.alphabet);
|
|
|
|
if (cc < 0)
|
|
|
|
{
|
2020-06-05 10:46:54 +00:00
|
|
|
print("Emesary: BinaryAsciiTransfer.decodeNumeric: Bad encoding ");
|
2017-07-23 14:04:46 +00:00
|
|
|
return BinaryAsciiTransfer.retval;
|
|
|
|
}
|
|
|
|
BinaryAsciiTransfer.retval.value += int(cc * math.exp(math.ln(BinaryAsciiTransfer._base) * power));
|
|
|
|
power = power - 1;
|
|
|
|
}
|
|
|
|
length = length-1;
|
|
|
|
BinaryAsciiTransfer.retval.pos = BinaryAsciiTransfer.retval.pos + 1;
|
2016-04-16 13:13:33 +00:00
|
|
|
}
|
2020-06-05 10:46:54 +00:00
|
|
|
BinaryAsciiTransfer.retval.value -= irange;
|
|
|
|
BinaryAsciiTransfer.retval.value = BinaryAsciiTransfer.retval.value * factor;
|
2017-07-23 14:04:46 +00:00
|
|
|
return BinaryAsciiTransfer.retval;
|
2020-06-05 10:46:54 +00:00
|
|
|
},
|
|
|
|
encodeInt : func(num,length){
|
|
|
|
return me.encodeNumeric(num, length, 1.0);
|
|
|
|
},
|
|
|
|
decodeInt : func(str, length, pos){
|
|
|
|
return me.decodeNumeric(str, length, 1.0, pos);
|
2016-04-09 19:39:57 +00:00
|
|
|
}
|
|
|
|
};
|
2016-04-16 13:13:33 +00:00
|
|
|
|
2016-04-12 21:25:11 +00:00
|
|
|
var TransferString =
|
|
|
|
{
|
2017-11-18 00:51:08 +00:00
|
|
|
MaxLength:16,
|
2016-04-12 21:25:11 +00:00
|
|
|
#
|
|
|
|
# just to pack a valid range and keep the lower and very upper control codes for seperators
|
|
|
|
# that way we don't need to do anything special to encode the string.
|
|
|
|
getalphanumericchar : func(v)
|
|
|
|
{
|
2017-11-18 00:51:08 +00:00
|
|
|
if (find(v,BinaryAsciiTransfer.alphabet) > 0)#"-./0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_abcdefghijklmnopqrstuvwxyz") > 0)
|
2016-04-12 21:25:11 +00:00
|
|
|
return v;
|
|
|
|
return nil;
|
|
|
|
},
|
|
|
|
encode : func(v)
|
|
|
|
{
|
2017-07-23 14:04:46 +00:00
|
|
|
if (v==nil)
|
|
|
|
return "0";
|
2016-04-12 21:25:11 +00:00
|
|
|
var l = size(v);
|
2017-11-18 00:51:08 +00:00
|
|
|
if (l > TransferString.MaxLength)
|
|
|
|
l = TransferString.MaxLength;
|
|
|
|
var rv = "";
|
|
|
|
var actual_len = 0;
|
2016-04-12 21:25:11 +00:00
|
|
|
for(var ii = 0; ii < l; ii = ii + 1)
|
|
|
|
{
|
|
|
|
ev = TransferString.getalphanumericchar(substr(v,ii,1));
|
2017-11-18 00:51:08 +00:00
|
|
|
if (ev != nil) {
|
2016-04-12 21:25:11 +00:00
|
|
|
rv = rv ~ ev;
|
2017-11-18 00:51:08 +00:00
|
|
|
actual_len = actual_len + 1;
|
|
|
|
}
|
2016-04-12 21:25:11 +00:00
|
|
|
}
|
2020-06-05 10:46:54 +00:00
|
|
|
|
|
|
|
rv = BinaryAsciiTransfer.encodeNumeric(l,1,1.0) ~ rv;
|
2016-04-12 21:25:11 +00:00
|
|
|
return rv;
|
|
|
|
},
|
2017-07-23 14:04:46 +00:00
|
|
|
decode : func(v,pos)
|
2016-04-12 21:25:11 +00:00
|
|
|
{
|
2020-06-05 10:46:54 +00:00
|
|
|
var dv = BinaryAsciiTransfer.decodeNumeric(v,1,1.0,pos);
|
2017-07-23 14:04:46 +00:00
|
|
|
var length = dv.value;
|
2020-06-05 10:46:54 +00:00
|
|
|
if (length == 0){
|
|
|
|
dv.value = "";
|
2017-11-18 00:51:08 +00:00
|
|
|
return dv;
|
2020-06-05 10:46:54 +00:00
|
|
|
}
|
2017-07-23 14:04:46 +00:00
|
|
|
var rv = substr(v,dv.pos,length);
|
|
|
|
dv.pos = dv.pos + length;
|
|
|
|
dv.value = rv;
|
|
|
|
return dv;
|
2016-04-12 21:25:11 +00:00
|
|
|
}
|
|
|
|
};
|
2016-04-09 19:39:57 +00:00
|
|
|
|
2017-07-23 14:04:46 +00:00
|
|
|
#
|
|
|
|
# encode an int into a specified number of characters.
|
|
|
|
var TransferInt =
|
2016-04-09 19:39:57 +00:00
|
|
|
{
|
2017-07-23 14:04:46 +00:00
|
|
|
encode : func(v, length)
|
2016-04-09 19:39:57 +00:00
|
|
|
{
|
2020-06-05 10:46:54 +00:00
|
|
|
return BinaryAsciiTransfer.encodeNumeric(v,length, 1.0);
|
2016-04-09 19:39:57 +00:00
|
|
|
},
|
2017-07-23 14:04:46 +00:00
|
|
|
decode : func(v, length, pos)
|
2016-04-09 19:39:57 +00:00
|
|
|
{
|
2020-06-05 10:46:54 +00:00
|
|
|
return BinaryAsciiTransfer.decodeNumeric(v,length, 1.0, pos);
|
2016-04-09 19:39:57 +00:00
|
|
|
}
|
|
|
|
};
|
|
|
|
|
2017-07-23 14:04:46 +00:00
|
|
|
var TransferFixedDouble =
|
|
|
|
{
|
|
|
|
encode : func(v, length, factor)
|
|
|
|
{
|
2020-06-05 10:46:54 +00:00
|
|
|
return BinaryAsciiTransfer.encodeNumeric(int(v), length, factor);
|
2017-07-23 14:04:46 +00:00
|
|
|
},
|
|
|
|
decode : func(v, length, factor, pos)
|
|
|
|
{
|
2020-06-05 10:46:54 +00:00
|
|
|
return BinaryAsciiTransfer.decodeNumeric(v, length, pos, factor);
|
2017-07-23 14:04:46 +00:00
|
|
|
}
|
|
|
|
};
|
|
|
|
|
|
|
|
var TransferNorm =
|
|
|
|
{
|
|
|
|
powers: [1,10.0, 100.0, 1000.0, 10000.0, 100000.0, 1000000.0, 10000000.0, 100000000.0, 1000000000.0, 10000000000.0, 100000000000.0],
|
|
|
|
|
|
|
|
encode : func(v, length)
|
|
|
|
{
|
2020-06-05 10:46:54 +00:00
|
|
|
return BinaryAsciiTransfer.encodeNumeric(int(v * BinaryAsciiTransfer.po2[length]),length, 1.0);
|
2017-07-23 14:04:46 +00:00
|
|
|
},
|
|
|
|
decode : func(v, length, pos)
|
|
|
|
{
|
2020-06-05 10:46:54 +00:00
|
|
|
dv = BinaryAsciiTransfer.decodeNumeric(v, length, 1.0, pos);
|
|
|
|
dv.value = (dv.value/BinaryAsciiTransfer.po2[length]);
|
2017-07-23 14:04:46 +00:00
|
|
|
return dv;
|
|
|
|
}
|
|
|
|
};
|
|
|
|
|
|
|
|
var TransferByte =
|
2016-04-09 19:39:57 +00:00
|
|
|
{
|
|
|
|
encode : func(v)
|
|
|
|
{
|
2020-06-05 10:46:54 +00:00
|
|
|
return BinaryAsciiTransfer.encodeNumeric(v,1, 1.0);
|
2016-04-09 19:39:57 +00:00
|
|
|
},
|
2017-07-23 14:04:46 +00:00
|
|
|
decode : func(v, pos)
|
2016-04-09 19:39:57 +00:00
|
|
|
{
|
2020-06-05 10:46:54 +00:00
|
|
|
return BinaryAsciiTransfer.decodeNumeric(v, 1, 1.0, pos);
|
2016-04-09 19:39:57 +00:00
|
|
|
}
|
|
|
|
};
|
|
|
|
|
2017-07-23 14:04:46 +00:00
|
|
|
var TransferCoord =
|
2016-04-09 19:39:57 +00:00
|
|
|
{
|
2017-07-23 14:04:46 +00:00
|
|
|
# 28 bits = 268435456 (268 435 456)
|
|
|
|
# to transfer lat lon (360 degree range) 268435456/360=745654
|
|
|
|
# we could use different factors for lat lon due to the differing range, however
|
|
|
|
# this will be fine.
|
|
|
|
# 1 degree = 110574 meters;
|
|
|
|
encode : func(v)
|
2016-04-09 19:39:57 +00:00
|
|
|
{
|
2020-06-05 10:46:54 +00:00
|
|
|
return BinaryAsciiTransfer.encodeNumeric((v.lat()+90)*745654,5, 1.0)
|
|
|
|
~ BinaryAsciiTransfer.encodeNumeric((v.lon()+180)*745654,5, 1.0)
|
|
|
|
~ TransferNumeric.encode(v.alt(), 3, 1.0);
|
2016-04-09 19:39:57 +00:00
|
|
|
},
|
2017-07-23 14:04:46 +00:00
|
|
|
decode : func(v,pos)
|
2016-04-09 19:39:57 +00:00
|
|
|
{
|
2020-06-05 10:46:54 +00:00
|
|
|
var dv = BinaryAsciiTransfer.decodeNumeric(v,5, 1.0 ,pos);
|
2017-07-23 14:04:46 +00:00
|
|
|
var lat = (dv.value / 745654)-90;
|
2020-06-05 10:46:54 +00:00
|
|
|
dv = BinaryAsciiTransfer.decodeNumeric(v,5, 1.0 ,dv.pos);
|
2017-07-23 14:04:46 +00:00
|
|
|
var lon = (dv.value / 745654)-180;
|
2020-06-05 10:46:54 +00:00
|
|
|
dv = TransferNumeric.decode(v, 3, 1.0 ,dv.pos);
|
2017-07-23 14:04:46 +00:00
|
|
|
var alt =dv.value;
|
|
|
|
|
|
|
|
dv.value = geo.Coord.new().set_latlon(lat, lon).set_alt(alt);
|
|
|
|
return dv;
|
2016-04-09 19:39:57 +00:00
|
|
|
}
|
|
|
|
};
|
2020-06-29 08:49:18 +00:00
|
|
|
|
|
|
|
# genericEmesaryGlobalTransmitterTransmit allowes to use the emesary.GlobalTransmitter via fgcommand
|
|
|
|
# which in turn allows using it in XML bindings, e.g.
|
|
|
|
# <binding>
|
|
|
|
# <command>emesary-transmit</command>
|
|
|
|
# <type>cockpit-switch</type>
|
|
|
|
# <ident>eicas-page-select</ident>
|
|
|
|
# <page>hydraulic</page>
|
|
|
|
# </binding>
|
|
|
|
#
|
|
|
|
var genericEmesaryGlobalTransmitterTransmit = func(node)
|
|
|
|
{
|
|
|
|
var transmitter = emesary.GlobalTransmitter;
|
|
|
|
var t = node.getNode("transmitter",1).getValue();
|
|
|
|
if (t != nil) {
|
|
|
|
transmitter = emesary.getTransmitter(t);
|
|
|
|
if (transmitter == nil) {
|
|
|
|
logprint(LOG_WARN, "Invalid transmitter "~t);
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
var type = node.getNode("type").getValue();
|
|
|
|
if (type == nil) {
|
|
|
|
logprint(LOG_WARN, "emesary-transmit requires a type");
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
var ident = node.getNode("ident").getValue();
|
|
|
|
if (ident == nil) {
|
|
|
|
logprint(LOG_WARN, "emesary-transmit requires an ident");
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
var typeid = node.getNode("typeid",1).getValue() or 0;
|
|
|
|
if (typeid == 0) {
|
|
|
|
typeid = TypeIdUnspecified;
|
|
|
|
logprint(LOG_WARN, "emesary-transmit using generic typeid ", typeid);
|
|
|
|
}
|
|
|
|
|
|
|
|
var message = emesary.Notification.new(type, ident, typeid);
|
|
|
|
node.removeChild("type");
|
|
|
|
node.removeChild("id");
|
|
|
|
node.removeChild("typeid");
|
|
|
|
|
|
|
|
# add remaining nodes to the message hash
|
|
|
|
var children = node.getValues();
|
|
|
|
if (children != nil) {
|
|
|
|
foreach (var key; keys(children)) {
|
|
|
|
message[key] = children[key];
|
|
|
|
}
|
|
|
|
}
|
|
|
|
transmitter.NotifyAll(message);
|
|
|
|
};
|
|
|
|
|
|
|
|
removecommand("emesary-transmit"); #in case of reload
|
|
|
|
addcommand("emesary-transmit", genericEmesaryGlobalTransmitterTransmit);
|
|
|
|
|
2017-07-23 14:04:46 +00:00
|
|
|
#setprop("/sim/startup/terminal-ansi-colors",0);
|
|
|
|
#for(i=-1;i<=1;i+=0.1)
|
|
|
|
#print ("i ",i, " --> ", (TransferNorm.decode(TransferNorm.encode(i,2), 2,0)).value);
|
|
|
|
#debug.dump(TransferNorm.decode(TransferNorm.encode(-1,2), 2,0));
|
|
|
|
#debug.dump(TransferNorm.decode(TransferNorm.encode(0,2), 2,0));
|
2020-06-05 10:46:54 +00:00
|
|
|
#debug.dump(TransferNorm.decode(TransferNorm.encode(1,2), 2,0));
|