1

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

     2

 *

     3

 *  $Id$

     4

 *

     5

 *  Copyright (C) 2007-2009  Florian Pose, Ingenieurgemeinschaft IgH

     6

 *

     7

 *  This file is part of the IgH EtherCAT Master.

     8

 *

     9

 *  The IgH EtherCAT Master is free software; you can redistribute it and/or

    10

 *  modify it under the terms of the GNU General Public License version 2, as

    11

 *  published by the Free Software Foundation.

    12

 *

    13

 *  The IgH EtherCAT Master is distributed in the hope that it will be useful,

    14

 *  but WITHOUT ANY WARRANTY; without even the implied warranty of

    15

 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General

    16

 *  Public License for more details.

    17

 *

    18

 *  You should have received a copy of the GNU General Public License along

    19

 *  with the IgH EtherCAT Master; if not, write to the Free Software

    20

 *  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA

    21

 *

    22

 *  ---

    23

 *

    24

 *  The license mentioned above concerns the source code only. Using the

    25

 *  EtherCAT technology and brand is only permitted in compliance with the

    26

 *  industrial property and similar rights of Beckhoff Automation GmbH.

    27

 *

    28

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

    29

    30

#include <errno.h>

    31

#include <signal.h>

    32

#include <stdio.h>

    33

#include <string.h>

    34

#include <sys/resource.h>

    35

#include <sys/time.h>

    36

#include <sys/types.h>

    37

#include <unistd.h>

    38

#include <time.h> /* clock_gettime() */

    39

#include <sys/mman.h> /* mlockall() */

    40

    41

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

    42

    43

#include "ecrt.h"

    44

    45

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

    46

    47

/** Task period in ns. */

    48

#define PERIOD_NS   (1000000)

    49

    50

#define MAX_SAFE_STACK (8 * 1024) /* The maximum stack size which is

    51

                                     guranteed safe to access without

    52

                                     faulting */

    53

    54

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

    55

    56

/* Constants */

    57

#define NSEC_PER_SEC (1000000000)

    58

#define FREQUENCY (NSEC_PER_SEC / PERIOD_NS)

    59

    60

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

    61

    62

// EtherCAT

    63

static ec_master_t *master = NULL;

    64

static ec_master_state_t master_state = {};

    65

    66

static ec_domain_t *domain1 = NULL;

    67

static ec_domain_state_t domain1_state = {};

    68

    69

static ec_slave_config_t *sc_ana_in = NULL;

    70

static ec_slave_config_state_t sc_ana_in_state = {};

    71

    72

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

    73

    74

// process data

    75

static uint8_t *domain1_pd = NULL;

    76

    77

#define BusCouplerPos  0, 0

    78

#define DigOutSlavePos 0, 2

    79

#define AnaInSlavePos  0, 3

    80

#define AnaOutSlavePos 0, 4

    81

    82

#define Beckhoff_EK1100 0x00000002, 0x044c2c52

    83

#define Beckhoff_EL2004 0x00000002, 0x07d43052

    84

#define Beckhoff_EL2032 0x00000002, 0x07f03052

    85

#define Beckhoff_EL3152 0x00000002, 0x0c503052

    86

#define Beckhoff_EL3102 0x00000002, 0x0c1e3052

    87

#define Beckhoff_EL4102 0x00000002, 0x10063052

    88

    89

// offsets for PDO entries

    90

static unsigned int off_ana_in_status;

    91

static unsigned int off_ana_in_value;

    92

static unsigned int off_ana_out;

    93

static unsigned int off_dig_out;

    94

    95

const static ec_pdo_entry_reg_t domain1_regs[] = {

    96

    {AnaInSlavePos,  Beckhoff_EL3102, 0x3101, 1, &off_ana_in_status},

    97

    {AnaInSlavePos,  Beckhoff_EL3102, 0x3101, 2, &off_ana_in_value},

    98

    {AnaOutSlavePos, Beckhoff_EL4102, 0x3001, 1, &off_ana_out},

    99

    {DigOutSlavePos, Beckhoff_EL2032, 0x3001, 1, &off_dig_out},

   100

    {}

   101

};

   102

   103

static unsigned int counter = 0;

   104

static unsigned int blink = 0;

   105

   106

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

   107

   108

// Analog in --------------------------

   109

   110

static ec_pdo_entry_info_t el3102_pdo_entries[] = {

   111

    {0x3101, 1,  8}, // channel 1 status

   112

    {0x3101, 2, 16}, // channel 1 value

   113

    {0x3102, 1,  8}, // channel 2 status

   114

    {0x3102, 2, 16}, // channel 2 value

   115

    {0x6401, 1, 16}, // channel 1 value (alt.)

   116

    {0x6401, 2, 16}  // channel 2 value (alt.)

   117

};

   118

   119

static ec_pdo_info_t el3102_pdos[] = {

   120

    {0x1A00, 2, el3102_pdo_entries},

   121

    {0x1A01, 2, el3102_pdo_entries + 2}

   122

};

   123

   124

