1 /* 2 * Driver for the NXP SAA7164 PCIe bridge 3 * 4 * Copyright (c) 2010-2015 Steven Toth <stoth@kernellabs.com> 5 * 6 * This program is free software; you can redistribute it and/or modify 7 * it under the terms of the GNU General Public License as published by 8 * the Free Software Foundation; either version 2 of the License, or 9 * (at your option) any later version. 10 * 11 * This program is distributed in the hope that it will be useful, 12 * but WITHOUT ANY WARRANTY; without even the implied warranty of 13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 14 * 15 * GNU General Public License for more details. 16 * 17 * You should have received a copy of the GNU General Public License 18 * along with this program; if not, write to the Free Software 19 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. 20 */ 21 22 /* TODO: Retest the driver with errors expressed as negatives */ 23 24 /* Result codes */ 25 #define SAA_OK 0 26 #define SAA_ERR_BAD_PARAMETER 0x09 27 #define SAA_ERR_NO_RESOURCES 0x0c 28 #define SAA_ERR_NOT_SUPPORTED 0x13 29 #define SAA_ERR_BUSY 0x15 30 #define SAA_ERR_READ 0x17 31 #define SAA_ERR_TIMEOUT 0x1f 32 #define SAA_ERR_OVERFLOW 0x20 33 #define SAA_ERR_EMPTY 0x22 34 #define SAA_ERR_NOT_STARTED 0x23 35 #define SAA_ERR_ALREADY_STARTED 0x24 36 #define SAA_ERR_NOT_STOPPED 0x25 37 #define SAA_ERR_ALREADY_STOPPED 0x26 38 #define SAA_ERR_INVALID_COMMAND 0x3e 39 #define SAA_ERR_NULL_PACKET 0x59 40 41 /* Errors and flags from the silicon */ 42 #define PVC_ERRORCODE_UNKNOWN 0x00 43 #define PVC_ERRORCODE_INVALID_COMMAND 0x01 44 #define PVC_ERRORCODE_INVALID_CONTROL 0x02 45 #define PVC_ERRORCODE_INVALID_DATA 0x03 46 #define PVC_ERRORCODE_TIMEOUT 0x04 47 #define PVC_ERRORCODE_NAK 0x05 48 #define PVC_RESPONSEFLAG_ERROR 0x01 49 #define PVC_RESPONSEFLAG_OVERFLOW 0x02 50 #define PVC_RESPONSEFLAG_RESET 0x04 51 #define PVC_RESPONSEFLAG_INTERFACE 0x08 52 #define PVC_RESPONSEFLAG_CONTINUED 0x10 53 #define PVC_CMDFLAG_INTERRUPT 0x02 54 #define PVC_CMDFLAG_INTERFACE 0x04 55 #define PVC_CMDFLAG_SERIALIZE 0x08 56 #define PVC_CMDFLAG_CONTINUE 0x10 57 58 /* Silicon Commands */ 59 #define GET_DESCRIPTORS_CONTROL 0x01 60 #define GET_STRING_CONTROL 0x03 61 #define GET_LANGUAGE_CONTROL 0x05 62 #define SET_POWER_CONTROL 0x07 63 #define GET_FW_STATUS_CONTROL 0x08 64 #define GET_FW_VERSION_CONTROL 0x09 65 #define SET_DEBUG_LEVEL_CONTROL 0x0B 66 #define GET_DEBUG_DATA_CONTROL 0x0C 67 #define GET_PRODUCTION_INFO_CONTROL 0x0D 68 69 /* cmd defines */ 70 #define SAA_CMDFLAG_CONTINUE 0x10 71 #define SAA_CMD_MAX_MSG_UNITS 256 72 73 /* Some defines */ 74 #define SAA_BUS_TIMEOUT 50 75 #define SAA_DEVICE_TIMEOUT 5000 76 #define SAA_DEVICE_MAXREQUESTSIZE 256 77 78 /* Register addresses */ 79 #define SAA_DEVICE_VERSION 0x30 80 #define SAA_DOWNLOAD_FLAGS 0x34 81 #define SAA_DOWNLOAD_FLAG 0x34 82 #define SAA_DOWNLOAD_FLAG_ACK 0x38 83 #define SAA_DATAREADY_FLAG 0x3C 84 #define SAA_DATAREADY_FLAG_ACK 0x40 85 86 /* Boot loader register and bit definitions */ 87 #define SAA_BOOTLOADERERROR_FLAGS 0x44 88 #define SAA_DEVICE_IMAGE_SEARCHING 0x01 89 #define SAA_DEVICE_IMAGE_LOADING 0x02 90 #define SAA_DEVICE_IMAGE_BOOTING 0x03 91 #define SAA_DEVICE_IMAGE_CORRUPT 0x04 92 #define SAA_DEVICE_MEMORY_CORRUPT 0x08 93 #define SAA_DEVICE_NO_IMAGE 0x10 94 95 /* Register addresses */ 96 #define SAA_DEVICE_2ND_VERSION 0x50 97 #define SAA_DEVICE_2ND_DOWNLOADFLAG_OFFSET 0x54 98 99 /* Register addresses */ 100 #define SAA_SECONDSTAGEERROR_FLAGS 0x64 101 102 /* Bootloader regs and flags */ 103 #define SAA_DEVICE_DEADLOCK_DETECTED_OFFSET 0x6C 104 #define SAA_DEVICE_DEADLOCK_DETECTED 0xDEADDEAD 105 106 /* Basic firmware status registers */ 107 #define SAA_DEVICE_SYSINIT_STATUS_OFFSET 0x70 108 #define SAA_DEVICE_SYSINIT_STATUS 0x70 109 #define SAA_DEVICE_SYSINIT_MODE 0x74 110 #define SAA_DEVICE_SYSINIT_SPEC 0x78 111 #define SAA_DEVICE_SYSINIT_INST 0x7C 112 #define SAA_DEVICE_SYSINIT_CPULOAD 0x80 113 #define SAA_DEVICE_SYSINIT_REMAINHEAP 0x84 114 115 #define SAA_DEVICE_DOWNLOAD_OFFSET 0x1000 116 #define SAA_DEVICE_BUFFERBLOCKSIZE 0x1000 117 118 #define SAA_DEVICE_2ND_BUFFERBLOCKSIZE 0x100000 119 #define SAA_DEVICE_2ND_DOWNLOAD_OFFSET 0x200000 120 121 /* Descriptors */ 122 #define CS_INTERFACE 0x24 123 124 /* Descriptor subtypes */ 125 #define VC_INPUT_TERMINAL 0x02 126 #define VC_OUTPUT_TERMINAL 0x03 127 #define VC_SELECTOR_UNIT 0x04 128 #define VC_PROCESSING_UNIT 0x05 129 #define FEATURE_UNIT 0x06 130 #define TUNER_UNIT 0x09 131 #define ENCODER_UNIT 0x0A 132 #define EXTENSION_UNIT 0x0B 133 #define VC_TUNER_PATH 0xF0 134 #define PVC_HARDWARE_DESCRIPTOR 0xF1 135 #define PVC_INTERFACE_DESCRIPTOR 0xF2 136 #define PVC_INFRARED_UNIT 0xF3 137 #define DRM_UNIT 0xF4 138 #define GENERAL_REQUEST 0xF5 139 140 /* Format Types */ 141 #define VS_FORMAT_TYPE 0x02 142 #define VS_FORMAT_TYPE_I 0x01 143 #define VS_FORMAT_UNCOMPRESSED 0x04 144 #define VS_FRAME_UNCOMPRESSED 0x05 145 #define VS_FORMAT_MPEG2PS 0x09 146 #define VS_FORMAT_MPEG2TS 0x0A 147 #define VS_FORMAT_MPEG4SL 0x0B 148 #define VS_FORMAT_WM9 0x0C 149 #define VS_FORMAT_DIVX 0x0D 150 #define VS_FORMAT_VBI 0x0E 151 #define VS_FORMAT_RDS 0x0F 152 153 /* Device extension commands */ 154 #define EXU_REGISTER_ACCESS_CONTROL 0x00 155 #define EXU_GPIO_CONTROL 0x01 156 #define EXU_GPIO_GROUP_CONTROL 0x02 157 #define EXU_INTERRUPT_CONTROL 0x03 158 159 /* State Transition and args */ 160 #define SAA_PROBE_CONTROL 0x01 161 #define SAA_COMMIT_CONTROL 0x02 162 #define SAA_STATE_CONTROL 0x03 163 #define SAA_DMASTATE_STOP 0x00 164 #define SAA_DMASTATE_ACQUIRE 0x01 165 #define SAA_DMASTATE_PAUSE 0x02 166 #define SAA_DMASTATE_RUN 0x03 167 168 /* A/V Mux Input Selector */ 169 #define SU_INPUT_SELECT_CONTROL 0x01 170 171 /* Encoder Profiles */ 172 #define EU_PROFILE_PS_DVD 0x06 173 #define EU_PROFILE_TS_HQ 0x09 174 #define EU_VIDEO_FORMAT_MPEG_2 0x02 175 176 /* Tuner */ 177 #define TU_AUDIO_MODE_CONTROL 0x17 178 179 /* Video Formats */ 180 #define TU_STANDARD_CONTROL 0x00 181 #define TU_STANDARD_AUTO_CONTROL 0x01 182 #define TU_STANDARD_NONE 0x00 183 #define TU_STANDARD_NTSC_M 0x01 184 #define TU_STANDARD_PAL_I 0x08 185 #define TU_STANDARD_MANUAL 0x00 186 #define TU_STANDARD_AUTO 0x01 187 188 /* Video Controls */ 189 #define PU_BRIGHTNESS_CONTROL 0x02 190 #define PU_CONTRAST_CONTROL 0x03 191 #define PU_HUE_CONTROL 0x06 192 #define PU_SATURATION_CONTROL 0x07 193 #define PU_SHARPNESS_CONTROL 0x08 194 195 /* Audio Controls */ 196 #define MUTE_CONTROL 0x01 197 #define VOLUME_CONTROL 0x02 198 #define AUDIO_DEFAULT_CONTROL 0x0D 199 200 /* Default Volume Levels */ 201 #define TMHW_LEV_ADJ_DECLEV_DEFAULT 0x00 202 #define TMHW_LEV_ADJ_MONOLEV_DEFAULT 0x00 203 #define TMHW_LEV_ADJ_NICLEV_DEFAULT 0x00 204 #define TMHW_LEV_ADJ_SAPLEV_DEFAULT 0x00 205 #define TMHW_LEV_ADJ_ADCLEV_DEFAULT 0x00 206 207 /* Encoder Related Commands */ 208 #define EU_PROFILE_CONTROL 0x00 209 #define EU_VIDEO_FORMAT_CONTROL 0x01 210 #define EU_VIDEO_BIT_RATE_CONTROL 0x02 211 #define EU_VIDEO_RESOLUTION_CONTROL 0x03 212 #define EU_VIDEO_GOP_STRUCTURE_CONTROL 0x04 213 #define EU_VIDEO_INPUT_ASPECT_CONTROL 0x0A 214 #define EU_AUDIO_FORMAT_CONTROL 0x0C 215 #define EU_AUDIO_BIT_RATE_CONTROL 0x0D 216 217 /* Firmware Debugging */ 218 #define SET_DEBUG_LEVEL_CONTROL 0x0B 219 #define GET_DEBUG_DATA_CONTROL 0x0C 220