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

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

    21

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

    22

 *

    23

 * Based on the

    24

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

    25

 *

    26

 */

    27

    28

    29

/*

    30

 * Conversion of st statements (i.e. ST code).

    31

 *

    32

 * This is part of the 4th stage that generates

    33

 * a C source program equivalent to the IL and ST, or SFC

    34

 * code.

    35

 */

    36

    37

    38

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

    39

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

    40

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

    41

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

    42

    43

    44

class generate_c_st_c: public generate_c_typedecl_c {

    45

    46

  public:

    47

    typedef enum {

    48

      expression_vg,

    49

      assignment_vg,

    50

      complextype_base_vg,

    51

      complextype_suffix_vg,

    52

      fparam_output_vg

    53

    } variablegeneration_t;

    54

    55

  private:

    56

    /* When calling a function block, we must first find it's type,

    57

     * by searching through the declarations of the variables currently

    58

     * in scope.

    59

     * This class does just that...

    60

     * A new class is instantiated whenever we begin generating the code

    61

     * for a function block type declaration, or a program declaration.

    62

     * This object instance will then later be called while the

    63

     * function block's or the program's body is being handled.

    64

     *

    65

     * Note that functions cannot contain calls to function blocks,

    66

     * so we do not create an object instance when handling

    67

     * a function declaration.

    68

     */

    69

    search_fb_instance_decl_c *search_fb_instance_decl;

    70

    71

    /* When compiling st code, it becomes necessary to determine the

    72

     * data type of st expressions. To do this, we must first find the

    73

     * st operand's declaration, within the scope of the function block

    74

     * or function currently being processed.

    75

     * The following object does just that...

    76

     * This object instance will then later be called while the

    77

     * remaining st code is being handled.

    78

     */

    79

    search_expression_type_c *search_expression_type;

    80

    81

    search_varfb_instance_type_c *search_varfb_instance_type;

    82

    83

    search_base_type_c search_base_type;

    84

    85

    symbol_c* current_array_type;

    86

    symbol_c* current_param_type;

    87

    88

    int fcall_number;

    89

    symbol_c *fbname;

    90

    91

    variablegeneration_t wanted_variablegeneration;

    92

    93

  public:

    94

    generate_c_st_c(stage4out_c *s4o_ptr, symbol_c *name, symbol_c *scope, const char *variable_prefix = NULL)

    95

    : generate_c_typedecl_c(s4o_ptr) {

    96

      search_fb_instance_decl = new search_fb_instance_decl_c(scope);

    97

      search_expression_type = new search_expression_type_c(scope);

    98

      search_varfb_instance_type = new search_varfb_instance_type_c(scope);

    99

      this->set_variable_prefix(variable_prefix);

   100

      current_array_type = NULL;

   101

      current_param_type = NULL;

   102

      fcall_number = 0;

   103

      fbname = name;

   104

      wanted_variablegeneration = expression_vg;

   105

    }

   106

   107

    virtual ~generate_c_st_c(void) {

   108

      delete search_fb_instance_decl;

   109

      delete search_expression_type;

   110

      delete search_varfb_instance_type;

   111

    }

   112

   113

   114

  public:

   115

    void generate(statement_list_c *stl) {

   116

      stl->accept(*this);

   117

    }

   118

   119

  private:

   120

