1

/*

     2

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

     3

 *

     4

 *  Copyright (C) 2003-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

#include <string>

    26

#include <iostream>

    27

#include <sstream>

    28

#include <typeinfo>

    29

#include <list>

    30

#include <map>

    31

#include <sstream>

    32

#include <strings.h>

    33

    34

    35

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

    36

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

    37

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

    38

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

    39

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

    40

    41

#include "../stage4.hh"

    42

    43

//#define DEBUG

    44

#ifdef DEBUG

    45

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

    46

#else

    47

#define TRACE(classname)

    48

#endif

    49

    50

    51

    52

#define STAGE4_ERROR(symbol1, symbol2, ...) {stage4err("while generating C code", symbol1, symbol2, __VA_ARGS__); exit(EXIT_FAILURE);}

    53

    54

    55

/* Macros to access the constant value of each expression (if it exists) from the annotation introduced to the symbol_c object by constant_folding_c in stage3! */

    56

#define VALID_CVALUE(dtype, symbol)           (symbol_c::cs_const_value == (symbol)->const_value._##dtype.status)

    57

#define GET_CVALUE(dtype, symbol)             ((symbol)->const_value._##dtype.value) 

    58

    59

    60

    61

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

    62

    63

/* Unlike Programs and Configurations which get mapped onto C++ classes,

    64

 * Function Blocks are mapped onto a C structure containing the variables, and

    65

 * a C function containing the code in the FB's body. This is to allow direct allocation

    66

 * of a FB variable (which is really an instance of the C data structure) to

    67

 * a member of a union variable (note that classes with constructors cannot

    68

 * be mebers of a union), which is done in IL when loading a FB onto IL's

    69

 * default variable.

    70

 *

    71

 * So as not to clash the names of the C data structure and the C function,

    72

 * the C structure is given a name identical to that of the FB name, whereas

    73

 * the name of the function is the FB name with a constant string appended.

    74

 * The value of that constant string which is appended is defined in the following

    75

 * constant.

    76

 * In order not to clash with any variable in the IL and ST source codem the

    77

 * following constant should contain a double underscore, which is not allowed

    78

 * in IL and ST.

    79

 *

    80

 * e.g.:  FUNTION_BLOCK TEST

    81

 * is mapped onto a TEST data structure, and a TEST_body__ function.

    82

 */

    83

    84

#define FB_FUNCTION_SUFFIX "_body__"

    85

    86

/* Idem as body, but for initializer FB function */

    87

#define FB_INIT_SUFFIX "_init__"

    88

    89

/* Idem as body, but for run CONFIG and RESOURCE function */

    90

#define FB_RUN_SUFFIX "_run__"

    91

    92

/* The FB body function is passed as the only parameter a pointer to the FB data

    93

 * structure instance. The name of this parameter is given by the following constant.

    94

 * In order not to clash with any variable in the IL and ST source codem the

    95

 * following constant should contain a double underscore, which is not allowed

    96

 * in IL and ST.

    97

 *

    98

 * e.g.: the body of FUNTION_BLOCK TEST

    99

 * is mapped onto the C function

   100

 *  TEST_body__(TEST *data__)

   101

 */

   102

   103

#define FB_FUNCTION_PARAM "data__"

   104

   105

   106

#define SFC_STEP_ACTION_PREFIX "__SFC_"

   107

   108

   109

/* Variable declaration symbol for accessor macros */

   110

#define DECLARE_VAR "__DECLARE_VAR"

   111

#define DECLARE_GLOBAL "__DECLARE_GLOBAL"

   112

#define DECLARE_GLOBAL_FB "__DECLARE_GLOBAL_FB"

   113

#define DECLARE_GLOBAL_LOCATION "__DECLARE_GLOBAL_LOCATION"

   114

#define DECLARE_GLOBAL_LOCATED "__DECLARE_GLOBAL_LOCATED"

   115

#define DECLARE_EXTERNAL "__DECLARE_EXTERNAL"

   116

#define DECLARE_EXTERNAL_FB "__DECLARE_EXTERNAL_FB"

   117

#define DECLARE_LOCATED "__DECLARE_LOCATED"

   118

#define DECLARE_GLOBAL_PROTOTYPE "__DECLARE_GLOBAL_PROTOTYPE"

   119

   120

/* Variable declaration symbol for accessor macros */

   121

