1 /* $NetBSD: fire_i2creg.h,v 1.1 2026/06/04 13:43:24 jdc Exp $ */ 2 3 /*- 4 * Copyright (c) 2026 The NetBSD Foundation, Inc. 5 * All rights reserved. 6 * 7 * This code is derived from software contributed to The NetBSD Foundation 8 * by Julian Coleman. 9 * 10 * Redistribution and use in source and binary forms, with or without 11 * modification, are permitted provided that the following conditions 12 * are met: 13 * 1. Redistributions of source code must retain the above copyright 14 * notice, this list of conditions and the following disclaimer. 15 * 2. Redistributions in binary form must reproduce the above copyright 16 * notice, this list of conditions and the following disclaimer in the 17 * documentation and/or other materials provided with the distribution. 18 * 19 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 20 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 21 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 22 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 23 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 24 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 25 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 26 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 27 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 28 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 29 * POSSIBILITY OF SUCH DAMAGE. 30 */ 31 32 #ifndef _FIRE_I2C_H_ 33 #define _FIRE_I2C_H_ 34 35 /* 36 * Register definitions for "Mentor Grapics MI2C / Fire I2C" 37 * Information taken from: 38 * - Inventra MI2C Product Specification 39 * - Fire Programmer's Reference Manual for Fire 2.1 40 */ 41 42 #include <sys/cdefs.h> 43 __KERNEL_RCSID(0, "$NetBSD: fire_i2creg.h,v 1.1 2026/06/04 13:43:24 jdc Exp $"); 44 45 /* Register offsets */ 46 #define FIREI2C_ADDR 0x00 /* Slave address */ 47 #define FIREI2C_XADDR 0x08 /* Extended slave address */ 48 #define FIREI2C_DATA 0x10 /* Data byte */ 49 #define FIREI2C_CTRL 0x18 /* Control register */ 50 #define FIREI2C_STAT 0x20 /* Status register (RO) */ 51 #define FIREI2C_CCR 0x28 /* Clock cntrol register (WO) */ 52 #define FIREI2C_SRST 0x30 /* Software reset */ 53 54 /* 0x00 - Slave (our) address */ 55 #define FIREI2C_ADDR_GC_ENBL 0x01 /* General call address enable */ 56 #define FIREI2C_ADDR_7 0xfe /* 7-bit addr address mask */ 57 #define FIREI2C_ADDR_SHIFT 1 58 #define FIREI2C_XADDR_9 0x06 /* 9-bit address mask (bits 8 + 9) */ 59 #define FIREI2C_XADDR_9_SHIFT 8 60 61 /* 0x08 - Extended slave address */ 62 #define FIREI2C_XADDR_7 0xff /* 9-bit address mask (bits 0 - 7) */ 63 64 /* 0x10 - Data byte - sent or received on the bus (including slave addr) */ 65 #define FIREI2C_DATA_SHIFT 1 66 67 /* 0x18 - Control register */ 68 #define FIREI2C_CTRL_AAK 0x04 /* Assert acknowledge */ 69 #define FIREI2C_CTRL_IFLG 0x08 /* Interrupt flag */ 70 #define FIREI2C_CTRL_STP 0x10 /* Master mode stop */ 71 #define FIREI2C_CTRL_STA 0x20 /* Master mode start */ 72 #define FIREI2C_CTRL_ENAB 0x40 /* Bus enable */ 73 #define FIREI2C_CTRL_IEN 0x80 /* Interrupt enable */ 74 75 /* 0x20 - Status register (RO) */ 76 #define FIREI2C_STAT_BERR 0x00 /* Bus error */ 77 #define FIREI2C_STAT_STA 0x08 /* Start transmitted */ 78 #define FIREI2C_STAT_REPSTA 0x10 /* Repeated start transmitted */ 79 #define FIREI2C_STAT_AWR_ACK 0x18 /* Addr + Write sent -> ACK rcvd */ 80 #define FIREI2C_STAT_AWR_NAK 0x20 /* Addr + Write sent -> no ACK rcvd */ 81 #define FIREI2C_STAT_DAT_ACK 0x28 /* Data sent = ACK rcvd */ 82 #define FIREI2C_STAT_DAT_NAK 0x30 /* Data sent = no ACK rcvd */ 83 #define FIREI2C_STAT_ARB_LST 0x38 /* Arbitration lost */ 84 #define FIREI2C_STAT_ARE_ACK 0x40 /* Addr + Read sent -> ACK rcvd */ 85 #define FIREI2C_STAT_ARE_NAK 0x48 /* Addr + Read sent -> no ACK rcvd */ 86 #define FIREI2C_STAT_MDAT_ACK 0x50 /* Data rcvd master -> ACK sent */ 87 #define FIREI2C_STAT_MDAT_NAK 0x58 /* Data rcvd master -> not ACK sent */ 88 #define FIREI2C_STAT_SLW_ACK 0x60 /* Slave + Write rcvd -> ACK sent */ 89 #define FIREI2C_STAT_ARB_SLW 0x68 /* Arb. lost, slv+wr rcvd, ACK sent */ 90 #define FIREI2C_STAT_GC_ACK 0x70 /* Gen. call rcvd, ACK sent */ 91 #define FIREI2C_STAT_ARB_GC 0x78 /* Arb. lost, gen call rcvd, ACK sent */ 92 #define FIREI2C_STAT_SDAT_ACK 0x80 /* Data rcvd slave -> ACK sent */ 93 #define FIREI2C_STAT_SDAT_NAK 0x88 /* Data rcvd slave -> not ACK sent */ 94 #define FIREI2C_STAT_GDAT_ACK 0x90 /* Data rcvd gen call -> ACK sent */ 95 #define FIREI2C_STAT_GDAT_NAK 0x98 /* Data rcvd gen call -> not ACK sent */ 96 #define FIREI2C_STAT_STP_REP 0xa0 /* Stop or Rep Start rcvd slave */ 97 #define FIREI2C_STAT_SLR_ACK 0xa8 /* Slave + Read rcvd -> ACK sent */ 98 #define FIREI2C_STAT_ARB_SLR 0xb0 /* Arb. lost, slv+rd rcvd, ACK sent */ 99 #define FIREI2C_STAT_SLV_ACK 0xb8 /* Data sent slave -> ACK rcvd */ 100 #define FIREI2C_STAT_SLV_NAK 0xc0 /* Data sent slave -> ACK not rcvd */ 101 #define FIREI2C_STAT_SLV_LAS 0xc8 /* Last byte sent slave -> ACK rcvd */ 102 #define FIREI2C_STAT_2AW_ACK 0xd0 /* 2nd Addr + Write sent -> ACK rcvd */ 103 #define FIREI2C_STAT_2AW_NAK 0xd8 /* 2nd Addr + Wr sent -> no ACK rcvd */ 104 #define FIREI2C_STAT_IDLE 0xf8 /* No relevant status (default) */ 105 106 /* 0x28 - Clock cntrol register (WO) */ 107 #define FIREI2C_CCR_POW2 0x07 /* Clock divider 1 = 2^N (sample clk) */ 108 #define FIREI2C_CCR_FACT 0x78 /* Clock divider 2 = M (i2c clock) */ 109 #define FIREI2C_CCR_FACT_SHIFT 3 110 #define FIREI2C_CCR_POW2_MAX 7 111 #define FIREI2C_CCR_FACT_MAX 15 112 113 /* 0x30 - Software reset - write any value to reset */ 114 #define FIREI2C_SRST_RST 0x01 115 116 #endif /* _FIRE_I2C_H_ */ 117