1

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

     2

 *

     3

 *  $Id$

     4

 *

     5

 *  Copyright (C) 2006-2008  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

/**

    31

   \file

    32

   EtherCAT domain methods.

    33

*/

    34

    35

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

    36

    37

#include <linux/module.h>

    38

    39

#include "globals.h"

    40

#include "master.h"

    41

#include "slave_config.h"

    42

    43

#include "domain.h"

    44

    45

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

    46

    47

void ec_domain_clear_data(ec_domain_t *);

    48

    49

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

    50

    51

/** Domain constructor.

    52

 */

    53

void ec_domain_init(

    54

        ec_domain_t *domain, /**< EtherCAT domain. */

    55

        ec_master_t *master, /**< Parent master. */

    56

        unsigned int index /**< Index. */

    57

        )

    58

{

    59

    domain->master = master;

    60

    domain->index = index;

    61

    INIT_LIST_HEAD(&domain->fmmu_configs);

    62

    domain->data_size = 0;

    63

    domain->data = NULL;

    64

    domain->data_origin = EC_ORIG_INTERNAL;

    65

    domain->logical_base_address = 0x00000000;

    66

    INIT_LIST_HEAD(&domain->datagrams);

    67

    domain->working_counter = 0x0000;

    68

    domain->expected_working_counter = 0x0000;

    69

    domain->working_counter_changes = 0;

    70

    domain->notify_jiffies = 0;

    71

}

    72

    73

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

    74

    75

/** Domain destructor.

    76

 */

    77

void ec_domain_clear(ec_domain_t *domain /**< EtherCAT domain */)

    78

{

    79

    ec_datagram_t *datagram, *next;

    80

    81

    // dequeue and free datagrams

    82

    list_for_each_entry_safe(datagram, next, &domain->datagrams, list) {

    83

        ec_datagram_clear(datagram);

    84

        kfree(datagram);

    85

    }

    86

    87

    ec_domain_clear_data(domain);

    88

}

    89

    90

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

    91

    92

/** Frees internally allocated memory.

    93

 */

    94

void ec_domain_clear_data(

    95

        ec_domain_t *domain /**< EtherCAT domain. */

    96

        )

    97

{

    98

    if (domain->data_origin == EC_ORIG_INTERNAL && domain->data)

    99

        kfree(domain->data);

   100

    domain->data = NULL;

   101

    domain->data_origin = EC_ORIG_INTERNAL;

   102

}

   103

   104

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

   105

   106

/** Adds an FMMU configuration to the domain.

   107

 */

   108

void ec_domain_add_fmmu_config(

   109

        ec_domain_t *domain, /**< EtherCAT domain. */

   110

        ec_fmmu_config_t *fmmu /**< FMMU configuration. */

   111

        )

   112

{

   113

    fmmu->domain = domain;

   114

   115

    domain->data_size += fmmu->data_size;

   116

    list_add_tail(&fmmu->list, &domain->fmmu_configs);

   117

   118

    if (domain->master->debug_level)

   119

        EC_DBG("Domain %u: Added %u bytes, total %zu.\n", domain->index,

   120

                fmmu->data_size, domain->data_size);

   121

}

   122

   123

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

   124

   125

/** Allocates a domain datagram and appends it to the list.

   126

 *

   127

 * The datagram type and expected working counters are determined by the

   128

 * number of input and output fmmus that share the datagram.

   129

 *

   130

 * \retval  0 Success.

   131

 * \retval <0 Error code.

   132

 */

   133

int ec_domain_add_datagram(

   134

        ec_domain_t *domain, /**< EtherCAT domain. */

   135

        uint32_t logical_offset, /**< Logical offset. */

   136

        size_t data_size, /**< Size of the data. */

   137

        uint8_t *data, /**< Process data. */

   138

        const unsigned int used[] /**< Used by inputs/outputs. */

   139

        )

   140

