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>

    46

#include "generate_iec.hh"

    47

    48

#include "../stage4.hh"

    49

    50

    51

    52

    53

    54

    55

//class generate_iec_c: public iterator_visitor_c {

    56

class generate_iec_c: public visitor_c {

    57

  private:

    58

    stage4out_c &s4o;

    59

    60

    61

  public:

    62

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

    63

    ~generate_iec_c(void) {}

    64

    65

    66

  private:

    67

    68

void *print_token(token_c *token) {

    69

  return s4o.print(token->value);

    70

}

    71

    72

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

    73

  type->accept(*this);

    74

  s4o.print("#");

    75

  value->accept(*this);

    76

  return NULL;

    77

}

    78

    79

void *print_list(list_c *list,

    80

			       std::string pre_elem_str = "",

    81

			       std::string inter_elem_str = "",

    82

			       std::string post_elem_str = "") {

    83

  if (list->n > 0) {

    84

    s4o.print(pre_elem_str);

    85

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

    86

  }

    87

    88

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

    89

    s4o.print(inter_elem_str);

    90

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

    91

  }

    92

    93

  if (list->n > 0)

    94

    s4o.print(post_elem_str);

    95

    96

  return NULL;

    97

}

    98

    99

   100

void *print_binary_expression(symbol_c *l_exp,

   101

			      symbol_c *r_exp,

   102

			      const char *operation) {

   103

  s4o.print("(");

   104

  l_exp->accept(*this);

   105

  s4o.print(operation);

   106

  r_exp->accept(*this);

   107

  s4o.print(")");

   108

  return NULL;

   109

}

   110

   111

void *print_unary_expression(symbol_c *exp,

   112

			     const char *operation) {

   113

  s4o.print(operation);

   114

  exp->accept(*this);

   115

  return NULL;

   116

}

   117

   118

   119

   120

   121

   122

  public:

   123

   124

/*  EN/ENO */

   125

void *visit(en_param_c *symbol) {

   126

  s4o.print("EN");

   127

  return NULL;

   128

}

   129

   130

void *visit(eno_param_c *symbol) {

   131

  s4o.print("ENO");

   132

  return NULL;

   133

}

   134

   135

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

   136

/* 2.1.6 Pragmas */

   137

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

   138

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

   139

   140

   141

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

   142

/* B 0 - Programming Model */

   143

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

   144

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

   145

   146

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

   147

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

   148

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

   149

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

   150

   151

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

   152

/* B 1.2 - Constants */

   153

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

   154

   155

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

   156

/* B 1.2.1 - Numeric Literals */

   157

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

   158

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

   159

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

   160

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

   161

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

   162

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

   163

   164

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

   165

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

   166

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

   167

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

   168

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

   169

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

   170

   171

   172

/* helper class for boolean_literal_c */

   173

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

   174

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

   175

   176

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

   177

/* B.1.2.2   Character Strings */

   178

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

   179

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

   180

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

   181

   182

   183

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

   184

/* B 1.2.3 - Time Literals */

   185

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

   186

   187

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

   188

/* B 1.2.3.1 - Duration */

   189

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

   190

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

   191

   192

void *visit(duration_c *symbol) {

   193

  s4o.print("TIME#");

   194

  if (symbol->neg != NULL)

   195

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

   196

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

   197

  return NULL;

   198

}

   199

   200

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

   201

   202

void *visit(days_c *symbol) {

   203

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

   204

  s4o.print("d");

   205

  if (symbol->hours != NULL)

   206

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

   207

  return NULL;

   208

}

   209

   210

void *visit(hours_c *symbol) {

   211

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

   212

  s4o.print("h");

   213

  if (symbol->minutes != NULL)

   214

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

   215

  return NULL;

   216

}

   217

   218

void *visit(minutes_c *symbol) {

   219

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

   220

  s4o.print("m");

   221

  if (symbol->seconds != NULL)

   222

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

   223

  return NULL;

   224

}

   225

   226

