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

 * This is one of the versions available for the 4th stage.

    28

 *

    29

 * This 4th stage generates a c++ source program equivalent

    30

 * to the IL and ST code.

    31

 */

    32

    33

    34

    35

    36

    37

    38

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

    39

#include <string>

    40

#include <iostream>

    41

#include <sstream>

    42

#include <typeinfo>

    43

#include <list>

    44

#include <strings.h>

    45

    46

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

    47

#include "../../util/dsymtable.hh"

    48

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

    49

#include "../../absyntax_utils/absyntax_utils.hh"

    50

    51

#include "../stage4.hh"

    52

    53

    54

    55

    56

    57

    58

    59

//#define DEBUG

    60

#ifdef DEBUG

    61

#define TRACE(classname) printf("\n____%s____\n",classname);

    62

#else

    63

#define TRACE(classname)

    64

#endif

    65

    66

    67

    68

#define ERROR error_exit(__FILE__,__LINE__)

    69

/* function defined in main.cc */

    70

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

    71

    72

    73

    74

    75

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

    76

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

    77

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

    78

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

    79

    80

/* Unlike Programs and Configurations which get mapped onto C++ classes,

    81

 * Function Blocks are mapped onto a C structure containing the variables, and

    82

 * a C function containing the code in the FB's body. This is to allow direct allocation

    83

 * of a FB variable (which is really an instance of the C data structure) to

    84

 * a member of a union variable (note that classes with constructors cannot

    85

 * be mebers of a union), which is done in IL when loading a FB onto IL's

    86

 * default variable.

    87

 *

    88

 * So as not to clash the names of the C data structure and the C function,

    89

 * the C structure is given a name identical to that of the FB name, whereas

    90

 * the name of the function is the FB name with a constant string appended.

    91

 * The value of that constant string which is appended is defined in the following

    92

 * constant.

    93

 * In order not to clash with any variable in the IL and ST source codem the

    94

 * following constant should contain a double underscore, which is not allowed

    95

 * in IL and ST.

    96

 *

    97

 * e.g.:  FUNTION_BLOCK TEST

    98

 * is mapped onto a TEST data structure, and a TEST_body__ function.

    99

 */

   100

   101

#define FB_FUNCTION_SUFFIX "_body__"

   102

   103

/* Idem as body, but for initializer FB function */

   104

#define FB_INIT_SUFFIX "_init__"

   105

   106

/* Idem as body, but for run CONFIG and RESOURCE function */

   107

#define FB_RUN_SUFFIX "_run__"

   108

   109

/* The FB body function is passed as the only parameter a pointer to the FB data

   110

 * structure instance. The name of this parameter is given by the following constant.

   111

 * In order not to clash with any variable in the IL and ST source codem the

   112

 * following constant should contain a double underscore, which is not allowed

   113

 * in IL and ST.

   114

 *

   115

 * e.g.: the body of FUNTION_BLOCK TEST

   116

 * is mapped onto the C function

   117

 *  TEST_body__(TEST *data__)

   118

 */

   119

   120

#define FB_FUNCTION_PARAM "data__"

   121

   122

   123

#define SFC_STEP_ACTION_PREFIX "__SFC_"

   124

   125

   126

/* Variable declaration symbol for accessor macros */

   127

#define DECLARE_VAR "__DECLARE_VAR"

   128

#define DECLARE_GLOBAL "__DECLARE_GLOBAL"

   129

#define DECLARE_GLOBAL_LOCATION "__DECLARE_GLOBAL_LOCATION"

   130

#define DECLARE_GLOBAL_LOCATED "__DECLARE_GLOBAL_LOCATED"

   131

#define DECLARE_EXTERNAL "__DECLARE_EXTERNAL"

   132

#define DECLARE_LOCATED "__DECLARE_LOCATED"

   133

   134

/* Variable declaration symbol for accessor macros */

   135

#define INIT_VAR "__INIT_VAR"

   136

#define INIT_GLOBAL "__INIT_GLOBAL"

   137

#define INIT_GLOBAL_LOCATED "__INIT_GLOBAL_LOCATED"

   138

#define INIT_EXTERNAL "__INIT_EXTERNAL"

   139

