1

/*

     2

 * (c) 2003 Mario de Sousa

     3

 *

     4

 * Offered to the public under the terms of the GNU General Public License

     5

 * as published by the Free Software Foundation; either version 2 of the

     6

 * License, or (at your option) any later version.

     7

 *

     8

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

     9

 * WITHOUT ANY WARRANTY; without even the implied warranty of

    10

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General

    11

 * Public License for more details.

    12

 *

    13

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

    14

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

    15

 */

    16

    17

/*

    18

 * An IEC 61131-3 IL and ST compiler.

    19

 *

    20

 * Based on the

    21

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

    22

 *

    23

 */

    24

    25

    26

/*

    27

 * Code to be included into the code generated by the 4th stage.

    28

 *

    29

 * This is part of the 4th stage that generates

    30

 * a ST and IL source program equivalent to the IL and ST

    31

 * code.

    32

 * This is expected to be used mainly in debuging the syntax

    33

 * and lexical parser, and as a starting point for other

    34

 * 4th stages.

    35

 */

    36

    37

    38

    39

    40

    41

    42

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

    43

#include <string>

    44

#include <iostream>

    45

#include <sstream>

    47

#include "generate_iec.hh"

    48

    49

#include "../stage4.hh"

    50

    51

    52

    53

    54

    55

    56

//class generate_iec_c: public iterator_visitor_c {

    57

class generate_iec_c: public visitor_c {

    58

  private:

    59

    stage4out_c &s4o;

    60

    61

    62

  public:

    63

    generate_iec_c(stage4out_c *s4o_ptr): s4o(*s4o_ptr) {}

    64

    ~generate_iec_c(void) {}

    65

    66

    67

  private:

    68

    69

void *print_token(token_c *token) {

    70

  return s4o.print(token->value);

    71

}

    72

    73

void *print_literal(symbol_c *type, symbol_c *value) {

    74

  type->accept(*this);

    75

  s4o.print("#");

    76

  value->accept(*this);

    77

  return NULL;

    78

}

    79

    80

void *print_list(list_c *list,

    81

			       std::string pre_elem_str = "",

    82

			       std::string inter_elem_str = "",

    83

			       std::string post_elem_str = "") {

    84

  if (list->n > 0) {

    85

    s4o.print(pre_elem_str);

    86

    list->elements[0]->accept(*this);

    87

  }

    88

    89

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

    90

    s4o.print(inter_elem_str);

    91

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

    92

  }

    93

    94

  if (list->n > 0)

    95

    s4o.print(post_elem_str);

    96

    97

  return NULL;

    98

}

    99

   100

   101

void *print_binary_expression(symbol_c *l_exp,

   102

			      symbol_c *r_exp,

   103

			      const char *operation) {

   104

  s4o.print("(");

   105

  l_exp->accept(*this);

   106

  s4o.print(operation);

   107

  r_exp->accept(*this);

   108

  s4o.print(")");

   109

  return NULL;

   110

}

   111

   112

void *print_unary_expression(symbol_c *exp,

   113

			     const char *operation) {

   114

  s4o.print(operation);

   115

  exp->accept(*this);

   116

  return NULL;

   117

}

   118

   119

   120

   121

   122

   123

  public:

   124

   125

/*  EN/ENO */

   127

void *visit(en_param_c *symbol) {

   128

  s4o.print("EN");

   129

  return NULL;

   130

}

   131

   132

void *visit(eno_param_c *symbol) {

   133

  s4o.print("ENO");

   134

  return NULL;

   135

}

   147

   148

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

   149

/* 2.1.6 Pragmas */

   150

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

   151

void *visit(pragma_c *symbol) {return print_token(symbol);}

   152

   153

   154

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

   155

/* B 0 - Programming Model */

   156

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

   157

void *visit(library_c *symbol) {return print_list(symbol);}

   158

   159

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

   160

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

   161

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

   162

void *visit(identifier_c *symbol) {return print_token(symbol);}

   163

   164

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

   165

/* B 1.2 - Constants */

   166

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

   167

   168

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

   169

/* B 1.2.1 - Numeric Literals */

   170

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

   171

void *visit(real_c *symbol) {return print_token(symbol);}

   172

void *visit(integer_c *symbol) {return print_token(symbol);}

   173

void *visit(binary_integer_c *symbol) {return print_token(symbol);}

   174

