1

#!/usr/bin/env python

     2

# -*- coding: utf-8 -*-

     3

     4

import string, os, sys

     5

     6

#This file is part of PLCOpenEditor, a library implementing an IEC 61131-3 editor

     7

#based on the plcopen standard. 

     8

#

     9

#Copyright (C): Edouard TISSERANT and Laurent BESSARD

    10

#

    11

#See COPYING file for copyrights details.

    12

#

    13

#This library is free software; you can redistribute it and/or

    14

#modify it under the terms of the GNU General Public

    15

#License as published by the Free Software Foundation; either

    16

#version 2.1 of the License, or (at your option) any later version.

    17

#

    18

#This library is distributed in the hope that it will be useful,

    19

#but WITHOUT ANY WARRANTY; without even the implied warranty of

    20

#MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU

    21

#Lesser General Public License for more details.

    22

#

    23

#You should have received a copy of the GNU General Public

    24

#License along with this library; if not, write to the Free Software

    25

#Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

    26

    27

    28

LANGUAGES = ["IL","ST","FBD","LD","SFC"]

    29

    30

    31

#-------------------------------------------------------------------------------

    32

#                        Function Block Types definitions

    33

#-------------------------------------------------------------------------------

    34

    35

    36

"""

    37

Ordored list of common Function Blocks defined in the IEC 61131-3

    38

Each block have this attributes:

    39

    - "name" : The block name

    40

    - "type" : The block type. It can be "function", "functionBlock" or "program"

    41

    - "extensible" : Boolean that define if the block is extensible

    42

    - "inputs" : List of the block inputs

    43

    - "outputs" : List of the block outputs

    44

    - "comment" : Comment that will be displayed in the block popup

    45

Inputs and outputs are a tuple of characteristics that are in order:

    46

    - The name

    47

    - The data type

    48

    - The default modifier which can be "none", "negated", "rising" or "falling"

    49

"""

    50

    51