{

   141

    ec_datagram_t *datagram;

   142

    int ret;

   143

   144

    if (!(datagram = kmalloc(sizeof(ec_datagram_t), GFP_KERNEL))) {

   145

        EC_ERR("Failed to allocate domain datagram!\n");

   146

        return -ENOMEM;

   147

    }

   148

   149

    ec_datagram_init(datagram);

   150

    snprintf(datagram->name, EC_DATAGRAM_NAME_SIZE,

   151

            "domain%u-%u", domain->index, logical_offset);

   152

   153

    if (used[EC_DIR_OUTPUT] && used[EC_DIR_INPUT]) { // inputs and outputs

   154

        ret = ec_datagram_lrw(datagram, logical_offset, data_size, data);

   155

        if (ret < 0) {

   156

            kfree(datagram);

   157

            return ret;

   158

        }

   159

        // If LRW is used, output FMMUs increment the working counter by 2,

   160

        // while input FMMUs increment it by 1.

   161

        domain->expected_working_counter +=

   162

            used[EC_DIR_OUTPUT] * 2 + used[EC_DIR_INPUT];

   163

    } else if (used[EC_DIR_OUTPUT]) { // outputs only

   164

        ret = ec_datagram_lwr(datagram, logical_offset, data_size, data);

   165

        if (ret < 0) {

   166

            kfree(datagram);

   167

            return ret;

   168

        }

   169

        domain->expected_working_counter += used[EC_DIR_OUTPUT];

   170

    } else { // inputs only (or nothing)

   171

        ret = ec_datagram_lrd(datagram, logical_offset, data_size, data);

   172

        if (ret < 0) {

   173

            kfree(datagram);

   174

            return ret;

   175

        }

   176

        domain->expected_working_counter += used[EC_DIR_INPUT];

   177

    }

   178

   179

    ec_datagram_zero(datagram);

   180

    list_add_tail(&datagram->list, &domain->datagrams);

   181

    return 0;

   182

}

   183

   184

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

   185

   186

/** Finishes a domain.

   187

 *

   188

 * This allocates the necessary datagrams and writes the correct logical

   189

 * addresses to every configured FMMU.

   190

 *

   191

 * \todo Check for FMMUs that do not fit into any datagram.

   192

 *

   193

 * \retval  0 Success

   194

 * \retval <0 Error code.

   195

 */

   196

int ec_domain_finish(

   197

        ec_domain_t *domain, /**< EtherCAT domain. */

   198

        uint32_t base_address /**< Logical base address. */

   199

        )

   200