void *visit(octal_integer_c *symbol) {return print_token(symbol);}

   175

void *visit(hex_integer_c *symbol) {return print_token(symbol);}

   176

   177

void *visit(integer_literal_c *symbol) {return print_literal(symbol->type, symbol->value);}

   178

void *visit(real_literal_c *symbol) {return print_literal(symbol->type, symbol->value);}

   179

void *visit(bit_string_literal_c *symbol) {return print_literal(symbol->type, symbol->value);}

   180

void *visit(boolean_literal_c *symbol) {return print_literal(symbol->type, symbol->value);}

   181

void *visit(neg_literal_c *symbol) {return print_unary_expression(symbol->exp, "-");}

   182

   183

   184

/* helper class for boolean_literal_c */

   185

void *visit(boolean_true_c *symbol) {s4o.print(/*"TRUE"*/"1"); return NULL;}

   186

void *visit(boolean_false_c *symbol) {s4o.print(/*"FALSE"*/"0"); return NULL;}

   187

   188

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

   189

/* B.1.2.2   Character Strings */

   190

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

   191

void *visit(double_byte_character_string_c *symbol) {return print_token(symbol);}

   192

void *visit(single_byte_character_string_c *symbol) {return print_token(symbol);}

   193

   194

   195

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

   196

/* B 1.2.3 - Time Literals */

   197

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

   198

   199

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

   200

/* B 1.2.3.1 - Duration */

   201

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

   202

void *visit(neg_time_c *symbol) {s4o.print("-"); return NULL;}

   203

   204

void *visit(duration_c *symbol) {

   205

  s4o.print("TIME#");

   206

  if (symbol->neg != NULL)

   207

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

   208

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

   209

  return NULL;

   210

}

   211

   212

void *visit(fixed_point_c *symbol) {return print_token(symbol);}

   213

   214

void *visit(days_c *symbol) {

   215

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

   216

  s4o.print("d");

   217

  if (symbol->hours != NULL)

   218

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

   219

  return NULL;

   220

}

   221

   222

void *visit(hours_c *symbol) {

   223

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

   224

  s4o.print("h");

   225

  if (symbol->minutes != NULL)

   226

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

   227

  return NULL;

   228

}

   229

   230

void *visit(minutes_c *symbol) {

   231

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

   232

  s4o.print("m");

   233

  if (symbol->seconds != NULL)

   234

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

   235

  return NULL;

   236

}

   237

   238

void *visit(seconds_c *symbol) {

   239

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

   240

  s4o.print("s");

   241

  if (symbol->milliseconds != NULL)

   242

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

   243

  return NULL;

   244

}

   245

   246

void *visit(milliseconds_c *symbol) {

   247

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

   248

  s4o.print("ms");

   249

  return NULL;

   250

}

   251

   252

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

   253

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

   254

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

   255

   256

void *visit(time_of_day_c *symbol) {

   257

  s4o.print("TIME_OF_DAY#");

   258

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

   259

  return NULL;

   260

}

   261

   262

void *visit(daytime_c *symbol) {

   263

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

   264

  s4o.print(":");

   265

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

   266

  s4o.print(":");

   267

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

   268

  return NULL;

   269

}

   270

   271

   272

void *visit(date_c *symbol) {

   273

  s4o.print("DATE#");

   274

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

   275

  return NULL;

   276

}

   277

   278

void *visit(date_literal_c *symbol) {

   279

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

   280

  s4o.print("-");

   281

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

   282

  s4o.print("-");

   283

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

   284

  return NULL;

   285

}

   286

   287

void *visit(date_and_time_c *symbol) {

   288

  s4o.print("DATE_AND_TIME#");

   289

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

   290

  s4o.print("-");

   291

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

   292

  return NULL;

   293

}

   294

   295

   296

   297

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

   298

/* B 1.3.1 - Elementary Data Types */

   299

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

   300

void *visit(time_type_name_c *symbol) {s4o.print("TIME"); return NULL;}

   301

void *visit(bool_type_name_c *symbol) {s4o.print("BOOL"); return NULL;}

   302

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

   303

/* whether we are suporting safe extensions           */

   304

/* as defined in PLCopen - Technical Committee 5      */

   305

/* Safety Software Technical Specification,           */

   306

/* Part 1: Concepts and Function Blocks,              */

   307

