[smscusb] Add ability to read MAC address from OTP

Signed-off-by: Michael Brown <mcb30@ipxe.org>
ipxe · Jul 7, 2017 · d4df9f5 · d4df9f5
1 parent b1df34d
commit d4df9f5
Show file tree

Hide file tree

Showing 2 changed files with 251 additions and 1 deletion.
diff --git a/src/drivers/net/smscusb.c b/src/drivers/net/smscusb.c
@@ -166,7 +166,7 @@ int smscusb_eeprom_fetch_mac ( struct smscusb_device *smscusb,
 
 	/* Check that EEPROM is physically present */
 	if ( ! is_valid_ether_addr ( netdev->hw_addr ) ) {
-		DBGC ( smscusb, "SMSCUSB %p has no EEPROM (%s)\n",
+		DBGC ( smscusb, "SMSCUSB %p has no EEPROM MAC (%s)\n",
 		       smscusb, eth_ntoa ( netdev->hw_addr ) );
 		return -ENODEV;
 	}
@@ -176,6 +176,212 @@ int smscusb_eeprom_fetch_mac ( struct smscusb_device *smscusb,
 	return 0;
 }
 
+/******************************************************************************
+ *
+ * OTP access
+ *
+ ******************************************************************************
+ */
+
+/**
+ * Power up OTP
+ *
+ * @v smscusb		SMSC USB device
+ * @v otp_base		OTP register base
+ * @ret rc		Return status code
+ */
+static int smscusb_otp_power_up ( struct smscusb_device *smscusb,
+				  unsigned int otp_base ) {
+	uint32_t otp_power;
+	unsigned int i;
+	int rc;
+
+	/* Power up OTP */
+	if ( ( rc = smscusb_writel ( smscusb, ( otp_base + SMSCUSB_OTP_POWER ),
+				     0 ) ) != 0 )
+		return rc;
+
+	/* Wait for OTP_POWER_DOWN to become clear */
+	for ( i = 0 ; i < SMSCUSB_OTP_MAX_WAIT_MS ; i++ ) {
+
+		/* Read OTP_POWER and check OTP_POWER_DOWN */
+		if ( ( rc = smscusb_readl ( smscusb,
+					    ( otp_base + SMSCUSB_OTP_POWER ),
+					    &otp_power ) ) != 0 )
+			return rc;
+		if ( ! ( otp_power & SMSCUSB_OTP_POWER_DOWN ) )
+			return 0;
+
+		/* Delay */
+		mdelay ( 1 );
+	}
+
+	DBGC ( smscusb, "SMSCUSB %p timed out waiting for OTP power up\n",
+	       smscusb );
+	return -ETIMEDOUT;
+}
+
+/**
+ * Wait for OTP to become idle
+ *
+ * @v smscusb		SMSC USB device
+ * @v otp_base		OTP register base
+ * @ret rc		Return status code
+ */
+static int smscusb_otp_wait ( struct smscusb_device *smscusb,
+			      unsigned int otp_base ) {
+	uint32_t otp_status;
+	unsigned int i;
+	int rc;
+
+	/* Wait for OTP_STATUS_BUSY to become clear */
+	for ( i = 0 ; i < SMSCUSB_OTP_MAX_WAIT_MS ; i++ ) {
+
+		/* Read OTP_STATUS and check OTP_STATUS_BUSY */
+		if ( ( rc = smscusb_readl ( smscusb,
+					    ( otp_base + SMSCUSB_OTP_STATUS ),
+					    &otp_status ) ) != 0 )
+			return rc;
+		if ( ! ( otp_status & SMSCUSB_OTP_STATUS_BUSY ) )
+			return 0;
+
+		/* Delay */
+		mdelay ( 1 );
+	}
+
+	DBGC ( smscusb, "SMSCUSB %p timed out waiting for OTP\n",
+	       smscusb );
+	return -ETIMEDOUT;
+}
+
+/**
+ * Read byte from OTP
+ *
+ * @v smscusb		SMSC USB device
+ * @v otp_base		OTP register base
+ * @v address		OTP address
+ * @ret byte		Byte read, or negative error
+ */
+static int smscusb_otp_read_byte ( struct smscusb_device *smscusb,
+				   unsigned int otp_base,
+				   unsigned int address ) {
+	uint8_t addrh = ( address >> 8 );
+	uint8_t addrl = ( address >> 0 );
+	uint32_t otp_data;
+	int rc;
+
+	/* Wait for OTP to become idle */
+	if ( ( rc = smscusb_otp_wait ( smscusb, otp_base ) ) != 0 )
+		return rc;
+
+	/* Initiate read command */
+	if ( ( rc = smscusb_writel ( smscusb, ( otp_base + SMSCUSB_OTP_ADDRH ),
+				     addrh ) ) != 0 )
+		return rc;
+	if ( ( rc = smscusb_writel ( smscusb, ( otp_base + SMSCUSB_OTP_ADDRL ),
+				     addrl ) ) != 0 )
+		return rc;
+	if ( ( rc = smscusb_writel ( smscusb, ( otp_base + SMSCUSB_OTP_CMD ),
+				     SMSCUSB_OTP_CMD_READ ) ) != 0 )
+		return rc;
+	if ( ( rc = smscusb_writel ( smscusb, ( otp_base + SMSCUSB_OTP_GO ),
+				     SMSCUSB_OTP_GO_GO ) ) != 0 )
+		return rc;
+
+	/* Wait for command to complete */
+	if ( ( rc = smscusb_otp_wait ( smscusb, otp_base ) ) != 0 )
+		return rc;
+
+	/* Read OTP data */
+	if ( ( rc = smscusb_readl ( smscusb, ( otp_base + SMSCUSB_OTP_DATA ),
+				    &otp_data ) ) != 0 )
+		return rc;
+
+	return SMSCUSB_OTP_DATA_GET ( otp_data );
+}
+
+/**
+ * Read data from OTP
+ *
+ * @v smscusb		SMSC USB device
+ * @v otp_base		OTP register base
+ * @v address		OTP address
+ * @v data		Data buffer
+ * @v len		Length of data
+ * @ret rc		Return status code
+ */
+static int smscusb_otp_read ( struct smscusb_device *smscusb,
+			      unsigned int otp_base, unsigned int address,
+			      void *data, size_t len ) {
+	uint8_t *bytes;
+	int byte;
+	int rc;
+
+	/* Power up OTP */
+	if ( ( rc = smscusb_otp_power_up ( smscusb, otp_base ) ) != 0 )
+		return rc;
+
+	/* Read bytes */
+	for ( bytes = data ; len-- ; address++, bytes++ ) {
+		byte = smscusb_otp_read_byte ( smscusb, otp_base, address );
+		if ( byte < 0 )
+			return byte;
+		*bytes = byte;
+	}
+
+	return 0;
+}
+
+/**
+ * Fetch MAC address from OTP
+ *
+ * @v smscusb		SMSC USB device
+ * @v otp_base		OTP register base
+ * @ret rc		Return status code
+ */
+int smscusb_otp_fetch_mac ( struct smscusb_device *smscusb,
+			    unsigned int otp_base ) {
+	struct net_device *netdev = smscusb->netdev;
+	uint8_t signature;
+	unsigned int address;
+	int rc;
+
+	/* Read OTP signature byte */
+	if ( ( rc = smscusb_otp_read ( smscusb, otp_base, 0, &signature,
+				       sizeof ( signature ) ) ) != 0 )
+		return rc;
+
+	/* Determine location of MAC address */
+	switch ( signature ) {
+	case SMSCUSB_OTP_1_SIG:
+		address = SMSCUSB_OTP_1_MAC;
+		break;
+	case SMSCUSB_OTP_2_SIG:
+		address = SMSCUSB_OTP_2_MAC;
+		break;
+	default:
+		DBGC ( smscusb, "SMSCUSB %p unknown OTP signature %#02x\n",
+		       smscusb, signature );
+		return -ENOTSUP;
+	}
+
+	/* Read MAC address from OTP */
+	if ( ( rc = smscusb_otp_read ( smscusb, otp_base, address,
+				       netdev->hw_addr, ETH_ALEN ) ) != 0 )
+		return rc;
+
+	/* Check that OTP is valid */
+	if ( ! is_valid_ether_addr ( netdev->hw_addr ) ) {
+		DBGC ( smscusb, "SMSCUSB %p has no layout %#02x OTP MAC (%s)\n",
+		       smscusb, signature, eth_ntoa ( netdev->hw_addr ) );
+		return -ENODEV;
+	}
+
+	DBGC ( smscusb, "SMSCUSB %p using layout %#02x OTP MAC %s\n",
+	       smscusb, signature, eth_ntoa ( netdev->hw_addr ) );
+	return 0;
+}
+
 /******************************************************************************
  *
  * MII access

diff --git a/src/drivers/net/smscusb.h b/src/drivers/net/smscusb.h
@@ -50,6 +50,48 @@ FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );
 /** Maximum time to wait for EEPROM (in milliseconds) */
 #define SMSCUSB_EEPROM_MAX_WAIT_MS 100
 
+/** OTP power register offset */
+#define SMSCUSB_OTP_POWER 0x000
+#define SMSCUSB_OTP_POWER_DOWN		0x00000001UL	/**< OTP power down */
+
+/** OTP address high byte register offset */
+#define SMSCUSB_OTP_ADDRH 0x004
+
+/** OTP address low byte register offset */
+#define SMSCUSB_OTP_ADDRL 0x008
+
+/** OTP data register offset */
+#define SMSCUSB_OTP_DATA 0x018
+#define SMSCUSB_OTP_DATA_GET(otp_data) \
+	( ( (otp_data) >> 0 ) & 0xff )			/**< OTP data */
+
+/** OTP command selection register offset */
+#define SMSCUSB_OTP_CMD 0x020
+#define SMSCUSB_OTP_CMD_READ		0x00000001UL	/**< Read command */
+
+/** OTP command initiation register offset */
+#define SMSCUSB_OTP_GO 0x028
+#define SMSCUSB_OTP_GO_GO		0x00000001UL	/**< Initiate command */
+
+/** OTP status register offset */
+#define SMSCUSB_OTP_STATUS 0x030
+#define SMSCUSB_OTP_STATUS_BUSY		0x00000001UL	/**< OTP busy */
+
+/** Maximum time to wait for OTP (in milliseconds) */
+#define SMSCUSB_OTP_MAX_WAIT_MS 100
+
+/** OTP layout 1 signature */
+#define SMSCUSB_OTP_1_SIG 0xf3
+
+/** OTP layout 1 MAC address offset */
+#define SMSCUSB_OTP_1_MAC 0x001
+
+/** OTP layout 2 signature */
+#define SMSCUSB_OTP_2_SIG 0xf7
+
+/** OTP layout 2 MAC address offset */
+#define SMSCUSB_OTP_2_MAC 0x101
+
 /** MII access register offset */
 #define SMSCUSB_MII_ACCESS 0x000
 #define SMSCUSB_MII_ACCESS_PHY_ADDRESS	0x00000800UL	/**< PHY address */
@@ -292,6 +334,8 @@ smscusb_mii_init ( struct smscusb_device *smscusb, unsigned int mii_base ) {
 
 extern int smscusb_eeprom_fetch_mac ( struct smscusb_device *smscusb,
 				      unsigned int e2p_base );
+extern int smscusb_otp_fetch_mac ( struct smscusb_device *smscusb,
+				   unsigned int otp_base );
 extern int smscusb_mii_check_link ( struct smscusb_device *smscusb );
 extern int smscusb_mii_open ( struct smscusb_device *smscusb );
 extern int smscusb_set_address ( struct smscusb_device *smscusb,