author | etisserant |
Mon, 03 Dec 2007 13:09:19 +0100 | |
changeset 321 | 994457edada8 |
parent 175 | e255529b6f7d |
child 378 | d2abf6c8c27b |
permissions | -rw-r--r-- |
0 | 1 |
/* |
2 |
This file is part of CanFestival, a library implementing CanOpen Stack. |
|
3 |
||
4 |
Copyright (C): Edouard TISSERANT and Francis DUPIN |
|
5 |
||
6 |
See COPYING file for copyrights details. |
|
7 |
||
8 |
This library is free software; you can redistribute it and/or |
|
9 |
modify it under the terms of the GNU Lesser General Public |
|
10 |
License as published by the Free Software Foundation; either |
|
11 |
version 2.1 of the License, or (at your option) any later version. |
|
12 |
||
13 |
This library 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 |
|
16 |
Lesser General Public License for more details. |
|
17 |
||
18 |
You should have received a copy of the GNU Lesser General Public |
|
19 |
License along with this library; if not, write to the Free Software |
|
20 |
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
|
21 |
*/ |
|
22 |
||
23 |
/** \file |
|
24 |
* \brief Responsible for accessing the object dictionary. |
|
25 |
* |
|
26 |
* This file contains functions for accessing the object dictionary and |
|
27 |
* variables that are contained by the object dictionary. |
|
28 |
* Accessing the object dictionary contains setting local variables |
|
29 |
* as PDOs and accessing (read/write) all entries of the object dictionary |
|
30 |
* \warning Only the basic entries of an object dictionary are included |
|
31 |
* at the moment. |
|
32 |
*/ |
|
33 |
||
34 |
#ifndef __objacces_h__ |
|
35 |
#define __objacces_h__ |
|
36 |
||
37 |
#include <applicfg.h> |
|
38 |
||
39 |
typedef UNS32 (*valueRangeTest_t)(UNS8 typeValue, void *Value); |
|
161
c4908cc776a9
SetODEntry now call CO_data->storeODSubEntry(Index,SubIndex) for variables to be Stored (when column Save==True in GUI)
etisserant
parents:
75
diff
changeset
|
40 |
typedef void (* storeODSubIndex_t)(UNS16 wIndex, UNS8 bSubindex); |
c4908cc776a9
SetODEntry now call CO_data->storeODSubEntry(Index,SubIndex) for variables to be Stored (when column Save==True in GUI)
etisserant
parents:
75
diff
changeset
|
41 |
void _storeODSubIndex (UNS16 wIndex, UNS8 bSubindex); |
0 | 42 |
|
43 |
#include "data.h" |
|
44 |
||
45 |
||
46 |
||
71 | 47 |
/* |
0 | 48 |
Print MSG_WAR (s) if error to the access to the object dictionary occurs. |
71 | 49 |
You must uncomment the lines |
0 | 50 |
//#define DEBUG_CAN |
51 |
//#define DEBUG_WAR_CONSOLE_ON |
|
52 |
//#define DEBUG_ERR_CONSOLE_ON |
|
71 | 53 |
in the file objaccess.c |
0 | 54 |
sizeDataDict : Size of the data defined in the dictionary |
55 |
sizeDataGiven : Size data given by the user. |
|
56 |
code : error code to print. (SDO abort code. See file def.h) |
|
57 |
Beware that sometimes, we force the sizeDataDict or sizeDataGiven to 0, when we wants to use |
|
58 |
this function but we do not have the access to the right value. One example is |
|
59 |
getSDOerror(). So do not take attention to these variables if they are null. |
|
60 |
*/ |
|
75
debc68b124b7
compiler compatibility : accessDictionaryError contains nothing out of debogue mode
frdupin
parents:
71
diff
changeset
|
61 |
|
0 | 62 |
UNS8 accessDictionaryError(UNS16 index, UNS8 subIndex, |
63 |
UNS8 sizeDataDict, UNS8 sizeDataGiven, UNS32 code); |
|
75
debc68b124b7
compiler compatibility : accessDictionaryError contains nothing out of debogue mode
frdupin
parents:
71
diff
changeset
|
64 |
|
0 | 65 |
|
71 | 66 |
/* Reads an entry from the object dictionary.\n |
0 | 67 |
* \code |
68 |
* // Example usage: |
|
69 |
* UNS8 *pbData; |
|
70 |
* UNS8 length; |
|
71 |
* UNS32 returnValue; |
|
72 |
* |
|
73 |
* returnValue = getODentry( (UNS16)0x100B, (UNS8)1, |
|
74 |
* (void * *)&pbData, (UNS8 *)&length ); |
|
75 |
* if( returnValue != SUCCESSFUL ) |
|
76 |
* { |
|
77 |
* // error handling |
|
78 |
* } |
|
79 |
* \endcode |
|
80 |
* \param wIndex The index in the object dictionary where you want to read |
|
81 |
* an entry |
|
82 |
* \param bSubindex The subindex of the Index. e.g. mostly subindex 0 is |
|
83 |
* used to tell you how many valid entries you can find |
|
84 |
* in this index. Look at the canopen standard for further |
|
85 |
* information |
|
86 |
* \param ppbData Pointer to the pointer which points to the variable where |
|
87 |
* the value of this object dictionary entry should be copied |
|
88 |
* \param pdwSize This function writes the size of the copied value (in Byte) |
|
89 |
* into this variable. |
|
90 |
* \param pDataType : The type of the data. See objdictdef.h |
|
91 |
* \param CheckAccess if other than 0, do not read if the data is Write Only |
|
92 |
* [Not used today. Put always 0]. |
|
93 |
* \return OD_SUCCESSFUL or SDO abort code. (See file def.h) |
|
94 |
*/ |
|
95 |
UNS32 getODentry( CO_Data* d, |
|
96 |
UNS16 wIndex, |
|
97 |
UNS8 bSubindex, |
|
98 |
void * pDestData, |
|
99 |
UNS8 * pExpectedSize, |
|
100 |
UNS8 * pDataType, |
|
101 |
UNS8 checkAccess); |
|
102 |
||
103 |
||
71 | 104 |
/* By this function you can write an entry into the object dictionary\n |
0 | 105 |
* \code |
106 |
* // Example usage: |
|
107 |
* UNS8 B; |
|
108 |
* B = 0xFF; // set transmission type |
|
109 |
* |
|
110 |
* retcode = setODentry( (UNS16)0x1800, (UNS8)2, &B, sizeof(UNS8), 1 ); |
|
111 |
* \endocde |
|
112 |
* \param wIndex The index in the object dictionary where you want to write |
|
113 |
* an entry |
|
114 |
* \param bSubindex The subindex of the Index. e.g. mostly subindex 0 is |
|
115 |
* used to tell you how many valid entries you can find |
|
116 |
* in this index. Look at the canopen standard for further |
|
117 |
* information |
|
118 |
* \param pbData Pointer to the variable that holds the value that should |
|
119 |
* be copied into the object dictionary |
|
120 |
* \param dwSize The size of the value (in Byte). |
|
121 |
* \param CheckAccess if other than 0, do not read if the data is Read Only or Constant |
|
122 |
* \return OD_SUCCESSFUL or SDO abort code. (See file def.h) |
|
123 |
*/ |
|
124 |
UNS32 setODentry( CO_Data* d, |
|
125 |
UNS16 wIndex, |
|
126 |
UNS8 bSubindex, |
|
127 |
void * pSourceData, |
|
128 |
UNS8 * pExpectedSize, |
|
129 |
UNS8 checkAccess); |
|
130 |
||
175
e255529b6f7d
Added writeLocalDict and readLocalDict, that have to be called from application instead of getODEntry and setODEntry. Fix potential endianization problem.
etisserant
parents:
161
diff
changeset
|
131 |
/*The same, without endianisation*/ |
e255529b6f7d
Added writeLocalDict and readLocalDict, that have to be called from application instead of getODEntry and setODEntry. Fix potential endianization problem.
etisserant
parents:
161
diff
changeset
|
132 |
UNS32 writeLocalDict( CO_Data* d, |
e255529b6f7d
Added writeLocalDict and readLocalDict, that have to be called from application instead of getODEntry and setODEntry. Fix potential endianization problem.
etisserant
parents:
161
diff
changeset
|
133 |
UNS16 wIndex, |
e255529b6f7d
Added writeLocalDict and readLocalDict, that have to be called from application instead of getODEntry and setODEntry. Fix potential endianization problem.
etisserant
parents:
161
diff
changeset
|
134 |
UNS8 bSubindex, |
e255529b6f7d
Added writeLocalDict and readLocalDict, that have to be called from application instead of getODEntry and setODEntry. Fix potential endianization problem.
etisserant
parents:
161
diff
changeset
|
135 |
void * pSourceData, |
e255529b6f7d
Added writeLocalDict and readLocalDict, that have to be called from application instead of getODEntry and setODEntry. Fix potential endianization problem.
etisserant
parents:
161
diff
changeset
|
136 |
UNS8 * pExpectedSize, |
e255529b6f7d
Added writeLocalDict and readLocalDict, that have to be called from application instead of getODEntry and setODEntry. Fix potential endianization problem.
etisserant
parents:
161
diff
changeset
|
137 |
UNS8 checkAccess); |
e255529b6f7d
Added writeLocalDict and readLocalDict, that have to be called from application instead of getODEntry and setODEntry. Fix potential endianization problem.
etisserant
parents:
161
diff
changeset
|
138 |
|
0 | 139 |
|
71 | 140 |
/* Scan the index of object dictionary. Used only by setODentry and getODentry. |
0 | 141 |
* *errorCode : OD_SUCCESSFUL if index foundor SDO abort code. (See file def.h) |
142 |
* Return NULL if index not found. Else : return the table part of the object dictionary. |
|
143 |
*/ |
|
144 |
const indextable * scanIndexOD (CO_Data* d, UNS16 wIndex, UNS32 *errorCode, ODCallback_t **Callback); |
|
145 |
||
146 |
UNS32 RegisterSetODentryCallBack(CO_Data* d, UNS16 wIndex, UNS8 bSubindex, ODCallback_t Callback); |
|
147 |
||
71 | 148 |
#endif /* __objacces_h__ */ |