xref: /openbmc/u-boot/test/py/tests/test_net.py (revision 7e86242b)
1# SPDX-License-Identifier: GPL-2.0
2# Copyright (c) 2016, NVIDIA CORPORATION. All rights reserved.
3
4# Test various network-related functionality, such as the dhcp, ping, and
5# tftpboot commands.
6
7import pytest
8import u_boot_utils
9
10"""
11Note: This test relies on boardenv_* containing configuration values to define
12which the network environment available for testing. Without this, this test
13will be automatically skipped.
14
15For example:
16
17# Boolean indicating whether the Ethernet device is attached to USB, and hence
18# USB enumeration needs to be performed prior to network tests.
19# This variable may be omitted if its value is False.
20env__net_uses_usb = False
21
22# Boolean indicating whether the Ethernet device is attached to PCI, and hence
23# PCI enumeration needs to be performed prior to network tests.
24# This variable may be omitted if its value is False.
25env__net_uses_pci = True
26
27# True if a DHCP server is attached to the network, and should be tested.
28# If DHCP testing is not possible or desired, this variable may be omitted or
29# set to False.
30env__net_dhcp_server = True
31
32# A list of environment variables that should be set in order to configure a
33# static IP. If solely relying on DHCP, this variable may be omitted or set to
34# an empty list.
35env__net_static_env_vars = [
36    ("ipaddr", "10.0.0.100"),
37    ("netmask", "255.255.255.0"),
38    ("serverip", "10.0.0.1"),
39]
40
41# Details regarding a file that may be read from a TFTP server. This variable
42# may be omitted or set to None if TFTP testing is not possible or desired.
43env__net_tftp_readable_file = {
44    "fn": "ubtest-readable.bin",
45    "addr": 0x10000000,
46    "size": 5058624,
47    "crc32": "c2244b26",
48}
49
50# Details regarding a file that may be read from a NFS server. This variable
51# may be omitted or set to None if NFS testing is not possible or desired.
52env__net_nfs_readable_file = {
53    "fn": "ubtest-readable.bin",
54    "addr": 0x10000000,
55    "size": 5058624,
56    "crc32": "c2244b26",
57}
58"""
59
60net_set_up = False
61
62def test_net_pre_commands(u_boot_console):
63    """Execute any commands required to enable network hardware.
64
65    These commands are provided by the boardenv_* file; see the comment at the
66    beginning of this file.
67    """
68
69    init_usb = u_boot_console.config.env.get('env__net_uses_usb', False)
70    if init_usb:
71        u_boot_console.run_command('usb start')
72
73    init_pci = u_boot_console.config.env.get('env__net_uses_pci', False)
74    if init_pci:
75        u_boot_console.run_command('pci enum')
76
77@pytest.mark.buildconfigspec('cmd_dhcp')
78def test_net_dhcp(u_boot_console):
79    """Test the dhcp command.
80
81    The boardenv_* file may be used to enable/disable this test; see the
82    comment at the beginning of this file.
83    """
84
85    test_dhcp = u_boot_console.config.env.get('env__net_dhcp_server', False)
86    if not test_dhcp:
87        pytest.skip('No DHCP server available')
88
89    u_boot_console.run_command('setenv autoload no')
90    output = u_boot_console.run_command('dhcp')
91    assert 'DHCP client bound to address ' in output
92
93    global net_set_up
94    net_set_up = True
95
96@pytest.mark.buildconfigspec('net')
97def test_net_setup_static(u_boot_console):
98    """Set up a static IP configuration.
99
100    The configuration is provided by the boardenv_* file; see the comment at
101    the beginning of this file.
102    """
103
104    env_vars = u_boot_console.config.env.get('env__net_static_env_vars', None)
105    if not env_vars:
106        pytest.skip('No static network configuration is defined')
107
108    for (var, val) in env_vars:
109        u_boot_console.run_command('setenv %s %s' % (var, val))
110
111    global net_set_up
112    net_set_up = True
113
114@pytest.mark.buildconfigspec('cmd_ping')
115def test_net_ping(u_boot_console):
116    """Test the ping command.
117
118    The $serverip (as set up by either test_net_dhcp or test_net_setup_static)
119    is pinged. The test validates that the host is alive, as reported by the
120    ping command's output.
121    """
122
123    if not net_set_up:
124        pytest.skip('Network not initialized')
125
126    output = u_boot_console.run_command('ping $serverip')
127    assert 'is alive' in output
128
129@pytest.mark.buildconfigspec('cmd_net')
130def test_net_tftpboot(u_boot_console):
131    """Test the tftpboot command.
132
133    A file is downloaded from the TFTP server, its size and optionally its
134    CRC32 are validated.
135
136    The details of the file to download are provided by the boardenv_* file;
137    see the comment at the beginning of this file.
138    """
139
140    if not net_set_up:
141        pytest.skip('Network not initialized')
142
143    f = u_boot_console.config.env.get('env__net_tftp_readable_file', None)
144    if not f:
145        pytest.skip('No TFTP readable file to read')
146
147    addr = f.get('addr', None)
148    if not addr:
149        addr = u_boot_utils.find_ram_base(u_boot_console)
150
151    fn = f['fn']
152    output = u_boot_console.run_command('tftpboot %x %s' % (addr, fn))
153    expected_text = 'Bytes transferred = '
154    sz = f.get('size', None)
155    if sz:
156        expected_text += '%d' % sz
157    assert expected_text in output
158
159    expected_crc = f.get('crc32', None)
160    if not expected_crc:
161        return
162
163    if u_boot_console.config.buildconfig.get('config_cmd_crc32', 'n') != 'y':
164        return
165
166    output = u_boot_console.run_command('crc32 %x $filesize' % addr)
167    assert expected_crc in output
168
169@pytest.mark.buildconfigspec('cmd_nfs')
170def test_net_nfs(u_boot_console):
171    """Test the nfs command.
172
173    A file is downloaded from the NFS server, its size and optionally its
174    CRC32 are validated.
175
176    The details of the file to download are provided by the boardenv_* file;
177    see the comment at the beginning of this file.
178    """
179
180    if not net_set_up:
181        pytest.skip('Network not initialized')
182
183    f = u_boot_console.config.env.get('env__net_nfs_readable_file', None)
184    if not f:
185        pytest.skip('No NFS readable file to read')
186
187    addr = f.get('addr', None)
188    if not addr:
189        addr = u_boot_utils.find_ram_base(u_boot_console)
190
191    fn = f['fn']
192    output = u_boot_console.run_command('nfs %x %s' % (addr, fn))
193    expected_text = 'Bytes transferred = '
194    sz = f.get('size', None)
195    if sz:
196        expected_text += '%d' % sz
197    assert expected_text in output
198
199    expected_crc = f.get('crc32', None)
200    if not expected_crc:
201        return
202
203    if u_boot_console.config.buildconfig.get('config_cmd_crc32', 'n') != 'y':
204        return
205
206    output = u_boot_console.run_command('crc32 %x $filesize' % addr)
207    assert expected_crc in output
208