#define INIT_VAR "__INIT_VAR"

   122

#define INIT_GLOBAL "__INIT_GLOBAL"

   123

#define INIT_GLOBAL_FB "__INIT_GLOBAL_FB"

   124

#define INIT_GLOBAL_LOCATED "__INIT_GLOBAL_LOCATED"

   125

#define INIT_EXTERNAL "__INIT_EXTERNAL"

   126

#define INIT_EXTERNAL_FB "__INIT_EXTERNAL_FB"

   127

#define INIT_LOCATED "__INIT_LOCATED"

   128

#define INIT_LOCATED_VALUE "__INIT_LOCATED_VALUE"

   129

   130

/* Variable getter symbol for accessor macros */

   131

#define GET_VAR "__GET_VAR"

   132

#define GET_EXTERNAL "__GET_EXTERNAL"

   133

#define GET_EXTERNAL_FB "__GET_EXTERNAL_FB"

   134

#define GET_LOCATED "__GET_LOCATED"

   135

   136

#define GET_VAR_REF "__GET_VAR_REF"

   137

#define GET_EXTERNAL_REF "__GET_EXTERNAL_REF"

   138

#define GET_EXTERNAL_FB_REF "__GET_EXTERNAL_FB_REF"

   139

#define GET_LOCATED_REF "__GET_LOCATED_REF"

   140

   141

#define GET_VAR_DREF "__GET_VAR_DREF"

   142

#define GET_EXTERNAL_DREF "__GET_EXTERNAL_DREF"

   143

#define GET_EXTERNAL_FB_DREF "__GET_EXTERNAL_FB_DREF"

   144

#define GET_LOCATED_DREF "__GET_LOCATED_DREF"

   145

   146

#define GET_VAR_BY_REF "__GET_VAR_BY_REF"

   147

#define GET_EXTERNAL_BY_REF "__GET_EXTERNAL_BY_REF"

   148

#define GET_EXTERNAL_FB_BY_REF "__GET_EXTERNAL_FB_BY_REF"

   149

#define GET_LOCATED_BY_REF "__GET_LOCATED_BY_REF"

   150

   151

/* Variable setter symbol for accessor macros */

   152

#define SET_VAR "__SET_VAR"

   153

#define SET_EXTERNAL "__SET_EXTERNAL"

   154

#define SET_EXTERNAL_FB "__SET_EXTERNAL_FB"

   155

#define SET_LOCATED "__SET_LOCATED"

   156

   157

/* Variable initial value symbol for accessor macros */

   158

#define INITIAL_VALUE "__INITIAL_VALUE"

   159

   160

/* Generate a name for a temporary variable.

   161

 * Each new name generated is appended a different number,

   162

 * starting off from 0.

   163

 * After calling reset(), the names will start off again from 0.

   164

 */

   165

#define VAR_LEADER "__"

   166

#define TEMP_VAR VAR_LEADER "TMP_"

   167

#define SOURCE_VAR VAR_LEADER "SRC_"

   168

   169

/* please see the comment before the RET_operator_c visitor for details... */

   170

#define END_LABEL VAR_LEADER "end"

   171

   172

   173

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

   174

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

   175

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

   176

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

   177

   178

   179

static int generate_line_directives__ = 0;

   180

static int generate_pou_filepairs__   = 0;

   181

   182

#ifdef __unix__

   183

/* Parse command line options passed from main.c !! */

   184

#include <stdlib.h> // for getsybopt()

   185

int  stage4_parse_options(char *options) {

   186

  enum {                    LINE_OPT = 0            ,  SEPTFILE_OPT              /*, SOME_OTHER_OPT, YET_ANOTHER_OPT */};

   187

  char *const token[] = { /*[LINE_OPT]=*/(char *)"l",/*SEPTFILE_OPT*/(char *)"p" /*, SOME_OTHER_OPT, ...             */, NULL };

   188

  /* unfortunately, the above commented out syntax for array initialization is valid in C, but not in C++ */

   189

   190

  char *subopts = options;

   191

  char *value;

   192

  int opt;

   193

   194

  while (*subopts != '\0') {

   195

    switch (getsubopt(&subopts, token, &value)) {

   196

      case     LINE_OPT: generate_line_directives__  = 1; break;

   197

      case SEPTFILE_OPT: generate_pou_filepairs__    = 1; break;

   198

      default          : fprintf(stderr, "Unrecognized option: -O %s\n", value); return -1; break;

   199

     }

   200

  }     

   201

  return 0;

   202

}

   203

   204

   205

