1

/*

     2

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

     3

 *

     4

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

     5

 *  Copyright (C) 2007-2011  Laurent Bessard and Edouard Tisserant

     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

    34

/*

    35

 * This is the main stage 3a file.

    36

 *

    37

 * In stage 3a some helpful symbol tables are instanciated and populated.

    38

 * These symbol tables wll then be used by stage3b and atage4 code generators.

    39

 */

    40

    41

    42

    43

    44

    45

    46

// #include <stdio.h>  /* required for NULL */

    47

#include <string>

    48

#include <iostream>

    49

#include <sstream>

    50

#include <typeinfo>

    51

#include <list>

    52

#include <strings.h>

    53

// #include <string.h>  /* required for strlen() */

    54

// #include <stdlib.h>  /* required for atoi() */

    55

// #include <errno.h>   /* required for errno */

    56

    57

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

    58

#include "../util/dsymtable.hh"

    59

#include "../absyntax/visitor.hh"

    60

#include "../main.hh" // required for ERROR() and ERROR_MSG() macros.

    61

    62

    63

    64

//#define DEBUG

    65

#ifdef DEBUG

    66

#define TRACE(classname) printf("\n____%s____\n",classname);

    67

#else

    68

#define TRACE(classname)

    69

#endif

    70

    71

    72

    73

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

    74

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

    75

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

    76

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

    77

    78

    79

/* returns 0 if the names are equal!! */

    80

/* NOTE: it must ignore case!! */

    81

int compare_identifiers(symbol_c *ident1, symbol_c *ident2) {

    82

    83

  token_c *name1 = dynamic_cast<token_c *>(ident1);

    84

  token_c *name2 = dynamic_cast<token_c *>(ident2);

    85

    86

  if ((name1 == NULL) || (name2 == NULL))

    87

    /* invalid identifiers... */

    88

    return -1;

    89

    90

  if (strcasecmp(name1->value, name2->value) == 0)

    91

    return 0;

    92

    93

  /* identifiers do not match! */

    94

  return 1;

    95

}

    96

    97

    98

    99

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

   100

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

   101

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

   102

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

   103

   104

   105

   106

/* A symbol table with all globally declared functions... */

   107

dsymtable_c<function_declaration_c *> function_symtable;

   108

   109

/* A symbol table with all globally declared functions block types... */

   110

symtable_c<function_block_declaration_c *> function_block_type_symtable;

   111

   112

/* A symbol table with all globally declared program types... */

   113

symtable_c<program_declaration_c *> program_type_symtable;

   114

   115

/* A symbol table with all user declared type definitions... */

   116

/* Note that function block types and program types have their

   117

 * own symbol tables, so do not get placed in this symbol table!

   118

 *

   119

 * The symbol_c * associated to the value will point to the data type declaration.

   120

 */

   121

symtable_c<symbol_c *> type_symtable;

   122

   123

   124

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

   125

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

   126

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

   127

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

   128

   129

   130

class populate_symtables_c: public iterator_visitor_c {

   131

   132

  private:

   133

	symbol_c *current_enumerated_type;

   134

   135

  public:

   136

    populate_symtables_c(void) {

   137

    	current_enumerated_type = NULL;

   138

    };

   139

    virtual ~populate_symtables_c(void) {}

   140

   141

   142

  public:

   143

   144

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

   145

  /* B.1 - Common elements */

   146

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

   147

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

   148

  /* B 1.1 - Letters, digits and identifiers */

   149

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

   150

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

   151

  /* B 1.2 - Constants */

   152

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

   153

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

   154

  /* B 1.2.1 - Numeric Literals */

   155

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

   156

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

   157

  /* B.1.2.2   Character Strings */

   158

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

   159

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

   160

  /* B 1.2.3 - Time Literals */

   161

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

   162

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

   163

  /* B 1.2.3.1 - Duration */

   164

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

   165

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

   166

  /* B 1.2.3.2 - Time of day and Date */

   167

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

   168

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

   169

  /* B.1.3 - Data types */

   170

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

   171

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

   172

  /* B 1.3.1 - Elementary Data Types */

   173

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

   174

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

   175

  /* B.1.3.2 - Generic data types */

   176

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

   177

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

   178

  /* B 1.3.3 - Derived data types */

   179

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

   180

   181

  /*  subrange_type_name ':' subrange_spec_init */

   182

  void *visit(subrange_type_declaration_c *symbol) {type_symtable.insert(symbol->subrange_type_name, symbol->subrange_spec_init); return NULL;}

   183

   184

  /*  enumerated_type_name ':' enumerated_spec_init */

   185