BlockTypes = [{"name" : "Standard function blocks", "list":

    52

               [{"name" : "SR", "type" : "functionBlock", "extensible" : False, 

    53

                    "inputs" : [("S1","BOOL","none"),("R","BOOL","none")], 

    54

                    "outputs" : [("Q1","BOOL","none")],

    55

                    "comment" : "SR bistable\nThe SR bistable is a latch where the Set dominates."},

    56

                {"name" : "RS", "type" : "functionBlock", "extensible" : False, 

    57

                    "inputs" : [("S","BOOL","none"),("R1","BOOL","none")], 

    58

                    "outputs" : [("Q1","BOOL","none")],

    59

                    "comment" : "RS bistable\nThe RS bistable is a latch where the Reset dominates."},

    60

                {"name" : "SEMA", "type" : "functionBlock", "extensible" : False, 

    61

                    "inputs" : [("CLAIM","BOOL","none"),("RELEASE","BOOL","none")], 

    62

                    "outputs" : [("BUSY","BOOL","none")],

    63

                    "comment" : "Semaphore\nThe semaphore provides a mechanism to allow software elements mutually exclusive access to certain ressources."},

    64

                {"name" : "R_TRIG", "type" : "functionBlock", "extensible" : False, 

    65

                    "inputs" : [("CLK","BOOL","none")], 

    66

                    "outputs" : [("Q","BOOL","none")],

    67

                    "comment" : "Rising edge detector\nThe output produces a single pulse when a rising edge is detected."},

    68

                {"name" : "F_TRIG", "type" : "functionBlock", "extensible" : False, 

    69

                    "inputs" : [("CLK","BOOL","none")], 

    70

                    "outputs" : [("Q","BOOL","none")],

    71

                    "comment" : "Falling edge detector\nThe output produces a single pulse when a falling edge is detected."},

    72

                {"name" : "CTU", "type" : "functionBlock", "extensible" : False, 

    73

                    "inputs" : [("CU","BOOL","rising"),("R","BOOL","none"),("PV","INT","none")], 

    74

                    "outputs" : [("Q","BOOL","none"),("CV","INT","none")],

    75

                    "comment" : "Up-counter\nThe up-counter can be used to signal when a count has reached a maximum value."},

    76

                {"name" : "CTD", "type" : "functionBlock", "extensible" : False, 

    77

                    "inputs" : [("CD","BOOL","rising"),("LD","BOOL","none"),("PV","INT","none")], 

    78

                    "outputs" : [("Q","BOOL","none"),("CV","INT","none")],

    79

                    "comment" : "Down-counter\nThe down-counter can be used to signal when a count has reached zero, on counting down from a preset value."},

    80

                {"name" : "CTUD", "type" : "functionBlock", "extensible" : False, 

    81

                    "inputs" : [("CU","BOOL","rising"),("CD","BOOL","rising"),("R","BOOL","none"),("LD","BOOL","none"),("PV","INT","none")], 

    82

                    "outputs" : [("QU","BOOL","none"),("QD","BOOL","none"),("CV","INT","none")],

    83

                    "comment" : "Up-down counter\nThe up-down counter has two inputs CU and CD. It can be used to both count up on one input ans down on the other."},

    84

                {"name" : "TP", "type" : "functionBlock", "extensible" : False, 

    85

                    "inputs" : [("IN","BOOL","none"),("PT","TIME","none")], 

    86

                    "outputs" : [("Q","BOOL","none"),("ET","TIME","none")],

    87

                    "comment" : "Pulse timer\nThe pulse timer can be used to generate output pulses of a given time duration."},

    88

                {"name" : "TOF", "type" : "functionBlock", "extensible" : False, 

    89

                    "inputs" : [("IN","BOOL","none"),("PT","TIME","none")], 

    90

                    "outputs" : [("Q","BOOL","none"),("ET","TIME","none")],

    91

                    "comment" : "On-delay timer\nThe on-delay timer can be used to delay setting an output true, for fixed period after an input becomes true."},

    92

                {"name" : "TON", "type" : "functionBlock", "extensible" : False, 

    93

                    "inputs" : [("IN","BOOL","none"),("PT","TIME","none")], 

    94

                    "outputs" : [("Q","BOOL","none"),("ET","TIME","none")],

    95

                    "comment" : "Off-delay timer\nThe off-delay timer can be used to delay setting an output false, for fixed period after input goes false."},

    96

                {"name" : "RTC", "type" : "functionBlock", "extensible" : False, 

    97

                    "inputs" : [("EN","BOOL","none"),("PDT","DATE_AND_TIME","none")], 

    98

                    "outputs" : [("Q","BOOL","none"),("CDT","DATE_AND_TIME","none")],

    99

                    "comment" : "Real time clock\nThe real time clock has many uses including time stamping, setting dates and times of day in batch reports, in alarm messages and so on."},

   100

                {"name" : "INTEGRAL", "type" : "functionBlock", "extensible" : False, 

   101

                    "inputs" : [("RUN","BOOL","none"),("R1","BOOL","none"),("XIN","REAL","none"),("X0","REAL","none"),("CYCLE","TIME","none")], 

   102

                    "outputs" : [("Q","BOOL","none"),("XOUT","REAL","none")],

   103

                    "comment" : "Integral\nThe integral function block integrates the value of input XIN over time."},

   104

                {"name" : "DERIVATIVE", "type" : "functionBlock", "extensible" : False, 

   105

                    "inputs" : [("RUN","BOOL","none"),("XIN","REAL","none"),("CYCLE","TIME","none")], 

   106

                    "outputs" : [("XOUT","REAL","none")],

   107

                    "comment" : "Derivative\nThe derivative function block produces an output XOUT proportional to the rate of change of the input XIN."},

   108

                {"name" : "PID", "type" : "functionBlock", "extensible" : False, 

   109

                    "inputs" : [("AUTO","BOOL","none"),("PV","REAL","none"),("SP","REAL","none"),("X0","REAL","none"),("KP","REAL","none"),("TR","REAL","none"),("TD","REAL","none"),("CYCLE","TIME","none")], 

   110

                    "outputs" : [("XOUT","REAL","none")],

   111

                    "comment" : "PID\nThe PID (proportional, Integral, Derivative) function block provides the classical three term controller for closed loop control."},

   112

                {"name" : "RAMP", "type" : "functionBlock", "extensible" : False, 

   113

                    "inputs" : [("RUN","BOOL","none"),("X0","REAL","none"),("X1","REAL","none"),("TR","TIME","none"),("CYCLE","TIME","none"),("HOLDBACK","BOOL","none"),("ERROR","REAL","none"),("PV","REAL","none")], 

   114

                    "outputs" : [("RAMP","BOOL","none"),("XOUT","REAL","none")],

   115

                    "comment" : "Ramp\nThe RAMP function block is modelled on example given in the standard but with the addition of a 'Holdback' feature."},

   116

                {"name" : "HYSTERESIS", "type" : "functionBlock", "extensible" : False, 

   117

                    "inputs" : [("XIN1","REAL","none"),("XIN2","REAL","none"),("EPS","REAL","none")], 

   118

                    "outputs" : [("Q","BOOL","none")],

   119

                    "comment" : "Hysteresis\nThe hysteresis function block provides a hysteresis boolean output driven by the difference of two floating point (REAL) inputs XIN1 and XIN2."},

   120

                {"name" : "RATIO_MONITOR", "type" : "functionBlock", "extensible" : False, 

   121

                    "inputs" : [("PV1","REAL","none"),("PV2","REAL","none"),("RATIO","REAL","none"),("TIMON","TIME","none"),("TIMOFF","TIME","none"),("TOLERANCE","BOOL","none"),("RESET","BOOL","none"),("CYCLE","TIME","none")], 

   122

                    "outputs" : [("ALARM","BOOL","none"),("TOTAL_ERR","BOOL","none")],

   123

                    "comment" : "Ratio monitor\nThe ratio_monitor function block checks that one process value PV1 is always a given ratio (defined by input RATIO) of a second process value PV2."},

   124

               ]}

   125

             ]

   126

   127

