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

 *

    21

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

    22

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

    23

 */

    24

    25

/*

    26

 * An IEC 61131-3 compiler.

    27

 *

    28

 * Based on the

    29

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

    30

 *

    31

 */

    32

    33

    34

/*

    35

 * This file contains the code that calls the stage 1 (lexical anayser) 

    36

 * and stage 2 (syntax parser) during the first pass.

    37

 */

    38

    39

#include <string.h>

    40

#include <stdlib.h>

    41

    42

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

    43

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

    44

    45

    46

#include "../main.hh"

    47

#include "stage1_2.hh"

    48

#include "iec_bison.hh"

    49

#include "stage1_2_priv.hh"

    50

#include "create_enumtype_conversion_functions.hh"

    51

    52

    53

    54

    55

    56

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

    57

/* whether we are supporting safe extensions          */

    58

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

    59

/* Safety Software Technical Specification,           */

    60

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

    61

/* Version 1.0 – Official Release                   */

    62

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

    63

bool get_opt_safe_extensions() {return runtime_options.safe_extensions;}

    64

    65

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

    66

/* whether to allow nested comments */

    67

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

    68

bool get_opt_nested_comments() {return runtime_options.nested_comments;}

    69

    70

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

    71

/* whether to allow REF(), DREF(), REF_TO, NULL and ^ operators/keywords  */

    72

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

    73

bool get_opt_ref_standard_extensions() {return runtime_options.ref_standard_extensions;}

    74

    75

    76

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

    77

/* whether bison is doing the pre-parsing, where POU bodies and var declarations are ignored! */

    78

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

    79

static bool preparse_state__ = false;

    80

    81

void set_preparse_state(void) {preparse_state__ = true; }

    82

void rst_preparse_state(void) {preparse_state__ = false;}

    83

bool get_preparse_state(void) {return preparse_state__;}     // returns true if bison is in preparse state

    84

    85

    86

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

    87

/* Controlling the entry to the body_state in flex. */

    88

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

    89

static int goto_body_state__ = 0;

    90

    91

void cmd_goto_body_state(void) {goto_body_state__ = 1;}

    92

int  get_goto_body_state(void) {return goto_body_state__;}

    93

void rst_goto_body_state(void) {goto_body_state__ = 0;}

    94

    95

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

    96

/* Controlling the entry to the sfc_qualifier_state in flex. */

    97

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

    98

static int goto_sfc_qualifier_state__ = 0;

    99

   100

void cmd_goto_sfc_qualifier_state(void) {goto_sfc_qualifier_state__ = 1;}

   101

int  get_goto_sfc_qualifier_state(void) {return goto_sfc_qualifier_state__;}

   102

void rst_goto_sfc_qualifier_state(void) {goto_sfc_qualifier_state__ = 0;}

   103

   104

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

   105

/* Controlling the entry to the sfc_priority_state in flex.  */

   106

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

   107

static int goto_sfc_priority_state__ = 0;

   108

   109

void cmd_goto_sfc_priority_state(void) {goto_sfc_priority_state__ = 1;}

   110

int  get_goto_sfc_priority_state(void) {return goto_sfc_priority_state__;}

   111

void rst_goto_sfc_priority_state(void) {goto_sfc_priority_state__ = 0;}

   112

   113

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

   114

/* Controlling the entry to the sfc_qualifier_state in flex. */

   115

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

   116

static int goto_task_init_state__ = 0;

   117

   118

void cmd_goto_task_init_state(void) {goto_task_init_state__ = 1;}

   119

int  get_goto_task_init_state(void) {return goto_task_init_state__;}

   120

void rst_goto_task_init_state(void) {goto_task_init_state__ = 0;}

   121

   122

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

   123

/* Returning to state in flex previously pushed onto the stack. */

   124

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

   125

static int pop_state__ = 0;

   126

   127

void cmd_pop_state(void) {pop_state__ = 1;}

   128

int  get_pop_state(void) {return pop_state__;}

   129

void rst_pop_state(void) {pop_state__ = 0;}

   130

   131

   132

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

   133

/* The global symbol tables...   */

   134

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

   135

