root/drivers/firewire/ohci.h
/* SPDX-License-Identifier: GPL-2.0 */
#ifndef _FIREWIRE_OHCI_H
#define _FIREWIRE_OHCI_H

/* OHCI register map */

#define OHCI1394_Version                      0x000
#define OHCI1394_GUID_ROM                     0x004
#define OHCI1394_ATRetries                    0x008
#define OHCI1394_CSRData                      0x00C
#define OHCI1394_CSRCompareData               0x010
#define OHCI1394_CSRControl                   0x014
#define OHCI1394_ConfigROMhdr                 0x018
#define OHCI1394_BusID                        0x01C
#define OHCI1394_BusOptions                   0x020
#define OHCI1394_GUIDHi                       0x024
#define OHCI1394_GUIDLo                       0x028
#define OHCI1394_ConfigROMmap                 0x034
#define OHCI1394_PostedWriteAddressLo         0x038
#define OHCI1394_PostedWriteAddressHi         0x03C
#define OHCI1394_VendorID                     0x040
#define OHCI1394_HCControlSet                 0x050
#define OHCI1394_HCControlClear               0x054
#define  OHCI1394_HCControl_BIBimageValid       0x80000000
#define  OHCI1394_HCControl_noByteSwapData      0x40000000
#define  OHCI1394_HCControl_programPhyEnable    0x00800000
#define  OHCI1394_HCControl_aPhyEnhanceEnable   0x00400000
#define  OHCI1394_HCControl_LPS                 0x00080000
#define  OHCI1394_HCControl_postedWriteEnable   0x00040000
#define  OHCI1394_HCControl_linkEnable          0x00020000
#define  OHCI1394_HCControl_softReset           0x00010000
#define OHCI1394_SelfIDBuffer                 0x064
#define OHCI1394_SelfIDCount                  0x068
#define OHCI1394_IRMultiChanMaskHiSet         0x070
#define OHCI1394_IRMultiChanMaskHiClear       0x074
#define OHCI1394_IRMultiChanMaskLoSet         0x078
#define OHCI1394_IRMultiChanMaskLoClear       0x07C
#define OHCI1394_IntEventSet                  0x080
#define OHCI1394_IntEventClear                0x084
#define OHCI1394_IntMaskSet                   0x088
#define OHCI1394_IntMaskClear                 0x08C
#define OHCI1394_IsoXmitIntEventSet           0x090
#define OHCI1394_IsoXmitIntEventClear         0x094
#define OHCI1394_IsoXmitIntMaskSet            0x098
#define OHCI1394_IsoXmitIntMaskClear          0x09C
#define OHCI1394_IsoRecvIntEventSet           0x0A0
#define OHCI1394_IsoRecvIntEventClear         0x0A4
#define OHCI1394_IsoRecvIntMaskSet            0x0A8
#define OHCI1394_IsoRecvIntMaskClear          0x0AC
#define OHCI1394_InitialBandwidthAvailable    0x0B0
#define OHCI1394_InitialChannelsAvailableHi   0x0B4
#define OHCI1394_InitialChannelsAvailableLo   0x0B8
#define OHCI1394_FairnessControl              0x0DC
#define OHCI1394_LinkControlSet               0x0E0
#define OHCI1394_LinkControlClear             0x0E4
#define   OHCI1394_LinkControl_rcvSelfID        (1 << 9)
#define   OHCI1394_LinkControl_rcvPhyPkt        (1 << 10)
#define   OHCI1394_LinkControl_cycleTimerEnable (1 << 20)
#define   OHCI1394_LinkControl_cycleMaster      (1 << 21)
#define   OHCI1394_LinkControl_cycleSource      (1 << 22)
#define OHCI1394_NodeID                       0x0E8
#define   OHCI1394_NodeID_idValid             0x80000000
#define   OHCI1394_NodeID_root                0x40000000
#define   OHCI1394_NodeID_nodeNumber          0x0000003f
#define   OHCI1394_NodeID_busNumber           0x0000ffc0
#define OHCI1394_PhyControl                   0x0EC
#define   OHCI1394_PhyControl_Read(addr)        (((addr) << 8) | 0x00008000)
#define   OHCI1394_PhyControl_ReadDone          0x80000000
#define   OHCI1394_PhyControl_ReadData(r)       (((r) & 0x00ff0000) >> 16)
#define   OHCI1394_PhyControl_Write(addr, data) (((addr) << 8) | (data) | 0x00004000)
#define   OHCI1394_PhyControl_WritePending      0x00004000
#define OHCI1394_IsochronousCycleTimer        0x0F0
#define OHCI1394_AsReqFilterHiSet             0x100
#define OHCI1394_AsReqFilterHiClear           0x104
#define OHCI1394_AsReqFilterLoSet             0x108
#define OHCI1394_AsReqFilterLoClear           0x10C
#define OHCI1394_PhyReqFilterHiSet            0x110
#define OHCI1394_PhyReqFilterHiClear          0x114
#define OHCI1394_PhyReqFilterLoSet            0x118
#define OHCI1394_PhyReqFilterLoClear          0x11C
#define OHCI1394_PhyUpperBound                0x120