"""

   128

Function that returns the block definition associated to the block type given

   129

"""

   130

   131

def GetBlockType(type, inputs = None):

   132

    for category in BlockTypes:

   133

        for blocktype in category["list"]:

   134

            if inputs:

   135

                block_inputs = tuple([var_type for name, var_type, modifier in blocktype["inputs"]])

   136

                same_inputs = inputs == block_inputs

   137

            else:

   138

                same_inputs = True

   139

            if blocktype["name"] == type and same_inputs:

   140

                return blocktype

   141

    return None

   142

   143

   144

#-------------------------------------------------------------------------------

   145

#                           Data Types definitions

   146

#-------------------------------------------------------------------------------

   147

   148

"""

   149

Ordored list of common data types defined in the IEC 61131-3

   150

Each type is associated to his direct parent type. It defines then a hierarchy

   151

between type that permits to make a comparison of two types

   152

"""

   153

TypeHierarchy_list = [

   154

    ("ANY", None),

   155

    ("ANY_DERIVED", "ANY"),

   156

    ("ANY_ELEMENTARY", "ANY"),

   157

    ("ANY_MAGNITUDE", "ANY_ELEMENTARY"),

   158

    ("ANY_BIT", "ANY_ELEMENTARY"),

   159

    ("ANY_NBIT", "ANY_BIT"),

   160

    ("ANY_STRING", "ANY_ELEMENTARY"),

   161

    ("ANY_DATE", "ANY_ELEMENTARY"),

   162

    ("ANY_NUM", "ANY_MAGNITUDE"),

   163

    ("ANY_REAL", "ANY_NUM"),

   164

    ("ANY_INT", "ANY_NUM"),

   165

    ("ANY_SINT", "ANY_INT"),

   166

    ("ANY_UINT", "ANY_INT"),

   167

	("BOOL", "ANY_BIT"),

   168

    ("SINT", "ANY_SINT"),

   169

    ("INT", "ANY_SINT"),

   170

    ("DINT", "ANY_SINT"),

   171

    ("LINT", "ANY_SINT"),

   172

    ("USINT", "ANY_UINT"),

   173

    ("UINT", "ANY_UINT"),

   174

    ("UDINT", "ANY_UINT"),

   175

    ("ULINT", "ANY_UINT"),

   176

    ("REAL", "ANY_REAL"),

   177

    ("LREAL", "ANY_REAL"),

   178

    ("TIME", "ANY_MAGNITUDE"),

   179

    ("DATE", "ANY_DATE"),

   180

    ("TOD", "ANY_DATE"),

   181

    ("DT", "ANY_DATE"),

   182

    ("STRING", "ANY_STRING"),

   183

    ("BYTE", "ANY_NBIT"),

   184

    ("WORD", "ANY_NBIT"),

   185

    ("DWORD", "ANY_NBIT"),

   186

    ("LWORD", "ANY_NBIT")

   187

    #("WSTRING", "ANY_STRING") # TODO

   188

]

   189

   190

TypeHierarchy = dict(TypeHierarchy_list)

   191

   192

