1 /*****************************************************************************/
5 /* Additional information about 6502 code */
9 /* (C) 2001-2002 Ullrich von Bassewitz */
11 /* D-70597 Stuttgart */
12 /* EMail: uz@cc65.org */
15 /* This software is provided 'as-is', without any expressed or implied */
16 /* warranty. In no event will the authors be held liable for any damages */
17 /* arising from the use of this software. */
19 /* Permission is granted to anyone to use this software for any purpose, */
20 /* including commercial applications, and to alter it and redistribute it */
21 /* freely, subject to the following restrictions: */
23 /* 1. The origin of this software must not be misrepresented; you must not */
24 /* claim that you wrote the original software. If you use this software */
25 /* in a product, an acknowledgment in the product documentation would be */
26 /* appreciated but is not required. */
27 /* 2. Altered source versions must be plainly marked as such, and must not */
28 /* be misrepresented as being the original software. */
29 /* 3. This notice may not be removed or altered from any source */
32 /*****************************************************************************/
41 /*****************************************************************************/
43 /*****************************************************************************/
51 /*****************************************************************************/
53 /*****************************************************************************/
57 /* Forward to struct RegContents */
60 /* Defines for registers. */
61 #define REG_NONE 0x0000U
65 #define REG_TMP1 0x0008U
66 #define REG_PTR1_LO 0x0010U
67 #define REG_PTR1_HI 0x0020U
68 #define REG_PTR2_LO 0x0040U
69 #define REG_PTR2_HI 0x0080U
70 #define REG_SREG_LO 0x0100U
71 #define REG_SREG_HI 0x0200U
72 #define REG_SAVE_LO 0x0400U
73 #define REG_SAVE_HI 0x0800U
74 #define REG_SP_LO 0x1000U
75 #define REG_SP_HI 0x2000U
78 /* Combined register defines */
79 #define REG_PTR1 (REG_PTR1_LO | REG_PTR1_HI)
80 #define REG_PTR2 (REG_PTR2_LO | REG_PTR2_HI)
81 #define REG_SREG (REG_SREG_LO | REG_SREG_HI)
82 #define REG_SAVE (REG_SAVE_LO | REG_SAVE_HI)
83 #define REG_SP (REG_SP_LO | REG_SP_HI)
84 #define REG_AX (REG_A | REG_X)
85 #define REG_AY (REG_A | REG_Y)
86 #define REG_XY (REG_X | REG_Y)
87 #define REG_AXY (REG_AX | REG_Y)
88 #define REG_EAX (REG_AX | REG_SREG)
89 #define REG_EAXY (REG_EAX | REG_Y)
90 #define REG_ZP 0xFFF8U
91 #define REG_ALL 0xFFFFU
95 /* Zero page register info */
96 typedef struct ZPInfo ZPInfo;
98 unsigned char Len; /* Length of the following string */
99 char Name[11]; /* Name of zero page symbol */
100 unsigned short ByteUse; /* Register info for this symbol */
101 unsigned short WordUse; /* Register info for 16 bit access */
106 /*****************************************************************************/
108 /*****************************************************************************/
112 void GetFuncInfo (const char* Name, unsigned short* Use, unsigned short* Chg);
113 /* For the given function, lookup register information and store it into
114 * the given variables. If the function is unknown, assume it will use and
115 * load all registers.
118 const ZPInfo* GetZPInfo (const char* Name);
119 /* If the given name is a zero page symbol, return a pointer to the info
120 * struct for this symbol, otherwise return NULL.
123 unsigned GetRegInfo (struct CodeSeg* S, unsigned Index, unsigned Wanted);
124 /* Determine register usage information for the instructions starting at the
128 int RegAUsed (struct CodeSeg* S, unsigned Index);
129 /* Check if the value in A is used. */
131 int RegXUsed (struct CodeSeg* S, unsigned Index);
132 /* Check if the value in X is used. */
134 int RegYUsed (struct CodeSeg* S, unsigned Index);
135 /* Check if the value in Y is used. */
137 int RegAXUsed (struct CodeSeg* S, unsigned Index);
138 /* Check if the value in A or(!) the value in X are used. */
140 unsigned GetKnownReg (unsigned Use, const struct RegContents* RC);
141 /* Return the register or zero page location from the set in Use, thats
142 * contents are known. If Use does not contain any register, or if the
143 * register in question does not have a known value, return REG_NONE.
148 /* End of codeinfo.h */