static ec_sync_info_t el3102_syncs[] = {

   125

    {2, EC_DIR_OUTPUT},

   126

    {3, EC_DIR_INPUT, 2, el3102_pdos},

   127

    {0xff}

   128

};

   129

   130

// Analog out -------------------------

   131

   132

static ec_pdo_entry_info_t el4102_pdo_entries[] = {

   133

    {0x3001, 1, 16}, // channel 1 value

   134

    {0x3002, 1, 16}, // channel 2 value

   135

};

   136

   137

static ec_pdo_info_t el4102_pdos[] = {

   138

    {0x1600, 1, el4102_pdo_entries},

   139

    {0x1601, 1, el4102_pdo_entries + 1}

   140

};

   141

   142

static ec_sync_info_t el4102_syncs[] = {

   143

    {2, EC_DIR_OUTPUT, 2, el4102_pdos},

   144

    {3, EC_DIR_INPUT},

   145

    {0xff}

   146

};

   147

   148

// Digital out ------------------------

   149

   150

static ec_pdo_entry_info_t el2004_channels[] = {

   151

    {0x3001, 1, 1}, // Value 1

   152

    {0x3001, 2, 1}, // Value 2

   153

    {0x3001, 3, 1}, // Value 3

   154

    {0x3001, 4, 1}  // Value 4

   155

};

   156

   157

static ec_pdo_info_t el2004_pdos[] = {

   158

    {0x1600, 1, &el2004_channels[0]},

   159

    {0x1601, 1, &el2004_channels[1]},

   160

    {0x1602, 1, &el2004_channels[2]},

   161

    {0x1603, 1, &el2004_channels[3]}

   162

};

   163

   164

static ec_sync_info_t el2004_syncs[] = {

   165

    {0, EC_DIR_OUTPUT, 4, el2004_pdos},

   166

    {1, EC_DIR_INPUT},

   167

    {0xff}

   168

};

   169

   170

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

   171

   172

void check_domain1_state(void)

   173

{

   174

    ec_domain_state_t ds;

   175

   176

    ecrt_domain_state(domain1, &ds);

   177

   178

    if (ds.working_counter != domain1_state.working_counter) {

   179

        printf("Domain1: WC %u.\n", ds.working_counter);

   180

    }

   181

    if (ds.wc_state != domain1_state.wc_state) {

   182

        printf("Domain1: State %u.\n", ds.wc_state);

   183

    }

   184

   185

    domain1_state = ds;

   186

}

   187

   188

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

   189

   190

void check_master_state(void)

   191

{

   192

    ec_master_state_t ms;

   193

   194

    ecrt_master_state(master, &ms);

   195

   196

    if (ms.slaves_responding != master_state.slaves_responding) {

   197

        printf("%u slave(s).\n", ms.slaves_responding);

   198

    }

   199

    if (ms.al_states != master_state.al_states) {

   200

        printf("AL states: 0x%02X.\n", ms.al_states);

   201

    }

   202

    if (ms.link_up != master_state.link_up) {

   203

        printf("Link is %s.\n", ms.link_up ? "up" : "down");

   204

    }

   205

   206

    master_state = ms;

   207

}

   208

   209

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

   210

   211

void check_slave_config_states(void)

   212

{

   213

    ec_slave_config_state_t s;

   214

   215

    ecrt_slave_config_state(sc_ana_in, &s);

   216

   217

    if (s.al_state != sc_ana_in_state.al_state) {

   218

        printf("AnaIn: State 0x%02X.\n", s.al_state);

   219

    }

   220

    if (s.online != sc_ana_in_state.online) {

   221

        printf("AnaIn: %s.\n", s.online ? "online" : "offline");

   222

    }

   223

    if (s.operational != sc_ana_in_state.operational) {

   224

        printf("AnaIn: %soperational.\n", s.operational ? "" : "Not ");

   225

    }

   226

   227

    sc_ana_in_state = s;

   228

}

   229

   230

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

   231

   232

void cyclic_task()

   233

{

   234

    // receive process data

   235

    ecrt_master_receive(master);

   236

    ecrt_domain_process(domain1);

   237

   238

    // check process data state

   239

    check_domain1_state();

   240

   241

    if (counter) {

   242

        counter--;

   243

    } else { // do this at 1 Hz

   244

        counter = FREQUENCY;

   245

   246

        // calculate new process data

   247

        blink = !blink;

   248

   249

        // check for master state (optional)

   250

        check_master_state();

   251

   252

        // check for slave configuration state(s) (optional)

   253

        check_slave_config_states();

   254

    }

   255

   256

#if 0

   257

    // read process data

   258

    printf("AnaIn: state %u value %u\n",

   259

            EC_READ_U8(domain1_pd + off_ana_in_status),

   260

            EC_READ_U16(domain1_pd + off_ana_in_value));

   261

#endif

   262

   263

#if 1

   264

    // write process data

   265

    EC_WRITE_U8(domain1_pd + off_dig_out, blink ? 0x06 : 0x09);

   266

#endif

   267

   268

    // send process data

   269

    ecrt_domain_queue(domain1);

   270

    ecrt_master_send(master);

   271

}

   272

   273

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

   274

   275

