examples/gene_SYNC_HCS12/objdict.html
changeset 0 4472ee7c6c3e
equal deleted inserted replaced
-1:000000000000 0:4472ee7c6c3e
       
     1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
       
     2 <html>
       
     3 <head>
       
     4 <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
       
     5 <title>CANOpen object dictionary Configuration</title>
       
     6 <style type="text/css">
       
     7          table {
       
     8 	  border: 1px solid #200088;
       
     9         }
       
    10 	  td {
       
    11 	  border: 1px solid #200088;
       
    12         }
       
    13          h1 {
       
    14 	   background: #FFDD66;
       
    15 	   border: 3px solid #AA0000;
       
    16            margin: 2em;
       
    17            padding: 1em;
       
    18 	 }
       
    19 
       
    20          h2, h2.dico, h2.pdo {
       
    21 	   background: #5577FF;
       
    22 	   border: 1px solid #AA0000;
       
    23            margin: 1em;
       
    24 	 }
       
    25 	 
       
    26 	  h1 em.node-id {
       
    27 	  color: #0728FF;
       
    28 	  padding-left: 1em;
       
    29 	  padding-right: 1em;
       
    30 	  }
       
    31 
       
    32 	  h1 em.type-node {
       
    33 	  color: #26BE08;
       
    34 	  padding-left: 1em;
       
    35 	  padding-right: 1em;
       
    36 	  }
       
    37 
       
    38 	  em.pdo-mode {
       
    39 	  color: #26BE08;
       
    40 	  }
       
    41 
       
    42 	  .entree {
       
    43 	  color: #AA0000;
       
    44 	  }
       
    45          
       
    46 	  .nom-var, .node-nom {
       
    47 	  color: #660000;
       
    48 	  }
       
    49 
       
    50 	</style>
       
    51 </head>
       
    52 <body text="#000000" bgcolor="#ffffff">
       
    53 <h1>Object dictionary for Node : </h1>
       
    54 <h1>
       
    55 <em class="node-id">0x03</em>(default) 
       
    56 	<em class="node-nom">Gene_SYNC</em><em class="type-node">slave</em>
       
    57 </h1>
       
    58 <h2>Overview</h2>
       
    59 <p>
       
    60 	How to make the object dictionary of the node ?
       
    61 	First, use Jaxe (command run_objdict) to edit an xml description file
       
    62 of the dictionary : objdict.xml.
       
    63 Then, run the php program : makeobjetdict.php. You can launch php through a web browser
       
    64 if you have installed a server, or, on Linux, you can launch php in command line :
       
    65 php-cgi makeobjetdict.php. It compute the file objdict.c. Link it to
       
    66         your project.
       
    67 <br>Note : To define the node id, use in your code the function setNodeId(UNS8 nodeId)
       
    68 	</p>
       
    69 <p>
       
    70 	  Then the node can be connected to the network. The master must configure it
       
    71 	  by sending SDO. It will write values in its index, subindex. What to configure ? 
       
    72 	  <ul>
       
    73 <li>Receiving heartbeats from which nodes ? Waiting time ?</li>
       
    74 <li>Emitting heartbeats or not ? time btw 2 heartbeats ? </li>
       
    75 <li>Defining a cobId for each PDO receive and transmit</li>
       
    76 <li>How to transmit a PDO ? on synchro ? request ? event ?</li>
       
    77 <li>What variables to put in each PDO receive and transmit ? </li>
       
    78 <li>...</li>
       
    79 </ul>
       
    80 </p>
       
    81 	To avoid configuring the node at the connection, you can put the values directly
       
    82 in the dictionary objdict.c. But it is boring and unsafe because it is too easy to make
       
    83 a mistake !
       
    84 
       
    85       
       
    86 	<h2>Number of heartbeat consumers : 
       
    87     <em class="entree">1</em>
       
    88 </h2>
       
    89 <p>This means that the node can expect heartbeats sent by 1 nodes. </p>
       
    90 <h2>Number of SDO clients : 
       
    91     <em class="entree">1</em>
       
    92 </h2>
       
    93 <p>Usualy, a slave node does not have the use of SDO clients, but
       
    94     today, for the library, you must define one. The Master, which can
       
    95     send SDO to "n" slaves nodes, must define here "n" SDO
       
    96     clients. Remember that in most cases, the SDO protocol is used by
       
    97     the master to configure a slave dictionary or read a value. In
       
    98     this use, the master is the client, and the slave is the server.</p>
       
    99 <h2>Mapped variables and tables</h2>
       
   100 <p>3 tables are defined for the mapping, starting at index 0x2000, 0x6000 and 0x6200.
       
   101 	You must start the mapping at the beginning of one of a table, without holes in index
       
   102 or subindex. For example, variables in 0x2000 and 0x2001 is ok, but variables in 0x2000 and 0x2002 is not allowed, because you are loosing room in memory. It is the same for the subindex.
       
   103 </p>
       
   104 <p>
       
   105 	The access of the variable is by default "rw" (read-write) or "ro" (read-only). A read-only variable cannot be mapped in a PDO receive.
       
   106 </p>
       
   107 <p>Here are some others rules for the mapping : </p>
       
   108 <ul>
       
   109 <li>At an Index, you can map a variable at subindex 0x0 or 0x1, as you like.</li>
       
   110 <li>To map several variables at the same Index, you must start at subindex 0x1,
       
   111 	  because in this case, the subindex 0x0 contains the number of subindex.</li>
       
   112 <li>You cannot map variables and tables at the same index.</li>
       
   113 <li>The mapping of a table is always starting at subindex 0x1.</li>
       
   114 </ul>
       
   115 <table class="mapping">
       
   116 <tr>
       
   117 <td>Var Name</td><td>Bits</td><td>Index</td><td>Sub-index</td><td>access</td>
       
   118 </tr>
       
   119 <tr>
       
   120 <td><em>canopenErrNB</em></td><td><em class="entree">32</em></td><td><em class="entree">0x6000</em></td><td><em class="entree">0x01</em></td><td><em class="entree"></em></td>
       
   121 </tr>
       
   122 <tr>
       
   123 <td><em>canopenErrVAL</em></td><td><em class="entree">32</em></td><td><em class="entree">0x6000</em></td><td><em class="entree">0x02</em></td><td><em class="entree"></em></td>
       
   124 </tr>
       
   125 <td>Table Name</td><td>Bits</td><td>Index</td><td>Sub-index</td><td>access</td>
       
   126 </table>
       
   127 </body>
       
   128 </html>