1 // SPDX-License-Identifier: GPL-2.0-only
35  * struct ks8851_net_par - KS8851 Parallel driver private data
42  * The @lock ensures that the chip is protected when certain operations are
44  * of the chip registers are not accessible until the transfer is finished
45  * and the DMA has been de-asserted.
58  * ks8851_lock_par - register access lock
59  * @ks: The chip state
62  * Claim chip register access lock
68 	spin_lock_irqsave(&ksp->lock, *flags);  in ks8851_lock_par()
72  * ks8851_unlock_par - register access unlock
73  * @ks: The chip state
76  * Release chip register access lock
82 	spin_unlock_irqrestore(&ksp->lock, *flags);  in ks8851_unlock_par()
86  * ks_check_endian - Check whether endianness of the bus is correct
87  * @ks	  : The chip information
89  * The KS8851-16MLL EESK pin allows selecting the endianness of the 16bit
100 	 * If the endian strap on the KS8851-16MLL in incorrect and the chip  in ks_check_endian()
102 	 * of BE[3:0] byte-enable bits is also swapped such that:  in ks_check_endian()
105 	 * Luckily for us, the byte-enable bits are the top four MSbits of  in ks_check_endian()
117 	 * BE[1:0] and this read returns non-zero 0x8872 value.  in ks_check_endian()
119 	iowrite16(BE3 | BE2 | KS_CIDER, ksp->hw_addr_cmd);  in ks_check_endian()
120 	cider = ioread16(ksp->hw_addr);  in ks_check_endian()
124 	netdev_err(ks->netdev, "incorrect EESK endian strap setting\n");  in ks_check_endian()
126 	return -EINVAL;  in ks_check_endian()
130  * ks8851_wrreg16_par - write 16bit register value to chip
131  * @ks: The chip state
142 	ksp->cmd_reg_cache = (u16)reg | ((BE1 | BE0) << (reg & 0x02));  in ks8851_wrreg16_par()
143 	iowrite16(ksp->cmd_reg_cache, ksp->hw_addr_cmd);  in ks8851_wrreg16_par()
144 	iowrite16(val, ksp->hw_addr);  in ks8851_wrreg16_par()
148  * ks8851_rdreg16_par - read 16 bit register from chip
149  * @ks: The chip information
152  * Read a 16bit register from the chip, returning the result
158 	ksp->cmd_reg_cache = (u16)reg | ((BE1 | BE0) << (reg & 0x02));  in ks8851_rdreg16_par()
159 	iowrite16(ksp->cmd_reg_cache, ksp->hw_addr_cmd);  in ks8851_rdreg16_par()
160 	return ioread16(ksp->hw_addr);  in ks8851_rdreg16_par()
164  * ks8851_rdfifo_par - read data from the receive fifo
176 	netif_dbg(ks, rx_status, ks->netdev,  in ks8851_rdfifo_par()
179 	ioread16_rep(ksp->hw_addr, (u16 *)buff + 1, len / 2);  in ks8851_rdfifo_par()
183  * ks8851_wrfifo_par - write packet to TX FIFO
186  * @irq: IRQ on completion of the packet.
188  * Send the @txp to the chip. This means creating the relevant packet header
189  * specifying the length of the packet and the other information the chip
190  * needs, such as IRQ on completion. Send the header and the packet data to
197 	unsigned int len = ALIGN(txp->len, 4);  in ks8851_wrfifo_par()
200 	netif_dbg(ks, tx_queued, ks->netdev, "%s: skb %p, %d@%p, irq %d\n",  in ks8851_wrfifo_par()
201 		  __func__, txp, txp->len, txp->data, irq);  in ks8851_wrfifo_par()
203 	fid = ks->fid++;  in ks8851_wrfifo_par()
207 		fid |= TXFR_TXIC;	/* irq on completion */  in ks8851_wrfifo_par()
209 	iowrite16(fid, ksp->hw_addr);  in ks8851_wrfifo_par()
210 	iowrite16(txp->len, ksp->hw_addr);  in ks8851_wrfifo_par()
212 	iowrite16_rep(ksp->hw_addr, txp->data, len / 2);  in ks8851_wrfifo_par()
216  * ks8851_rx_skb_par - receive skbuff
231  * ks8851_start_xmit_par - transmit packet
235  * Called by the network layer to transmit the @skb. Queue the packet for
239  * We do this to firstly avoid sleeping with the network device locked,
253 	netif_dbg(ks, tx_queued, ks->netdev,  in ks8851_start_xmit_par()
254 		  "%s: skb %p, %d@%p\n", __func__, skb, skb->len, skb->data);  in ks8851_start_xmit_par()
260 	if (likely(txmir >= skb->len + 12)) {  in ks8851_start_xmit_par()
261 		ks8851_wrreg16_par(ks, KS_RXQCR, ks->rc_rxqcr | RXQCR_SDA);  in ks8851_start_xmit_par()
263 		ks8851_wrreg16_par(ks, KS_RXQCR, ks->rc_rxqcr);  in ks8851_start_xmit_par()
284 	struct device *dev = &pdev->dev;  in ks8851_probe_par()
292 		return -ENOMEM;  in ks8851_probe_par()
296 	ks->lock = ks8851_lock_par;  in ks8851_probe_par()
297 	ks->unlock = ks8851_unlock_par;  in ks8851_probe_par()
298 	ks->rdreg16 = ks8851_rdreg16_par;  in ks8851_probe_par()
299 	ks->wrreg16 = ks8851_wrreg16_par;  in ks8851_probe_par()
300 	ks->rdfifo = ks8851_rdfifo_par;  in ks8851_probe_par()
301 	ks->wrfifo = ks8851_wrfifo_par;  in ks8851_probe_par()
302 	ks->start_xmit = ks8851_start_xmit_par;  in ks8851_probe_par()
303 	ks->rx_skb = ks8851_rx_skb_par;  in ks8851_probe_par()
308 	ks->rc_ier = STD_IRQ;  in ks8851_probe_par()
311 	spin_lock_init(&ksp->lock);  in ks8851_probe_par()
313 	ksp->hw_addr = devm_platform_ioremap_resource(pdev, 0);  in ks8851_probe_par()
314 	if (IS_ERR(ksp->hw_addr))  in ks8851_probe_par()
315 		return PTR_ERR(ksp->hw_addr);  in ks8851_probe_par()
317 	ksp->hw_addr_cmd = devm_platform_ioremap_resource(pdev, 1);  in ks8851_probe_par()
318 	if (IS_ERR(ksp->hw_addr_cmd))  in ks8851_probe_par()
319 		return PTR_ERR(ksp->hw_addr_cmd);  in ks8851_probe_par()
325 	netdev->irq = platform_get_irq(pdev, 0);  in ks8851_probe_par()
332 	return ks8851_remove_common(&pdev->dev);  in ks8851_remove_par()
336 	{ .compatible = "micrel,ks8851-mll" },
352 MODULE_DESCRIPTION("KS8851 Network driver");