"""

   193

returns true if the given data type is the same that "reference" meta-type or one of its types.

   194

"""

   195

   196

def IsOfType(test, reference):

   197

    while test != None:

   198

        if test == reference:

   199

            return True

   200

        test = TypeHierarchy[test]

   201

    return False

   202

   203

"""

   204

returns list of all types that correspont to the ANY* meta type

   205

"""

   206

def GetSubTypes(reference):

   207

    return [ typename for typename, parenttype in TypeHierarchy_list if typename[:3] != "ANY" and IsOfType(typename, reference)]

   208

   209

   210

#-------------------------------------------------------------------------------

   211

#                             Test identifier

   212

#-------------------------------------------------------------------------------

   213

   214

   215

   216

# Test if identifier is valid

   217

def TestIdentifier(identifier):

   218

     if identifier[0].isdigit():

   219

        return False

   220

     words = identifier.split('_')

   221

     for i, word in enumerate(words):

   222

         if len(word) == 0 and i != 0:

   223

             return False

   224

         if len(word) != 0 and not word.isalnum():

   225

             return False

   226

     return True

   227

   228

   229

#-------------------------------------------------------------------------------

   230

#                            Languages Keywords

   231

#-------------------------------------------------------------------------------

   232

   233

   234

# Keywords for Pou Declaration

   235

POU_KEYWORDS = ["FUNCTION", "END_FUNCTION", "FUNCTION_BLOCK", "END_FUNCTION_BLOCK",

   236

 "PROGRAM", "END_PROGRAM", "EN", "ENO", "F_EDGE", "R_EDGE"]

   237

for category in BlockTypes:

   238

    for block in category["list"]:

   239

        if block["name"] not in POU_KEYWORDS:

   240

            POU_KEYWORDS.append(block["name"])

   241

   242

   243

# Keywords for Type Declaration

   244

TYPE_KEYWORDS = ["TYPE", "END_TYPE", "STRUCT", "END_STRUCT", "ARRAY", "OF", "T",

   245

 "D", "TIME_OF_DAY", "DATE_AND_TIME"]

   246

TYPE_KEYWORDS.extend([keyword for keyword in TypeHierarchy.keys() if keyword not in TYPE_KEYWORDS])

   247

   248

   249

# Keywords for Variable Declaration

   250

VAR_KEYWORDS = ["VAR", "VAR_INPUT", "VAR_OUTPUT", "VAR_IN_OUT", "VAR_TEMP", 

   251

 "VAR_EXTERNAL", "END_VAR", "AT", "CONSTANT", "RETAIN", "NON_RETAIN"]

   252

   253

   254

# Keywords for Configuration Declaration

   255

CONFIG_KEYWORDS = ["CONFIGURATION", "END_CONFIGURATION", "RESOURCE", "ON", "END_RESOURCE",

   256

 "PROGRAM", "WITH", "READ_ONLY", "READ_WRITE", "TASK", "VAR_ACCESS", "VAR_CONFIG", 

   257

 "VAR_GLOBAL", "END_VAR"]

   258

   259

   260

# Keywords for Structured Function Chart

   261

SFC_KEYWORDS = ["ACTION", "END_ACTION", "INITIAL_STEP", "STEP", "END_STEP", "TRANSITION",

   262

 "FROM", "TO", "END_TRANSITION"]

   263

   264

   265

# Keywords for Instruction List

   266

IL_KEYWORDS = ["LD", "LDN", "ST", "STN", "S", "R", "AND", "ANDN", "OR", "ORN",

   267

 "XOR", "XORN", "NOT", "ADD", "SUB", "MUL", "DIV", "MOD", "GT", "GE", "EQ", "NE",

   268

 "LE", "LT", "JMP", "JMPC", "JMPNC", "CAL", "CALC", "CALNC", "RET", "RETC", "RETNC"]

   269

   270

   271

# Keywords for Instruction List and Structured Text

   272

ST_KEYWORDS = ["IF", "THEN", "ELSIF", "ELSE", "END_IF", "CASE", "OF", "END_CASE", 

   273

 "FOR", "TO", "BY", "DO", "END_FOR", "WHILE", "DO", "END_WHILE", "REPEAT", "UNTIL", 

   274

 "END_REPEAT", "EXIT", "RETURN", "NOT", "MOD", "AND", "XOR", "OR"]

   275

   276

   277

# All the keywords of IEC

   278