  void *visit(enumerated_type_declaration_c *symbol) {

   186

    type_symtable.insert(symbol->enumerated_type_name, symbol);

   187

    current_enumerated_type = symbol->enumerated_type_name;

   188

    symbol->enumerated_spec_init->accept(*this);

   189

    current_enumerated_type = NULL;

   190

    return NULL;

   191

  }

   192

   193

  /* enumerated_specification ASSIGN enumerated_value */

   194

  void *visit(enumerated_spec_init_c *symbol) {return symbol->enumerated_specification->accept(*this);}

   195

  /*  identifier ':' array_spec_init */

   196

  void *visit(array_type_declaration_c *symbol) {type_symtable.insert(symbol->identifier, symbol->array_spec_init); return NULL;}

   197

  /*  simple_type_name ':' simple_spec_init */

   198

  void *visit(simple_type_declaration_c *symbol) {type_symtable.insert(symbol->simple_type_name, symbol->simple_spec_init); return NULL;}

   199

  /*  structure_type_name ':' structure_specification */

   200

  void *visit(structure_type_declaration_c *symbol) {type_symtable.insert(symbol->structure_type_name, symbol->structure_specification); return NULL;}

   201

  /*  string_type_name ':' elementary_string_type_name string_type_declaration_size string_type_declaration_init */

   202

  void *visit(string_type_declaration_c *symbol) {type_symtable.insert(symbol->string_type_name, symbol); return NULL;}

   203

  /* identifier ':' ref_spec_init */

   204

  void *visit(ref_type_decl_c *symbol) {type_symtable.insert(symbol->ref_type_name, symbol); return NULL;}

   205

   206

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

   207

  /* B 1.4 - Variables */

   208

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

   209

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

   210

  /* B.1.4.1   Directly Represented Variables */

   211

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

   212

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

   213

  /* B.1.4.2   Multi-element Variables */

   214

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

   215

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

   216

  /* B 1.4.3 - Declaration & Initialisation */

   217

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

   218

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

   219

  /* B.1.5 - Program organization units */

   220

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

   221

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

   222

  /* B 1.5.1 - Functions */

   223

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

   224

  public:

   225

  /*   FUNCTION derived_function_name ':' elementary_type_name io_OR_function_var_declarations_list function_body END_FUNCTION */

   226

  /* | FUNCTION derived_function_name ':' derived_type_name io_OR_function_var_declarations_list function_body END_FUNCTION */

   227

  void *visit(function_declaration_c *symbol) {

   228

    TRACE("function_declaration_c");

   229

    function_symtable.insert(symbol->derived_function_name, symbol);

   230

   231

    /* symbol->derived_function_name->accept(*this);  */ /* Function name */

   232

    /* symbol->type_name->accept(*this);              */ /* return data type */

   233

    /* symbol->var_declarations_list->accept(*this);  */ /* Function parameters and variables */

   234

    /* symbol->function_body->accept(*this);          */ /* Function body */

   235

    return NULL;

   236

  }

   237

   238

   239

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

   240

  /* B 1.5.2 - Function Blocks */

   241

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

   242

  public:

   243

  /*  FUNCTION_BLOCK derived_function_block_name io_OR_other_var_declarations function_block_body END_FUNCTION_BLOCK */

   244

  //SYM_REF4(function_block_declaration_c, fblock_name, var_declarations, fblock_body, unused)

   245

  void *visit(function_block_declaration_c *symbol) {

   246

    TRACE("function_block_declaration_c");

   247

    function_block_type_symtable.insert(symbol->fblock_name, symbol);

   248

  /*

   249

    symbol->fblock_name->accept(*this);

   250

    symbol->var_declarations->accept(*this);

   251

    symbol->fblock_body->accept(*this);

   252

  */

   253

    return NULL;

   254

  }

   255

   256

   257

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

   258

  /* B 1.5.3 - Programs */

   259

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

   260

  public:

   261

  /*  PROGRAM program_type_name program_var_declarations_list function_block_body END_PROGRAM */

   262

  //SYM_REF4(program_declaration_c, program_type_name, var_declarations, function_block_body, unused)

   263

  void *visit(program_declaration_c *symbol) {

   264

    TRACE("program_declaration_c");

   265

    program_type_symtable.insert(symbol->program_type_name, symbol);

   266

  /*

   267

    symbol->program_type_name->accept(*this);

   268

    symbol->var_declarations->accept(*this);

   269

    symbol->function_block_body->accept(*this);

   270

  */

   271

    return NULL;

   272

  }

   273

   274

}; /* populate_symtables_c */

   275

   276

   277

   278

   279

   280

void absyntax_utils_init(symbol_c *tree_root) {

   281

  populate_symtables_c populate_symbols;

   282

   283

  tree_root->accept(populate_symbols);

   284

}

   285