{

   201

    uint32_t datagram_offset;

   202

    size_t datagram_size;

   203

    unsigned int datagram_count;

   204

    unsigned int datagram_used[EC_DIR_COUNT];

   205

    ec_fmmu_config_t *fmmu;

   206

    ec_fmmu_config_t *fmmu_temp;

   207

    const ec_datagram_t *datagram;

   208

    int ret;

   209

   210

    domain->logical_base_address = base_address;

   211

   212

    if (domain->data_size && domain->data_origin == EC_ORIG_INTERNAL) {

   213

        if (!(domain->data =

   214

                    (uint8_t *) kmalloc(domain->data_size, GFP_KERNEL))) {

   215

            EC_ERR("Failed to allocate %zu bytes internal memory for"

   216

                    " domain %u!\n", domain->data_size, domain->index);

   217

            return -ENOMEM;

   218

        }

   219

    }

   220

   221

    // Cycle through all domain FMMUS and

   222

    // - correct the logical base addresses

   223

    // - set up the datagrams to carry the process data

   224

    datagram_offset = 0;

   225

    datagram_size = 0;

   226

    datagram_count = 0;

   227

    datagram_used[EC_DIR_OUTPUT] = 0;

   228

    datagram_used[EC_DIR_INPUT] = 0;

   229

   230

    list_for_each_entry(fmmu_temp, &domain->fmmu_configs, list) {

   231

        // we have to remove the constness, sorry FIXME

   232

        ec_slave_config_t *sc = (ec_slave_config_t *) fmmu_temp->sc;

   233

        sc->used_for_fmmu_datagram[fmmu_temp->dir] = 0;

   234

    }

   235

   236

    list_for_each_entry(fmmu, &domain->fmmu_configs, list) {

   237

        // Correct logical FMMU address

   238

        fmmu->logical_start_address += base_address;

   239

   240

        // Increment Input/Output counter to determine datagram types

   241

        // and calculate expected working counters

   242

        if (fmmu->sc->used_for_fmmu_datagram[fmmu->dir] == 0) {

   243

            ec_slave_config_t *sc = (ec_slave_config_t *)fmmu->sc;

   244

            datagram_used[fmmu->dir]++;

   245

            sc->used_for_fmmu_datagram[fmmu->dir] = 1;

   246

        }

   247

   248

        // If the current FMMU's data do not fit in the current datagram,

   249

        // allocate a new one.

   250

        if (datagram_size + fmmu->data_size > EC_MAX_DATA_SIZE) {

   251

            ret = ec_domain_add_datagram(domain,

   252

                    domain->logical_base_address + datagram_offset,

   253

                    datagram_size, domain->data + datagram_offset,

   254

                    datagram_used);

   255

            if (ret < 0)

   256

                return ret;

   257

            datagram_offset += datagram_size;

   258

            datagram_size = 0;

   259

            datagram_count++;

   260

            datagram_used[EC_DIR_OUTPUT] = 0;

   261

            datagram_used[EC_DIR_INPUT] = 0;

   262

            list_for_each_entry(fmmu_temp, &domain->fmmu_configs, list) {

   263

                ec_slave_config_t *sc = (ec_slave_config_t *)fmmu_temp->sc;

   264

               sc->used_for_fmmu_datagram[fmmu_temp->dir] = 0;

   265

            }

   266

        }

   267

   268

        datagram_size += fmmu->data_size;

   269

    }

   270

   271

    // Allocate last datagram, if data are left (this is also the case if the

   272

    // process data fit into a single datagram)

   273

    if (datagram_size) {

   274

        ret = ec_domain_add_datagram(domain,

   275

                domain->logical_base_address + datagram_offset,

   276

                datagram_size, domain->data + datagram_offset,

   277

                datagram_used);

   278

        if (ret < 0)

   279

            return ret;

   280

        datagram_count++;

   281

    }

   282

   283

    EC_INFO("Domain%u: Logical address 0x%08x, %zu byte, "

   284

            "expected working counter %u.\n", domain->index,

   285

            domain->logical_base_address, domain->data_size,

   286

            domain->expected_working_counter);

   287

    list_for_each_entry(datagram, &domain->datagrams, list) {

   288

        EC_INFO("  Datagram %s: Logical offset 0x%08x, %zu byte, type %s.\n",

   289

                datagram->name, EC_READ_U32(datagram->address),

   290

                datagram->data_size, ec_datagram_type_string(datagram));

   291

    }

   292

   293

    return 0;

   294

}

   295

   296

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

   297

   298

/** Get the number of FMMU configurations of the domain.

   299

 */

   300

unsigned int ec_domain_fmmu_count(const ec_domain_t *domain)

   301

{

   302

    const ec_fmmu_config_t *fmmu;

   303

    unsigned int num = 0;

   304

   305

    list_for_each_entry(fmmu, &domain->fmmu_configs, list) {

   306

        num++;

   307

    }

   308

   309

    return num;

   310

}

   311

   312

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

   313

   314

/** Get a certain FMMU configuration via its position in the list.

   315

 */

   316

const ec_fmmu_config_t *ec_domain_find_fmmu(

   317

        const ec_domain_t *domain, /**< EtherCAT domain. */

   318

        unsigned int pos /**< List position. */

   319

        )

   320

{

   321

    const ec_fmmu_config_t *fmmu;

   322

   323

    list_for_each_entry(fmmu, &domain->fmmu_configs, list) {

   324

        if (pos--)

   325

            continue;

   326

        return fmmu;

   327

    }

   328

   329

    return NULL;

   330

}

   331

   332

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

   333

 *  Realtime interface

   334

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

   335

   336

int ecrt_domain_reg_pdo_entry_list(ec_domain_t *domain,

   337

        const ec_pdo_entry_reg_t *regs)

   338

{

   339

    const ec_pdo_entry_reg_t *reg;

   340

    ec_slave_config_t *sc;

   341

    int ret;

   342

   343

    if (domain->master->debug_level)

   344

        EC_DBG("ecrt_domain_reg_pdo_entry_list(domain = 0x%p, regs = 0x%p)\n",

   345

                domain, regs);

   346

   347

    for (reg = regs; reg->index; reg++) {

   348

        sc = ecrt_master_slave_config_err(domain->master, reg->alias,

   349

                reg->position, reg->vendor_id, reg->product_code);

   350

        if (IS_ERR(sc))

   351

            return PTR_ERR(sc);

   352

   353

        ret = ecrt_slave_config_reg_pdo_entry(sc, reg->index,

   354

                        reg->subindex, domain, reg->bit_position);

   355

        if (ret < 0)

   356

            return ret;

   357

   358

        *reg->offset = ret;

   359

    }

   360

   361

    return 0;

   362

}

   363

   364

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

   365

   366

