ixp425_npereg.h revision 194322
1/*- 2 * Copyright (c) 2006 Sam Leffler, Errno Consulting 3 * All rights reserved. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions 7 * are met: 8 * 1. Redistributions of source code must retain the above copyright 9 * notice, this list of conditions and the following disclaimer, 10 * without modification. 11 * 2. Redistributions in binary form must reproduce at minimum a disclaimer 12 * similar to the "NO WARRANTY" disclaimer below ("Disclaimer") and any 13 * redistribution must be conditioned upon including a substantially 14 * similar Disclaimer requirement for further binary redistribution. 15 * 16 * NO WARRANTY 17 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 18 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 19 * LIMITED TO, THE IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTIBILITY 20 * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL 21 * THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, 22 * OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 23 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 24 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER 25 * IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 26 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF 27 * THE POSSIBILITY OF SUCH DAMAGES. 28 * 29 * $FreeBSD: head/sys/arm/xscale/ixp425/ixp425_npereg.h 194322 2009-06-17 02:55:53Z sam $ 30 */ 31 32/*- 33 * Copyright (c) 2001-2005, Intel Corporation. 34 * All rights reserved. 35 * 36 * Redistribution and use in source and binary forms, with or without 37 * modification, are permitted provided that the following conditions 38 * are met: 39 * 1. Redistributions of source code must retain the above copyright 40 * notice, this list of conditions and the following disclaimer. 41 * 2. Redistributions in binary form must reproduce the above copyright 42 * notice, this list of conditions and the following disclaimer in the 43 * documentation and/or other materials provided with the distribution. 44 * 3. Neither the name of the Intel Corporation nor the names of its contributors 45 * may be used to endorse or promote products derived from this software 46 * without specific prior written permission. 47 * 48 * 49 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS'' 50 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 51 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 52 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE 53 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 54 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 55 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 56 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 57 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 58 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 59 * SUCH DAMAGE. 60*/ 61 62#ifndef _IXP425_NPEREG_H_ 63#define _IXP425_NPEREG_H_ 64 65/* signature found as 1st word in a microcode image library */ 66#define IX_NPEDL_IMAGEMGR_SIGNATURE 0xDEADBEEF 67/* marks end of header in a microcode image library */ 68#define IX_NPEDL_IMAGEMGR_END_OF_HEADER 0xFFFFFFFF 69 70/* 71 * Intel (R) IXP400 Software NPE Image ID Definition 72 * 73 * Definition of NPE Image ID to be passed to ixNpeDlNpeInitAndStart() 74 * as input of type uint32_t which has the following fields format: 75 * 76 * Field [Bit Location] 77 * ----------------------------------- 78 * Device ID [31 - 28] 79 * NPE ID [27 - 24] 80 * NPE Functionality ID [23 - 16] 81 * Major Release Number [15 - 8] 82 * Minor Release Number [7 - 0] 83 */ 84#define IX_NPEDL_NPEID_FROM_IMAGEID_GET(imageId) \ 85 (((imageId) >> 24) & 0xf) 86#define IX_NPEDL_DEVICEID_FROM_IMAGEID_GET(imageId) \ 87 (((imageId) >> 28) & 0xf) 88#define IX_NPEDL_FUNCTIONID_FROM_IMAGEID_GET(imageId) \ 89 (((imageId) >> 16) & 0xff) 90#define IX_NPEDL_MAJOR_FROM_IMAGEID_GET(imageId) \ 91 (((imageId) >> 8) & 0xff) 92#define IX_NPEDL_MINOR_FROM_IMAGEID_GET(imageId) \ 93 (((imageId) >> 0) & 0xff) 94 95/* 96 * Instruction and Data Memory Size (in words) for each NPE 97 */ 98#define IX_NPEDL_INS_MEMSIZE_WORDS_NPEA 4096 99#define IX_NPEDL_INS_MEMSIZE_WORDS_NPEB 2048 100#define IX_NPEDL_INS_MEMSIZE_WORDS_NPEC 2048 101 102#define IX_NPEDL_DATA_MEMSIZE_WORDS_NPEA 2048 103#define IX_NPEDL_DATA_MEMSIZE_WORDS_NPEB 2048 104#define IX_NPEDL_DATA_MEMSIZE_WORDS_NPEC 2048 105 106#define IXP46X_NPEDL_INS_MEMSIZE_WORDS 4096 107#define IXP46X_NPEDL_DATA_MEMSIZE_WORDS 4096 108 109/* BAR offsets */ 110#define IX_NPEDL_REG_OFFSET_EXAD 0x00000000 /* Execution Address */ 111#define IX_NPEDL_REG_OFFSET_EXDATA 0x00000004 /* Execution Data */ 112#define IX_NPEDL_REG_OFFSET_EXCTL 0x00000008 /* Execution Control */ 113#define IX_NPEDL_REG_OFFSET_EXCT 0x0000000C /* Execution Count */ 114#define IX_NPEDL_REG_OFFSET_AP0 0x00000010 /* Action Point 0 */ 115#define IX_NPEDL_REG_OFFSET_AP1 0x00000014 /* Action Point 1 */ 116#define IX_NPEDL_REG_OFFSET_AP2 0x00000018 /* Action Point 2 */ 117#define IX_NPEDL_REG_OFFSET_AP3 0x0000001C /* Action Point 3 */ 118#define IX_NPEDL_REG_OFFSET_WFIFO 0x00000020 /* Watchpoint FIFO */ 119#define IX_NPEDL_REG_OFFSET_WC 0x00000024 /* Watch Count */ 120#define IX_NPEDL_REG_OFFSET_PROFCT 0x00000028 /* Profile Count */ 121#define IX_NPEDL_REG_OFFSET_STAT 0x0000002C /* Messaging Status */ 122#define IX_NPEDL_REG_OFFSET_CTL 0x00000030 /* Messaging Control */ 123#define IX_NPEDL_REG_OFFSET_MBST 0x00000034 /* Mailbox Status */ 124#define IX_NPEDL_REG_OFFSET_FIFO 0x00000038 /* Message FIFO */ 125 126/* 127 * Reset value for Mailbox (MBST) register 128 * NOTE that if used, it should be complemented with an NPE intruction 129 * to clear the Mailbox at the NPE side as well 130 */ 131#define IX_NPEDL_REG_RESET_MBST 0x0000F0F0 132 133#define IX_NPEDL_MASK_WFIFO_VALID 0x80000000 /* VALID bit */ 134#define IX_NPEDL_MASK_STAT_OFNE 0x00010000 /* OFNE bit */ 135#define IX_NPEDL_MASK_STAT_IFNE 0x00080000 /* IFNE bit */ 136 137/* 138 * EXCTL (Execution Control) Register commands 139*/ 140#define IX_NPEDL_EXCTL_CMD_NPE_STEP 0x01 /* Step 1 instruction */ 141#define IX_NPEDL_EXCTL_CMD_NPE_START 0x02 /* Start execution */ 142#define IX_NPEDL_EXCTL_CMD_NPE_STOP 0x03 /* Stop execution */ 143#define IX_NPEDL_EXCTL_CMD_NPE_CLR_PIPE 0x04 /* Clear ins pipeline */ 144 145/* 146 * Read/write operations use address in EXAD and data in EXDATA. 147 */ 148#define IX_NPEDL_EXCTL_CMD_RD_INS_MEM 0x10 /* Read ins memory */ 149#define IX_NPEDL_EXCTL_CMD_WR_INS_MEM 0x11 /* Write ins memory */ 150#define IX_NPEDL_EXCTL_CMD_RD_DATA_MEM 0x12 /* Read data memory */ 151#define IX_NPEDL_EXCTL_CMD_WR_DATA_MEM 0x13 /* Write data memory */ 152#define IX_NPEDL_EXCTL_CMD_RD_ECS_REG 0x14 /* Read ECS register */ 153#define IX_NPEDL_EXCTL_CMD_WR_ECS_REG 0x15 /* Write ECS register */ 154 155#define IX_NPEDL_EXCTL_CMD_CLR_PROFILE_CNT 0x0C /* Clear Profile Count register */ 156 157 158/* 159 * EXCTL (Execution Control) Register status bit masks 160 */ 161#define IX_NPEDL_EXCTL_STATUS_RUN 0x80000000 162#define IX_NPEDL_EXCTL_STATUS_STOP 0x40000000 163#define IX_NPEDL_EXCTL_STATUS_CLEAR 0x20000000 164#define IX_NPEDL_EXCTL_STATUS_ECS_K 0x00800000 /* pipeline Klean */ 165 166/* 167 * Executing Context Stack (ECS) level registers 168 */ 169#define IX_NPEDL_ECS_BG_CTXT_REG_0 0x00 /* reg 0 @ bg ctx */ 170#define IX_NPEDL_ECS_BG_CTXT_REG_1 0x01 /* reg 1 @ bg ctx */ 171#define IX_NPEDL_ECS_BG_CTXT_REG_2 0x02 /* reg 2 @ bg ctx */ 172 173#define IX_NPEDL_ECS_PRI_1_CTXT_REG_0 0x04 /* reg 0 @ pri 1 ctx */ 174#define IX_NPEDL_ECS_PRI_1_CTXT_REG_1 0x05 /* reg 1 @ pri 1 ctx */ 175#define IX_NPEDL_ECS_PRI_1_CTXT_REG_2 0x06 /* reg 2 @ pri 1 ctx */ 176 177#define IX_NPEDL_ECS_PRI_2_CTXT_REG_0 0x08 /* reg 0 @ pri 2 ctx */ 178#define IX_NPEDL_ECS_PRI_2_CTXT_REG_1 0x09 /* reg 1 @ pri 2 ctx */ 179#define IX_NPEDL_ECS_PRI_2_CTXT_REG_2 0x0A /* reg 2 @ pri 2 ctx */ 180 181#define IX_NPEDL_ECS_DBG_CTXT_REG_0 0x0C /* reg 0 @ debug ctx */ 182#define IX_NPEDL_ECS_DBG_CTXT_REG_1 0x0D /* reg 1 @ debug ctx */ 183#define IX_NPEDL_ECS_DBG_CTXT_REG_2 0x0E /* reg 2 @ debug ctx */ 184 185#define IX_NPEDL_ECS_INSTRUCT_REG 0x11 /* Instruction reg */ 186 187/* 188 * Execution Access register reset values 189 */ 190#define IX_NPEDL_ECS_BG_CTXT_REG_0_RESET 0xA0000000 191#define IX_NPEDL_ECS_BG_CTXT_REG_1_RESET 0x01000000 192#define IX_NPEDL_ECS_BG_CTXT_REG_2_RESET 0x00008000 193#define IX_NPEDL_ECS_PRI_1_CTXT_REG_0_RESET 0x20000080 194#define IX_NPEDL_ECS_PRI_1_CTXT_REG_1_RESET 0x01000000 195#define IX_NPEDL_ECS_PRI_1_CTXT_REG_2_RESET 0x00008000 196#define IX_NPEDL_ECS_PRI_2_CTXT_REG_0_RESET 0x20000080 197#define IX_NPEDL_ECS_PRI_2_CTXT_REG_1_RESET 0x01000000 198#define IX_NPEDL_ECS_PRI_2_CTXT_REG_2_RESET 0x00008000 199#define IX_NPEDL_ECS_DBG_CTXT_REG_0_RESET 0x20000000 200#define IX_NPEDL_ECS_DBG_CTXT_REG_1_RESET 0x00000000 201#define IX_NPEDL_ECS_DBG_CTXT_REG_2_RESET 0x001E0000 202#define IX_NPEDL_ECS_INSTRUCT_REG_RESET 0x1003C00F 203 204/* 205 * Masks used to read/write particular bits in Execution Access registers 206 */ 207 208#define IX_NPEDL_MASK_ECS_REG_0_ACTIVE 0x80000000 /* Active bit */ 209#define IX_NPEDL_MASK_ECS_REG_0_NEXTPC 0x1FFF0000 /* NextPC bits */ 210#define IX_NPEDL_MASK_ECS_REG_0_LDUR 0x00000700 /* LDUR bits */ 211 212#define IX_NPEDL_MASK_ECS_REG_1_CCTXT 0x000F0000 /* NextPC bits */ 213#define IX_NPEDL_MASK_ECS_REG_1_SELCTXT 0x0000000F 214 215#define IX_NPEDL_MASK_ECS_DBG_REG_2_IF 0x00100000 /* IF bit */ 216#define IX_NPEDL_MASK_ECS_DBG_REG_2_IE 0x00080000 /* IE bit */ 217 218 219/* 220 * Bit-Offsets from LSB of particular bit-fields in Execution Access registers. 221 */ 222 223#define IX_NPEDL_OFFSET_ECS_REG_0_NEXTPC 16 224#define IX_NPEDL_OFFSET_ECS_REG_0_LDUR 8 225 226#define IX_NPEDL_OFFSET_ECS_REG_1_CCTXT 16 227#define IX_NPEDL_OFFSET_ECS_REG_1_SELCTXT 0 228 229/* 230 * NPE core & co-processor instruction templates to load into NPE Instruction 231 * Register, for read/write of NPE register file registers. 232 */ 233 234/* 235 * Read an 8-bit NPE internal logical register 236 * and return the value in the EXDATA register (aligned to MSB). 237 * NPE Assembler instruction: "mov8 d0, d0 &&& DBG_WrExec" 238 */ 239#define IX_NPEDL_INSTR_RD_REG_BYTE 0x0FC00000 240 241/* 242 * Read a 16-bit NPE internal logical register 243 * and return the value in the EXDATA register (aligned to MSB). 244 * NPE Assembler instruction: "mov16 d0, d0 &&& DBG_WrExec" 245 */ 246#define IX_NPEDL_INSTR_RD_REG_SHORT 0x0FC08010 247 248/* 249 * Read a 16-bit NPE internal logical register 250 * and return the value in the EXDATA register. 251 * NPE Assembler instruction: "mov32 d0, d0 &&& DBG_WrExec" 252 */ 253#define IX_NPEDL_INSTR_RD_REG_WORD 0x0FC08210 254 255/* 256 * Write an 8-bit NPE internal logical register. 257 * NPE Assembler instruction: "mov8 d0, #0" 258 */ 259#define IX_NPEDL_INSTR_WR_REG_BYTE 0x00004000 260 261/* 262 * Write a 16-bit NPE internal logical register. 263 * NPE Assembler instruction: "mov16 d0, #0" 264 */ 265#define IX_NPEDL_INSTR_WR_REG_SHORT 0x0000C000 266 267/* 268 * Write a 16-bit NPE internal logical register. 269 * NPE Assembler instruction: "cprd32 d0 &&& DBG_RdInFIFO" 270 */ 271#define IX_NPEDL_INSTR_RD_FIFO 0x0F888220 272 273/* 274 * Reset Mailbox (MBST) register 275 * NPE Assembler instruction: "mov32 d0, d0 &&& DBG_ClearM" 276 */ 277#define IX_NPEDL_INSTR_RESET_MBOX 0x0FAC8210 278 279 280/* 281 * Bit-offsets from LSB, of particular bit-fields in an NPE instruction 282 */ 283#define IX_NPEDL_OFFSET_INSTR_SRC 4 /* src operand */ 284#define IX_NPEDL_OFFSET_INSTR_DEST 9 /* dest operand */ 285#define IX_NPEDL_OFFSET_INSTR_COPROC 18 /* coprocessor ins */ 286 287/* 288 * Masks used to read/write particular bits of an NPE Instruction 289 */ 290 291/** 292 * Mask the bits of 16-bit data value (least-sig 5 bits) to be used in 293 * SRC field of immediate-mode NPE instruction 294 */ 295#define IX_NPEDL_MASK_IMMED_INSTR_SRC_DATA 0x1F 296 297/** 298 * Mask the bits of 16-bit data value (most-sig 11 bits) to be used in 299 * COPROC field of immediate-mode NPE instruction 300 */ 301#define IX_NPEDL_MASK_IMMED_INSTR_COPROC_DATA 0xFFE0 302 303/** 304 * LSB offset of the bit-field of 16-bit data value (most-sig 11 bits) 305 * to be used in COPROC field of immediate-mode NPE instruction 306 */ 307#define IX_NPEDL_OFFSET_IMMED_INSTR_COPROC_DATA 5 308 309/** 310 * Number of left-shifts required to align most-sig 11 bits of 16-bit 311 * data value into COPROC field of immediate-mode NPE instruction 312 */ 313#define IX_NPEDL_DISPLACE_IMMED_INSTR_COPROC_DATA \ 314 (IX_NPEDL_OFFSET_INSTR_COPROC - IX_NPEDL_OFFSET_IMMED_INSTR_COPROC_DATA) 315 316/** 317 * LDUR value used with immediate-mode NPE Instructions by the NpeDl 318 * for writing to NPE internal logical registers 319 */ 320#define IX_NPEDL_WR_INSTR_LDUR 1 321 322/** 323 * LDUR value used with NON-immediate-mode NPE Instructions by the NpeDl 324 * for reading from NPE internal logical registers 325 */ 326#define IX_NPEDL_RD_INSTR_LDUR 0 327 328 329/** 330 * NPE internal Context Store registers. 331 */ 332typedef enum 333{ 334 IX_NPEDL_CTXT_REG_STEVT = 0, /**< identifies STEVT */ 335 IX_NPEDL_CTXT_REG_STARTPC, /**< identifies STARTPC */ 336 IX_NPEDL_CTXT_REG_REGMAP, /**< identifies REGMAP */ 337 IX_NPEDL_CTXT_REG_CINDEX, /**< identifies CINDEX */ 338 IX_NPEDL_CTXT_REG_MAX /**< Total number of Context Store registers */ 339} IxNpeDlCtxtRegNum; 340 341 342/* 343 * NPE Context Store register logical addresses 344 */ 345#define IX_NPEDL_CTXT_REG_ADDR_STEVT 0x0000001B 346#define IX_NPEDL_CTXT_REG_ADDR_STARTPC 0x0000001C 347#define IX_NPEDL_CTXT_REG_ADDR_REGMAP 0x0000001E 348#define IX_NPEDL_CTXT_REG_ADDR_CINDEX 0x0000001F 349 350/* 351 * NPE Context Store register reset values 352 */ 353 354/** 355 * Reset value of STEVT NPE internal Context Store register 356 * (STEVT = off, 0x80) 357 */ 358#define IX_NPEDL_CTXT_REG_RESET_STEVT 0x80 359 360/** 361 * Reset value of STARTPC NPE internal Context Store register 362 * (STARTPC = 0x0000) 363 */ 364#define IX_NPEDL_CTXT_REG_RESET_STARTPC 0x0000 365 366/** 367 * Reset value of REGMAP NPE internal Context Store register 368 * (REGMAP = d0->p0, d8->p2, d16->p4) 369 */ 370#define IX_NPEDL_CTXT_REG_RESET_REGMAP 0x0820 371 372/** 373 * Reset value of CINDEX NPE internal Context Store register 374 * (CINDEX = 0) 375 */ 376#define IX_NPEDL_CTXT_REG_RESET_CINDEX 0x00 377 378 379/* 380 * Numeric range of context levels available on an NPE 381 */ 382#define IX_NPEDL_CTXT_NUM_MIN 0 383#define IX_NPEDL_CTXT_NUM_MAX 15 384 385 386/** 387 * Number of Physical registers currently supported 388 * Initial NPE implementations will have a 32-word register file. 389 * Later implementations may have a 64-word register file. 390 */ 391#define IX_NPEDL_TOTAL_NUM_PHYS_REG 32 392 393/** 394 * LSB-offset of Regmap number in Physical NPE register address, used 395 * for Physical To Logical register address mapping in the NPE 396 */ 397#define IX_NPEDL_OFFSET_PHYS_REG_ADDR_REGMAP 1 398 399/** 400 * Mask to extract a logical NPE register address from a physical 401 * register address, used for Physical To Logical address mapping 402 */ 403#define IX_NPEDL_MASK_PHYS_REG_ADDR_LOGICAL_ADDR 0x1 404 405/* 406 * NPE Message/Mailbox interface. 407 */ 408#define IX_NPESTAT IX_NPEDL_REG_OFFSET_STAT /* status register */ 409#define IX_NPECTL IX_NPEDL_REG_OFFSET_CTL /* control register */ 410#define IX_NPEFIFO IX_NPEDL_REG_OFFSET_FIFO /* FIFO register */ 411 412/* control register */ 413#define IX_NPECTL_OFE 0x00010000 /* output fifo enable */ 414#define IX_NPECTL_IFE 0x00020000 /* input fifo enable */ 415#define IX_NPECTL_OFWE 0x01000000 /* output fifo write enable */ 416#define IX_NPECTL_IFWE 0x02000000 /* input fifo write enable */ 417 418/* status register */ 419#define IX_NPESTAT_OFNE 0x00010000 /* output fifo not empty */ 420#define IX_NPESTAT_IFNF 0x00020000 /* input fifo not full */ 421#define IX_NPESTAT_OFNF 0x00040000 /* output fifo not full */ 422#define IX_NPESTAT_IFNE 0x00080000 /* input fifo not empty */ 423#define IX_NPESTAT_MBINT 0x00100000 /* Mailbox interrupt */ 424#define IX_NPESTAT_IFINT 0x00200000 /* input fifo interrupt */ 425#define IX_NPESTAT_OFINT 0x00400000 /* output fifo interrupt */ 426#define IX_NPESTAT_WFINT 0x00800000 /* watch fifo interrupt */ 427#endif /* _IXP425_NPEREG_H_ */ 428