#define INIT_LOCATED "__INIT_LOCATED"

   140

#define INIT_LOCATED_VALUE "__INIT_LOCATED_VALUE"

   141

   142

   143

/* Variable getter symbol for accessor macros */

   144

#define GET_VAR "__GET_VAR"

   145

#define GET_EXTERNAL "__GET_EXTERNAL"

   146

#define GET_LOCATED "__GET_LOCATED"

   147

#define GET_VAR_BY_REF "__GET_VAR_BY_REF"

   148

#define GET_EXTERNAL_BY_REF "__GET_EXTERNAL_BY_REF"

   149

#define GET_LOCATED_BY_REF "__GET_LOCATED_BY_REF"

   150

   151

/* Variable setter symbol for accessor macros */

   152

#define SET_VAR "__SET_VAR"

   153

#define SET_EXTERNAL "__SET_EXTERNAL"

   154

#define SET_COMPLEX_EXTERNAL "__SET_COMPLEX_EXTERNAL"

   155

#define SET_LOCATED "__SET_LOCATED"

   156

   157

   158

/* Generate a name for a temporary variable.

   159

 * Each new name generated is appended a different number,

   160

 * starting off from 0.

   161

 * After calling reset(), the names will start off again from 0.

   162

 */

   163

#define VAR_LEADER "__"

   164

#define TEMP_VAR VAR_LEADER "TMP_"

   165

#define SOURCE_VAR VAR_LEADER "SRC_"

   166

   167

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

   168

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

   169

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

   170

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

   171

   172

#include "generate_c_base.cc"

   173

#include "generate_c_typedecl.cc"

   174

#include "generate_c_sfcdecl.cc"

   175

#include "generate_c_vardecl.cc"

   176

#include "generate_c_configbody.cc"

   177

#include "generate_location_list.cc"

   178

#include "generate_var_list.cc"

   179

   180

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

   181

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

   182

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

   183

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

   184

   185

#include "generate_c_st.cc"

   186

#include "generate_c_il.cc"

   187

#include "generate_c_inlinefcall.cc"

   188

   189

#include "generate_c.hh"

   190

   191

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

   192

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

   193

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

   194

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

   195

   196

#define MILLISECOND 1000000

   197

#define SECOND 1000 * MILLISECOND

   198

   199

/* A helper class that knows how to generate code for both the IL and ST languages... */

   200

class calculate_time_c: public iterator_visitor_c {

   201

  private:

   202

    unsigned long long time;

   203

    float current_value;

   204

   205

  public:

   206

    calculate_time_c(void){time = 0;};

   207

   208

    unsigned long long get_time(void) {return time;};

   209

   210

    void *get_integer_value(token_c *token) {

   211

      std::string str = "";

   212

      for (unsigned int i = 0; i < strlen(token->value); i++)

   213

        if (token->value[i] != '_')

   214

          str += token->value[i];

   215

      current_value = atof(str.c_str());

   216

      return NULL;

   217

    }

   218

   219

    void *get_float_value(token_c *token) {

   220

      current_value = atof(token->value);

   221

      return NULL;

   222

    }

   223

   224

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

   225

/* B 1.2.1 - Numeric Literals */

   226

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

   227

   228

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

   229

   230

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

   231

/* B 1.2.3.1 - Duration */

   232

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

   233

   234

    /* SYM_REF2(duration_c, neg, interval) */

   235

    void *visit(duration_c *symbol) {

   236

      if (symbol->neg != NULL)

   237

        ERROR;

   238

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

   239

      return NULL;

   240

    }

   241

   242

    /* SYM_TOKEN(fixed_point_c) */

   243

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

   244

   245

    /* SYM_REF2(days_c, days, hours) */

   246

    void *visit(days_c *symbol) {

   247

      if (symbol->hours)

   248

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

   249

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

   250

      time += (unsigned long long)(current_value * 24 * 3600 * SECOND);

   251

      return NULL;

   252

    }

   253

   254

    /* SYM_REF2(hours_c, hours, minutes) */

   255

    void *visit(hours_c *symbol) {

   256

      if (symbol->minutes)

   257

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

   258

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

   259

      time += (unsigned long long)(current_value * 3600 * SECOND);

   260

      return NULL;

   261

    }

