1

/*

     2

 *  matiec - a compiler for the programming languages defined in IEC 61131-3

     3

 *

     4

 *  Copyright (C) 2009-2012  Mario de Sousa (msousa@fe.up.pt)

     5

 *  Copyright (C) 2012       Manuele Conti (conti.ma@alice.it)

     6

 *

     7

 *  This program is free software: you can redistribute it and/or modify

     8

 *  it under the terms of the GNU General Public License as published by

     9

 *  the Free Software Foundation, either version 3 of the License, or

    10

 *  (at your option) any later version.

    11

 *

    12

 *  This program is distributed in the hope that it will be useful,

    13

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

    14

 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

    15

 *  GNU General Public License for more details.

    16

 *

    17

 *  You should have received a copy of the GNU General Public License

    18

 *  along with this program.  If not, see <http://www.gnu.org/licenses/>.

    19

 *

    20

 *

    21

 * This code is made available on the understanding that it will not be

    22

 * used in safety-critical situations without a full and competent review.

    23

 */

    24

    25

/*

    26

 * An IEC 61131-3 compiler.

    27

 *

    28

 * Based on the

    29

 * FINAL DRAFT - IEC 61131-3, 2nd Ed. (2001-12-10)

    30

 *

    31

 */

    32

    33

/* Determine the value of an constant expression.

    34

 * A reference to the relevant type definition is returned.

    35

 *

    36

 * For example:

    37

 *       2 + 3       -> returns reference 

    38

 *       22.2 - 5    -> returns reference

    39

 *       etc...

    40

 */

    41

    42

#include <vector>

    43

#include "../absyntax_utils/absyntax_utils.hh"

    44

    45

    46

    47

/* For the moment we disable constant propagation algorithm as it is not yet complete, 

    48

 * and due to this is currently brocken and producing incorrect results!

    49

 */

    50

#define DO_CONSTANT_PROPAGATION__ 0

    51

    52

    53

    54

class constant_folding_c : public iterator_visitor_c {

    55

    search_varfb_instance_type_c *search_varfb_instance_type;

    56

    int error_count;

    57

    bool warning_found;

    58

    int current_display_error_level;

    59

    /* Pointer to the previous IL instruction, which contains the current cvalue of the data stored in the IL stack, i.e. the default variable, a.k.a. accumulator */

    60

    symbol_c *prev_il_instruction;

    61

    /* the current IL operand being analyzed */

    62

    symbol_c *il_operand;

    63

    64

    65

    66

  public:

    67

    constant_folding_c(symbol_c *symbol = NULL);

    68

    virtual ~constant_folding_c(void);

    69

    int get_error_count();

    70

    int handle_var_extern_global_pair(symbol_c *extern_var_name, symbol_c *extern_var_decl, symbol_c *global_var_name, symbol_c *global_var_decl);

    71

    typedef std::map <std::string, const_value_c> map_values_t;

    72

  private:

    73

    map_values_t values;

    74

    void *handle_var_list_decl(symbol_c *var_list, symbol_c *type_decl);

    75

    void *handle_var_decl     (symbol_c *var_list, bool fixed_init_value);

    76

    // Flag to indicate whether the variables in the variable declaration list will always have a fixed value when the POU is executed!

    77

    // VAR CONSTANT ... END_VAR will always be true

    78

    // VAR          ... END_VAR will always be true for functions (who initialise local variables every time they are called), but false for FBs and PROGRAMS

    79

    bool fixed_init_value_; 

    80

    bool function_pou_;

    81

    bool is_constant(symbol_c *option);

    82

    bool is_retain  (symbol_c *option);

    83

    84

    85

  public:

    86

	#if 0

    87

	// not currently needed, so comment it out!...

    88

	/* utility functions for other stage3 algorithms to access the contant folded values */

    89

	/* written as static since we do not need to iteratively visit the symbols! */

    90

	// returns true if both symbols have the same value in all the cvalues

    91

	static bool is_equal_cvalue(symbol_c *symbol_1, symbol_c *symbol_2);

    92

	#endif

    93

    94

  private:

    95

    /*********************/

    96

    /* B 1.2 - Constants */

    97

    /*********************/

    98

    /******************************/

    99

    /* B 1.2.1 - Numeric Literals */

   100

    /******************************/

   101

    void *visit(real_c *symbol);

   102

    void *visit(integer_c *symbol);

   103