void stage4_print_options(void) {

   206

  printf("          (options must be separated by commas. Example: 'l,w,x')\n"); 

   207

  printf("      l : insert '#line' directives in generated C code.\n"); 

   208

  printf("      p : place each POU in a separate pair of files (<pou_name>.c, <pou_name>.h).\n"); 

   209

}

   210

#else /* not __unix__ */

   211

/* getsubopt isn't supported with mingw, 

   212

 *  then stage4 options aren't available on windows*/

   213

void stage4_print_options(void) {}

   214

int  stage4_parse_options(char *options) {}

   215

#endif 

   216

   217

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

   218

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

   219

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

   220

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

   221

   222

#include "generate_c_base.cc"

   223

#include "generate_c_typedecl.cc"

   224

#include "generate_c_sfcdecl.cc"

   225

#include "generate_c_vardecl.cc"

   226

#include "generate_c_configbody.cc"

   227

#include "generate_location_list.cc"

   228

#include "generate_var_list.cc"

   229

   230

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

   231

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

   232

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

   233

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

   234

   235

   236

#include "generate_c.hh"

   237

   238

   239

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

   240

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

   241

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

   242

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

   243

   244

/* A helper class that prints out the identifiers for function calls to overloaded functions */

   245

/* Given a function declaration of the function being called, it 

   246

 * will simply print out the returned data type,

   247

 * followed by the data types of all input, output, and in_out parameters.

   248

 *   for e.g.; 

   249

 *     SIN( REAL) : REAL      -> prints out ->  REAL__REAL

   250

 *     LEN( STRING) : INT     -> prints out ->  INT__STRING

   251

 *     MUL(TIME, INT) : TIME  -> prints out ->  TIME__TIME__INT

   252

 */

   253

class print_function_parameter_data_types_c: public generate_c_base_c {

   254

  private:

   255

    symbol_c *current_type;

   256

    bool_type_name_c tmp_bool;

   257

   258

    void print_list(symbol_c *var_list, symbol_c *data_type) { 

   259

      if (data_type != NULL) {

   260

        /* print out the data type once for every variable! */

   261

        list_c *list = dynamic_cast<list_c *>(var_list);

   262

        if (list == NULL) ERROR;  

   263

        for (int i=0; i < list->n; i++) {

   264

          s4o.print("__");

   265

          data_type->accept(*this);

   266

        }  

   267

      }

   268

    }

   269

   270

  public:

   271

    print_function_parameter_data_types_c(stage4out_c *s4o_ptr): 

   272

      generate_c_base_c(s4o_ptr)

   273

      {current_type = NULL;}

   274

   275

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

   276

    /* B.1.5 - Program organization units */

   277

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

   278

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

   279

    /* B 1.5.1 - Functions */

   280

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

   281

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

   282

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

   283

    void *visit(function_declaration_c *symbol) {

   284

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

   285

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

   286

      return NULL;

   287

    }

   288

   289

    /* already handled by iterator base class (note that generate_c_base_c inherits from iterator_c) */

   290

    //void *visit(var_declarations_list_c *symbol) {// iterate through list}

   291

   292

    /* already handled by iterator base class (note that generate_c_base_c inherits from iterator_c) */

   293

    //void *visit(input_declarations_c *symbol) {// iterate through list}

   294

   295

    /* already handled by iterator base class (note that generate_c_base_c inherits from iterator_c) */

   296

    //void *visit(input_declaration_list_c *symbol) {// iterate through list}

   297

   298

    void *visit(edge_declaration_c *symbol) {

   299

      current_type = &tmp_bool; 

   300

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

   301

      current_type = NULL; 

   302

      return NULL;

   303

    }

   304

   305

    /* We do NOT print out EN and ENO parameters! */

   306

    void *visit(en_param_declaration_c *symbol) {return NULL;}

   307

   308

    /* already handled by iterator base class (note that generate_c_base_c inherits from iterator_c) */

   309

    //void *visit(output_declarations_c *symbol) {// iterate through list}    

   310

   311

    /* already handled by iterator base class (note that generate_c_base_c inherits from iterator_c) */

   312

    //void *visit(var_init_decl_list_c *symbol) {// iterate through list}