   121

void *print_getter(symbol_c *symbol) {

   122

  unsigned int vartype = search_varfb_instance_type->get_vartype(symbol);

   123

  if (wanted_variablegeneration == fparam_output_vg) {

   124

  	if (vartype == search_var_instance_decl_c::external_vt)

   125

      s4o.print(GET_EXTERNAL_BY_REF);

   126

    else if (vartype == search_var_instance_decl_c::located_vt)

   127

      s4o.print(GET_LOCATED_BY_REF);

   128

    else

   129

      s4o.print(GET_VAR_BY_REF);

   130

  }

   131

  else {

   132

	if (vartype == search_var_instance_decl_c::external_vt)

   133

	  s4o.print(GET_EXTERNAL);

   134

	else if (vartype == search_var_instance_decl_c::located_vt)

   135

	  s4o.print(GET_LOCATED);

   136

	else

   137

	  s4o.print(GET_VAR);

   138

  }

   139

  s4o.print("(");

   140

   141

  variablegeneration_t old_wanted_variablegeneration = wanted_variablegeneration;

   142

  wanted_variablegeneration = complextype_base_vg;

   143

  symbol->accept(*this);

   144

  if (search_varfb_instance_type->type_is_complex())

   145

    s4o.print(",");

   146

  wanted_variablegeneration = complextype_suffix_vg;

   147

  symbol->accept(*this);

   148

  s4o.print(")");

   149

  wanted_variablegeneration = old_wanted_variablegeneration;

   150

  return NULL;

   151

}

   152

   153

void *print_setter(symbol_c* symbol,

   154

		symbol_c* type,

   155

		symbol_c* value,

   156

		symbol_c* fb_symbol = NULL,

   157

		symbol_c* fb_value = NULL) {

   158

  unsigned int vartype = search_varfb_instance_type->get_vartype(symbol);

   159

  if (vartype == search_var_instance_decl_c::external_vt) {

   160

    symbolic_variable_c *variable = dynamic_cast<symbolic_variable_c *>(symbol);

   161

    /* TODO Find a solution for forcing global complex variables */

   162

    if (variable != NULL) {

   163

      s4o.print(SET_EXTERNAL);

   164

      s4o.print("(");

   165

      variable->var_name->accept(*this);

   166

      s4o.print(",");

   167

    }

   168

    else {

   169

      s4o.print(SET_COMPLEX_EXTERNAL);

   170

      s4o.print("(");

   171

    }

   172

  }

   173

  else {

   174

    if (vartype == search_var_instance_decl_c::located_vt)

   175

      s4o.print(SET_LOCATED);

   176

    else

   177

      s4o.print(SET_VAR);

   178

    s4o.print("(");

   179

  }

   180

   181

  if (fb_symbol != NULL) {

   182

    print_variable_prefix();

   183

    fb_symbol->accept(*this);

   184

    s4o.print(".");

   185

  }

   186

  else

   187

    wanted_variablegeneration = complextype_base_vg;

   188

  symbol->accept(*this);

   189

  s4o.print(",");

   190

  wanted_variablegeneration = expression_vg;

   191

  print_check_function(type, value, fb_value);

   192

  if (search_varfb_instance_type->type_is_complex()) {

   193

    s4o.print(",");

   194

    wanted_variablegeneration = complextype_suffix_vg;

   195

    symbol->accept(*this);

   196

  }

   197

  s4o.print(")");

   198

  wanted_variablegeneration = expression_vg;

   199

  return NULL;

   200

}

   201

   202

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

   203

/* B 1.4 - Variables */

   204

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

   205

void *visit(symbolic_variable_c *symbol) {

   206

  unsigned int vartype;

   207

  if (wanted_variablegeneration == complextype_base_vg)

   208

	generate_c_base_c::visit(symbol);

   209

  else if (wanted_variablegeneration == complextype_suffix_vg)

   210

	return NULL;

   211

  else if (this->is_variable_prefix_null()) {

   212

	vartype = search_varfb_instance_type->get_vartype(symbol);

   213

	if (wanted_variablegeneration == fparam_output_vg) {

   214

	  s4o.print("&(");

   215

      generate_c_base_c::visit(symbol);

   216

      s4o.print(")");

   217

    }

   218

    else {

   219

      generate_c_base_c::visit(symbol);

   220

    }

   221

  }

   222

  else

   223

	print_getter(symbol);

   224

  return NULL;

   225

}

   226

   227

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

   228

/* B.1.4.1   Directly Represented Variables */

   229

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

   230

// direct_variable: direct_variable_token   {$$ = new direct_variable_c($1);};