    void *visit(neg_real_c *symbol);

   104

    void *visit(neg_integer_c *symbol);

   105

    void *visit(binary_integer_c *symbol);

   106

    void *visit(octal_integer_c *symbol);

   107

    void *visit(hex_integer_c *symbol);

   108

    void *visit(integer_literal_c *symbol);

   109

    void *visit(real_literal_c *symbol);

   110

    void *visit(bit_string_literal_c *symbol);

   111

    void *visit(boolean_literal_c *symbol);

   112

    void *visit(boolean_true_c *symbol);

   113

    void *visit(boolean_false_c *symbol);

   114

   115

    /************************/

   116

    /* B 1.2.3.1 - Duration */

   117

    /********* **************/

   118

    void *visit(fixed_point_c *symbol);

   119

   120

    /*********************/

   121

    /* B 1.4 - Variables */

   122

    /*********************/

   123

//     #if DO_CONSTANT_PROPAGATION__

   124

    void *visit(symbolic_variable_c *symbol);

   125

//     #endif // DO_CONSTANT_PROPAGATION__

   126

    void *visit(symbolic_constant_c *symbol);

   127

   128

    /******************************************/

   129

    /* B 1.4.3 - Declaration & Initialisation */

   130

    /******************************************/

   131

    void *visit(        input_declarations_c *symbol);

   132

    void *visit(       output_declarations_c *symbol);

   133

    void *visit( input_output_declarations_c *symbol);

   134

    void *visit(          var_declarations_c *symbol);

   135

    void *visit(retentive_var_declarations_c *symbol);

   136

    void *visit( external_var_declarations_c *symbol);

   137

    void *visit(   global_var_declarations_c *symbol);

   138

    void *visit(  external_declaration_c     *symbol);

   139

    void *visit(global_var_decl_c            *symbol);

   140

    void *visit( var1_init_decl_c            *symbol);

   141

   142

    /**************************************/

   143

    /* B.1.5 - Program organization units */

   144

    /**************************************/

   145

    /***********************/

   146

    /* B 1.5.1 - Functions */

   147

    /***********************/

   148

    void *visit(function_declaration_c *symbol);

   149

    void *visit(function_var_decls_c   *symbol);

   150

   151

    /*****************************/

   152

    /* B 1.5.2 - Function Blocks */

   153

    /*****************************/

   154

    void *visit(function_block_declaration_c *symbol);

   155

    void *visit(            temp_var_decls_c *symbol);

   156

    void *visit(   non_retentive_var_decls_c *symbol);

   157

   158

    /**********************/

   159

    /* B 1.5.3 - Programs */

   160

    /**********************/

   161

    void *visit(       program_declaration_c *symbol);

   162

   163

    /********************************/

   164

    /* B 1.7 Configuration elements */

   165

    /********************************/

   166

    void *visit( configuration_declaration_c *symbol);

   167

    void *visit(      resource_declaration_c *symbol);

   168

   169

   170

    /****************************************/

   171

    /* B.2 - Language IL (Instruction List) */

   172

    /****************************************/

   173

    /***********************************/

   174

    /* B 2.1 Instructions and Operands */

   175

    /***********************************/

   176

    // void *visit(instruction_list_c *symbol); /* Not needed, since we inherit from iterator_visitor_c */

   177

    void *visit(il_instruction_c *symbol);

   178

    void *visit(il_simple_operation_c *symbol);

   179

    //void *visit(il_function_call_c *symbol);  /* TODO */

   180

    void *visit(il_expression_c *symbol);

   181

    void *visit(il_jump_operation_c *symbol);

   182

    void *visit(il_fb_call_c *symbol);

   183

    //void *visit(il_formal_funct_call_c *symbol);   /* TODO */

   184

    //void *visit(il_operand_list_c *symbol);  /* Not needed, since we inherit from iterator_visitor_c */

   185

    void *visit(simple_instr_list_c *symbol);

   186

    void *visit(il_simple_instruction_c *symbol);

   187

   188

   189

    /*******************/

   190

    /* B 2.2 Operators */

   191

    /*******************/

   192

    void *visit(   LD_operator_c *symbol);

   193

    void *visit(  LDN_operator_c *symbol);

   194

    void *visit(   ST_operator_c *symbol);

   195

    void *visit(  STN_operator_c *symbol);

   196

    void *visit(  NOT_operator_c *symbol);

   197

    void *visit(    S_operator_c *symbol);

