1

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

     2

 *

     3

 *  $Id$

     4

 *

     5

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

    31

#include <iomanip>

    32

#include <list>

    33

#include <string.h>

    34

using namespace std;

    35

    36

#include "CommandSlaves.h"

    37

#include "MasterDevice.h"

    38

    39

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

    40

    41

CommandSlaves::CommandSlaves():

    42

    Command("slaves", "Display slaves on the bus.")

    43

{

    44

}

    45

    46

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

    47

    48

string CommandSlaves::helpString() const

    49

{

    50

    stringstream str;

    51

    52

    str << getName() << " [OPTIONS]" << endl

    53

        << endl

    54

        << getBriefDescription() << endl

    55

        << endl

    56

        << "If the --verbose option is not given, the slaves are" << endl

    57

        << "displayed one-per-line. Example:" << endl

    58

        << endl

    59

        << "1  5555:0  PREOP  +  EL3162 2C. Ana. Input 0-10V" << endl

    60

        << "|  |    |  |      |  |" << endl

    61

        << "|  |    |  |      |  \\- Name from the SII if avaliable," << endl

    62

        << "|  |    |  |      |     otherwise vendor ID and product" << endl

    63

        << "|  |    |  |      |     code (both hexadecimal)." << endl

    64

        << "|  |    |  |      \\- Error flag. '+' means no error," << endl

    65

        << "|  |    |  |         'E' means that scan or" << endl

    66

        << "|  |    |  |         configuration failed." << endl

    67

        << "|  |    |  \\- Current application-layer state." << endl

    68

        << "|  |    \\- Decimal relative position to the last" << endl

    69

        << "|  |       slave with an alias address set." << endl

    70

        << "|  \\- Decimal alias address of this slave (if set)," << endl

    71

        << "|     otherwise of the last slave with an alias set," << endl

    72

        << "|     or zero, if no alias was encountered up to this" << endl

    73

        << "|     position." << endl

    74

        << "\\- Absolute ring position in the bus." << endl

    75

        << endl

    76

        << "If the --verbose option is given, a detailed (multi-line)" << endl

    77

        << "description is output for each slave." << endl

    78

        << endl

    79

        << "Slave selection:" << endl

    80

        << "  Slaves for this and other commands can be selected with" << endl

    81

        << "  the --alias and --position parameters as follows:" << endl

    82

        << endl

    83

        << "  1) If neither the --alias nor the --position option" << endl

    84

        << "     is given, all slaves are selected." << endl

    85

        << "  2) If only the --position option is given, it is" << endl

    86

        << "     interpreted as an absolute ring position and" << endl

    87

        << "     a slave with this position is matched." << endl

    88

        << "  3) If only the --alias option is given, all slaves" << endl

    89

        << "     with the given alias address and subsequent" << endl

    90

        << "     slaves before a slave with a different alias" << endl

    91

        << "     address match (use -p0 if only the slaves" << endl

    92

        << "     with the given alias are desired, see 4))." << endl

    93

        << "  4) If both the --alias and the --position option are" << endl

    94

        << "     given, the latter is interpreted as relative" << endl

    95

        << "     position behind any slave with the given alias." << endl

    96

        << endl

    97

        << "Command-specific options:" << endl

    98

        << "  --alias    -a <alias>  Slave alias (see above)." << endl

    99

        << "  --position -p <pos>    Slave position (see above)." << endl

   100

        << "  --verbose  -v          Show detailed slave information." << endl

   101

        << endl

   102

        << numericInfo();

   103

   104

    return str.str();

   105

}

   106

   107

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

   108

   109

void CommandSlaves::execute(const StringVector &args)

   110

{

   111

	MasterIndexList masterIndices;

   112

    SlaveList slaves;

   113

    bool doIndent;

   114

   115

    if (args.size()) {

   116

        stringstream err;

   117

        err << "'" << getName() << "' takes no arguments!";

   118

        throwInvalidUsageException(err);

   119

    }

   120

   121

	masterIndices = getMasterIndices();

   122

    doIndent = masterIndices.size() > 1;

   123

    MasterIndexList::const_iterator mi;

   124

    for (mi = masterIndices.begin();

   125

            mi != masterIndices.end(); mi++) {

   126

        MasterDevice m(*mi);

   127

        m.open(MasterDevice::Read);

   128

        slaves = selectedSlaves(m);

   129

   130

        if (getVerbosity() == Verbose) {

   131

            showSlaves(m, slaves);

   132

        } else {

   133

            listSlaves(m, slaves, doIndent);

   134

        }

   135

    }

   136

}

   137

   138

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

   139

   140

