1 /****************************************************************************
3 (c) SYSTEC electronic GmbH, D-07973 Greiz, August-Bebel-Str. 29
4 www.systec-electronic.com
8 Description: Definitions for Abstract Memory Interface
12 Redistribution and use in source and binary forms, with or without
13 modification, are permitted provided that the following conditions
16 1. Redistributions of source code must retain the above copyright
17 notice, this list of conditions and the following disclaimer.
19 2. Redistributions in binary form must reproduce the above copyright
20 notice, this list of conditions and the following disclaimer in the
21 documentation and/or other materials provided with the distribution.
23 3. Neither the name of SYSTEC electronic GmbH nor the names of its
24 contributors may be used to endorse or promote products derived
25 from this software without prior written permission. For written
26 permission, please contact info@systec-electronic.com.
28 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
29 "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
30 LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
31 FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
32 COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
33 INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
34 BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
35 LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
36 CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
37 LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
38 ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
39 POSSIBILITY OF SUCH DAMAGE.
43 If a provision of this License is or becomes illegal, invalid or
44 unenforceable in any jurisdiction, that shall not affect:
45 1. the validity or enforceability in that jurisdiction of any other
46 provision of this License; or
47 2. the validity or enforceability in other jurisdictions of that or
48 any other provision of this License.
50 -------------------------------------------------------------------------
52 $RCSfile: EplAmi.h,v $
56 $Revision: 1.2 $ $Date: 2008/04/17 21:36:32 $
63 -------------------------------------------------------------------------
71 To save code space the functions AmiSetByte and AmiGetByte
72 are replaced by macros. For targets which assign BYTE by
73 an 16Bit type, the definition of macros must changed to
77 Functions included for extended data types such as UNSIGNED24,
81 Extended the interface for EPL with the different functions
82 for little endian and big endian
84 ****************************************************************************/
89 #if ((DEV_SYSTEM & _DEV_64BIT_SUPPORT_) == 0)
91 #error 'ERROR: development system does not support 64 bit operations!'
95 //---------------------------------------------------------------------------
97 //---------------------------------------------------------------------------
99 //---------------------------------------------------------------------------
101 //---------------------------------------------------------------------------
107 //---------------------------------------------------------------------------
111 // To save code space the function AmiSetByte is replaced by
113 // void AmiSetByte (void FAR* pAddr_p, BYTE bByteVal_p);
115 #define AmiSetByteToBe(pAddr_p, bByteVal_p) {*(BYTE FAR*)(pAddr_p) = (bByteVal_p);}
116 #define AmiSetByteToLe(pAddr_p, bByteVal_p) {*(BYTE FAR*)(pAddr_p) = (bByteVal_p);}
118 void AmiSetWordToBe(void FAR *pAddr_p, WORD wWordVal_p);
119 void AmiSetDwordToBe(void FAR *pAddr_p, DWORD dwDwordVal_p);
120 void AmiSetWordToLe(void FAR *pAddr_p, WORD wWordVal_p);
121 void AmiSetDwordToLe(void FAR *pAddr_p, DWORD dwDwordVal_p);
123 //---------------------------------------------------------------------------
127 // To save code space the function AmiGetByte is replaced by
129 // BYTE AmiGetByte (void FAR* pAddr_p);
131 #define AmiGetByteFromBe(pAddr_p) (*(BYTE FAR*)(pAddr_p))
132 #define AmiGetByteFromLe(pAddr_p) (*(BYTE FAR*)(pAddr_p))
134 WORD AmiGetWordFromBe(void FAR *pAddr_p);
135 DWORD AmiGetDwordFromBe(void FAR *pAddr_p);
136 WORD AmiGetWordFromLe(void FAR *pAddr_p);
137 DWORD AmiGetDwordFromLe(void FAR *pAddr_p);
139 //---------------------------------------------------------------------------
141 // Function: AmiSetDword24()
143 // Description: sets a 24 bit value to a buffer
145 // Parameters: pAddr_p = pointer to destination buffer
146 // dwDwordVal_p = value to set
150 //---------------------------------------------------------------------------
152 void AmiSetDword24ToBe(void FAR *pAddr_p, DWORD dwDwordVal_p);
153 void AmiSetDword24ToLe(void FAR *pAddr_p, DWORD dwDwordVal_p);
155 //---------------------------------------------------------------------------
157 // Function: AmiGetDword24()
159 // Description: reads a 24 bit value from a buffer
161 // Parameters: pAddr_p = pointer to source buffer
163 // Return: DWORD = read value
165 //---------------------------------------------------------------------------
167 DWORD AmiGetDword24FromBe(void FAR *pAddr_p);
168 DWORD AmiGetDword24FromLe(void FAR *pAddr_p);
172 //---------------------------------------------------------------------------
174 // Function: AmiSetQword40()
176 // Description: sets a 40 bit value to a buffer
178 // Parameters: pAddr_p = pointer to destination buffer
179 // qwQwordVal_p = quadruple word value
183 //---------------------------------------------------------------------------
185 void AmiSetQword40ToBe(void FAR *pAddr_p, QWORD qwQwordVal_p);
186 void AmiSetQword40ToLe(void FAR *pAddr_p, QWORD qwQwordVal_p);
188 //---------------------------------------------------------------------------
190 // Function: AmiGetQword40()
192 // Description: reads a 40 bit value from a buffer
194 // Parameters: pAddr_p = pointer to source buffer
198 //---------------------------------------------------------------------------
200 QWORD AmiGetQword40FromBe(void FAR *pAddr_p);
201 QWORD AmiGetQword40FromLe(void FAR *pAddr_p);
203 //---------------------------------------------------------------------------
205 // Function: AmiSetQword48()
207 // Description: sets a 48 bit value to a buffer
209 // Parameters: pAddr_p = pointer to destination buffer
210 // qwQwordVal_p = quadruple word value
214 //---------------------------------------------------------------------------
216 void AmiSetQword48ToBe(void FAR *pAddr_p, QWORD qwQwordVal_p);
217 void AmiSetQword48ToLe(void FAR *pAddr_p, QWORD qwQwordVal_p);
219 //---------------------------------------------------------------------------
221 // Function: AmiGetQword48()
223 // Description: reads a 48 bit value from a buffer
225 // Parameters: pAddr_p = pointer to source buffer
229 //---------------------------------------------------------------------------
231 QWORD AmiGetQword48FromBe(void FAR *pAddr_p);
232 QWORD AmiGetQword48FromLe(void FAR *pAddr_p);
234 //---------------------------------------------------------------------------
236 // Function: AmiSetQword56()
238 // Description: sets a 56 bit value to a buffer
240 // Parameters: pAddr_p = pointer to destination buffer
241 // qwQwordVal_p = quadruple word value
245 //---------------------------------------------------------------------------
247 void AmiSetQword56ToBe(void FAR *pAddr_p, QWORD qwQwordVal_p);
248 void AmiSetQword56ToLe(void FAR *pAddr_p, QWORD qwQwordVal_p);
250 //---------------------------------------------------------------------------
252 // Function: AmiGetQword56()
254 // Description: reads a 56 bit value from a buffer
256 // Parameters: pAddr_p = pointer to source buffer
260 //---------------------------------------------------------------------------
262 QWORD AmiGetQword56FromBe(void FAR *pAddr_p);
263 QWORD AmiGetQword56FromLe(void FAR *pAddr_p);
265 //---------------------------------------------------------------------------
267 // Function: AmiSetQword64()
269 // Description: sets a 64 bit value to a buffer
271 // Parameters: pAddr_p = pointer to destination buffer
272 // qwQwordVal_p = quadruple word value
276 //---------------------------------------------------------------------------
278 void AmiSetQword64ToBe(void FAR *pAddr_p, QWORD qwQwordVal_p);
279 void AmiSetQword64ToLe(void FAR *pAddr_p, QWORD qwQwordVal_p);
281 //---------------------------------------------------------------------------
283 // Function: AmiGetQword64()
285 // Description: reads a 64 bit value from a buffer
287 // Parameters: pAddr_p = pointer to source buffer
291 //---------------------------------------------------------------------------
293 QWORD AmiGetQword64FromBe(void FAR *pAddr_p);
294 QWORD AmiGetQword64FromLe(void FAR *pAddr_p);
296 //---------------------------------------------------------------------------
298 // Function: AmiSetTimeOfDay()
300 // Description: sets a TIME_OF_DAY (CANopen) value to a buffer
302 // Parameters: pAddr_p = pointer to destination buffer
303 // pTimeOfDay_p = pointer to struct TIME_OF_DAY
307 //---------------------------------------------------------------------------
308 void AmiSetTimeOfDay(void FAR *pAddr_p, tTimeOfDay FAR *pTimeOfDay_p);
310 //---------------------------------------------------------------------------
312 // Function: AmiGetTimeOfDay()
314 // Description: reads a TIME_OF_DAY (CANopen) value from a buffer
316 // Parameters: pAddr_p = pointer to source buffer
317 // pTimeOfDay_p = pointer to struct TIME_OF_DAY
321 //---------------------------------------------------------------------------
322 void AmiGetTimeOfDay(void FAR *pAddr_p, tTimeOfDay FAR *pTimeOfDay_p);
327 #endif // ifndef _EPLAMI_H_
328 // Die letzte Zeile muß unbedingt eine leere Zeile sein, weil manche Compiler// damit ein Problem haben, wenn das nicht so ist (z.B. GNU oder Borland C++ Builder).