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

#include "../util/symtable.hh"

    45

    46

    47

    48

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

    49

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

    50

 */

    51

#define DO_CONSTANT_PROPAGATION__ 0

    52

    53

    54

    55

class constant_folding_c : public iterator_visitor_c {

    56

    search_varfb_instance_type_c *search_varfb_instance_type;

    57

    int error_count;

    58

    bool warning_found;

    59

    int current_display_error_level;

    60

    /* 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 */

    61

    symbol_c *prev_il_instruction;

    62

    /* the current IL operand being analyzed */

    63

    symbol_c *il_operand;

    64

    65

    66

    67

  public:

    68

    constant_folding_c(symbol_c *symbol = NULL);

    69

    virtual ~constant_folding_c(void);

    70

    int get_error_count();

    71

    typedef symtable_c<const_value_c> map_values_t;

    72

  private:

    75

    map_values_t values;

    77

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

    78

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

    79

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

    80

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

    81

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

    82

    bool fixed_init_value_; 

    83

    bool function_pou_;

    84

    bool is_constant(symbol_c *option);

    85

    bool is_retain  (symbol_c *option);

    86

    87

    88

  public:

    89

	#if 0

    90

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

    91

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

    92

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

    93

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

    94

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

    95

	#endif

    96

    97

  private:

   102

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

   103

    /* B 1.2 - Constants */

   104

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

   105

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

   106

    /* B 1.2.1 - Numeric Literals */

   107

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

   108

    void *visit(real_c *symbol);

   109

    void *visit(integer_c *symbol);

   110

    void *visit(neg_real_c *symbol);

   111

    void *visit(neg_integer_c *symbol);

   112

    void *visit(binary_integer_c *symbol);

   113

    void *visit(octal_integer_c *symbol);

   114

    void *visit(hex_integer_c *symbol);

   115

    void *visit(integer_literal_c *symbol);

   116

    void *visit(real_literal_c *symbol);

   117

    void *visit(bit_string_literal_c *symbol);

   118

    void *visit(boolean_literal_c *symbol);

   119

    void *visit(boolean_true_c *symbol);

   120

    void *visit(boolean_false_c *symbol);

   121

   122

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

   123

    /* B 1.2.3.1 - Duration */

   124

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

   125

    void *visit(fixed_point_c *symbol);

   126

   127

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

   128

    /* B 1.4 - Variables */

   129

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

   130

    #if DO_CONSTANT_PROPAGATION__

   131

    void *visit(symbolic_variable_c *symbol);

   132

    #endif // DO_CONSTANT_PROPAGATION__

   133

    void *visit(symbolic_constant_c *symbol);

   134

   135

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

   136

    /* B 1.4.3 - Declaration & Initialisation */

   137

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

   138

    void *visit(        input_declarations_c *symbol);

   139

    void *visit(       output_declarations_c *symbol);

   140

    void *visit( input_output_declarations_c *symbol);

   141

    void *visit(          var_declarations_c *symbol);

   142

    void *visit(retentive_var_declarations_c *symbol);

   143

    void *visit( external_var_declarations_c *symbol);

   144

    void *visit(   global_var_declarations_c *symbol);

   145

    void *visit(  external_declaration_c     *symbol);

   146

    void *visit(global_var_decl_c            *symbol);

   147

    void *visit( var1_init_decl_c            *symbol);

   148

   149

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

   150

    /* B.1.5 - Program organization units */

   151

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

   152

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

   153

    /* B 1.5.1 - Functions */

   154

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

   155

    void *visit(function_declaration_c *symbol);

   156

    void *visit(function_var_decls_c   *symbol);

   157

   158

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

   159

    /* B 1.5.2 - Function Blocks */

   160

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

   161

    void *visit(function_block_declaration_c *symbol);

   162

    void *visit(            temp_var_decls_c *symbol);

   163

    void *visit(   non_retentive_var_decls_c *symbol);

   164

   165

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

   166

    /* B 1.5.3 - Programs */

   167

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

   168

    void *visit(       program_declaration_c *symbol);

   169

   170

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

   171

    /* B 1.7 Configuration elements */

   172

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

   173

    void *visit( configuration_declaration_c *symbol);

   174

    void *visit(      resource_declaration_c *symbol);

   177

   178

   179

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

   180

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

   181

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

   182

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

   183

    /* B 2.1 Instructions and Operands */

   184

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

   185

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

   186

    void *visit(il_instruction_c *symbol);

   187

    void *visit(il_simple_operation_c *symbol);

   188

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

   189

    void *visit(il_expression_c *symbol);

   190