   231

void *visit(direct_variable_c *symbol) {

   232

  TRACE("direct_variable_c");

   233

  /* Do not use print_token() as it will change everything into uppercase */

   234

  if (strlen(symbol->value) == 0) ERROR;

   235

  if (this->is_variable_prefix_null()) {

   236

    if (wanted_variablegeneration != fparam_output_vg)

   237

	  s4o.print("*(");

   238

  }

   239

  else {

   240

    switch (wanted_variablegeneration) {

   241

      case expression_vg:

   242

  	    s4o.print(GET_LOCATED);

   243

  	    s4o.print("(");

   244

  	    break;

   245

      case fparam_output_vg:

   246

        s4o.print(GET_LOCATED_BY_REF);

   247

        s4o.print("(");

   248

        break;

   249

      default:

   250

        break;

   251

    }

   252

  }

   253

  this->print_variable_prefix();

   254

  s4o.printlocation(symbol->value + 1);

   255

  if ((this->is_variable_prefix_null() && wanted_variablegeneration != fparam_output_vg) ||

   256

	  wanted_variablegeneration != assignment_vg)

   257

    s4o.print(")");

   258

  return NULL;

   259

}

   260

   261

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

   262

/* B.1.4.2   Multi-element Variables */

   263

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

   264

   265

// SYM_REF2(structured_variable_c, record_variable, field_selector)

   266

void *visit(structured_variable_c *symbol) {

   267

  TRACE("structured_variable_c");

   268

  switch (wanted_variablegeneration) {

   269

    case complextype_base_vg:

   270

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

   271

      break;

   272

    case complextype_suffix_vg:

   273

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

   274

      s4o.print(".");

   275

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

   276

      break;

   277

    default:

   278

      if (this->is_variable_prefix_null()) {

   279

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

   280

    	s4o.print(".");

   281

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

   282

      }

   283

      else

   284

    	print_getter(symbol);

   285

      break;

   286

  }

   287

  return NULL;

   288

}

   289

   290

/*  subscripted_variable '[' subscript_list ']' */

   291

//SYM_REF2(array_variable_c, subscripted_variable, subscript_list)

   292

void *visit(array_variable_c *symbol) {

   293

  switch (wanted_variablegeneration) {

   294

    case complextype_base_vg:

   295

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

   296

      break;

   297

    case complextype_suffix_vg:

   298

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

   299

   300

      current_array_type = search_varfb_instance_type->get_rawtype(symbol->subscripted_variable);

   301

      if (current_array_type == NULL) ERROR;

   302

   303

      s4o.print(".table");

   304

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

   305

   306

      current_array_type = NULL;

   307

      break;

   308

    default:

   309

      if (this->is_variable_prefix_null()) {

   310

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

   311

   312

    	current_array_type = search_varfb_instance_type->get_rawtype(symbol->subscripted_variable);

   313

    	if (current_array_type == NULL) ERROR;

   314

   315

    	s4o.print(".table");

   316

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

   317

   318

        current_array_type = NULL;

   319

      }

   320

      else

   321

    	print_getter(symbol);

   322

      break;

   323

  }

   324

  return NULL;

   325

}

   326

   327

/* subscript_list ',' subscript */

   328

void *visit(subscript_list_c *symbol) {

   329

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

   330

    s4o.print("[__");

   331

    current_array_type->accept(*this);

   332

    s4o.print("_TRANSIDX");

   333

    print_integer(i);

   334

    s4o.print("(");

   335

    symbol->elements[i]->accept(*this);

   336

    s4o.print(")]");

   337

  }

   338

  return NULL;

   339

}

   340

   341

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

   342

/* B 1.4.3 - Declaration & Initialisation */

   343

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

   344

   345

/* helper symbol for structure_initialization */

   346

/* structure_element_initialization_list ',' structure_element_initialization */

   347

void *visit(structure_element_initialization_list_c *symbol) {

   348

  generate_c_structure_initialization_c *structure_initialization = new generate_c_structure_initialization_c(&s4o);

   349

  structure_initialization->init_structure_default(this->current_param_type);

   350

  structure_initialization->init_structure_values(symbol);

   351

  delete structure_initialization;

   352

  return NULL;

   353

}

   354

   355