#define OHCI1394_AsReqTrContextBase           0x180
#define OHCI1394_AsReqTrContextControlSet     0x180
#define OHCI1394_AsReqTrContextControlClear   0x184
#define OHCI1394_AsReqTrCommandPtr            0x18C

#define OHCI1394_AsRspTrContextBase           0x1A0
#define OHCI1394_AsRspTrContextControlSet     0x1A0
#define OHCI1394_AsRspTrContextControlClear   0x1A4
#define OHCI1394_AsRspTrCommandPtr            0x1AC

#define OHCI1394_AsReqRcvContextBase          0x1C0
#define OHCI1394_AsReqRcvContextControlSet    0x1C0
#define OHCI1394_AsReqRcvContextControlClear  0x1C4
#define OHCI1394_AsReqRcvCommandPtr           0x1CC

#define OHCI1394_AsRspRcvContextBase          0x1E0
#define OHCI1394_AsRspRcvContextControlSet    0x1E0
#define OHCI1394_AsRspRcvContextControlClear  0x1E4
#define OHCI1394_AsRspRcvCommandPtr           0x1EC

/* Isochronous transmit registers */
#define OHCI1394_IsoXmitContextBase(n)           (0x200 + 16 * (n))
#define OHCI1394_IsoXmitContextControlSet(n)     (0x200 + 16 * (n))
#define OHCI1394_IsoXmitContextControlClear(n)   (0x204 + 16 * (n))
#define OHCI1394_IsoXmitCommandPtr(n)            (0x20C + 16 * (n))

/* Isochronous receive registers */
#define OHCI1394_IsoRcvContextBase(n)         (0x400 + 32 * (n))
#define OHCI1394_IsoRcvContextControlSet(n)   (0x400 + 32 * (n))
#define OHCI1394_IsoRcvContextControlClear(n) (0x404 + 32 * (n))
#define OHCI1394_IsoRcvCommandPtr(n)          (0x40C + 32 * (n))
#define OHCI1394_IsoRcvContextMatch(n)        (0x410 + 32 * (n))

/* Interrupts Mask/Events */
#define OHCI1394_reqTxComplete          0x00000001
#define OHCI1394_respTxComplete         0x00000002
#define OHCI1394_ARRQ                   0x00000004
#define OHCI1394_ARRS                   0x00000008
#define OHCI1394_RQPkt                  0x00000010
#define OHCI1394_RSPkt                  0x00000020
#define OHCI1394_isochTx                0x00000040
#define OHCI1394_isochRx                0x00000080
#define OHCI1394_postedWriteErr         0x00000100
#define OHCI1394_lockRespErr            0x00000200
#define OHCI1394_selfIDComplete         0x00010000
#define OHCI1394_busReset               0x00020000
#define OHCI1394_regAccessFail          0x00040000
#define OHCI1394_phy                    0x00080000
#define OHCI1394_cycleSynch             0x00100000
#define OHCI1394_cycle64Seconds         0x00200000
#define OHCI1394_cycleLost              0x00400000
#define OHCI1394_cycleInconsistent      0x00800000
#define OHCI1394_unrecoverableError     0x01000000
#define OHCI1394_cycleTooLong           0x02000000
#define OHCI1394_phyRegRcvd             0x04000000
#define OHCI1394_masterIntEnable        0x80000000

