1 /* SPDX-License-Identifier: GPL-2.0+ */ 2 /* 3 * Test-related constants for sandbox 4 * 5 * Copyright (c) 2014 Google, Inc 6 */ 7 8 #ifndef __ASM_TEST_H 9 #define __ASM_TEST_H 10 11 /* The sandbox driver always permits an I2C device with this address */ 12 #define SANDBOX_I2C_TEST_ADDR 0x59 13 14 #define SANDBOX_PCI_VENDOR_ID 0x1234 15 #define SANDBOX_PCI_DEVICE_ID 0x5678 16 #define SANDBOX_PCI_CLASS_CODE PCI_CLASS_CODE_COMM 17 #define SANDBOX_PCI_CLASS_SUB_CODE PCI_CLASS_SUB_CODE_COMM_SERIAL 18 19 #define PCI_CAP_ID_PM_OFFSET 0x50 20 #define PCI_CAP_ID_EXP_OFFSET 0x60 21 #define PCI_CAP_ID_MSIX_OFFSET 0x70 22 23 #define PCI_EXT_CAP_ID_ERR_OFFSET 0x100 24 #define PCI_EXT_CAP_ID_VC_OFFSET 0x200 25 #define PCI_EXT_CAP_ID_DSN_OFFSET 0x300 26 27 /* Useful for PCI_VDEVICE() macro */ 28 #define PCI_VENDOR_ID_SANDBOX SANDBOX_PCI_VENDOR_ID 29 #define SWAP_CASE_DRV_DATA 0x55aa 30 31 #define SANDBOX_CLK_RATE 32768 32 33 /* System controller driver data */ 34 enum { 35 SYSCON0 = 32, 36 SYSCON1, 37 38 SYSCON_COUNT 39 }; 40 41 /** 42 * sandbox_i2c_set_test_mode() - set test mode for running unit tests 43 * 44 * See sandbox_i2c_xfer() for the behaviour changes. 45 * 46 * @bus: sandbox I2C bus to adjust 47 * @test_mode: true to select test mode, false to run normally 48 */ 49 void sandbox_i2c_set_test_mode(struct udevice *bus, bool test_mode); 50 51 enum sandbox_i2c_eeprom_test_mode { 52 SIE_TEST_MODE_NONE, 53 /* Permits read/write of only one byte per I2C transaction */ 54 SIE_TEST_MODE_SINGLE_BYTE, 55 }; 56 57 void sandbox_i2c_eeprom_set_test_mode(struct udevice *dev, 58 enum sandbox_i2c_eeprom_test_mode mode); 59 60 void sandbox_i2c_eeprom_set_offset_len(struct udevice *dev, int offset_len); 61 62 /* 63 * sandbox_timer_add_offset() 64 * 65 * Allow tests to add to the time reported through lib/time.c functions 66 * offset: number of milliseconds to advance the system time 67 */ 68 void sandbox_timer_add_offset(unsigned long offset); 69 70 /** 71 * sandbox_i2c_rtc_set_offset() - set the time offset from system/base time 72 * 73 * @dev: RTC device to adjust 74 * @use_system_time: true to use system time, false to use @base_time 75 * @offset: RTC offset from current system/base time (-1 for no 76 * change) 77 * @return old value of RTC offset 78 */ 79 long sandbox_i2c_rtc_set_offset(struct udevice *dev, bool use_system_time, 80 int offset); 81 82 /** 83 * sandbox_i2c_rtc_get_set_base_time() - get and set the base time 84 * 85 * @dev: RTC device to adjust 86 * @base_time: New base system time (set to -1 for no change) 87 * @return old base time 88 */ 89 long sandbox_i2c_rtc_get_set_base_time(struct udevice *dev, long base_time); 90 91 int sandbox_usb_keyb_add_string(struct udevice *dev, const char *str); 92 93 /** 94 * sandbox_osd_get_mem() - get the internal memory of a sandbox OSD 95 * 96 * @dev: OSD device for which to access the internal memory for 97 * @buf: pointer to buffer to receive the OSD memory data 98 * @buflen: length of buffer in bytes 99 */ 100 int sandbox_osd_get_mem(struct udevice *dev, u8 *buf, size_t buflen); 101 102 /** 103 * sandbox_pwm_get_config() - get the PWM config for a channel 104 * 105 * @dev: Device to check 106 * @channel: Channel number to check 107 * @period_ns: Period of the PWM in nanoseconds 108 * @duty_ns: Current duty cycle of the PWM in nanoseconds 109 * @enable: true if the PWM is enabled 110 * @polarity: true if the PWM polarity is active high 111 * @return 0 if OK, -ENOSPC if the PWM number is invalid 112 */ 113 int sandbox_pwm_get_config(struct udevice *dev, uint channel, uint *period_nsp, 114 uint *duty_nsp, bool *enablep, bool *polarityp); 115 116 /** 117 * sandbox_sf_set_block_protect() - Set the BP bits of the status register 118 * 119 * @dev: Device to update 120 * @bp_mask: BP bits to set (bits 2:0, so a value of 0 to 7) 121 */ 122 void sandbox_sf_set_block_protect(struct udevice *dev, int bp_mask); 123 124 /** 125 * sandbox_get_codec_params() - Read back codec parameters 126 * 127 * This reads back the parameters set by audio_codec_set_params() for the 128 * sandbox audio driver. Arguments are as for that function. 129 */ 130 void sandbox_get_codec_params(struct udevice *dev, int *interfacep, int *ratep, 131 int *mclk_freqp, int *bits_per_samplep, 132 uint *channelsp); 133 134 /** 135 * sandbox_get_i2s_sum() - Read back the sum of the audio data so far 136 * 137 * This data is provided to the sandbox driver by the I2S tx_data() method. 138 * 139 * @dev: Device to check 140 * @return sum of audio data 141 */ 142 int sandbox_get_i2s_sum(struct udevice *dev); 143 144 /** 145 * sandbox_get_setup_called() - Returns the number of times setup(*) was called 146 * 147 * This is used in the sound test 148 * 149 * @dev: Device to check 150 * @return call count for the setup() method 151 */ 152 int sandbox_get_setup_called(struct udevice *dev); 153 154 /** 155 * sandbox_get_sound_sum() - Read back the sum of the sound data so far 156 * 157 * This data is provided to the sandbox driver by the sound play() method. 158 * 159 * @dev: Device to check 160 * @return sum of audio data 161 */ 162 int sandbox_get_sound_sum(struct udevice *dev); 163 164 /** 165 * sandbox_set_allow_beep() - Set whether the 'beep' interface is supported 166 * 167 * @dev: Device to update 168 * @allow: true to allow the start_beep() method, false to disallow it 169 */ 170 void sandbox_set_allow_beep(struct udevice *dev, bool allow); 171 172 /** 173 * sandbox_get_beep_frequency() - Get the frequency of the current beep 174 * 175 * @dev: Device to check 176 * @return frequency of beep, if there is an active beep, else 0 177 */ 178 int sandbox_get_beep_frequency(struct udevice *dev); 179 180 /** 181 * sandbox_get_pch_spi_protect() - Get the PCI SPI protection status 182 * 183 * @dev: Device to check 184 * @return 0 if not protected, 1 if protected 185 */ 186 int sandbox_get_pch_spi_protect(struct udevice *dev); 187 188 #endif 189