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

 * Stage 2

    27

 * =======

    28

 *

    29

 *  This file contains the syntax definition of the textual

    30

 *  languages IL and ST. The syntax parser, comprising the

    31

 *  2nd stage of the overall compiler, is generated by runing

    32

 *  bison on this file.

    33

 */

    34

    35

    36

    37

    38

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

    39

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

    40

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

    41

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

    42

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

    43

/*******   The following syntax does not have any conflicts.    *******/

    44

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

    45

/*******   P L E A S E    K E E P    I T    T H A T    W A Y !  *******/

    46

/*******   ===================================================  *******/

    47

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

    48

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

    49

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

    50

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

    51

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

    52

    53

    54

    55

    56

%{

    57

#include <string.h>	/* required for strdup()  */

    58

    59

    60

/* declare the token parser generated by flex... */

    61

int yylex(void);

    62

    63

/* declare the error handler defined at the end of this file */

    64

void yyerror (const char *error_msg);

    65

    66

/* produce a more verbose parsing error message */

    67

#define YYERROR_VERBOSE

    68

    69

/* Include debuging code.

    70

 * Printing of debug info must then be activated by setting

    71

 * the variable yydebug to 1.

    72

 */

    73

#define YYDEBUG 0

    74

    75

    76

/* file with declaration of absyntax classes... */

    77

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

    78

    79

/* file with declaration of token constants. Generated by bison! */

    80

#include "iec.y.hh"

    81

    82

/* file with the declarations of symbol tables... */

    83

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

    84

    85

    86

/* an ugly hack!!

    87

 * We will probably not need it when we decide

    88

 *  to cut down the abstract syntax down to size.

    89

 *  We keep it as it is until we get to write

    90

 *  stages 3 and 4 of the compiler. Who knows,

    91

 *  we might just find out that we really do need

    92

 *  the abstract syntax tree to stay as it is

    93

 *  afterall!

    94

 */

    95

/* for each element <elem> in list_c * <list>

    96

 * execute the code <code>

    97

 */

    98

#define FOR_EACH_ELEMENT(elem, list, code) {		\

    99

  symbol_c *elem;					\

   100

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

   101

    elem = list->elements[i];				\

   102

    code;						\

   103

  }							\

   104

}

   105

   106

   107

/* A macro for printing out internal parser errors... */

   108

#define ERROR error_exit(__FILE__,__LINE__)

   109

/* function defined in main.cc */

   110

extern void error_exit(const char *file_name, int line_no);

   111

   112

   113

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

   114

/* The global symbol tables...   */

   115

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

   116

/* NOTE: declared static because they are not accessed

   117

 *       directly by the lexical parser (flex), but rather

   118

 *       through the function get_identifier_token()

   119

 */

   120

/* A symbol table to store all the library elements */

   121

/* e.g.: <function_name , function_decl>

   122

 *       <fb_name , fb_decl>

   123

 *       <type_name , type_decl>

   124

 *       <program_name , program_decl>

   125

 *       <configuration_name , configuration_decl>

   126

 */

   127

static symtable_c<int, BOGUS_TOKEN_ID> library_element_symtable;

   128

   129

/* A symbol table to store the declared variables of

   130

 * the function currently being parsed...

   131

 */

   132

static symtable_c<int, BOGUS_TOKEN_ID> variable_name_symtable;

   133

   134

   135

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

   136

/* global variables...   */

   137

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

   138

static symbol_c *tree_root = NULL;

   139

   140

/* The name of the file currently being parsed...

   141

 * Note that flex accesses and updates this global variable

   142

 * apropriately whenever it comes across an (*#include <filename> *)

   143

 * directive...

   144

 */

   145

const char *current_filename = NULL;

   146

   147

/* A global flag used to tell the parser if overloaded funtions should be allowed.

   148

 * The IEC 61131-3 standard allows overloaded funtions in the standard library,

   149

 * but disallows them in user code...

   150

 */

   151

bool allow_function_overloading = false;

   152

   153

   154

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

   155

/* forward declarations */

   156

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

   157

/* The functions declared here are defined at the end of this file... */

   158

   159

/* Convert an il_operator_c into an identifier_c */

   160

symbol_c *il_operator_c_2_identifier_c(symbol_c *il_operator);

   161

   162