/* helper symbol for array_initialization */

   356

/* array_initial_elements_list ',' array_initial_elements */

   357

void *visit(array_initial_elements_list_c *symbol) {

   358

  generate_c_array_initialization_c *array_initialization = new generate_c_array_initialization_c(&s4o);

   359

  array_initialization->init_array_size(this->current_param_type);

   360

  array_initialization->init_array_values(symbol);

   361

  delete array_initialization;

   362

  return NULL;

   363

}

   364

   365

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

   366

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

   367

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

   368

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

   369

/* B 3.1 - Expressions */

   370

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

   371

void *visit(or_expression_c *symbol) {

   372

  symbol_c *left_type = search_expression_type->get_type(symbol->l_exp);

   373

  symbol_c *right_type = search_expression_type->get_type(symbol->r_exp);

   374

  if (!search_expression_type->is_same_type(left_type, right_type))

   375

      ERROR;

   376

  if (search_expression_type->is_bool_type(left_type))

   377

    return print_binary_expression(symbol->l_exp, symbol->r_exp, " || ");

   378

  if (search_expression_type->is_binary_type(left_type))

   379

    return print_binary_expression(symbol->l_exp, symbol->r_exp, " | ");

   380

  ERROR;

   381

  return NULL;

   382

}

   383

   384

void *visit(xor_expression_c *symbol) {

   385

  symbol_c *left_type = search_expression_type->get_type(symbol->l_exp);

   386

  symbol_c *right_type = search_expression_type->get_type(symbol->r_exp);

   387

  if (!search_expression_type->is_same_type(left_type, right_type))

   388

      ERROR;

   389

  if (search_expression_type->is_bool_type(left_type)) {

   390

    s4o.print("(");

   391

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

   392

    s4o.print(" && !");

   393

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

   394

    s4o.print(") || (!");

   395

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

   396

    s4o.print(" && ");

   397

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

   398

    s4o.print(")");

   399

    return NULL;

   400

  }

   401

  if (search_expression_type->is_binary_type(left_type))

   402

    return print_binary_expression(symbol->l_exp, symbol->r_exp, " ^ ");

   403

  ERROR;

   404

  return NULL;

   405

}

   406

   407

void *visit(and_expression_c *symbol) {

   408

  symbol_c *left_type = search_expression_type->get_type(symbol->l_exp);

   409

  symbol_c *right_type = search_expression_type->get_type(symbol->r_exp);

   410

  if (!search_expression_type->is_same_type(left_type, right_type))

   411

      ERROR;

   412

  if (search_expression_type->is_bool_type(left_type))

   413

    return print_binary_expression(symbol->l_exp, symbol->r_exp, " && ");

   414

  if (search_expression_type->is_binary_type(left_type))

   415

    return print_binary_expression(symbol->l_exp, symbol->r_exp, " & ");

   416

  ERROR;

   417

  return NULL;

   418

}

   419

   420

void *visit(equ_expression_c *symbol) {

   421

  symbol_c *left_type = search_expression_type->get_type(symbol->l_exp);

   422

  symbol_c *right_type = search_expression_type->get_type(symbol->r_exp);

   423

  if (!search_expression_type->is_same_type(left_type, right_type))

   424

      ERROR;

   425

  if (search_expression_type->is_time_type(left_type) ||

   426

      search_expression_type->is_string_type(left_type))

   427

    return print_compare_function("__eq_", left_type, symbol->l_exp, symbol->r_exp);

   428

  return print_binary_expression(symbol->l_exp, symbol->r_exp, " == ");

   429

}

   430

   431

void *visit(notequ_expression_c *symbol) {

   432

  symbol_c *left_type = search_expression_type->get_type(symbol->l_exp);

   433

  symbol_c *right_type = search_expression_type->get_type(symbol->r_exp);

   434

  if (!search_expression_type->is_same_type(left_type, right_type))

   435

      ERROR;

   436

  if (search_expression_type->is_time_type(left_type) ||

   437

      search_expression_type->is_string_type(left_type))

   438

    return print_compare_function("__ne_", left_type, symbol->l_exp, symbol->r_exp);

   439

  return print_binary_expression(symbol->l_exp, symbol->r_exp, " != ");

   440

}

   441

   442