void stack_prefault(void)

   276

{

   277

    unsigned char dummy[MAX_SAFE_STACK];

   278

   279

    memset(dummy, 0, MAX_SAFE_STACK);

   280

}

   281

   282

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

   283

   284

int main(int argc, char **argv)

   285

{

   286

    ec_slave_config_t *sc;

   287

    struct timespec wakeup_time;

   288

    int ret = 0;

   289

   290

    master = ecrt_request_master(0);

   291

    if (!master) {

   292

        return -1;

   293

    }

   294

   295

    domain1 = ecrt_master_create_domain(master);

   296

    if (!domain1) {

   297

        return -1;

   298

    }

   299

   300

    if (!(sc_ana_in = ecrt_master_slave_config(

   301

                    master, AnaInSlavePos, Beckhoff_EL3102))) {

   302

        fprintf(stderr, "Failed to get slave configuration.\n");

   303

        return -1;

   304

    }

   305

   306

    printf("Configuring PDOs...\n");

   307

    if (ecrt_slave_config_pdos(sc_ana_in, EC_END, el3102_syncs)) {

   308

        fprintf(stderr, "Failed to configure PDOs.\n");

   309

        return -1;

   310

    }

   311

   312

    if (!(sc = ecrt_master_slave_config(

   313

                    master, AnaOutSlavePos, Beckhoff_EL4102))) {

   314

        fprintf(stderr, "Failed to get slave configuration.\n");

   315

        return -1;

   316

    }

   317

   318

    if (ecrt_slave_config_pdos(sc, EC_END, el4102_syncs)) {

   319

        fprintf(stderr, "Failed to configure PDOs.\n");

   320

        return -1;

   321

    }

   322

   323

    if (!(sc = ecrt_master_slave_config(

   324

                    master, DigOutSlavePos, Beckhoff_EL2032))) {

   325

        fprintf(stderr, "Failed to get slave configuration.\n");

   326

        return -1;

   327

    }

   328

   329

    if (ecrt_slave_config_pdos(sc, EC_END, el2004_syncs)) {

   330

        fprintf(stderr, "Failed to configure PDOs.\n");

   331

        return -1;

   332

    }

   333

   334

    // Create configuration for bus coupler

   335

    sc = ecrt_master_slave_config(master, BusCouplerPos, Beckhoff_EK1100);

   336

    if (!sc) {

   337

        return -1;

   338

    }

   339

   340

    if (ecrt_domain_reg_pdo_entry_list(domain1, domain1_regs)) {

   341

        fprintf(stderr, "PDO entry registration failed!\n");

   342

        return -1;

   343

    }

   344

   345

    printf("Activating master...\n");

   346

    if (ecrt_master_activate(master)) {

   347

        return -1;

   348

    }

   349

   350

    if (!(domain1_pd = ecrt_domain_data(domain1))) {

   351

        return -1;

   352

    }

   353

   354

    /* Set priority */

   355

   356

    pid_t pid = getpid();

   357

    if (setpriority(PRIO_PROCESS, pid, -19)) {

   358

        fprintf(stderr, "Warning: Failed to set priority: %s\n",

   359

                strerror(errno));

   360

    }

   361

   362

    /* Lock memory */

   363

   364

    if (mlockall(MCL_CURRENT | MCL_FUTURE) == -1) {

   365

        fprintf(stderr, "Warning: Failed to lock memory: %s\n",

   366

                strerror(errno));

   367

    }

   368

   369

    stack_prefault();

   370

   371

    printf("Starting RT task with dt=%u ns.\n", PERIOD_NS);

   372

   373

    clock_gettime(CLOCK_MONOTONIC, &wakeup_time);

   374

    wakeup_time.tv_sec += 1; /* start in future */

   375

    wakeup_time.tv_nsec = 0;

   376

   377

    while (1) {

   378

        ret = clock_nanosleep(CLOCK_MONOTONIC, TIMER_ABSTIME,

   379

                &wakeup_time, NULL);

   380

        if (ret) {

   381

            fprintf(stderr, "clock_nanosleep(): %s\n", strerror(ret));

   382

            break;

   383

        }

   384

   385

        cyclic_task();

   386

   387

        wakeup_time.tv_nsec += PERIOD_NS;

   388

        while (wakeup_time.tv_nsec >= NSEC_PER_SEC) {

   389

            wakeup_time.tv_nsec -= NSEC_PER_SEC;

   390

            wakeup_time.tv_sec++;

   391

        }

   392

    }

   393

   394

    return ret;

   395

}

   396

   397

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