/* NOTE: only accessed indirectly by the lexical parser (flex)

   136

 *       through the function get_identifier_token()

   137

 */

   138

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

   139

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

   140

 *       <fb_name , fb_decl>

   141

 *       <type_name , type_decl>

   142

 *       <program_name , program_decl>

   143

 *       <configuration_name , configuration_decl>

   144

 */

   145

/* static */ library_element_symtable_t library_element_symtable;

   146

   147

/* A symbol table to store the declared variables of

   148

 * the function currently being parsed...

   149

 */

   150

/* static */ variable_name_symtable_t   variable_name_symtable;

   151

   152

/* A symbol table to store the declared direct variables of

   153

 * the function currently being parsed...

   154

 */

   155

/* static */ direct_variable_symtable_t direct_variable_symtable;

   156

   157

/* Function only called from within flex!

   158

 *

   159

 * search for a symbol in either of the two symbol tables

   160

 * declared above, and return the token id of the first

   161

 * symbol found.

   162

 * Searches first in the variables, and only if not found

   163

 * does it continue searching in the library elements

   164

 */

   165

int get_identifier_token(const char *identifier_str) {

   166

//  std::cout << "get_identifier_token(" << identifier_str << "): \n";

   167

  variable_name_symtable_t  ::iterator iter1;

   168

  library_element_symtable_t::iterator iter2;

   169

   170

  if ((iter1 = variable_name_symtable.find(identifier_str)) != variable_name_symtable.end())

   171

    return iter1->second;

   172

   173

  if ((iter2 = library_element_symtable.find(identifier_str)) != library_element_symtable.end())

   174

    return iter2->second;

   175

   176

  return identifier_token;

   177

}

   178

   179

/* Function only called from within flex!

   180

 *

   181

 * search for a symbol in direct variables symbol table

   182

 * declared above, and return the token id of the first

   183

 * symbol found.

   184

 */

   185

int get_direct_variable_token(const char *direct_variable_str) {

   186

  direct_variable_symtable_t::iterator iter;

   187

   188

  if ((iter = direct_variable_symtable.find(direct_variable_str)) != direct_variable_symtable.end())

   189

    return iter->second;

   190

   191

  return direct_variable_token;

   192

}

   193

   194

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

   195

/* Utility Functions... */

   196

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

   197

   198

/*

   199

 * Join two strings together. Allocate space with malloc(3).

   200

 */

   201

char *strdup2(const char *a, const char *b) {

   202

  char *res = (char *)malloc(strlen(a) + strlen(b) + 1);

   203

   204

  if (!res)

   205

    return NULL;

   206

  return strcat(strcpy(res, a), b);  /* safe, actually */

   207

}

   208

   209

/*

   210

 * Join three strings together. Allocate space with malloc(3).

   211

 */

   212

char *strdup3(const char *a, const char *b, const char *c) {

   213

  char *res = (char *)malloc(strlen(a) + strlen(b) + strlen(c) + 1);

   214

   215

  if (!res)

   216

    return NULL;

   217

  return strcat(strcat(strcpy(res, a), b), c);  /* safe, actually */

   218

}

   219

   220

   221

   222

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

   223

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

   224

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

   225

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

   226

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

   227

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

   228

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

   229

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

   230

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

   231

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

   232

   233

int stage2__(const char *filename, 

   234

             symbol_c **tree_root_ref

   235

            );

   236

   237

   238

int stage1_2(const char *filename, symbol_c **tree_root_ref) {

   239

      /* NOTE: we only call stage2 (bison - syntax analysis) directly, as stage 2 will itself call stage1 (flex - lexical analysis)

   240

       *       automatically as needed

   241

       */

   242

   243

      /* NOTE: Since we do not call stage1__ (flex) directly, we cannot directly pass any parameters to that function either.

   244

       *       In this case, we use callback functions, i.e. stage1__ (i.e. flex) will call functions defined in this file

   245

       *       whenever it needs info/parameters coming from stage1_2().

   246

       *       These callback functions will get their data from local (to this file) global variables...

   247

       *       We now set those variables...

   248

       */

   249

  return stage2__(filename, tree_root_ref);

   250

}

   251