/* Version 1.0 – Official Release                     */

   308

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

   309

void *visit(safebool_type_name_c *symbol) {s4o.print("SAFEBOOL"); return NULL;}

   310

void *visit(sint_type_name_c *symbol) {s4o.print("SINT"); return NULL;}

   311

void *visit(int_type_name_c *symbol) {s4o.print("INT"); return NULL;}

   312

void *visit(dint_type_name_c *symbol) {s4o.print("DINT"); return NULL;}

   313

void *visit(lint_type_name_c *symbol) {s4o.print("LINT"); return NULL;}

   314

void *visit(usint_type_name_c *symbol) {s4o.print("USINT"); return NULL;}

   315

void *visit(uint_type_name_c *symbol) {s4o.print("UINT"); return NULL;}

   316

void *visit(udint_type_name_c *symbol) {s4o.print("UDINT"); return NULL;}

   317

void *visit(ulint_type_name_c *symbol) {s4o.print("ULINT"); return NULL;}

   318

void *visit(real_type_name_c *symbol) {s4o.print("REAL"); return NULL;}

   319

void *visit(lreal_type_name_c *symbol) {s4o.print("LREAL"); return NULL;}

   320

void *visit(date_type_name_c *symbol) {s4o.print("DATE"); return NULL;}

   321

void *visit(tod_type_name_c *symbol) {s4o.print("TOD"); return NULL;}

   322

void *visit(dt_type_name_c *symbol) {s4o.print("DT"); return NULL;}

   323

void *visit(byte_type_name_c *symbol) {s4o.print("BYTE"); return NULL;}

   324

void *visit(word_type_name_c *symbol) {s4o.print("WORD"); return NULL;}

   325

void *visit(lword_type_name_c *symbol) {s4o.print("LWORD"); return NULL;}

   326

void *visit(dword_type_name_c *symbol) {s4o.print("DWORD"); return NULL;}

   327

void *visit(string_type_name_c *symbol) {s4o.print("STRING"); return NULL;}

   328

void *visit(wstring_type_name_c *symbol) {s4o.print("WSTRING"); return NULL;}

   330

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

   331

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

   333

   334

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

   335

/* B 1.3.3 - Derived data types */

   336

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

   337

/*  TYPE type_declaration_list END_TYPE */

   338

void *visit(data_type_declaration_c *symbol) {

   339

  s4o.print("TYPE\n");

   340

  s4o.indent_right();

   341

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

   342

  s4o.indent_left();

   343

  s4o.print("END_TYPE\n\n\n");

   344

  return NULL;

   345

}

   346

   347

   348

/* helper symbol for data_type_declaration */

   349

/*| type_declaration_list type_declaration ';' */

   350

void *visit(type_declaration_list_c *symbol) {

   351

  return print_list(symbol, s4o.indent_spaces, ";\n" + s4o.indent_spaces, ";\n");

   352

}

   353

   354

   355

/*  simple_type_name ':' simple_spec_init */

   356

void *visit(simple_type_declaration_c *symbol) {

   357

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

   358

  s4o.print(" : ");

   359

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

   360

  return NULL;

   361

}

   362

   363

/* simple_specification ASSIGN constant */

   364

void *visit(simple_spec_init_c *symbol) {

   365

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

   366

  if (symbol->constant != NULL) {

   367

    s4o.print(" := ");

   368

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

   369

  }

   370

  return NULL;

   371

}

   372

   373

/*  subrange_type_name ':' subrange_spec_init */

   374

void *visit(subrange_type_declaration_c *symbol) {

   375

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

   376

  s4o.print(" : ");

   377

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

   378

  return NULL;

   379

}

   380

   381

/* subrange_specification ASSIGN signed_integer */

   382

void *visit(subrange_spec_init_c *symbol) {

   383

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

   384

  if (symbol->signed_integer != NULL) {

   385

    s4o.print(" := ");

   386

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

   387

  }

   388

  return NULL;

   389

}

   390

   391

/*  integer_type_name '(' subrange')' */

   392

void *visit(subrange_specification_c *symbol) {

   393

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

   394

  if (symbol->subrange != NULL) {

   395

    s4o.print("(");

   396

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

   397

    s4o.print(")");

   398

  }

   399

  return NULL;

   400

}

   401

   402

/*  signed_integer DOTDOT signed_integer */

   403

