1 /* SPDX-License-Identifier: GPL-2.0+ */
3 * Test-related constants for sandbox
5 * Copyright (c) 2014 Google, Inc
11 /* The sandbox driver always permits an I2C device with this address */
12 #define SANDBOX_I2C_TEST_ADDR 0x59
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
19 #define PCI_CAP_ID_PM_OFFSET 0x50
20 #define PCI_CAP_ID_EXP_OFFSET 0x60
21 #define PCI_CAP_ID_MSIX_OFFSET 0x70
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
27 /* Useful for PCI_VDEVICE() macro */
28 #define PCI_VENDOR_ID_SANDBOX SANDBOX_PCI_VENDOR_ID
29 #define SWAP_CASE_DRV_DATA 0x55aa
31 #define SANDBOX_CLK_RATE 32768
33 /* System controller driver data */
42 * sandbox_i2c_set_test_mode() - set test mode for running unit tests
44 * See sandbox_i2c_xfer() for the behaviour changes.
46 * @bus: sandbox I2C bus to adjust
47 * @test_mode: true to select test mode, false to run normally
49 void sandbox_i2c_set_test_mode(struct udevice *bus, bool test_mode);
51 enum sandbox_i2c_eeprom_test_mode {
53 /* Permits read/write of only one byte per I2C transaction */
54 SIE_TEST_MODE_SINGLE_BYTE,
57 void sandbox_i2c_eeprom_set_test_mode(struct udevice *dev,
58 enum sandbox_i2c_eeprom_test_mode mode);
60 void sandbox_i2c_eeprom_set_offset_len(struct udevice *dev, int offset_len);
63 * sandbox_i2c_rtc_set_offset() - set the time offset from system/base time
65 * @dev: RTC device to adjust
66 * @use_system_time: true to use system time, false to use @base_time
67 * @offset: RTC offset from current system/base time (-1 for no
69 * @return old value of RTC offset
71 long sandbox_i2c_rtc_set_offset(struct udevice *dev, bool use_system_time,
75 * sandbox_i2c_rtc_get_set_base_time() - get and set the base time
77 * @dev: RTC device to adjust
78 * @base_time: New base system time (set to -1 for no change)
79 * @return old base time
81 long sandbox_i2c_rtc_get_set_base_time(struct udevice *dev, long base_time);
83 int sandbox_usb_keyb_add_string(struct udevice *dev, const char *str);
86 * sandbox_osd_get_mem() - get the internal memory of a sandbox OSD
88 * @dev: OSD device for which to access the internal memory for
89 * @buf: pointer to buffer to receive the OSD memory data
90 * @buflen: length of buffer in bytes
92 int sandbox_osd_get_mem(struct udevice *dev, u8 *buf, size_t buflen);
95 * sandbox_pwm_get_config() - get the PWM config for a channel
97 * @dev: Device to check
98 * @channel: Channel number to check
99 * @period_ns: Period of the PWM in nanoseconds
100 * @duty_ns: Current duty cycle of the PWM in nanoseconds
101 * @enable: true if the PWM is enabled
102 * @polarity: true if the PWM polarity is active high
103 * @return 0 if OK, -ENOSPC if the PWM number is invalid
105 int sandbox_pwm_get_config(struct udevice *dev, uint channel, uint *period_nsp,
106 uint *duty_nsp, bool *enablep, bool *polarityp);
109 * sandbox_sf_set_block_protect() - Set the BP bits of the status register
111 * @dev: Device to update
112 * @bp_mask: BP bits to set (bits 2:0, so a value of 0 to 7)
114 void sandbox_sf_set_block_protect(struct udevice *dev, int bp_mask);
117 * sandbox_get_codec_params() - Read back codec parameters
119 * This reads back the parameters set by audio_codec_set_params() for the
120 * sandbox audio driver. Arguments are as for that function.
122 void sandbox_get_codec_params(struct udevice *dev, int *interfacep, int *ratep,
123 int *mclk_freqp, int *bits_per_samplep,
127 * sandbox_get_i2s_sum() - Read back the sum of the audio data so far
129 * This data is provided to the sandbox driver by the I2S tx_data() method.
131 * @dev: Device to check
132 * @return sum of audio data
134 int sandbox_get_i2s_sum(struct udevice *dev);
137 * sandbox_get_setup_called() - Returns the number of times setup(*) was called
139 * This is used in the sound test
141 * @dev: Device to check
142 * @return call count for the setup() method
144 int sandbox_get_setup_called(struct udevice *dev);
147 * sandbox_get_sound_sum() - Read back the sum of the sound data so far
149 * This data is provided to the sandbox driver by the sound play() method.
151 * @dev: Device to check
152 * @return sum of audio data
154 int sandbox_get_sound_sum(struct udevice *dev);
157 * sandbox_set_allow_beep() - Set whether the 'beep' interface is supported
159 * @dev: Device to update
160 * @allow: true to allow the start_beep() method, false to disallow it
162 void sandbox_set_allow_beep(struct udevice *dev, bool allow);
165 * sandbox_get_beep_frequency() - Get the frequency of the current beep
167 * @dev: Device to check
168 * @return frequency of beep, if there is an active beep, else 0
170 int sandbox_get_beep_frequency(struct udevice *dev);
173 * sandbox_get_pch_spi_protect() - Get the PCI SPI protection status
175 * @dev: Device to check
176 * @return 0 if not protected, 1 if protected
178 int sandbox_get_pch_spi_protect(struct udevice *dev);
181 * sandbox_get_pci_ep_irq_count() - Get the PCI EP IRQ count
183 * @dev: Device to check
186 int sandbox_get_pci_ep_irq_count(struct udevice *dev);