IEC_KEYWORDS = ["E", "TRUE", "FALSE"]

   279

IEC_KEYWORDS.extend([keyword for keyword in POU_KEYWORDS if keyword not in IEC_KEYWORDS])

   280

IEC_KEYWORDS.extend([keyword for keyword in TYPE_KEYWORDS if keyword not in IEC_KEYWORDS])

   281

IEC_KEYWORDS.extend([keyword for keyword in VAR_KEYWORDS if keyword not in IEC_KEYWORDS])

   282

IEC_KEYWORDS.extend([keyword for keyword in CONFIG_KEYWORDS if keyword not in IEC_KEYWORDS])

   283

IEC_KEYWORDS.extend([keyword for keyword in SFC_KEYWORDS if keyword not in IEC_KEYWORDS])

   284

IEC_KEYWORDS.extend([keyword for keyword in IL_KEYWORDS if keyword not in IEC_KEYWORDS])

   285

IEC_KEYWORDS.extend([keyword for keyword in ST_KEYWORDS if keyword not in IEC_KEYWORDS])

   286

   287

   288

   289

"""

   290

take a .csv file and translate it it a "csv_table"

   291

"""            

   292

def csv_file_to_table(file):

   293

    return [ map(string.strip,line.split(';')) for line in file.xreadlines()]

   294

   295

"""

   296

seek into the csv table to a section ( section_name match 1st field )

   297

return the matching row without first field

   298

"""

   299

def find_section(section_name, table):

   300

    fields = [None]

   301

    while(fields[0] != section_name):

   302

        fields = table.pop(0)

   303

    return fields[1:]

   304

   305

"""

   306

extract the standard functions standard parameter names and types...

   307

return a { ParameterName: Type, ...}

   308

"""

   309

def get_standard_funtions_input_variables(table):

   310

    variables = find_section("Standard_functions_variables_types", table)

   311

    standard_funtions_input_variables = {}

   312

    fields = [True,True]

   313

    while(fields[1]):

   314

        fields = table.pop(0)

   315

        variable_from_csv = dict([(champ, val) for champ, val in zip(variables, fields[1:]) if champ!=''])

   316

        standard_funtions_input_variables[variable_from_csv['name']] = variable_from_csv['type']

   317

    return standard_funtions_input_variables

   318

   319

"""

   320

translate .csv file input declaration into PLCOpenEditor interessting values

   321

in : "(ANY_NUM, ANY_NUM)" and { ParameterName: Type, ...}

   322

return [("IN1","ANY_NUM","none"),("IN2","ANY_NUM","none")] 

   323

"""

   324

def csv_input_translate(str_decl, variables, base):

   325

    decl = str_decl.replace('(','').replace(')','').replace(' ','').split(',')

   326

    params = []

   327

   328

    len_of_not_predifined_variable = len([True for param_type in decl if param_type not in variables])

   329

   330

    for param_type in decl:

   331

        if param_type in variables.keys():

   332

            param_name = param_type

   333

            param_type = variables[param_type]

   334

        elif len_of_not_predifined_variable > 1:

   335

            param_name = "IN%d"%base

   336

            base += 1

   337

        else:

   338

            param_name = "IN"

   339

        params.append((param_name, param_type, "none"))

   340

    return params

   341

   342

   343

