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 <map>

    32

using namespace std;

    33

    34

#include "CommandGraph.h"

    35

    36

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

    37

    38

CommandGraph::CommandGraph():

    39

    Command("graph", "Output the bus topology as a graph.")

    40

{

    41

}

    42

    43

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

    44

    45

string CommandGraph::helpString() const

    46

{

    47

    stringstream str;

    48

    49

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

    50

        << endl

    51

        << getBriefDescription() << endl

    52

        << endl

    53

        << "The bus is output in DOT language (see" << endl

    54

        << "http://www.graphviz.org/doc/info/lang.html), which can" << endl

    55

        << "be processed with the tools from the Graphviz" << endl

    56

        << "package. Example:" << endl

    57

        << endl

    58

        << "  ethercat graph | dot -Tsvg > bus.svg" << endl

    59

        << endl

    60

        << "See 'man dot' for more information." << endl;

    61

    62

    return str.str();

    63

}

    64

    65

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

    66

    67

void CommandGraph::execute(MasterDevice &m, const StringVector &args)

    68

{

    69

    ec_ioctl_master_t master;

    70

    unsigned int i;

    71

    typedef vector<ec_ioctl_slave_t> SlaveVector;

    72

    SlaveVector slaves;

    73

    ec_ioctl_slave_t slave;

    74

    SlaveVector::const_iterator si;

    75

    map<int, string> portMedia;

    76

    map<int, string>::const_iterator mi;

    77

    map<int, int> mediaWeights;

    78

    map<int, int>::const_iterator wi;

    79

    80

    portMedia[EC_PORT_MII] = "MII";

    81

    mediaWeights[EC_PORT_MII] = 1;

    82

    83

    portMedia[EC_PORT_EBUS] = "EBUS";

    84

    mediaWeights[EC_PORT_EBUS] = 5;

    85

    86

    if (args.size()) {

    87

        stringstream err;

    88

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

    89

        throwInvalidUsageException(err);

    90

    }

    91

    92

    m.open(MasterDevice::Read);

    93

    m.getMaster(&master);

    94

    95

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

    96

        m.getSlave(&slave, i);

    97

        slaves.push_back(slave);

    98

    }

    99

   100

    cout << "/* EtherCAT bus graph. Generated by 'ethercat graph'. */" << endl

   101

        << endl

   102

        << "strict graph bus {" << endl

   103

        << "    rankdir=\"LR\"" << endl

   104

        << "    ranksep=0.8" << endl

   105

        << "    nodesep=0.8" << endl

   106

        << "    node [fontname=\"Helvetica\"]" << endl

   107

        << "    edge [fontname=\"Helvetica\",fontsize=\"10\"]" << endl

   108

        << endl

   109

        << "    master [label=\"EtherCAT\\nMaster\"]" << endl;

   110

   111

    if (slaves.size()) {

   112

        cout << "    master -- slave0"; 

   113

        mi = portMedia.find(slaves.front().ports[0].desc);

   114

        if (mi != portMedia.end())

   115

            cout << "[label=\"" << mi->second << "\"]";

   116

   117

        cout << endl;

   118

    }

   119

    cout << endl;

   120

   121

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

   122

	    cout << "    slave" << si->position << " [shape=\"box\""

   123

            << ",label=\"" << si->position;

   124

        if (string(si->order).size())

   125

            cout << "\\n" << si->order;

   126

        if (si->dc_supported) {

   127

            cout << "\\nDC: ";

   128

            if (si->has_dc_system_time) {

   129

                switch (si->dc_range) {

   130

                    case EC_DC_32:

   131

                        cout << "32 bit";

   132

                        break;

   133

                    case EC_DC_64:

   134

                        cout << "64 bit";

   135

                        break;

   136

                    default:

   137

                        break;

   138

                }

   139

            } else {

   140

                cout << "Delay meas.";

   141

            }

   142

            cout << "\\nDelay: " << si->transmission_delay << " ns";

   143

        }

   144

        cout << "\"]" << endl;

   145

   146

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

   147

            uint16_t next_pos = si->ports[i].next_slave;

   148

            ec_ioctl_slave_t *next = NULL;

   149

   150

            if (next_pos == 0xffff)

   151

                continue;

   152

   153

            if (next_pos < slaves.size()) {

   154

                next = &slaves[next_pos];

   155

            } else {

   156

                cerr << "Invalid next slave pointer." << endl;

   157

            }

   158

   159

            cout << "    slave" << si->position << " -- "

   160

                << "slave" << next_pos << " [taillabel=\"" << i;

   161

   162

            if (si->dc_supported) {

   163

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

   164

            }

   165

            cout << "\",headlabel=\"0";

   166

   167

            if (next && next->dc_supported) {

   168

                cout << " [" << next->ports[0].delay_to_next_dc << "]";

   169

            }

   170

            cout << "\"";

   171

   172

            mi = portMedia.find(si->ports[i].desc);

   173

            if (mi == portMedia.end() && next) {

   174

                /* Try medium of next-hop slave. */

   175

                mi = portMedia.find(next->ports[0].desc);

   176

            }

   177

   178

            if (mi != portMedia.end())

   179

                cout << ",label=\"" << mi->second << "\"";

   180

   181

            wi = mediaWeights.find(si->ports[i].desc);

   182

            if (wi != mediaWeights.end())

   183

                cout << ",weight=\"" << wi->second << "\"";

   184

   185

            cout << "]" << endl;

   186

        }

   187

   188

        cout << endl;

   189

    }

   190

   191

    cout << "}" << endl;

   192

}

   193

   194

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