void CommandSlaves::listSlaves(

   141

        MasterDevice &m,

   142

        const SlaveList &slaves,

   143

        bool doIndent

   144

        )

   145

{

   146

    ec_ioctl_master_t master;

   147

    unsigned int i;

   148

    ec_ioctl_slave_t slave;

   149

    uint16_t lastAlias, aliasIndex;

   150

    Info info;

   151

    typedef list<Info> InfoList;

   152

    InfoList infoList;

   153

    InfoList::const_iterator iter;

   154

    stringstream str;

   155

    unsigned int maxPosWidth = 0, maxAliasWidth = 0,

   156

                 maxRelPosWidth = 0, maxStateWidth = 0;

   157

    string indent(doIndent ? "  " : "");

   158

   159

    m.getMaster(&master);

   160

   161

    lastAlias = 0;

   162

    aliasIndex = 0;

   163

    for (i = 0; i < master.slave_count; i++) {

   164

        m.getSlave(&slave, i);

   165

   166

        if (slave.alias) {

   167

            lastAlias = slave.alias;

   168

            aliasIndex = 0;

   169

        }

   170

   171

        if (slaveInList(slave, slaves)) {

   172

            str << dec << i;

   173

            info.pos = str.str();

   174

            str.clear();

   175

            str.str("");

   176

   177

            str << lastAlias;

   178

            info.alias = str.str();

   179

            str.str("");

   180

   181

            str << aliasIndex;

   182

            info.relPos = str.str();

   183

            str.str("");

   184

   185

            info.state = alStateString(slave.al_state);

   186

            info.flag = (slave.error_flag ? 'E' : '+');

   187

   188

            if (strlen(slave.name)) {

   189

                info.name = slave.name;

   190

            } else {

   191

                str << "0x" << hex << setfill('0')

   192

                    << setw(8) << slave.vendor_id << ":0x"

   193

                    << setw(8) << slave.product_code;

   194

                info.name = str.str();

   195

                str.str("");

   196

            }

   197

   198

   199

            infoList.push_back(info);

   200

   201

            if (info.pos.length() > maxPosWidth)

   202

                maxPosWidth = info.pos.length();

   203

            if (info.alias.length() > maxAliasWidth)

   204

                maxAliasWidth = info.alias.length();

   205

            if (info.relPos.length() > maxRelPosWidth)

   206

                maxRelPosWidth = info.relPos.length();

   207

            if (info.state.length() > maxStateWidth)

   208

                maxStateWidth = info.state.length();

   209

        }

   210

   211

        aliasIndex++;

   212

    }

   213

   214

    if (infoList.size() && doIndent) {

   215

        cout << "Master" << dec << m.getIndex() << endl;

   216

    }

   217

   218

    for (iter = infoList.begin(); iter != infoList.end(); iter++) {

   219

        cout << indent << setfill(' ') << right

   220

            << setw(maxPosWidth) << iter->pos << "  "

   221

            << setw(maxAliasWidth) << iter->alias

   222

            << ":" << left

   223

            << setw(maxRelPosWidth) << iter->relPos << "  "

   224

            << setw(maxStateWidth) << iter->state << "  "

   225

            << iter->flag << "  "

   226

            << iter->name << endl;

   227

    }

   228

}

   229

   230

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

   231

   232

void CommandSlaves::showSlaves(

   233

        MasterDevice &m,

   234

        const SlaveList &slaves

   235

        )

   236

