| .. | .. |
|---|
| 1 | | -/** |
|---|
| 1 | +// SPDX-License-Identifier: GPL-2.0-only |
|---|
| 2 | +/* |
|---|
| 2 | 3 | * arch/arm/mac-sa1100/jornada720_ssp.c |
|---|
| 3 | 4 | * |
|---|
| 4 | 5 | * Copyright (C) 2006/2007 Kristoffer Ericson <Kristoffer.Ericson@gmail.com> |
|---|
| 5 | 6 | * Copyright (C) 2006 Filip Zyzniewski <filip.zyzniewski@tefnet.pl> |
|---|
| 6 | | - * |
|---|
| 7 | | - * This program is free software; you can redistribute it and/or modify |
|---|
| 8 | | - * it under the terms of the GNU General Public License version 2 as |
|---|
| 9 | | - * published by the Free Software Foundation. |
|---|
| 10 | 7 | * |
|---|
| 11 | 8 | * SSP driver for the HP Jornada 710/720/728 |
|---|
| 12 | 9 | */ |
|---|
| .. | .. |
|---|
| 29 | 26 | |
|---|
| 30 | 27 | /** |
|---|
| 31 | 28 | * jornada_ssp_reverse - reverses input byte |
|---|
| 29 | + * @byte: input byte to reverse |
|---|
| 32 | 30 | * |
|---|
| 33 | 31 | * we need to reverse all data we receive from the mcu due to its physical location |
|---|
| 34 | 32 | * returns : 01110111 -> 11101110 |
|---|
| .. | .. |
|---|
| 49 | 47 | |
|---|
| 50 | 48 | /** |
|---|
| 51 | 49 | * jornada_ssp_byte - waits for ready ssp bus and sends byte |
|---|
| 50 | + * @byte: input byte to transmit |
|---|
| 52 | 51 | * |
|---|
| 53 | 52 | * waits for fifo buffer to clear and then transmits, if it doesn't then we will |
|---|
| 54 | 53 | * timeout after <timeout> rounds. Needs mcu running before its called. |
|---|
| .. | .. |
|---|
| 80 | 79 | |
|---|
| 81 | 80 | /** |
|---|
| 82 | 81 | * jornada_ssp_inout - decide if input is command or trading byte |
|---|
| 82 | + * @byte: input byte to send (may be %TXDUMMY) |
|---|
| 83 | 83 | * |
|---|
| 84 | 84 | * returns : (jornada_ssp_byte(byte)) on success |
|---|
| 85 | 85 | * : %-ETIMEDOUT on timeout failure |
|---|