ANY_TO_ANY_LIST=[

   344

        # simple type conv are let as C cast

   345

        (("ANY_NUM","ANY_BIT"),("ANY_NUM","ANY_BIT"), "(%(return_type)s)%(IN_value)s"),

   346

        # TO_TIME

   347

        (("ANY_INT","ANY_BIT"),("ANY_DATE","TIME"), "(%(return_type)s)__int_to_time(%(IN_value)s)"),

   348

        (("ANY_REAL",),("ANY_DATE","TIME"), "(%(return_type)s)__real_to_time(%(IN_value)s)"),

   349

        (("ANY_STRING",), ("ANY_DATE","TIME"), "(%(return_type)s)__string_to_time(%(IN_value)s)"),

   350

        # FROM_TIME

   351

        (("ANY_DATE","TIME"), ("ANY_REAL",), "(%(return_type)s)__time_to_real(%(IN_value)s)"),

   352

        (("ANY_DATE","TIME"), ("ANY_INT","ANY_BIT"), "(%(return_type)s)__time_to_int(%(IN_value)s)"),

   353

        (("TIME",), ("ANY_STRING",), "(%(return_type)s)__time_to_string(%(IN_value)s)"),

   354

        (("DATE",), ("ANY_STRING",), "(%(return_type)s)__date_to_string(%(IN_value)s)"),

   355

        (("TOD",), ("ANY_STRING",), "(%(return_type)s)__tod_to_string(%(IN_value)s)"),

   356

        (("DT",), ("ANY_STRING",), "(%(return_type)s)__dt_to_string(%(IN_value)s)"),

   357

        # TO_STRING

   358

        (("BOOL",), ("ANY_STRING",), "(%(return_type)s)__bool_to_string(%(IN_value)s)"),

   359

        (("ANY_BIT",), ("ANY_STRING",), "(%(return_type)s)__bit_to_string(%(IN_value)s)"),

   360

        (("ANY_REAL",), ("ANY_STRING",), "(%(return_type)s)__real_to_string(%(IN_value)s)"),

   361

        (("ANY_SINT",), ("ANY_STRING",), "(%(return_type)s)__sint_to_string(%(IN_value)s)"),

   362

        (("ANY_UINT",), ("ANY_STRING",), "(%(return_type)s)__uint_to_string(%(IN_value)s)"),

   363

        # FROM_STRING

   364

        (("ANY_STRING",), ("BOOL",), "(%(return_type)s)__string_to_bool(%(IN_value)s)"),

   365

        (("ANY_STRING",), ("ANY_BIT",), "(%(return_type)s)__string_to_bit(%(IN_value)s)"),

   366

        (("ANY_STRING",), ("ANY_SINT",), "(%(return_type)s)__string_to_sint(%(IN_value)s)"),

   367

        (("ANY_STRING",), ("ANY_UINT",), "(%(return_type)s)__string_to_uint(%(IN_value)s)"),

   368

        (("ANY_STRING",), ("ANY_REAL",), "(%(return_type)s)__string_to_real(%(IN_value)s)")]

   369

   370

   371

BCD_TO_ANY_LIST=[

   372

        (("BYTE",),("USINT",), "(%(return_type)s)__bcd_to_uint(%(IN_value)s)"),

   373

        (("WORD",),("UINT",), "(%(return_type)s)__bcd_to_uint(%(IN_value)s)"),

   374

        (("DWORD",),("UDINT",), "(%(return_type)s)__bcd_to_uint(%(IN_value)s)"),

   375

        (("LWORD",),("ULINT",), "(%(return_type)s)__bcd_to_uint(%(IN_value)s)")]

   376

   377

   378

ANY_TO_BCD_LIST=[

   379

        (("USINT",),("BYTE",), "(%(return_type)s)__uint_to_bcd(%(IN_value)s)"),

   380

        (("UINT",),("WORD",), "(%(return_type)s)__uint_to_bcd(%(IN_value)s)"),

   381

        (("UDINT",),("DWORD",), "(%(return_type)s)__uint_to_bcd(%(IN_value)s)"),

   382

        (("ULINT",),("LWORD",), "(%(return_type)s)__uint_to_bcd(%(IN_value)s)")]

   383

   384

   385

def ANY_TO_ANY_FORMAT_GEN(any_to_any_list, fdecl):

   386

   387

    for (InTypes, OutTypes, Format) in any_to_any_list:

   388

        outs = reduce(lambda a,b: a or b, map(lambda testtype : IsOfType(fdecl["outputs"][0][1],testtype), OutTypes))

   389

        inps = reduce(lambda a,b: a or b, map(lambda testtype : IsOfType(fdecl["inputs"][0][1],testtype), InTypes))

   390

        if inps and outs and fdecl["outputs"][0][1] != fdecl["inputs"][0][1]:

   391

             return Format

   392

   393

    return None

   394

   395

   396

"""

   397

Returns this kind of declaration for all standard functions

   398

   399

            [{"name" : "Numerical", 'list': [   {   

   400

                'baseinputnumber': 1,

   401

                'comment': 'Addition',

   402

                'extensible': True,

   403

                'inputs': [   ('IN1', 'ANY_NUM', 'none'),

   404

                              ('IN2', 'ANY_NUM', 'none')],

   405

                'name': 'ADD',

   406

                'outputs': [('OUT', 'ANY_NUM', 'none')],

   407

                'type': 'function'}, ...... ] },.....]

   408

"""

   409

