USB Host Shield 2.0
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Macros Pages
macros.h
Go to the documentation of this file.
1 /*
2  * File: macros.h
3  * Author: AJK
4  *
5  * Created on September 23, 2013, 12:31 AM
6  */
7 
8 #if !defined(_usb_h_) || defined(MACROS_H)
9 #error "Never include macros.h directly; include Usb.h instead"
10 #else
11 #define MACROS_H
12 
14 // HANDY MACROS
16 
17 #define VALUE_BETWEEN(v,l,h) (((v)>(l)) && ((v)<(h)))
18 #define VALUE_WITHIN(v,l,h) (((v)>=(l)) && ((v)<=(h)))
19 #define output_pgm_message(wa,fp,mp,el) wa = &mp, fp((char *)pgm_read_pointer(wa), el)
20 #define output_if_between(v,l,h,wa,fp,mp,el) if(VALUE_BETWEEN(v,l,h)) output_pgm_message(wa,fp,mp[v-(l+1)],el);
21 
22 #define SWAP(a, b) (((a) ^= (b)), ((b) ^= (a)), ((a) ^= (b)))
23 #ifndef __BYTE_GRABBING_DEFINED__
24 #define __BYTE_GRABBING_DEFINED__ 1
25 #ifdef BROKEN_OPTIMIZER_LITTLE_ENDIAN
26 // Note: Use this if your compiler generates horrible assembler!
27 #define BGRAB0(__usi__) (((uint8_t *)&(__usi__))[0])
28 #define BGRAB1(__usi__) (((uint8_t *)&(__usi__))[1])
29 #define BGRAB2(__usi__) (((uint8_t *)&(__usi__))[2])
30 #define BGRAB3(__usi__) (((uint8_t *)&(__usi__))[3])
31 #define BGRAB4(__usi__) (((uint8_t *)&(__usi__))[4])
32 #define BGRAB5(__usi__) (((uint8_t *)&(__usi__))[5])
33 #define BGRAB6(__usi__) (((uint8_t *)&(__usi__))[6])
34 #define BGRAB7(__usi__) (((uint8_t *)&(__usi__))[7])
35 #else
36 // Note: The cast alone to uint8_t is actually enough.
37 // GCC throws out the "& 0xff", and the size is no different.
38 // Some compilers need it.
39 #define BGRAB0(__usi__) ((uint8_t)((__usi__) & 0xff ))
40 #define BGRAB1(__usi__) ((uint8_t)(((__usi__) >> 8) & 0xff))
41 #define BGRAB2(__usi__) ((uint8_t)(((__usi__) >> 16) & 0xff))
42 #define BGRAB3(__usi__) ((uint8_t)(((__usi__) >> 24) & 0xff))
43 #define BGRAB4(__usi__) ((uint8_t)(((__usi__) >> 32) & 0xff))
44 #define BGRAB5(__usi__) ((uint8_t)(((__usi__) >> 40) & 0xff))
45 #define BGRAB6(__usi__) ((uint8_t)(((__usi__) >> 48) & 0xff))
46 #define BGRAB7(__usi__) ((uint8_t)(((__usi__) >> 56) & 0xff))
47 #endif
48 #define BOVER1(__usi__) ((uint16_t)(__usi__) << 8)
49 #define BOVER2(__usi__) ((uint32_t)(__usi__) << 16)
50 #define BOVER3(__usi__) ((uint32_t)(__usi__) << 24)
51 #define BOVER4(__usi__) ((uint64_t)(__usi__) << 32)
52 #define BOVER5(__usi__) ((uint64_t)(__usi__) << 40)
53 #define BOVER6(__usi__) ((uint64_t)(__usi__) << 48)
54 #define BOVER7(__usi__) ((uint64_t)(__usi__) << 56)
55 
56 // These are the smallest and fastest ways I have found so far in pure C/C++.
57 #define BMAKE16(__usc1__,__usc0__) ((uint16_t)((uint16_t)(__usc0__) | (uint16_t)BOVER1(__usc1__)))
58 #define BMAKE32(__usc3__,__usc2__,__usc1__,__usc0__) ((uint32_t)((uint32_t)(__usc0__) | (uint32_t)BOVER1(__usc1__) | (uint32_t)BOVER2(__usc2__) | (uint32_t)BOVER3(__usc3__)))
59 #define BMAKE64(__usc7__,__usc6__,__usc5__,__usc4__,__usc3__,__usc2__,__usc1__,__usc0__) ((uint64_t)((uint64_t)__usc0__ | (uint64_t)BOVER1(__usc1__) | (uint64_t)BOVER2(__usc2__) | (uint64_t)BOVER3(__usc3__) | (uint64_t)BOVER4(__usc4__) | (uint64_t)BOVER5(__usc5__) | (uint64_t)BOVER6(__usc6__) | (uint64_t)BOVER1(__usc7__)))
60 #endif
61 
62 /*
63  * Debug macros: Strings are stored in progmem (flash) instead of RAM.
64  */
65 #define USBTRACE(s) (Notify(PSTR(s), 0x80))
66 #define USBTRACE1(s,l) (Notify(PSTR(s), l))
67 #define USBTRACE2(s,r) (Notify(PSTR(s), 0x80), D_PrintHex((r), 0x80), Notify(PSTR("\r\n"), 0x80))
68 #define USBTRACE3(s,r,l) (Notify(PSTR(s), l), D_PrintHex((r), l), Notify(PSTR("\r\n"), l))
69 
70 
71 #endif /* MACROS_H */
72