   198

    void *visit(    R_operator_c *symbol);

   199

    void *visit(   S1_operator_c *symbol);

   200

    void *visit(   R1_operator_c *symbol);

   201

    void *visit(  CLK_operator_c *symbol);

   202

    void *visit(   CU_operator_c *symbol);

   203

    void *visit(   CD_operator_c *symbol);

   204

    void *visit(   PV_operator_c *symbol);

   205

    void *visit(   IN_operator_c *symbol);

   206

    void *visit(   PT_operator_c *symbol);

   207

    void *visit(  AND_operator_c *symbol);

   208

    void *visit(   OR_operator_c *symbol);

   209

    void *visit(  XOR_operator_c *symbol);

   210

    void *visit( ANDN_operator_c *symbol);

   211

    void *visit(  ORN_operator_c *symbol);

   212

    void *visit( XORN_operator_c *symbol);

   213

    void *visit(  ADD_operator_c *symbol);

   214

    void *visit(  SUB_operator_c *symbol);

   215

    void *visit(  MUL_operator_c *symbol);

   216

    void *visit(  DIV_operator_c *symbol);

   217

    void *visit(  MOD_operator_c *symbol);

   218

    void *visit(   GT_operator_c *symbol);

   219

    void *visit(   GE_operator_c *symbol);

   220

    void *visit(   EQ_operator_c *symbol);

   221

    void *visit(   LT_operator_c *symbol);

   222

    void *visit(   LE_operator_c *symbol);

   223

    void *visit(   NE_operator_c *symbol);

   224

    void *visit(  CAL_operator_c *symbol);

   225

    void *visit( CALC_operator_c *symbol);

   226

    void *visit(CALCN_operator_c *symbol);

   227

    void *visit(  RET_operator_c *symbol);

   228

    void *visit( RETC_operator_c *symbol);

   229

    void *visit(RETCN_operator_c *symbol);

   230

    void *visit(  JMP_operator_c *symbol);

   231

    void *visit( JMPC_operator_c *symbol);

   232

    void *visit(JMPCN_operator_c *symbol);

   233

    /* Symbol class handled together with function call checks */

   234

    // void *visit(il_assign_operator_c *symbol, variable_name);

   235

    /* Symbol class handled together with function call checks */

   236

    // void *visit(il_assign_operator_c *symbol, option, variable_name);

   237

   238

    /***************************************/

   239

    /* B.3 - Language ST (Structured Text) */

   240

    /***************************************/

   241

    /***********************/

   242

    /* B 3.1 - Expressions */

   243

    /***********************/

   244

    void *visit(    or_expression_c *symbol);

   245

    void *visit(   xor_expression_c *symbol);

   246

    void *visit(   and_expression_c *symbol);

   247

    void *visit(   equ_expression_c *symbol);

   248

    void *visit(notequ_expression_c *symbol);

   249

    void *visit(    lt_expression_c *symbol);

   250

    void *visit(    gt_expression_c *symbol);

   251

    void *visit(    le_expression_c *symbol);

   252

    void *visit(    ge_expression_c *symbol);

   253

    void *visit(   add_expression_c *symbol);

   254

    void *visit(   sub_expression_c *symbol);

   255

    void *visit(   mul_expression_c *symbol);

   256

    void *visit(   div_expression_c *symbol);

   257

    void *visit(   mod_expression_c *symbol);

   258

    void *visit( power_expression_c *symbol);

   259

    void *visit(   neg_expression_c *symbol);

   260

    void *visit(   not_expression_c *symbol);

   261

    //void *visit(function_invocation_c *symbol); /* TODO */

   262

   263

   264

    /*********************************/

   265

    /* B 3.2.1 Assignment Statements */

   266

    /*********************************/

   267

    void *visit(assignment_statement_c *symbol);

   268

   269

    #if DO_CONSTANT_PROPAGATION__

   270

    /********************************/

   271

    /* B 3.2.3 Selection Statements */

   272

    /********************************/

   273

    void *visit(if_statement_c *symbol);

   274

   275

    /********************************/

   276

    /* B 3.2.4 Iteration Statements */

   277

    /********************************/

   278

    void *visit(for_statement_c *symbol);

   279

    void *visit(while_statement_c *symbol);

   280

    void *visit(repeat_statement_c *symbol);

   281

    #endif // DO_CONSTANT_PROPAGATION__

   282

};

   283