void *visit(subrange_c *symbol) {

   404

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

   405

  s4o.print(" .. ");

   406

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

   407

  return NULL;

   408

}

   409

   410

/*  enumerated_type_name ':' enumerated_spec_init */

   411

void *visit(enumerated_type_declaration_c *symbol) {

   412

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

   413

  s4o.print(" : ");

   414

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

   415

  return NULL;

   416

}

   417

   418

/* enumerated_specification ASSIGN enumerated_value */

   419

void *visit(enumerated_spec_init_c *symbol) {

   420

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

   421

  if (symbol->enumerated_value != NULL) {

   422

    s4o.print(" := ");

   423

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

   424

  }

   425

  return NULL;

   426

}

   427

   428

/* helper symbol for enumerated_specification->enumerated_spec_init */

   429

/* enumerated_value_list ',' enumerated_value */

   430

void *visit(enumerated_value_list_c *symbol) {print_list(symbol, "(", ", ", ")"); return NULL;}

   431

   432

/* enumerated_type_name '#' identifier */

   433

void *visit(enumerated_value_c *symbol) {

   434

  if (symbol->type != NULL) {

   435

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

   436

    s4o.print("#");

   437

  }

   438

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

   439

  return NULL;

   440

}

   441

   442

/*  identifier ':' array_spec_init */

   443

void *visit(array_type_declaration_c *symbol) {

   444

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

   445

  s4o.print(" : ");

   446

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

   447

  return NULL;

   448

}

   449

   450

/* array_specification [ASSIGN array_initialization} */

   451

/* array_initialization may be NULL ! */

   452

void *visit(array_spec_init_c *symbol) {

   453

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

   454

  if (symbol->array_initialization != NULL) {

   455

    s4o.print(" := ");

   456

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

   457

  }

   458

  return NULL;

   459

}

   460

   461

/* ARRAY '[' array_subrange_list ']' OF non_generic_type_name */

   462

void *visit(array_specification_c *symbol) {

   463

  s4o.print("ARRAY [");

   464

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

   465

  s4o.print("] OF ");

   466

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

   467

  return NULL;

   468

}

   469

   470

/* helper symbol for array_specification */

   471

/* array_subrange_list ',' subrange */

   472

void *visit(array_subrange_list_c *symbol) {print_list(symbol, "", ", "); return NULL;}

   473

   474

/* helper symbol for array_initialization */

   475

/* array_initial_elements_list ',' array_initial_elements */

   476

void *visit(array_initial_elements_list_c *symbol) {print_list(symbol, "[", ", ", "]"); return NULL;}

   477

   478

/* integer '(' [array_initial_element] ')' */

   479

/* array_initial_element may be NULL ! */

   480

void *visit(array_initial_elements_c *symbol) {

   481

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

   482

  s4o.print("(");

   483

  if (symbol->array_initial_element != NULL)

   484

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

   485

  s4o.print(")");

   486

  return NULL;

   487

}

   488

   489

/*  structure_type_name ':' structure_specification */

   490

void *visit(structure_type_declaration_c *symbol) {

   491

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

   492

  s4o.print(" : ");

   493

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

   494

  return NULL;

   495

}

   496

   497

/* structure_type_name ASSIGN structure_initialization */

   498

/* structure_initialization may be NULL ! */

   499

void *visit(initialized_structure_c *symbol) {

   500

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

   501

  if (symbol->structure_initialization != NULL) {

   502

    s4o.print(" := ");

   503

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

   504

  }

   505

  return NULL;

   506

}

   507

   508

/* helper symbol for structure_declaration */

   509

/* structure_declaration:  STRUCT structure_element_declaration_list END_STRUCT */

   510

/* structure_element_declaration_list structure_element_declaration ';' */

   511

void *visit(structure_element_declaration_list_c *symbol) {

   512

  s4o.print("STRUCT\n");

   513

  s4o.indent_right();

   514

  print_list(symbol, s4o.indent_spaces, ";\n" + s4o.indent_spaces, ";\n" + s4o.indent_spaces);

   515

  s4o.print("END_STRUCT");

   516

  s4o.indent_left();

   517

  return NULL;

   518

}

   519

   520

/*  structure_element_name ':' *_spec_init */

   521

void *visit(structure_element_declaration_c *symbol) {

   522

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

   523

  s4o.print(" : ");

   524

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

   525

  return NULL;