{

   237

    SlaveList::const_iterator si;

   238

    int i;

   239

   240

    for (si = slaves.begin(); si != slaves.end(); si++) {

   241

        cout << "=== Master " << dec << m.getIndex()

   242

            << ", Slave " << dec << si->position << " ===" << endl;

   243

   244

        if (si->alias)

   245

            cout << "Alias: " << si->alias << endl;

   246

   247

        cout

   248

            << "State: " << alStateString(si->al_state) << endl

   249

            << "Flag: " << (si->error_flag ? 'E' : '+') << endl

   250

            << "Identity:" << endl

   251

            << "  Vendor Id:       0x"

   252

            << hex << setfill('0')

   253

            << setw(8) << si->vendor_id << endl

   254

            << "  Product code:    0x"

   255

            << setw(8) << si->product_code << endl

   256

            << "  Revision number: 0x"

   257

            << setw(8) << si->revision_number << endl

   258

            << "  Serial number:   0x"

   259

            << setw(8) << si->serial_number << endl;

   260

   261

        cout << "DL information:" << endl

   262

            << "  FMMU bit operation: "

   263

            << (si->fmmu_bit ? "yes" : "no") << endl

   264

            << "  Distributed clocks: ";

   265

        if (si->dc_supported) {

   266

            if (si->has_dc_system_time) {

   267

                cout << "yes, ";

   268

                switch (si->dc_range) {

   269

                    case EC_DC_32:

   270

                        cout << "32 bit";

   271

                        break;

   272

                    case EC_DC_64:

   273

                        cout << "64 bit";

   274

                        break;

   275

                    default:

   276

                        cout << "???";

   277

                }

   278

                cout << endl;

   279

            } else {

   280

                cout << "yes, delay measurement only" << endl;

   281

            }

   282

            cout << "  DC system time transmission delay: "

   283

                << dec << si->transmission_delay << " ns" << endl;

   284

        } else {

   285

            cout << "no" << endl;

   286

        }

   287

   288

        cout << "Port  Type  Link  Loop    Signal  NextSlave";

   289

        if (si->dc_supported)

   290

            cout << "  RxTime [ns]  Diff [ns]   NextDc [ns]";

   291

        cout << endl;

   292

   293

        for (i = 0; i < EC_MAX_PORTS; i++) {

   294

            cout << "   " << i << "  " << setfill(' ') << left << setw(4);

   295

            switch (si->ports[i].desc) {

   296

                case EC_PORT_NOT_IMPLEMENTED:

   297

                    cout << "N/A";

   298

                    break;

   299

                case EC_PORT_NOT_CONFIGURED:

   300

                    cout << "N/C";

   301

                    break;

   302

                case EC_PORT_EBUS:

   303

                    cout << "EBUS";

   304

                    break;

   305

                case EC_PORT_MII:

   306

                    cout << "MII";

   307

                    break;

   308

                default:

   309

                    cout << "???";

   310

            }

   311

   312

            cout << "  " << setw(4)

   313

                << (si->ports[i].link.link_up ? "up" : "down")

   314

                << "  " << setw(6)

   315

                << (si->ports[i].link.loop_closed ? "closed" : "open")

   316

                << "  " << setw(6)

   317

                << (si->ports[i].link.signal_detected ? "yes" : "no")

   318

                << "  " << setw(9) << right;

   319

   320

            if (si->ports[i].next_slave != 0xffff) {

   321

                cout << dec << si->ports[i].next_slave;

   322

            } else {

   323

                cout << "-";

   324

            }

   325

   326

            if (si->dc_supported) {

   327

                cout << "  " << setw(11) << right;

   328

                if (!si->ports[i].link.loop_closed) {

   329

                    cout << dec << si->ports[i].receive_time;

   330

                } else {

   331

                    cout << "-";

   332

                }

   333

                cout << "  " << setw(10);

   334

                if (!si->ports[i].link.loop_closed) {

   335

                    cout << si->ports[i].receive_time - si->ports[0].receive_time;

   336

                } else {

   337

                    cout << "-";

   338

                }

   339

                cout << "  " << setw(10);

   340

                if (!si->ports[i].link.loop_closed) {

   341

                    cout << si->ports[i].delay_to_next_dc;

   342

                } else {

   343

                    cout << "-";

   344

                }

   345

            }

   346

   347

            cout << endl;

   348

        }

   349

   350

        if (si->mailbox_protocols) {

   351

            list<string> protoList;

   352

            list<string>::const_iterator protoIter;

   353

   354

            cout << "Mailboxes:" << endl

   355

                << "  Bootstrap RX: 0x" << setfill('0')

   356

                << hex << setw(4) << si->boot_rx_mailbox_offset << "/"

   357

                << dec << si->boot_rx_mailbox_size

   358

                << ", TX: 0x"

   359

                << hex << setw(4) << si->boot_tx_mailbox_offset << "/"

   360

                << dec << si->boot_tx_mailbox_size << endl

   361

                << "  Standard  RX: 0x"

   362

                << hex << setw(4) << si->std_rx_mailbox_offset << "/"

   363

                << dec << si->std_rx_mailbox_size

   364

                << ", TX: 0x"

   365

                << hex << setw(4) << si->std_tx_mailbox_offset << "/"

   366

                << dec << si->std_tx_mailbox_size << endl

   367

                << "  Supported protocols: ";

   368

   369

            if (si->mailbox_protocols & EC_MBOX_AOE) {

   370

                protoList.push_back("AoE");

   371

            }

   372

            if (si->mailbox_protocols & EC_MBOX_EOE) {

   373

                protoList.push_back("EoE");

   374

            }

   375

            if (si->mailbox_protocols & EC_MBOX_COE) {

   376

                protoList.push_back("CoE");

   377

            }

   378

            if (si->mailbox_protocols & EC_MBOX_FOE) {

   379

                protoList.push_back("FoE");

   380

            }

   381

            if (si->mailbox_protocols & EC_MBOX_SOE) {

   382

                protoList.push_back("SoE");

   383

            }

   384

            if (si->mailbox_protocols & EC_MBOX_VOE) {

   385

                protoList.push_back("VoE");

   386

            }

   387

   388

            for (protoIter = protoList.begin(); protoIter != protoList.end();

   389

                    protoIter++) {

   390

                if (protoIter != protoList.begin())

   391

                    cout << ", ";

   392

                cout << *protoIter;

   393

            }

   394

            cout << endl;

   395

        }

   396

   397

        if (si->has_general_category) {

   398

            cout << "General:" << endl

   399

                << "  Group: " << si->group << endl

   400

                << "  Image name: " << si->image << endl

   401

                << "  Order number: " << si->order << endl

   402

                << "  Device name: " << si->name << endl;

   403

   404

            if (si->mailbox_protocols & EC_MBOX_COE) {

   405

                cout << "  CoE details:" << endl

   406

                    << "    Enable SDO: "

   407

                    << (si->coe_details.enable_sdo ? "yes" : "no") << endl

   408

                    << "    Enable SDO Info: "

   409

                    << (si->coe_details.enable_sdo_info ? "yes" : "no") << endl

   410

                    << "    Enable PDO Assign: "

   411

                    << (si->coe_details.enable_pdo_assign

   412

                            ? "yes" : "no") << endl

   413

                    << "    Enable PDO Configuration: "

   414

                    << (si->coe_details.enable_pdo_configuration

   415

                            ? "yes" : "no") << endl

   416

                    << "    Enable Upload at startup: "

   417

                    << (si->coe_details.enable_upload_at_startup

   418

                            ? "yes" : "no") << endl

   419

                    << "    Enable SDO complete access: "

   420

                    << (si->coe_details.enable_sdo_complete_access

   421

                            ? "yes" : "no") << endl;

   422

            }

   423

   424

            cout << "  Flags:" << endl

   425

                << "    Enable SafeOp: "

   426

                << (si->general_flags.enable_safeop ? "yes" : "no") << endl

   427

                << "    Enable notLRW: "

   428

                << (si->general_flags.enable_not_lrw ? "yes" : "no") << endl

   429

                << "  Current consumption: "

   430

                << dec << si->current_on_ebus << " mA" << endl;

   431

        }

   432

    }

   433

}

   434

   435

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

   436

   437

bool CommandSlaves::slaveInList(

   438

        const ec_ioctl_slave_t &slave,

   439

        const SlaveList &slaves

   440

        )

   441

{

   442

    SlaveList::const_iterator si;

   443

   444

    for (si = slaves.begin(); si != slaves.end(); si++) {

   445

        if (si->position == slave.position) {

   446

            return true;

   447

        }

   448

    }

   449

   450

    return false;

   451

}

   452

   453

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