| # SPDX-License-Identifier: GPL-2.0 |
| # Copyright (c) 2018, NVIDIA CORPORATION. All rights reserved. |
| |
| # Test U-Boot's "mmc read" command. The test reads data from the eMMC or SD |
| # card, and validates the no errors occurred, and that the expected data was |
| # read if the test configuration contains a CRC of the expected data. |
| |
| import pytest |
| import time |
| import u_boot_utils |
| |
| """ |
| This test relies on boardenv_* to containing configuration values to define |
| which MMC devices should be tested. For example: |
| |
| # Configuration data for test_mmc_dev, test_mmc_rescan, test_mmc_info; defines |
| # whole MMC devices that mmc dev/rescan/info commands may operate upon. |
| env__mmc_dev_configs = ( |
| { |
| 'fixture_id': 'emmc-boot0', |
| 'is_emmc': True, |
| 'devid': 0, |
| 'partid': 1, |
| 'info_device': ???, |
| 'info_speed': ???, |
| 'info_mode': ???, |
| 'info_buswidth': ???. |
| }, |
| { |
| 'fixture_id': 'emmc-boot1', |
| 'is_emmc': True, |
| 'devid': 0, |
| 'partid': 2, |
| 'info_device': ???, |
| 'info_speed': ???, |
| 'info_mode': ???, |
| 'info_buswidth': ???. |
| }, |
| { |
| 'fixture_id': 'emmc-data', |
| 'is_emmc': True, |
| 'devid': 0, |
| 'partid': 0, |
| 'info_device': ???, |
| 'info_speed': ???, |
| 'info_mode': ???, |
| 'info_buswidth': ???. |
| }, |
| { |
| 'fixture_id': 'sd', |
| 'is_emmc': False, |
| 'devid': 1, |
| 'partid': None, |
| 'info_device': ???, |
| 'info_speed': ???, |
| 'info_mode': ???, |
| 'info_buswidth': ???. |
| }, |
| ) |
| |
| # Configuration data for test_mmc_rd; defines regions of the MMC (entire |
| # devices, or ranges of sectors) which can be read: |
| env__mmc_rd_configs = ( |
| { |
| 'fixture_id': 'emmc-boot0', |
| 'is_emmc': True, |
| 'devid': 0, |
| 'partid': 1, |
| 'sector': 0x10, |
| 'count': 1, |
| }, |
| { |
| 'fixture_id': 'emmc-boot1', |
| 'is_emmc': True, |
| 'devid': 0, |
| 'partid': 2, |
| 'sector': 0x10, |
| 'count': 1, |
| }, |
| { |
| 'fixture_id': 'emmc-data', |
| 'is_emmc': True, |
| 'devid': 0, |
| 'partid': 0, |
| 'sector': 0x10, |
| 'count': 0x1000, |
| }, |
| { |
| 'fixture_id': 'sd-mbr', |
| 'is_emmc': False, |
| 'devid': 1, |
| 'partid': None, |
| 'sector': 0, |
| 'count': 1, |
| 'crc32': '8f6ecf0d', |
| }, |
| { |
| 'fixture_id': 'sd-large', |
| 'is_emmc': False, |
| 'devid': 1, |
| 'partid': None, |
| 'sector': 0x10, |
| 'count': 0x1000, |
| }, |
| ) |
| """ |
| |
| def mmc_dev(u_boot_console, is_emmc, devid, partid): |
| """Run the "mmc dev" command. |
| |
| Args: |
| u_boot_console: A U-Boot console connection. |
| is_emmc: Whether the device is eMMC |
| devid: Device ID |
| partid: Partition ID |
| |
| Returns: |
| Nothing. |
| """ |
| |
| # Select MMC device |
| cmd = 'mmc dev %d' % devid |
| if is_emmc: |
| cmd += ' %d' % partid |
| response = u_boot_console.run_command(cmd) |
| assert 'no card present' not in response |
| if is_emmc: |
| partid_response = '(part %d)' % partid |
| else: |
| partid_response = '' |
| good_response = 'mmc%d%s is current device' % (devid, partid_response) |
| assert good_response in response |
| |
| @pytest.mark.buildconfigspec('cmd_mmc') |
| def test_mmc_dev(u_boot_console, env__mmc_dev_config): |
| """Test the "mmc dev" command. |
| |
| Args: |
| u_boot_console: A U-Boot console connection. |
| env__mmc_dev_config: The single MMC configuration on which |
| to run the test. See the file-level comment above for details |
| of the format. |
| |
| Returns: |
| Nothing. |
| """ |
| |
| is_emmc = env__mmc_dev_config['is_emmc'] |
| devid = env__mmc_dev_config['devid'] |
| partid = env__mmc_dev_config.get('partid', 0) |
| |
| # Select MMC device |
| mmc_dev(u_boot_console, is_emmc, devid, partid) |
| |
| @pytest.mark.buildconfigspec('cmd_mmc') |
| def test_mmc_rescan(u_boot_console, env__mmc_dev_config): |
| """Test the "mmc rescan" command. |
| |
| Args: |
| u_boot_console: A U-Boot console connection. |
| env__mmc_dev_config: The single MMC configuration on which |
| to run the test. See the file-level comment above for details |
| of the format. |
| |
| Returns: |
| Nothing. |
| """ |
| |
| is_emmc = env__mmc_dev_config['is_emmc'] |
| devid = env__mmc_dev_config['devid'] |
| partid = env__mmc_dev_config.get('partid', 0) |
| |
| # Select MMC device |
| mmc_dev(u_boot_console, is_emmc, devid, partid) |
| |
| # Rescan MMC device |
| cmd = 'mmc rescan' |
| response = u_boot_console.run_command(cmd) |
| assert 'no card present' not in response |
| |
| @pytest.mark.buildconfigspec('cmd_mmc') |
| def test_mmc_info(u_boot_console, env__mmc_dev_config): |
| """Test the "mmc info" command. |
| |
| Args: |
| u_boot_console: A U-Boot console connection. |
| env__mmc_dev_config: The single MMC configuration on which |
| to run the test. See the file-level comment above for details |
| of the format. |
| |
| Returns: |
| Nothing. |
| """ |
| |
| is_emmc = env__mmc_dev_config['is_emmc'] |
| devid = env__mmc_dev_config['devid'] |
| partid = env__mmc_dev_config.get('partid', 0) |
| info_device = env__mmc_dev_config['info_device'] |
| info_speed = env__mmc_dev_config['info_speed'] |
| info_mode = env__mmc_dev_config['info_mode'] |
| info_buswidth = env__mmc_dev_config['info_buswidth'] |
| |
| # Select MMC device |
| mmc_dev(u_boot_console, is_emmc, devid, partid) |
| |
| # Read MMC device information |
| cmd = 'mmc info' |
| response = u_boot_console.run_command(cmd) |
| good_response = "Device: %s" % info_device |
| assert good_response in response |
| good_response = "Bus Speed: %s" % info_speed |
| assert good_response in response |
| good_response = "Mode: %s" % info_mode |
| assert good_response in response |
| good_response = "Bus Width: %s" % info_buswidth |
| assert good_response in response |
| |
| @pytest.mark.buildconfigspec('cmd_mmc') |
| def test_mmc_rd(u_boot_console, env__mmc_rd_config): |
| """Test the "mmc read" command. |
| |
| Args: |
| u_boot_console: A U-Boot console connection. |
| env__mmc_rd_config: The single MMC configuration on which |
| to run the test. See the file-level comment above for details |
| of the format. |
| |
| Returns: |
| Nothing. |
| """ |
| |
| is_emmc = env__mmc_rd_config['is_emmc'] |
| devid = env__mmc_rd_config['devid'] |
| partid = env__mmc_rd_config.get('partid', 0) |
| sector = env__mmc_rd_config.get('sector', 0) |
| count_sectors = env__mmc_rd_config.get('count', 1) |
| expected_crc32 = env__mmc_rd_config.get('crc32', None) |
| read_duration_max = env__mmc_rd_config.get('read_duration_max', 0) |
| |
| count_bytes = count_sectors * 512 |
| bcfg = u_boot_console.config.buildconfig |
| has_cmd_memory = bcfg.get('config_cmd_memory', 'n') == 'y' |
| has_cmd_crc32 = bcfg.get('config_cmd_crc32', 'n') == 'y' |
| ram_base = u_boot_utils.find_ram_base(u_boot_console) |
| addr = '0x%08x' % ram_base |
| |
| # Select MMC device |
| mmc_dev(u_boot_console, is_emmc, devid, partid) |
| |
| # Clear target RAM |
| if expected_crc32: |
| if has_cmd_memory and has_cmd_crc32: |
| cmd = 'mw.b %s 0 0x%x' % (addr, count_bytes) |
| u_boot_console.run_command(cmd) |
| |
| cmd = 'crc32 %s 0x%x' % (addr, count_bytes) |
| response = u_boot_console.run_command(cmd) |
| assert expected_crc32 not in response |
| else: |
| u_boot_console.log.warning( |
| 'CONFIG_CMD_MEMORY or CONFIG_CMD_CRC32 != y: Skipping RAM clear') |
| |
| # Read data |
| cmd = 'mmc read %s %x %x' % (addr, sector, count_sectors) |
| tstart = time.time() |
| response = u_boot_console.run_command(cmd) |
| tend = time.time() |
| good_response = 'MMC read: dev # %d, block # %d, count %d ... %d blocks read: OK' % ( |
| devid, sector, count_sectors, count_sectors) |
| assert good_response in response |
| |
| # Check target RAM |
| if expected_crc32: |
| if has_cmd_crc32: |
| cmd = 'crc32 %s 0x%x' % (addr, count_bytes) |
| response = u_boot_console.run_command(cmd) |
| assert expected_crc32 in response |
| else: |
| u_boot_console.log.warning('CONFIG_CMD_CRC32 != y: Skipping check') |
| |
| # Check if the command did not take too long |
| if read_duration_max: |
| elapsed = tend - tstart |
| u_boot_console.log.info('Reading %d bytes took %f seconds' % |
| (count_bytes, elapsed)) |
| assert elapsed <= (read_duration_max - 0.01) |