   313

   314

    void *visit(simple_spec_init_c *symbol) {

   315

      /* return the data type */

   316

      return symbol->simple_specification; 

   317

    }

   318

   319

    /* currently we do not support data types defined in the declaration itself */

   320

    /* For now, sugest the user define a TYPE .. END_TYPE */

   321

    /* NOTE: although this class may also sometimes point to a previously_declared_subrange_type_name

   322

     * we don't need this for now, so it is easier to just skip it allocation

   323

     */

   324

    void *visit(subrange_spec_init_c *symbol) {return NULL;}

   325

   326

    /* currently we do not support data types defined in the declaration itself */

   327

    /* For now, sugest the user define a TYPE .. END_TYPE */

   328

    /* NOTE: although this class may also sometimes point to a previously_declared_enumerated_type_name

   329

     * we don't need this for now, so it is easier to just skip it allocation

   330

     */

   331

    void *visit(enumerated_spec_init_c *symbol) {return NULL;}

   332

   333

    /* currently we do not support data types defined in the declaration itself */

   334

    /* For now, sugest the user define a TYPE .. END_TYPE */

   335

    /* NOTE: although this class may also sometimes point to a previously_declared_array_type_name

   336

     * we don't need this for now, so it is easier to just skip it allocation

   337

     */

   338

    void *visit(array_var_init_decl_c *symbol) {return NULL;}

   339

   340

    /* currently we do not support data types defined in the declaration itself */

   341

    /* For now, sugest the user define a TYPE .. END_TYPE */

   342

    /* NOTE: although this class may also sometimes point to a previously_declared_structured_type_name

   343

     * we don't need this for now, so it is easier to just skip it allocation

   344

     */

   345

    void *visit(structured_var_init_decl_c *symbol) {return NULL;}

   346

   347

    /* We do NOT print out EN and ENO parameters! */

   348

    void *visit(eno_param_declaration_c *symbol) {return NULL;}

   349

   350

    /* already handled by iterator base class (note that generate_c_base_c inherits from iterator_c) */

   351

    //void *visit(input_output_declarations_c *symbol) {// iterate through list}    

   352

   353

    /* already handled by iterator base class (note that generate_c_base_c inherits from iterator_c) */

   354

    //void *visit(var_declaration_list_c *symbol) {iterate through list}

   355

   356

    void *visit(fb_name_decl_c *symbol) {

   357

      print_list(symbol->fb_name_list, spec_init_sperator_c::get_spec(symbol->fb_spec_init)); 

   358

      return NULL;

   359

    }

   360

   361

    void *visit(var1_init_decl_c *symbol) {

   362

      print_list(symbol->var1_list, (symbol_c *)symbol->spec_init->accept(*this));

   363

      return NULL;

   364

    }

   365

   366

    /* currently we do not support data types defined in the declaration itself */

   367

    /* For now, sugest the user define a TYPE .. END_TYPE */

   368

    void *visit(array_var_declaration_c *symbol) {return NULL;}

   369

   370

    void *visit(structured_var_declaration_c *symbol) {

   371

      current_type = symbol->structure_type_name; 

   372

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

   373

      current_type = NULL; 

   374

      return NULL;

   375

    }

   376

   377

    /* currently we do not support data types defined in the declaration itself */

   378

    /* For now, sugest the user define a TYPE .. END_TYPE */

   379

    /* Note that this class is used for fixed length strings...

   380

     *   STRING [ 42 ]

   381

     */

   382

    void *visit(single_byte_string_var_declaration_c *symbol) {return NULL;}

   383

   384

    /* currently we do not support data types defined in the declaration itself */

   385

    /* For now, sugest the user define a TYPE .. END_TYPE */

   386

    /* Note that this class is used for fixed length strings...

   387

     *   WSTRING [ 42 ]

   388

     */

   389

    void *visit(double_byte_string_var_declaration_c *symbol) {return NULL;}

   390

};

   391

   392

   393

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

   394

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

   395

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

   396

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

   397

   398

/* A helper class that analyses if the datatype of a variable is 'complex'. */

   399

/* 'complex' means that it is either a strcuture or an array!               */

   400

class analyse_variable_c: public search_visitor_c {

   401

  private:

   402

    static analyse_variable_c *singleton_;

   403

   404

  public:

   405

