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

   320

   321

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

   322

/* B 1.3.3 - Derived data types */

   323

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

   324

/*  TYPE type_declaration_list END_TYPE */

   325

void *visit(data_type_declaration_c *symbol) {

   326

  s4o.print("TYPE\n");

   327

  s4o.indent_right();

   328

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

   329

  s4o.indent_left();

   330

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

   331

  return NULL;

   332

}

   333

   334

   335

/* helper symbol for data_type_declaration */

   336

/*| type_declaration_list type_declaration ';' */

   337

void *visit(type_declaration_list_c *symbol) {

   338

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

   339

}

   340

   341

   342

/*  simple_type_name ':' simple_spec_init */

   343

void *visit(simple_type_declaration_c *symbol) {

   344

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

   345

  s4o.print(" : ");

   346

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

   347

  return NULL;

   348

}

   349

   350

/* simple_specification ASSIGN constant */

   351

void *visit(simple_spec_init_c *symbol) {

   352

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

   353

  if (symbol->constant != NULL) {

   354

    s4o.print(" := ");

   355

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

   356

  }

   357

  return NULL;

   358

}

   359

   360

/*  subrange_type_name ':' subrange_spec_init */

   361

void *visit(subrange_type_declaration_c *symbol) {

   362

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

   363

  s4o.print(" : ");

   364

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

   365

  return NULL;

   366

}

   367

   368

/* subrange_specification ASSIGN signed_integer */

   369

void *visit(subrange_spec_init_c *symbol) {

   370

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

   371

  if (symbol->signed_integer != NULL) {

   372

    s4o.print(" := ");

   373

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

   374

  }

   375

  return NULL;

   376

}

   377

   378

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

   379

void *visit(subrange_specification_c *symbol) {

   380

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

   381

  if (symbol->subrange != NULL) {

   382

    s4o.print("(");

   383

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

   384

    s4o.print(")");

   385

  }

   386

  return NULL;

   387

}

   388

   389

/*  signed_integer DOTDOT signed_integer */

   390

void *visit(subrange_c *symbol) {

   391

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

   392

  s4o.print(" .. ");

   393

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

   394

  return NULL;

   395

}

   396

   397

/*  enumerated_type_name ':' enumerated_spec_init */

   398

void *visit(enumerated_type_declaration_c *symbol) {

   399

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

   400

  s4o.print(" : ");

   401

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

   402

  return NULL;

   403

}

   404

   405

/* enumerated_specification ASSIGN enumerated_value */

   406

void *visit(enumerated_spec_init_c *symbol) {

   407

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

   408

  if (symbol->enumerated_value != NULL) {

   409

    s4o.print(" := ");

   410

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

   411

  }

   412

  return NULL;

   413

}

   414

   415

/* helper symbol for enumerated_specification->enumerated_spec_init */

   416

/* enumerated_value_list ',' enumerated_value */

   417

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

   418

   419

/* enumerated_type_name '#' identifier */

   420

void *visit(enumerated_value_c *symbol) {

   421

  if (symbol->type != NULL) {

   422

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

   423

    s4o.print("#");

   424

  }

   425

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

   426

  return NULL;

   427

}

   428

   429

/*  identifier ':' array_spec_init */

   430

void *visit(array_type_declaration_c *symbol) {

   431

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

   432

  s4o.print(" : ");

   433

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

   434

  return NULL;

   435

}

   436

   437

/* array_specification [ASSIGN array_initialization} */

   438

/* array_initialization may be NULL ! */

   439

void *visit(array_spec_init_c *symbol) {

   440

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

   441

  if (symbol->array_initialization != NULL) {

   442

    s4o.print(" := ");

   443

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

   444

  }

   445

  return NULL;

   446

}

   447

   448

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

   449

void *visit(array_specification_c *symbol) {

   450

  s4o.print("ARRAY [");

   451

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

   452

  s4o.print("] OF ");

   453

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

   454

  return NULL;

   455

}

   456

   457

/* helper symbol for array_specification */

   458

/* array_subrange_list ',' subrange */

   459

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

   460

   461

/* helper symbol for array_initialization */

   462

/* array_initial_elements_list ',' array_initial_elements */

   463

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

   464

   465

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

   466

/* array_initial_element may be NULL ! */

   467

void *visit(array_initial_elements_c *symbol) {

   468

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

   469

  s4o.print("(");

   470

  if (symbol->array_initial_element != NULL)

   471

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

   472

  s4o.print(")");

   473

  return NULL;

   474

}

   475

   476

/*  structure_type_name ':' structure_specification */

   477

void *visit(structure_type_declaration_c *symbol) {

   478

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

   479

  s4o.print(" : ");

   480

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

   481

  return NULL;

   482

}

   483

   484

/* structure_type_name ASSIGN structure_initialization */

   485

/* structure_initialization may be NULL ! */

   486

void *visit(initialized_structure_c *symbol) {

   487

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

   488

  if (symbol->structure_initialization != NULL) {

   489

    s4o.print(" := ");

   490

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

   491

  }

   492

  return NULL;

   493

}

   494

   495

/* helper symbol for structure_declaration */

   496

/* structure_declaration:  STRUCT structure_element_declaration_list END_STRUCT */

   497

/* structure_element_declaration_list structure_element_declaration ';' */

   498

void *visit(structure_element_declaration_list_c *symbol) {

   499

  s4o.print("STRUCT\n");

   500

  s4o.indent_right();

   501

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

   502

  s4o.print("END_STRUCT");

   503

  s4o.indent_left();

   504

  return NULL;

   505

}

   506

   507

/*  structure_element_name ':' *_spec_init */

   508

void *visit(structure_element_declaration_c *symbol) {

   509

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

   510

  s4o.print(" : ");

   511

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

   512

  return NULL;

   513

}

   514

   515

/* helper symbol for structure_initialization */

   516

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

   517

/* structure_element_initialization_list ',' structure_element_initialization */

   518

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

   519

   520

/*  structure_element_name ASSIGN value */

   521

void *visit(structure_element_initialization_c *symbol) {

   522

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

   523

  s4o.print(" := ");

   524

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

   525

  return NULL;

   526

}