void *visit(lt_expression_c *symbol) {

   443

  symbol_c *left_type = search_expression_type->get_type(symbol->l_exp);

   444

  symbol_c *right_type = search_expression_type->get_type(symbol->r_exp);

   445

  if (!search_expression_type->is_same_type(left_type, right_type))

   446

      ERROR;

   447

  if (search_expression_type->is_time_type(left_type) ||

   448

      search_expression_type->is_string_type(left_type))

   449

    return print_compare_function("__lt_", left_type, symbol->l_exp, symbol->r_exp);

   450

  if (!search_base_type.type_is_enumerated(left_type))

   451

    return print_binary_expression(symbol->l_exp, symbol->r_exp, " < ");

   452

  ERROR;

   453

  return NULL;

   454

}

   455

   456

void *visit(gt_expression_c *symbol) {

   457

  symbol_c *left_type = search_expression_type->get_type(symbol->l_exp);

   458

  symbol_c *right_type = search_expression_type->get_type(symbol->r_exp);

   459

  if (!search_expression_type->is_same_type(left_type, right_type))

   460

      ERROR;

   461

  if (search_expression_type->is_time_type(left_type) ||

   462

      search_expression_type->is_string_type(left_type))

   463

    return print_compare_function("__gt_", left_type, symbol->l_exp, symbol->r_exp);

   464

  if (!search_base_type.type_is_enumerated(left_type))

   465

    return print_binary_expression(symbol->l_exp, symbol->r_exp, " > ");

   466

  ERROR;

   467

  return NULL;

   468

}

   469

   470

void *visit(le_expression_c *symbol) {

   471

  symbol_c *left_type = search_expression_type->get_type(symbol->l_exp);

   472

  symbol_c *right_type = search_expression_type->get_type(symbol->r_exp);

   473

  if (!search_expression_type->is_same_type(left_type, right_type))

   474

      ERROR;

   475

  if (search_expression_type->is_time_type(left_type) ||

   476

      search_expression_type->is_string_type(left_type))

   477

    return print_compare_function("__le_", left_type, symbol->l_exp, symbol->r_exp);

   478

  if (!search_base_type.type_is_enumerated(left_type))

   479

    return print_binary_expression(symbol->l_exp, symbol->r_exp, " <= ");

   480

  ERROR;

   481

  return NULL;

   482

}

   483

   484

void *visit(ge_expression_c *symbol) {

   485

  symbol_c *left_type = search_expression_type->get_type(symbol->l_exp);

   486

  symbol_c *right_type = search_expression_type->get_type(symbol->r_exp);

   487

  if (!search_expression_type->is_same_type(left_type, right_type))

   488

      ERROR;

   489

  if (search_expression_type->is_time_type(left_type) ||

   490

      search_expression_type->is_string_type(left_type))

   491

    return print_compare_function("__ge_", left_type, symbol->l_exp, symbol->r_exp);

   492

  if (!search_base_type.type_is_enumerated(left_type))

   493

    return print_binary_expression(symbol->l_exp, symbol->r_exp, " >= ");

   494

  ERROR;

   495

  return NULL;

   496

}

   497

   498

void *visit(add_expression_c *symbol) {

   499

  symbol_c *left_type = search_expression_type->get_type(symbol->l_exp);

   500

	symbol_c *right_type = search_expression_type->get_type(symbol->r_exp);

   501

	if ((typeid(*left_type) == typeid(time_type_name_c) && typeid(*right_type) == typeid(time_type_name_c)) ||

   502

      (typeid(*left_type) == typeid(tod_type_name_c) && typeid(*right_type) == typeid(time_type_name_c)) ||

   503

      (typeid(*left_type) == typeid(dt_type_name_c) && typeid(*right_type) == typeid(time_type_name_c)))