/* print an error message */

   163

void print_err_msg(const char *filename, int lineno, const char *additional_error_msg);

   164

   165

   166

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

   167

/* forward declarations */

   168

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

   169

/* The functions declared here are defined in iec.flex... */

   170

void print_include_stack(void);

   171

   172

   173

%}

   174

   175

   176

   177

%union {

   178

    symbol_c 	*leaf;

   179

    list_c	*list;

   180

    char 	*ID;	/* token value */

   181

    struct {

   182

      symbol_c	*first;

   183

      symbol_c	*second;

   184

    } double_symbol; /* used by il_simple_operator_clash_il_operand */

   185

}

   186

   187

   188

   189

   190

   191

   192

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

   193

/* Prelimenary constructs... */

   194

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

   195

%type <leaf> start

   196

   197

%type <leaf>	any_identifier

   198

   199

%token <ID>	prev_declared_variable_name_token

   200

%token <ID>	prev_declared_fb_name_token

   201

%type <leaf>	prev_declared_variable_name

   202

%type <leaf>	prev_declared_fb_name

   203

   204

%token  <ID>	prev_declared_simple_type_name_token

   205

%token  <ID>	prev_declared_subrange_type_name_token

   206

%token  <ID>	prev_declared_enumerated_type_name_token

   207

%token  <ID>	prev_declared_array_type_name_token

   208

%token  <ID>	prev_declared_structure_type_name_token

   209

%token  <ID>	prev_declared_string_type_name_token

   210

   211

%type  <leaf>	prev_declared_simple_type_name

   212

%type  <leaf>	prev_declared_subrange_type_name

   213

%type  <leaf>	prev_declared_enumerated_type_name

   214

%type  <leaf>	prev_declared_array_type_name

   215

%type  <leaf>	prev_declared_structure_type_name

   216

%type  <leaf>	prev_declared_string_type_name

   217

   218

%token <ID>	prev_declared_derived_function_name_token

   219

%token <ID>	prev_declared_derived_function_block_name_token

   220

%token <ID>	prev_declared_program_type_name_token

   221

%type  <leaf>	prev_declared_derived_function_name

   222

%type  <leaf>	prev_declared_derived_function_block_name

   223

%type  <leaf>	prev_declared_program_type_name

   224

   225

   226

/* A bogus token that, in principle, flex MUST NEVER generate */

   227

/* USE 1:

   228

 * ======

   229

 * This token is currently also being used as the default

   230

 * initialisation value of the token_id member in

   231

 * the symbol_c base class.

   232

 *

   233

 * USE 2

   234

 * =====

   235

 * This token may also be used in the future to remove

   236

 * mysterious reduce/reduce conflicts due to the fact

   237

 * that our grammar may not be LALR(1) but merely LR(1).

   238

 * This means that bison cannot handle it without some

   239

 * caoxing from ourselves. We will then need this token

   240

 * to do the coaxing...

   241

 */

   242

%token BOGUS_TOKEN_ID

   243

   244

   245

/* The pragmas... */

   246

%token <ID>	pragma_token

   247

%type <leaf>	pragma

   248

   249

   250

/* Where do these tokens belong ?? */

   251

/* TODO: get the syntax parser to handle these tokens... */

   252

%token	EN

   253

%token	ENO

   254

   255

   256

   257

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

   258

/* B 0 - Programming Model */

   259

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

   260

%type <list>	library

   261

%type <leaf>	library_element_declaration

   262

   263

   264

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

   265

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

   266

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

   267

/* Done totally within flex...

   268

  letter

   269

  digit

   270

  octal_digit

   271

  hex_digit

   272

*/

   273

%token <ID>	identifier_token

   274

%type  <leaf>	identifier

   275

   276

   277

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

   278

/* B 1.2 - Constants */

   279

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

   280

%type <leaf>	constant

   281

/* a helper symbol for expression */

   282

%type  <leaf> non_negative_constant

   283

   284

   285

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

   286

/* B 1.2.1 - Numeric Literals */

   287

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

   288

/* Done totally within flex...

   289

  bit

   290

*/

   291

%type  <leaf> numeric_literal

   292

/* helper symbol for non_negative_constant */

   293

%type  <leaf> non_negative_numeric_literal

   294