def get_standard_funtions(table):

   410

   411

    variables = get_standard_funtions_input_variables(table)

   412

   413

    fonctions = find_section("Standard_functions_type",table)

   414

   415

    Standard_Functions_Decl = []

   416

    Current_section = None

   417

   418

    translate = {

   419

            "extensible" : lambda x: {"yes":True, "no":False}[x],

   420

            "inputs" : lambda x:csv_input_translate(x,variables,baseinputnumber),

   421

            "outputs":lambda x:[("OUT",x,"none")]}

   422

   423

    for fields in table:

   424

        if fields[1]:

   425

            # If function section name given

   426

            if fields[0]:

   427

                Current_section = {"name" : fields[0], "list" : []}

   428

                Standard_Functions_Decl.append(Current_section)

   429

                Function_decl_list = []

   430

            if Current_section:

   431

                Function_decl = dict([(champ, val) for champ, val in zip(fonctions, fields[1:]) if champ])

   432

                baseinputnumber = int(Function_decl.get("baseinputnumber",1))

   433

                Function_decl["baseinputnumber"] = baseinputnumber

   434

                for param, value in Function_decl.iteritems():

   435

                    if param in translate:

   436

                        Function_decl[param] = translate[param](value)

   437

                Function_decl["type"] = "function"

   438

   439

                if Function_decl["name"].startswith('*') or Function_decl["name"].endswith('*') :

   440

                    input_ovrloading_types = GetSubTypes(Function_decl["inputs"][0][1])

   441

                    output_types = GetSubTypes(Function_decl["outputs"][0][1])

   442

                else:

   443

                    input_ovrloading_types = [None]

   444

                    output_types = [None]

   445

   446

                funcdeclname_orig = Function_decl["name"]

   447

                funcdeclname = Function_decl["name"].strip('*_')

   448

                fdc = Function_decl["inputs"][:]

   449

                for intype in input_ovrloading_types:

   450

                    if intype != None:

   451

                        Function_decl["inputs"] = []

   452

                        for decl_tpl in fdc:

   453

                            if IsOfType(intype, decl_tpl[1]):

   454

                                Function_decl["inputs"] += [(decl_tpl[0], intype, decl_tpl[2])]

   455

                            else:

   456

                                Function_decl["inputs"] += [(decl_tpl)]

   457

   458

                            if funcdeclname_orig.startswith('*'):

   459

                                funcdeclin = intype + '_' + funcdeclname 

   460

                            else:

   461

                                funcdeclin = funcdeclname

   462

                    else:

   463

                        funcdeclin = funcdeclname

   464

   465

                    for outype in output_types:

   466

                        if outype != None:

   467

                            decl_tpl = Function_decl["outputs"][0]

   468

                            Function_decl["outputs"] = [ (decl_tpl[0] , outype,  decl_tpl[2])]

   469

                            if funcdeclname_orig.endswith('*'):

   470

                                funcdeclout =  funcdeclin + '_' + outype

   471

                            else:

   472

                                funcdeclout =  funcdeclin

   473

                        else:

   474

                            funcdeclout =  funcdeclin

   475

                        Function_decl["name"] = funcdeclout

   476

   477

   478

                        fdecl = Function_decl

   479

                        res = eval(Function_decl["python_eval_c_code_format"])

   480

   481

                        if res != None :

   482

                            # create the copy of decl dict to be appended to section

   483

                            Function_decl_copy = Function_decl.copy()

   484

                            # Have to generate type description in comment with freshly redefined types

   485

                            Function_decl_copy["comment"] += (

   486

                                "\n (" +

   487

                                str([ " " + fctdecl[1]+":"+fctdecl[0] for fctdecl in Function_decl["inputs"]]).strip("[]").replace("'",'') +

   488

                                " ) => (" +

   489

                                str([ " " + fctdecl[1]+":"+fctdecl[0] for fctdecl in Function_decl["outputs"]]).strip("[]").replace("'",'') +

   490

                                " )")

   491

                            Current_section["list"].append(Function_decl_copy)

   492

                            #pp.pprint(Function_decl_copy)

   493

            else:

   494

                raise "First function must be in a category"

   495

   496

    return Standard_Functions_Decl

   497

   498

std_decl = get_standard_funtions(csv_file_to_table(open(os.path.join(os.path.split(__file__)[0],"iec_std.csv"))))#, True)

   499

   500

BlockTypes.extend(std_decl)

   501