#define OHCI1394_evt_no_status          0x0
#define OHCI1394_evt_long_packet        0x2
#define OHCI1394_evt_missing_ack        0x3
#define OHCI1394_evt_underrun           0x4
#define OHCI1394_evt_overrun            0x5
#define OHCI1394_evt_descriptor_read    0x6
#define OHCI1394_evt_data_read          0x7
#define OHCI1394_evt_data_write         0x8
#define OHCI1394_evt_bus_reset          0x9
#define OHCI1394_evt_timeout            0xa
#define OHCI1394_evt_tcode_err          0xb
#define OHCI1394_evt_reserved_b         0xc
#define OHCI1394_evt_reserved_c         0xd
#define OHCI1394_evt_unknown            0xe
#define OHCI1394_evt_flushed            0xf


// Asynchronous Transmit DMA.
//
// The content of first two quadlets of data for AT DMA is different from the header for IEEE 1394
// asynchronous packet.

#define OHCI1394_AT_DATA_Q0_srcBusID_MASK               0x00800000
#define OHCI1394_AT_DATA_Q0_srcBusID_SHIFT              23
#define OHCI1394_AT_DATA_Q0_spd_MASK                    0x00070000
#define OHCI1394_AT_DATA_Q0_spd_SHIFT                   16
#define OHCI1394_AT_DATA_Q0_tLabel_MASK                 0x0000fc00
#define OHCI1394_AT_DATA_Q0_tLabel_SHIFT                10
#define OHCI1394_AT_DATA_Q0_rt_MASK                     0x00000300
#define OHCI1394_AT_DATA_Q0_rt_SHIFT                    8
#define OHCI1394_AT_DATA_Q0_tCode_MASK                  0x000000f0
#define OHCI1394_AT_DATA_Q0_tCode_SHIFT                 4
#define OHCI1394_AT_DATA_Q1_destinationId_MASK          0xffff0000
#define OHCI1394_AT_DATA_Q1_destinationId_SHIFT         16
#define OHCI1394_AT_DATA_Q1_destinationOffsetHigh_MASK  0x0000ffff
#define OHCI1394_AT_DATA_Q1_destinationOffsetHigh_SHIFT 0
#define OHCI1394_AT_DATA_Q1_rCode_MASK                  0x0000f000
#define OHCI1394_AT_DATA_Q1_rCode_SHIFT                 12

static inline bool ohci1394_at_data_get_src_bus_id(const __le32 *data)
{
        return !!((data[0] & OHCI1394_AT_DATA_Q0_srcBusID_MASK) >> OHCI1394_AT_DATA_Q0_srcBusID_SHIFT);
}

static inline void ohci1394_at_data_set_src_bus_id(__le32 *data, bool src_bus_id)
{
        data[0] &= cpu_to_le32(~OHCI1394_AT_DATA_Q0_srcBusID_MASK);
        data[0] |= cpu_to_le32((src_bus_id << OHCI1394_AT_DATA_Q0_srcBusID_SHIFT) & OHCI1394_AT_DATA_Q0_srcBusID_MASK);
}

static inline unsigned int ohci1394_at_data_get_speed(const __le32 *data)
{
        return (le32_to_cpu(data[0]) & OHCI1394_AT_DATA_Q0_spd_MASK) >> OHCI1394_AT_DATA_Q0_spd_SHIFT;
}

static inline void ohci1394_at_data_set_speed(__le32 *data, unsigned int scode)
{
        data[0] &= cpu_to_le32(~OHCI1394_AT_DATA_Q0_spd_MASK);
        data[0] |= cpu_to_le32((scode << OHCI1394_AT_DATA_Q0_spd_SHIFT) & OHCI1394_AT_DATA_Q0_spd_MASK);
}