    void *visit(il_jump_operation_c *symbol);

   191

    void *visit(il_fb_call_c *symbol);

   192

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

   193

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

   194

    void *visit(simple_instr_list_c *symbol);

   195

    void *visit(il_simple_instruction_c *symbol);

   196

   197

   198

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

   199

    /* B 2.2 Operators */

   200

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

   201

    void *visit(   LD_operator_c *symbol);

   202

    void *visit(  LDN_operator_c *symbol);

   203

    void *visit(   ST_operator_c *symbol);

   204

    void *visit(  STN_operator_c *symbol);

   205

    void *visit(  NOT_operator_c *symbol);

   206

    void *visit(    S_operator_c *symbol);

   207

    void *visit(    R_operator_c *symbol);

   208

    void *visit(   S1_operator_c *symbol);

   209

    void *visit(   R1_operator_c *symbol);

   210

    void *visit(  CLK_operator_c *symbol);

   211

    void *visit(   CU_operator_c *symbol);

   212

    void *visit(   CD_operator_c *symbol);

   213

    void *visit(   PV_operator_c *symbol);

   214

    void *visit(   IN_operator_c *symbol);

   215

    void *visit(   PT_operator_c *symbol);

   216

    void *visit(  AND_operator_c *symbol);

   217

    void *visit(   OR_operator_c *symbol);

   218

    void *visit(  XOR_operator_c *symbol);

   219

    void *visit( ANDN_operator_c *symbol);

   220

    void *visit(  ORN_operator_c *symbol);

   221

    void *visit( XORN_operator_c *symbol);

   222

    void *visit(  ADD_operator_c *symbol);

   223

    void *visit(  SUB_operator_c *symbol);

   224

    void *visit(  MUL_operator_c *symbol);

   225

    void *visit(  DIV_operator_c *symbol);

   226

    void *visit(  MOD_operator_c *symbol);

   227

    void *visit(   GT_operator_c *symbol);

   228

    void *visit(   GE_operator_c *symbol);

   229

    void *visit(   EQ_operator_c *symbol);

   230

    void *visit(   LT_operator_c *symbol);

   231

    void *visit(   LE_operator_c *symbol);

   232

    void *visit(   NE_operator_c *symbol);

   233

    void *visit(  CAL_operator_c *symbol);

   234

    void *visit( CALC_operator_c *symbol);

   235

    void *visit(CALCN_operator_c *symbol);

   236

    void *visit(  RET_operator_c *symbol);

   237

    void *visit( RETC_operator_c *symbol);

   238

    void *visit(RETCN_operator_c *symbol);

   239

    void *visit(  JMP_operator_c *symbol);

   240

    void *visit( JMPC_operator_c *symbol);

   241

    void *visit(JMPCN_operator_c *symbol);

   242

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

   243

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

   244

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

   245

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

   246

   247

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

   248

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

   249

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

   250

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

   251

    /* B 3.1 - Expressions */

   252

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

   253

    void *visit(    or_expression_c *symbol);

   254

    void *visit(   xor_expression_c *symbol);

   255

    void *visit(   and_expression_c *symbol);

   256

    void *visit(   equ_expression_c *symbol);

   257

    void *visit(notequ_expression_c *symbol);

   258

    void *visit(    lt_expression_c *symbol);

   259

    void *visit(    gt_expression_c *symbol);

   260

    void *visit(    le_expression_c *symbol);

   261

    void *visit(    ge_expression_c *symbol);

   262

    void *visit(   add_expression_c *symbol);

   263

    void *visit(   sub_expression_c *symbol);

   264

    void *visit(   mul_expression_c *symbol);

   265

    void *visit(   div_expression_c *symbol);

   266

    void *visit(   mod_expression_c *symbol);

   267

    void *visit( power_expression_c *symbol);

   268

    void *visit(   neg_expression_c *symbol);

   269

    void *visit(   not_expression_c *symbol);

   270

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

   271

   272

    #if DO_CONSTANT_PROPAGATION__

   273

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

   274

    /* B 3.2.1 Assignment Statements */

   275

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

   276

    void *visit(assignment_statement_c *symbol);

   277

   278

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

   279

    /* B 3.2.3 Selection Statements */

   280

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

   281

    void *visit(if_statement_c *symbol);

   282

   283

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

   284

    /* B 3.2.4 Iteration Statements */

   285

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

   286

    void *visit(for_statement_c *symbol);

   287

    void *visit(while_statement_c *symbol);

   288

    void *visit(repeat_statement_c *symbol);

   289

    #endif // DO_CONSTANT_PROPAGATION__

   290

};

   291