%type  <leaf> integer_literal

   295

%type  <leaf> signed_integer

   296

/* a helper symbol for non_negative_constant */

   297

%type  <leaf> non_negative_signed_integer

   298

%token <ID>   integer_token

   299

%type  <leaf> integer

   300

%token <ID>   binary_integer_token

   301

%type  <leaf> binary_integer

   302

%token <ID>   octal_integer_token

   303

%type  <leaf> octal_integer

   304

%token <ID>   hex_integer_token

   305

%type  <leaf> hex_integer

   306

%token <ID>   real_token

   307

%type  <leaf> real

   308

%type  <leaf> signed_real

   309

/* helper symbol for non_negative_real_literal */

   310

%type  <leaf> non_negative_signed_real

   311

%type  <leaf> real_literal

   312

/* helper symbol for non_negative_numeric_literal */

   313

%type  <leaf> non_negative_real_literal

   314

// %type  <leaf> exponent

   315

%type  <leaf> bit_string_literal

   316

%type  <leaf> boolean_literal

   317

   318

%token FALSE

   319

%token TRUE

   320

   321

   322

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

   323

/* B 1.2.2 - Character Strings */

   324

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

   325

%token <ID>   single_byte_character_string_token

   326

%token <ID>   double_byte_character_string_token

   327

   328

%type  <leaf> character_string

   329

%type  <leaf> single_byte_character_string

   330

%type  <leaf> double_byte_character_string

   331

   332

   333

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

   334

/* B 1.2.3 - Time Literals */

   335

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

   336

%type  <leaf> time_literal

   337

   338

   339

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

   340

/* B 1.2.3.1 - Duration */

   341

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

   342

%type  <leaf>	duration

   343

%type  <leaf>	interval

   344

%type  <leaf>	days

   345

%type  <leaf>	fixed_point

   346

%type  <leaf>	hours

   347

%type  <leaf>	minutes

   348

%type  <leaf>	seconds

   349

%type  <leaf>	milliseconds

   350

   351

%type  <leaf>	integer_d

   352

%type  <leaf>	integer_h

   353

%type  <leaf>	integer_m

   354

%type  <leaf>	integer_s

   355

%type  <leaf>	integer_ms

   356

%type  <leaf>	fixed_point_d

   357

%type  <leaf>	fixed_point_h

   358

%type  <leaf>	fixed_point_m

   359

%type  <leaf>	fixed_point_s

   360

%type  <leaf>	fixed_point_ms

   361

   362

%token <ID>	fixed_point_token

   363

%token <ID>	fixed_point_d_token

   364

%token <ID>	integer_d_token

   365

%token <ID>	fixed_point_h_token

   366

%token <ID>	integer_h_token

   367

%token <ID>	fixed_point_m_token

   368

%token <ID>	integer_m_token

   369

%token <ID>	fixed_point_s_token

   370

%token <ID>	integer_s_token

   371

%token <ID>	fixed_point_ms_token

   372

%token <ID>	integer_ms_token

   373

   374

%token TIME

   375

%token T_SHARP

   376

   377

   378

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

   379

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

   380

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

   381

%type  <leaf>	time_of_day

   382

%type  <leaf>	daytime

   383

%type  <leaf>	day_hour

   384

%type  <leaf>	day_minute

   385

%type  <leaf>	day_second

   386

%type  <leaf>	date

   387

%type  <leaf>	date_literal

   388

%type  <leaf>	year

   389

%type  <leaf>	month

   390

%type  <leaf>	day

   391

%type  <leaf>	date_and_time

   392

   393

%token TIME_OF_DAY

   394

%token DATE

   395

%token D_SHARP

   396

%token DATE_AND_TIME

   397

   398

   399

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

   400

/* B 1.3 - Data Types */

   401

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

   402

/* Strangely, the following symbol does seem to be required! */

   403

// %type  <leaf> data_type_name

   404

%type  <leaf> non_generic_type_name

   405

   406

   407

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

   408

/* B 1.3.1 - Elementary Data Types */

   409

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

   410