static inline unsigned int ohci1394_at_data_get_tlabel(const __le32 *data)
{
        return (le32_to_cpu(data[0]) & OHCI1394_AT_DATA_Q0_tLabel_MASK) >> OHCI1394_AT_DATA_Q0_tLabel_SHIFT;
}

static inline void ohci1394_at_data_set_tlabel(__le32 *data, unsigned int tlabel)
{
        data[0] &= cpu_to_le32(~OHCI1394_AT_DATA_Q0_tLabel_MASK);
        data[0] |= cpu_to_le32((tlabel << OHCI1394_AT_DATA_Q0_tLabel_SHIFT) & OHCI1394_AT_DATA_Q0_tLabel_MASK);
}

static inline unsigned int ohci1394_at_data_get_retry(const __le32 *data)
{
        return (le32_to_cpu(data[0]) & OHCI1394_AT_DATA_Q0_rt_MASK) >> OHCI1394_AT_DATA_Q0_rt_SHIFT;
}

static inline void ohci1394_at_data_set_retry(__le32 *data, unsigned int retry)
{
        data[0] &= cpu_to_le32(~OHCI1394_AT_DATA_Q0_rt_MASK);
        data[0] |= cpu_to_le32((retry << OHCI1394_AT_DATA_Q0_rt_SHIFT) & OHCI1394_AT_DATA_Q0_rt_MASK);
}

static inline unsigned int ohci1394_at_data_get_tcode(const __le32 *data)
{
        return (le32_to_cpu(data[0]) & OHCI1394_AT_DATA_Q0_tCode_MASK) >> OHCI1394_AT_DATA_Q0_tCode_SHIFT;
}

static inline void ohci1394_at_data_set_tcode(__le32 *data, unsigned int tcode)
{
        data[0] &= cpu_to_le32(~OHCI1394_AT_DATA_Q0_tCode_MASK);
        data[0] |= cpu_to_le32((tcode << OHCI1394_AT_DATA_Q0_tCode_SHIFT) & OHCI1394_AT_DATA_Q0_tCode_MASK);
}

static inline unsigned int ohci1394_at_data_get_destination_id(const __le32 *data)
{
        return (le32_to_cpu(data[1]) & OHCI1394_AT_DATA_Q1_destinationId_MASK) >> OHCI1394_AT_DATA_Q1_destinationId_SHIFT;
}

static inline void ohci1394_at_data_set_destination_id(__le32 *data, unsigned int destination_id)
{
        data[1] &= cpu_to_le32(~OHCI1394_AT_DATA_Q1_destinationId_MASK);
        data[1] |= cpu_to_le32((destination_id << OHCI1394_AT_DATA_Q1_destinationId_SHIFT) & OHCI1394_AT_DATA_Q1_destinationId_MASK);
}

static inline u64 ohci1394_at_data_get_destination_offset(const __le32 *data)
{
        u64 hi = (u64)((le32_to_cpu(data[1]) & OHCI1394_AT_DATA_Q1_destinationOffsetHigh_MASK) >> OHCI1394_AT_DATA_Q1_destinationOffsetHigh_SHIFT);
        u64 lo = (u64)le32_to_cpu(data[2]);
        return (hi << 32) | lo;
}

static inline void ohci1394_at_data_set_destination_offset(__le32 *data, u64 offset)
{
        u32 hi = (u32)(offset >> 32);
        u32 lo = (u32)(offset & 0x00000000ffffffff);
        data[1] &= cpu_to_le32(~OHCI1394_AT_DATA_Q1_destinationOffsetHigh_MASK);
        data[1] |= cpu_to_le32((hi << OHCI1394_AT_DATA_Q1_destinationOffsetHigh_SHIFT) & OHCI1394_AT_DATA_Q1_destinationOffsetHigh_MASK);
        data[2] = cpu_to_le32(lo);
}

static inline unsigned int ohci1394_at_data_get_rcode(const __le32 *data)
{
        return (le32_to_cpu(data[1]) & OHCI1394_AT_DATA_Q1_rCode_MASK) >> OHCI1394_AT_DATA_Q1_rCode_SHIFT;
}