void *visit(seconds_c *symbol) {

   227

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

   228

  s4o.print("s");

   229

  if (symbol->milliseconds != NULL)

   230

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

   231

  return NULL;

   232

}

   233

   234

void *visit(milliseconds_c *symbol) {

   235

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

   236

  s4o.print("ms");

   237

  return NULL;

   238

}

   239

   240

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

   241

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

   242

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

   243

   244

void *visit(time_of_day_c *symbol) {

   245

  s4o.print("TIME_OF_DAY#");

   246

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

   247

  return NULL;

   248

}

   249

   250

void *visit(daytime_c *symbol) {

   251

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

   252

  s4o.print(":");

   253

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

   254

  s4o.print(":");

   255

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

   256

  return NULL;

   257

}

   258

   259

   260

void *visit(date_c *symbol) {

   261

  s4o.print("DATE#");

   262

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

   263

  return NULL;

   264

}

   265

   266

void *visit(date_literal_c *symbol) {

   267

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

   268

  s4o.print("-");

   269

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

   270

  s4o.print("-");

   271

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

   272

  return NULL;

   273

}

   274

   275

void *visit(date_and_time_c *symbol) {

   276

  s4o.print("DATE_AND_TIME#");

   277

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

   278

  s4o.print("-");

   279

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

   280

  return NULL;

   281

}

   282

   283

   284

   285

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

   286

/* B 1.3.1 - Elementary Data Types */

   287

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

   288

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

   289

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

   290

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

   291

/* whether we are suporting safe extensions           */

   292

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

   293

/* Safety Software Technical Specification,           */

   294

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

   295

/* Version 1.0 – Official Release                     */

   296

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

   297

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

   298

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

   299

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

   300

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

   301

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

   302

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

   303

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

   304

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

   305

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

   306

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

   307

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

   308

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

   309

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

   310

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

   311

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

   312

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

   313

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

   314

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

   315

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

   316

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

   317

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

   318

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

   319

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

   320

   321

   322

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

   323

/* B 1.3.3 - Derived data types */

   324

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

   325

/*  TYPE type_declaration_list END_TYPE */

   326

void *visit(data_type_declaration_c *symbol) {

   327

  s4o.print("TYPE\n");

   328

  s4o.indent_right();

   329

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

   330

  s4o.indent_left();

   331

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

   332

  return NULL;

   333

}

   334

   335

   336

/* helper symbol for data_type_declaration */

   337

/*| type_declaration_list type_declaration ';' */

   338

void *visit(type_declaration_list_c *symbol) {

   339

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

   340

}

   341

   342

   343

/*  simple_type_name ':' simple_spec_init */

   344

void *visit(simple_type_declaration_c *symbol) {

   345

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

   346

  s4o.print(" : ");

   347

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

   348

  return NULL;

   349

}

   350

   351

/* simple_specification ASSIGN constant */

   352

void *visit(simple_spec_init_c *symbol) {

   353

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

   354

  if (symbol->constant != NULL) {

   355

    s4o.print(" := ");

   356

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

   357

  }

   358

  return NULL;

   359

}

   360

   361

/*  subrange_type_name ':' subrange_spec_init */

   362

void *visit(subrange_type_declaration_c *symbol) {

   363

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

   364

  s4o.print(" : ");

   365

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

   366

  return NULL;

   367

}

   368

   369

/* subrange_specification ASSIGN signed_integer */

   370

void *visit(subrange_spec_init_c *symbol) {

   371

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

   372

  if (symbol->signed_integer != NULL) {

   373

    s4o.print(" := ");

   374

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

   375

  }

   376

  return NULL;

   377

}

   378

   379

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

   380

void *visit(subrange_specification_c *symbol) {

   381

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

   382

  if (symbol->subrange != NULL) {

   383

    s4o.print("(");

   384

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

   385

    s4o.print(")");

   386

  }

   387

  return NULL;

   388

}

   389

   390

/*  signed_integer DOTDOT signed_integer */

   391

void *visit(subrange_c *symbol) {

   392

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

   393

  s4o.print(" .. ");

   394

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

   395

  return NULL;

   396

}

   397

   398