/* NOTES:

   411

 *

   412

 *    - To make the definition of bit_string_literal more

   413

 *      concise, it is useful to use an extra non-terminal

   414

 *      symbol (i.e. a grouping or construct) that groups the

   415

 *      following elements (BYTE, WORD, DWORD, LWORD).

   416

 *      Note that the definition of bit_string_type_name

   417

 *      (according to the spec) includes the above elements

   418

 *      and an extra BOOL.

   419

 *      We could use an extra construct with the first four

   420

 *      elements to be used solely in the definition of

   421

 *      bit_string_literal, but with the objective of not

   422

 *      having to replicate the actions (if we ever need

   423

 *      to change them, they would need to be changed in both

   424

 *      bit_string_type_name and the extra grouping), we

   425

 *      have re-defined bit_string_type_name as only including

   426

 *      the first four elements.

   427

 *      In order to have our parser implement the specification

   428

 *      correctly we have augmented every occurence of

   429

 *      bit_string_type_name in other rules with the BOOL

   430

 *      token. Since bit_string_type_name only appears in

   431

 *      the rule for elementary_type_name, this does not

   432

 *      seem to be a big concession to make!

   433

 *

   434

 *    - We have added a helper symbol to concentrate the

   435

 *      instantiation of STRING and WSTRING into a single

   436

 *      location (elementary_string_type_name).

   437

 *      These two elements show up in several other rules,

   438

 *      but we want to create the equivalent abstract syntax

   439

 *      in a single location of this file, in order to make

   440

 *      possible future changes easier to edit...

   441

 */

   442

%type  <leaf>	elementary_type_name

   443

%type  <leaf>	numeric_type_name

   444

%type  <leaf>	integer_type_name

   445

%type  <leaf>	signed_integer_type_name

   446

%type  <leaf>	unsigned_integer_type_name

   447

%type  <leaf>	real_type_name

   448

%type  <leaf>	date_type_name

   449

%type  <leaf>	bit_string_type_name

   450

/* helper symbol to concentrate the instantiation

   451

 * of STRING and WSTRING into a single location

   452

 */

   453

%type  <leaf>	elementary_string_type_name

   454

   455

%token BYTE

   456

%token WORD

   457

%token DWORD

   458

%token LWORD

   459

   460

%token LREAL

   461

%token REAL

   462

   463

%token SINT

   464

%token INT

   465

%token DINT

   466

%token LINT

   467

   468

%token USINT

   469

%token UINT

   470

%token UDINT

   471

%token ULINT

   472

   473

%token WSTRING

   474

%token STRING

   475

%token BOOL

   476

   477

%token TIME

   478

%token DATE

   479

%token DATE_AND_TIME

   480

%token DT

   481

%token TIME_OF_DAY

   482

%token TOD

   483

   484

   485

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

   486

/* B 1.3.2 - Generic data types */

   487

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

   488

/* Strangely, the following symbol does seem to be required! */

   489

// %type  <leaf>	generic_type_name

   490

   491

/* The following tokens do not seem to be used either

   492

 * but we declare them so they become reserved words...

   493

 */

   494

%token ANY

   495

%token ANY_DERIVED

   496

%token ANY_ELEMENTARY

   497

%token ANY_MAGNITUDE

   498

%token ANY_NUM

   499

%token ANY_REAL

   500

%token ANY_INT

   501

%token ANY_BIT

   502

%token ANY_STRING

   503

%token ANY_DATE

   504

   505

   506

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

   507

/* B 1.3.3 - Derived data types */

   508

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

   509

%type  <leaf>	derived_type_name

   510

%type  <leaf>	single_element_type_name

   511

// %type  <leaf>	simple_type_name

   512

// %type  <leaf>	subrange_type_name

   513

// %type  <leaf>	enumerated_type_name

   514

// %type  <leaf>	array_type_name

   515

// %type  <leaf>	structure_type_name

   516

   517

%type  <leaf>	data_type_declaration

   518

/* helper symbol for data_type_declaration */

   519

%type  <list>	type_declaration_list

   520

%type  <leaf>	type_declaration

   521

%type  <leaf>	single_element_type_declaration

   522

   523

%type  <leaf>	simple_type_declaration

   524

%type  <leaf>	simple_spec_init

   525

%type  <leaf>	simple_specification

   526

   527

%type  <leaf>	subrange_type_declaration

   528

%type  <leaf>	subrange_spec_init

   529

%type  <leaf>	subrange_specification

   530