static inline void ohci1394_at_data_set_rcode(__le32 *data, unsigned int rcode)
{
        data[1] &= cpu_to_le32(~OHCI1394_AT_DATA_Q1_rCode_MASK);
        data[1] |= cpu_to_le32((rcode << OHCI1394_AT_DATA_Q1_rCode_SHIFT) & OHCI1394_AT_DATA_Q1_rCode_MASK);
}

// Isochronous Transmit DMA.
//
// The content of first two quadlets of data for IT DMA is different from the header for IEEE 1394
// isochronous packet.

#define OHCI1394_IT_DATA_Q0_spd_MASK            0x00070000
#define OHCI1394_IT_DATA_Q0_spd_SHIFT           16
#define OHCI1394_IT_DATA_Q0_tag_MASK            0x0000c000
#define OHCI1394_IT_DATA_Q0_tag_SHIFT           14
#define OHCI1394_IT_DATA_Q0_chanNum_MASK        0x00003f00
#define OHCI1394_IT_DATA_Q0_chanNum_SHIFT       8
#define OHCI1394_IT_DATA_Q0_tcode_MASK          0x000000f0
#define OHCI1394_IT_DATA_Q0_tcode_SHIFT         4
#define OHCI1394_IT_DATA_Q0_sy_MASK             0x0000000f
#define OHCI1394_IT_DATA_Q0_sy_SHIFT            0
#define OHCI1394_IT_DATA_Q1_dataLength_MASK     0xffff0000
#define OHCI1394_IT_DATA_Q1_dataLength_SHIFT    16

static inline unsigned int ohci1394_it_data_get_speed(const __le32 *data)
{
        return (le32_to_cpu(data[0]) & OHCI1394_IT_DATA_Q0_spd_MASK) >> OHCI1394_IT_DATA_Q0_spd_SHIFT;
}

static inline void ohci1394_it_data_set_speed(__le32 *data, unsigned int scode)
{
        data[0] &= cpu_to_le32(~OHCI1394_IT_DATA_Q0_spd_MASK);
        data[0] |= cpu_to_le32((scode << OHCI1394_IT_DATA_Q0_spd_SHIFT) & OHCI1394_IT_DATA_Q0_spd_MASK);
}

static inline unsigned int ohci1394_it_data_get_tag(const __le32 *data)
{
        return (le32_to_cpu(data[0]) & OHCI1394_IT_DATA_Q0_tag_MASK) >> OHCI1394_IT_DATA_Q0_tag_SHIFT;
}

static inline void ohci1394_it_data_set_tag(__le32 *data, unsigned int tag)
{
        data[0] &= cpu_to_le32(~OHCI1394_IT_DATA_Q0_tag_MASK);
        data[0] |= cpu_to_le32((tag << OHCI1394_IT_DATA_Q0_tag_SHIFT) & OHCI1394_IT_DATA_Q0_tag_MASK);
}

static inline unsigned int ohci1394_it_data_get_channel(const __le32 *data)
{
        return (le32_to_cpu(data[0]) & OHCI1394_IT_DATA_Q0_chanNum_MASK) >> OHCI1394_IT_DATA_Q0_chanNum_SHIFT;
}

static inline void ohci1394_it_data_set_channel(__le32 *data, unsigned int channel)
{
        data[0] &= cpu_to_le32(~OHCI1394_IT_DATA_Q0_chanNum_MASK);
        data[0] |= cpu_to_le32((channel << OHCI1394_IT_DATA_Q0_chanNum_SHIFT) & OHCI1394_IT_DATA_Q0_chanNum_MASK);
}

static inline unsigned int ohci1394_it_data_get_tcode(const __le32 *data)
{
        return (le32_to_cpu(data[0]) & OHCI1394_IT_DATA_Q0_tcode_MASK) >> OHCI1394_IT_DATA_Q0_tcode_SHIFT;
}

static inline void ohci1394_it_data_set_tcode(__le32 *data, unsigned int tcode)
{
        data[0] &= cpu_to_le32(~OHCI1394_IT_DATA_Q0_tcode_MASK);
        data[0] |= cpu_to_le32((tcode << OHCI1394_IT_DATA_Q0_tcode_SHIFT) & OHCI1394_IT_DATA_Q0_tcode_MASK);
}