   262

   263

    /* SYM_REF2(minutes_c, minutes, seconds) */

   264

    void *visit(minutes_c *symbol) {

   265

      if (symbol->seconds)

   266

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

   267

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

   268

      time += (unsigned long long)(current_value * 60 * SECOND);

   269

      return NULL;

   270

    }

   271

   272

    /* SYM_REF2(seconds_c, seconds, milliseconds) */

   273

    void *visit(seconds_c *symbol) {

   274

      if (symbol->milliseconds)

   275

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

   276

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

   277

      time += (unsigned long long)(current_value * SECOND);

   278

      return NULL;

   279

    }

   280

   281

    /* SYM_REF2(milliseconds_c, milliseconds, unused) */

   282

    void *visit(milliseconds_c *symbol) {

   283

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

   284

      time += (unsigned long long)(current_value * MILLISECOND);

   285

      return NULL;

   286

    }

   287

};

   288

   289

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

   290

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

   291

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

   292

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

   293

   294

class calculate_common_ticktime_c: public iterator_visitor_c {

   295

  private:

   296

    unsigned long long common_ticktime;

   297

    unsigned long long least_common_ticktime;

   298

   299

  public:

   300

    calculate_common_ticktime_c(void){

   301

      common_ticktime = 0;

   302

      least_common_ticktime = 0;

   303

    }

   304

   305

    unsigned long long euclide(unsigned long long a, unsigned long long b) {

   306

      unsigned long long c = a % b;

   307

      if (c == 0)

   308

        return b;

   309

      else

   310

        return euclide(b, c);

   311

    }

   312

   313

    void update_ticktime(unsigned long long time) {

   314

      if (common_ticktime == 0)

   315

        common_ticktime = time;

   316

      else if (time > common_ticktime)

   317

        common_ticktime = euclide(time, common_ticktime);

   318

      else

   319

        common_ticktime = euclide(common_ticktime, time);

   320

      if (least_common_ticktime == 0)

   321

        least_common_ticktime = time;

   322

      else

   323

        least_common_ticktime = (least_common_ticktime * time) / common_ticktime;

   324

    }

   325

   326

    unsigned long long get_common_ticktime(void) {

   327

      return common_ticktime;

   328

    }

   329

   330

    unsigned long get_greatest_tick_count(void) {

   331

      unsigned long long least_common_tick = least_common_ticktime / common_ticktime;

   332

      if (least_common_tick >> 32)

   333

        ERROR;

   334

      return (unsigned long)(~(((unsigned long)-1) % (unsigned long)least_common_tick) + 1);

   335

    }

   336

   337

/*  TASK task_name task_initialization */

   338

//SYM_REF2(task_configuration_c, task_name, task_initialization)  

   339

    void *visit(task_initialization_c *symbol) {

   340

      calculate_time_c calculate_time;

   341

      unsigned long long time = 0;

   342

      if (symbol->interval_data_source != NULL) {

   343

        symbol->interval_data_source->accept(calculate_time);

   344

        time = calculate_time.get_time();

   345

      }

   346

      if (time > 0)

   347

        update_ticktime(time);

   348

      return NULL;

   349

    }

   350

};    

   351

   352

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

   353

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

   354

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

   355

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

   356

   357

/* A helper class that knows how to generate code for the SFC, IL and ST languages... */

   358

class generate_c_SFC_IL_ST_c: public null_visitor_c {

   359

  private:

   360

    stage4out_c *s4o_ptr;

   361

    symbol_c *scope;

   362

    symbol_c *fbname;

   363

    const char *variable_prefix;

   364

   365

  public:

   366

    generate_c_SFC_IL_ST_c(stage4out_c *s4o_ptr, symbol_c *name, symbol_c *scope, const char *variable_prefix = NULL);

   367

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

   368

    /* B.1.6  Sequential function chart elements */

   369

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

   370

   371

    /*| sequential_function_chart sfc_network*/

   372

    void *visit(sequential_function_chart_c * symbol);

   373

   374

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

   375

    /* B.2 - Language IL (Instruction List) */

   376

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

   377

   378

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

   379

    /* B 2.1 Instructions and Operands */