    analyse_variable_c(void) {};

   406

   407

    static bool is_complex_type(symbol_c *symbol) {

   408

      if (NULL == symbol) ERROR;

   409

      if (!get_datatype_info_c::is_type_valid     (symbol->datatype)) return false;

   410

      return (   get_datatype_info_c::is_structure(symbol->datatype) 

   411

              || get_datatype_info_c::is_array    (symbol->datatype) 

   412

             );

   413

    }

   414

   415

   416

  private:

   417

    symbol_c *last_fb, *first_non_fb_identifier;

   418

   419

  public:  

   420

    /* returns the first element (from left to right) in a structured variable that is not a FB, i.e. is either a structure or an array! */

   421

    /* eg:

   422

     *      fb1.fb2.fb3.real       returns ??????

   423

     *      fb1.fb2.struct1.real   returns struct1

   424

     *      struct1.real           returns struct1

   425

     */

   426

    static symbol_c *find_first_nonfb(symbol_c *symbol) {

   427

      if (NULL == singleton_)       singleton_ = new analyse_variable_c();

   428

      if (NULL == singleton_)       ERROR;

   429

      if (NULL == symbol)           ERROR;

   430

   431

      singleton_->last_fb                 = NULL;

   432

      singleton_->first_non_fb_identifier = NULL;

   433

      return (symbol_c *)symbol->accept(*singleton_);

   434

    }

   435

   436

    /* returns true if a strcutured variable (e.g. fb1.fb2.strcut1.real) contains a structure or array */

   437

    /* eg:

   438

     *      fb1.fb2.fb3.real       returns FALSE

   439

     *      fb1.fb2.struct1.real   returns TRUE

   440

     *      struct1.real           returns TRUE

   441

     */

   442

    static bool contains_complex_type(symbol_c *symbol) {

   443

      if (NULL == symbol) ERROR;

   444

      if (!get_datatype_info_c::is_type_valid(symbol->datatype)) ERROR;

   445

   446

      symbol_c *first_non_fb = (symbol_c *)find_first_nonfb(symbol);

   447

      return is_complex_type(first_non_fb->datatype);

   448

    }

   449

   450

   451

    /* returns the datatype of the variable returned by find_first_nonfb() */

   452

    /* eg:

   453

     *      fb1.fb2.fb3.real       returns ??????

   454

     *      fb1.fb2.struct1.real   returns datatype of struct1

   455

     *      struct1.real           returns datatype of struct1

   456

     */

   457

    static search_var_instance_decl_c::vt_t first_nonfb_vardecltype(symbol_c *symbol, symbol_c *scope) {

   458

      if (NULL == symbol) ERROR;

   459

      if (!get_datatype_info_c::is_type_valid(symbol->datatype)) ERROR;

   460

   461

      symbol_c *first_non_fb = (symbol_c *)find_first_nonfb(symbol);

   462

      if (NULL != singleton_->last_fb) {

   463

        scope = singleton_->last_fb->datatype;

   464

        symbol = singleton_->first_non_fb_identifier;

   465

      }

   466

   467

      search_var_instance_decl_c search_var_instance_decl(scope);

   468

   469

      return search_var_instance_decl.get_vartype(symbol);

   470

    }

   471

   472

   473

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

   474

    /* B 1.4 - Variables */

   475

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

   476

    void *visit(symbolic_variable_c *symbol) {

   477

      if (!get_datatype_info_c::is_type_valid    (symbol->datatype)) ERROR;

   478

      if (!get_datatype_info_c::is_function_block(symbol->datatype)) {

   479

         first_non_fb_identifier = symbol; 

   480

         return (void *)symbol;

   481

      }

   482

      last_fb = symbol;

   483

      return NULL;

   484

    }

   485

   486

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

   487

    /* B.1.4.2   Multi-element Variables */

   488

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

   489

   490

    // SYM_REF2(structured_variable_c, record_variable, field_selector)

   491

    void *visit(structured_variable_c *symbol) {

   492

      symbol_c *res = (symbol_c *)symbol->record_variable->accept(*this);

   493

      if (NULL != res) return res;

   494

   495

      if (!get_datatype_info_c::is_type_valid    (symbol->datatype)) ERROR;

   496

      if (!get_datatype_info_c::is_function_block(symbol->datatype)) {

   497

         first_non_fb_identifier = symbol->field_selector;