size_t ecrt_domain_size(const ec_domain_t *domain)

   367

{

   368

    return domain->data_size;

   369

}

   370

   371

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

   372

   373

void ecrt_domain_external_memory(ec_domain_t *domain, uint8_t *mem)

   374

{

   375

    if (domain->master->debug_level)

   376

        EC_DBG("ecrt_domain_external_memory(domain = 0x%p, mem = 0x%p)\n",

   377

                domain, mem);

   378

   379

    down(&domain->master->master_sem);

   380

   381

    ec_domain_clear_data(domain);

   382

   383

    domain->data = mem;

   384

    domain->data_origin = EC_ORIG_EXTERNAL;

   385

   386

    up(&domain->master->master_sem);

   387

}

   388

   389

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

   390

   391

uint8_t *ecrt_domain_data(ec_domain_t *domain)

   392

{

   393

    return domain->data;

   394

}

   395

   396

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

   397

   398

void ecrt_domain_process(ec_domain_t *domain)

   399

{

   400

    uint16_t working_counter_sum;

   401

    ec_datagram_t *datagram;

   402

   403

    working_counter_sum = 0x0000;

   404

    list_for_each_entry(datagram, &domain->datagrams, list) {

   405

        ec_datagram_output_stats(datagram);

   406

        if (datagram->state == EC_DATAGRAM_RECEIVED) {

   407

            working_counter_sum += datagram->working_counter;

   408

        }

   409

    }

   410

   411

    if (working_counter_sum != domain->working_counter) {

   412

        domain->working_counter_changes++;

   413

        domain->working_counter = working_counter_sum;

   414

    }

   415

   416

    if (domain->working_counter_changes &&

   417

        jiffies - domain->notify_jiffies > HZ) {

   418

        domain->notify_jiffies = jiffies;

   419

        if (domain->working_counter_changes == 1) {

   420

            EC_INFO("Domain %u: Working counter changed to %u/%u.\n",

   421

                    domain->index, domain->working_counter,

   422

                    domain->expected_working_counter);

   423

        } else {

   424

            EC_INFO("Domain %u: %u working counter changes - now %u/%u.\n",

   425

                    domain->index, domain->working_counter_changes,

   426

                    domain->working_counter, domain->expected_working_counter);

   427

        }

   428

        domain->working_counter_changes = 0;

   429

    }

   430

}

   431

   432

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

   433

   434

void ecrt_domain_queue(ec_domain_t *domain)

   435

{

   436

    ec_datagram_t *datagram;

   437

   438

    list_for_each_entry(datagram, &domain->datagrams, list) {

   439

        ec_master_queue_datagram(domain->master, datagram);

   440

    }

   441

}

   442

   443

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

   444

   445

void ecrt_domain_state(const ec_domain_t *domain, ec_domain_state_t *state)

   446

{

   447

    state->working_counter = domain->working_counter;

   448

   449

    if (domain->working_counter) {

   450

        if (domain->working_counter == domain->expected_working_counter) {

   451

            state->wc_state = EC_WC_COMPLETE;

   452

        } else {

   453

            state->wc_state = EC_WC_INCOMPLETE;

   454

        }

   455

    } else {

   456

        state->wc_state = EC_WC_ZERO;

   457

    }

   458

}

   459

   460

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

   461

   462

/** \cond */

   463

   464

EXPORT_SYMBOL(ecrt_domain_reg_pdo_entry_list);

   465

EXPORT_SYMBOL(ecrt_domain_size);

   466

EXPORT_SYMBOL(ecrt_domain_external_memory);

   467

EXPORT_SYMBOL(ecrt_domain_data);

   468

EXPORT_SYMBOL(ecrt_domain_process);

   469

EXPORT_SYMBOL(ecrt_domain_queue);

   470

EXPORT_SYMBOL(ecrt_domain_state);

   471

   472

/** \endcond */

   473

   474

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