   380

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

   381

    /*| instruction_list il_instruction */

   382

    void *visit(instruction_list_c *symbol);

   383

   384

    /* Remainder implemented in generate_c_il_c... */

   385

   386

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

   387

    /* B.3 - Language ST (Structured Text) */

   388

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

   389

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

   390

    /* B 3.1 - Expressions */

   391

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

   392

    /* Implemented in generate_c_st_c */

   393

   394

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

   395

    /* B 3.2 Statements */

   396

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

   397

    void *visit(statement_list_c *symbol);

   398

   399

/* Remainder implemented in generate_c_st_c... */

   400

};

   401

   402

#include "generate_c_sfc.cc"

   403

   404

generate_c_SFC_IL_ST_c::generate_c_SFC_IL_ST_c(stage4out_c *s4o_ptr, symbol_c *name, symbol_c *scope, const char *variable_prefix) {

   405

  if (NULL == scope) ERROR;

   406

  this->s4o_ptr = s4o_ptr;

   407

  this->scope = scope;

   408

  this->fbname = name;

   409

  this->variable_prefix = variable_prefix;

   410

}

   411

   412

void *generate_c_SFC_IL_ST_c::visit(sequential_function_chart_c * symbol) {

   413

  generate_c_sfc_c generate_c_sfc(s4o_ptr, fbname, scope, variable_prefix);

   414

  generate_c_sfc.generate(symbol);

   415

  return NULL;

   416

}

   417

   418

void *generate_c_SFC_IL_ST_c::visit(instruction_list_c *symbol) {

   419

  generate_c_il_c generate_c_il(s4o_ptr, fbname, scope, variable_prefix);

   420

  generate_c_il.generate(symbol);

   421

  return NULL;

   422

}

   423

   424

void *generate_c_SFC_IL_ST_c::visit(statement_list_c *symbol) {

   425

  generate_c_st_c generate_c_st(s4o_ptr, fbname, scope, variable_prefix);

   426

  generate_c_st.generate(symbol);

   427

  return NULL;

   428

}

   429

   430

   431

   432

   433

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

   434

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

   435

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

   436

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

   437

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

   438

   439

   440

class generate_c_pous_c: public generate_c_typedecl_c {

   441

   442

  public:

   443

    generate_c_pous_c(stage4out_c *s4o_ptr, stage4out_c *s4o_incl_ptr)

   444

      : generate_c_typedecl_c(s4o_ptr, s4o_incl_ptr) {};

   445

    virtual ~generate_c_pous_c(void) {}

   446

   447

   448

  public:

   449

   450

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

   451

/* B.1 - Common elements */

   452

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

   453

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

   454

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

   455

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

   456

  /* done in base class(es) */

   457

   458

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

   459

/* B 1.2 - Constants */

   460

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

   461

  /* originally empty... */

   462

   463

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

   464

/* B 1.2.1 - Numeric Literals */

   465

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

   466

  /* done in base class(es) */

   467

   468

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

   469

/* B.1.2.2   Character Strings */

   470

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

   471

  /* done in base class(es) */

   472

   473

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

   474

/* B 1.2.3 - Time Literals */

   475

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

   476

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

   477

/* B 1.2.3.1 - Duration */

   478

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

   479

  /* done in base class(es) */

   480

   481

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

   482

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

   483

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

   484

  /* done in base class(es) */

   485

   486

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

   487

/* B.1.3 - Data types */

   488

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

   489

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

   490

/* B 1.3.1 - Elementary Data Types */

   491

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

   492

  /* done in base class(es) */

   493

   494

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

   495

/* B.1.3.2 - Generic data types */

   496

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

   497

  /* originally empty... */

   498

   499

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

   500

/* B 1.3.3 - Derived data types */

   501

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

   502

  /* done in base class(es) */

   503

   504

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

   505

/* B 1.4 - Variables */

   506

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

   507

  /* done in base class(es) */

   508

   509

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

   510

/* B.1.4.1   Directly Represented Variables */

   511

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

   512

  /* done in base class(es) */

   513

   514

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

   515

/* B.1.4.2   Multi-element Variables */

   516

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

   517

  /* done in base class(es) */

   518

   519

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