/*  enumerated_type_name ':' enumerated_spec_init */

   399

void *visit(enumerated_type_declaration_c *symbol) {

   400

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

   401

  s4o.print(" : ");

   402

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

   403

  return NULL;

   404

}

   405

   406

/* enumerated_specification ASSIGN enumerated_value */

   407

void *visit(enumerated_spec_init_c *symbol) {

   408

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

   409

  if (symbol->enumerated_value != NULL) {

   410

    s4o.print(" := ");

   411

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

   412

  }

   413

  return NULL;

   414

}

   415

   416

/* helper symbol for enumerated_specification->enumerated_spec_init */

   417

/* enumerated_value_list ',' enumerated_value */

   418

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

   419

   420

/* enumerated_type_name '#' identifier */

   421

void *visit(enumerated_value_c *symbol) {

   422

  if (symbol->type != NULL) {

   423

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

   424

    s4o.print("#");

   425

  }

   426

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

   427

  return NULL;

   428

}

   429

   430

/*  identifier ':' array_spec_init */

   431

void *visit(array_type_declaration_c *symbol) {

   432

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

   433

  s4o.print(" : ");

   434

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

   435

  return NULL;

   436

}

   437

   438

/* array_specification [ASSIGN array_initialization} */

   439

/* array_initialization may be NULL ! */

   440

void *visit(array_spec_init_c *symbol) {

   441

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

   442

  if (symbol->array_initialization != NULL) {

   443

    s4o.print(" := ");

   444

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

   445

  }

   446

  return NULL;

   447

}

   448

   449

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

   450

void *visit(array_specification_c *symbol) {

   451

  s4o.print("ARRAY [");

   452

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

   453

  s4o.print("] OF ");

   454

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

   455

  return NULL;

   456

}

   457

   458

/* helper symbol for array_specification */

   459

/* array_subrange_list ',' subrange */

   460

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

   461

   462

/* helper symbol for array_initialization */

   463

/* array_initial_elements_list ',' array_initial_elements */

   464

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

   465

   466

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

   467

/* array_initial_element may be NULL ! */

   468

void *visit(array_initial_elements_c *symbol) {

   469

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

   470

  s4o.print("(");

   471

  if (symbol->array_initial_element != NULL)

   472

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

   473

  s4o.print(")");

   474

  return NULL;

   475

}

   476

   477

/*  structure_type_name ':' structure_specification */

   478

void *visit(structure_type_declaration_c *symbol) {

   479

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

   480

  s4o.print(" : ");

   481

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

   482

  return NULL;

   483

}

   484

   485

/* structure_type_name ASSIGN structure_initialization */

   486

/* structure_initialization may be NULL ! */

   487

void *visit(initialized_structure_c *symbol) {

   488

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

   489

  if (symbol->structure_initialization != NULL) {

   490

    s4o.print(" := ");

   491

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

   492

  }

   493

  return NULL;

   494

}

   495

   496

/* helper symbol for structure_declaration */

   497

/* structure_declaration:  STRUCT structure_element_declaration_list END_STRUCT */

   498

/* structure_element_declaration_list structure_element_declaration ';' */

   499

void *visit(structure_element_declaration_list_c *symbol) {

   500

  s4o.print("STRUCT\n");

   501

  s4o.indent_right();

   502

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

   503

  s4o.print("END_STRUCT");

   504

  s4o.indent_left();

   505

  return NULL;

   506

}

   507

   508

/*  structure_element_name ':' *_spec_init */

   509

void *visit(structure_element_declaration_c *symbol) {

   510

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

   511

  s4o.print(" : ");

   512

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

   513

  return NULL;

   514

}

   515

   516

/* helper symbol for structure_initialization */

   517

/* structure_initialization: '(' structure_element_initialization_list ')' */

   518

/* structure_element_initialization_list ',' structure_element_initialization */

   519

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

   520

   521

/*  structure_element_name ASSIGN value */

   522

void *visit(structure_element_initialization_c *symbol) {

   523

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

   524

  s4o.print(" := ");

   525

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

   526

  return NULL;