static inline unsigned int ohci1394_it_data_get_sync(const __le32 *data)
{
        return (le32_to_cpu(data[0]) & OHCI1394_IT_DATA_Q0_sy_MASK) >> OHCI1394_IT_DATA_Q0_sy_SHIFT;
}

static inline void ohci1394_it_data_set_sync(__le32 *data, unsigned int sync)
{
        data[0] &= cpu_to_le32(~OHCI1394_IT_DATA_Q0_sy_MASK);
        data[0] |= cpu_to_le32((sync << OHCI1394_IT_DATA_Q0_sy_SHIFT) & OHCI1394_IT_DATA_Q0_sy_MASK);
}

static inline unsigned int ohci1394_it_data_get_data_length(const __le32 *data)
{
        return (le32_to_cpu(data[1]) & OHCI1394_IT_DATA_Q1_dataLength_MASK) >> OHCI1394_IT_DATA_Q1_dataLength_SHIFT;
}

static inline void ohci1394_it_data_set_data_length(__le32 *data, unsigned int data_length)
{
        data[1] &= cpu_to_le32(~OHCI1394_IT_DATA_Q1_dataLength_MASK);
        data[1] |= cpu_to_le32((data_length << OHCI1394_IT_DATA_Q1_dataLength_SHIFT) & OHCI1394_IT_DATA_Q1_dataLength_MASK);
}

// Self-ID DMA.

#define OHCI1394_SelfIDCount_selfIDError_MASK           0x80000000
#define OHCI1394_SelfIDCount_selfIDError_SHIFT          31
#define OHCI1394_SelfIDCount_selfIDGeneration_MASK      0x00ff0000
#define OHCI1394_SelfIDCount_selfIDGeneration_SHIFT     16
#define OHCI1394_SelfIDCount_selfIDSize_MASK            0x000007fc
#define OHCI1394_SelfIDCount_selfIDSize_SHIFT           2

static inline bool ohci1394_self_id_count_is_error(u32 value)
{
        return !!((value & OHCI1394_SelfIDCount_selfIDError_MASK) >> OHCI1394_SelfIDCount_selfIDError_SHIFT);
}

static inline u8 ohci1394_self_id_count_get_generation(u32 value)
{
        return (value & OHCI1394_SelfIDCount_selfIDGeneration_MASK) >> OHCI1394_SelfIDCount_selfIDGeneration_SHIFT;
}

// In 1394 OHCI specification, the maximum size of self ID stream is 504 quadlets
// (= 63 devices * 4 self ID packets * 2 quadlets). The selfIDSize field accommodates it and its
// additional first quadlet, since the field is 9 bits (0x1ff = 511).
static inline u32 ohci1394_self_id_count_get_size(u32 value)
{
        return (value & OHCI1394_SelfIDCount_selfIDSize_MASK) >> OHCI1394_SelfIDCount_selfIDSize_SHIFT;
}

#define OHCI1394_SELF_ID_RECEIVE_Q0_GENERATION_MASK     0x00ff0000
#define OHCI1394_SELF_ID_RECEIVE_Q0_GENERATION_SHIFT    16
#define OHCI1394_SELF_ID_RECEIVE_Q0_TIMESTAMP_MASK      0x0000ffff
#define OHCI1394_SELF_ID_RECEIVE_Q0_TIMESTAMP_SHIFT     0

static inline u8 ohci1394_self_id_receive_q0_get_generation(u32 quadlet0)
{
        return (quadlet0 & OHCI1394_SELF_ID_RECEIVE_Q0_GENERATION_MASK) >> OHCI1394_SELF_ID_RECEIVE_Q0_GENERATION_SHIFT;
}

static inline u16 ohci1394_self_id_receive_q0_get_timestamp(u32 quadlet0)
{
        return (quadlet0 & OHCI1394_SELF_ID_RECEIVE_Q0_TIMESTAMP_MASK) >> OHCI1394_SELF_ID_RECEIVE_Q0_TIMESTAMP_SHIFT;
}

#endif /* _FIREWIRE_OHCI_H */