1*** Settings ***
2Resource                ../lib/utils.robot
3Resource                ../lib/connection_client.robot
4Resource                ../lib/boot_utils.robot
5Library                 ../lib/gen_misc.py
6Library                 ../lib/utils.py
7
8*** Variables ***
9# MAC input from user.
10${MAC_ADDRESS}          ${EMPTY}
11
12
13*** Keywords ***
14
15Check And Reset MAC
16    [Documentation]  Update BMC with user input MAC address.
17    [Arguments]  ${mac_address}=${MAC_ADDRESS}
18
19    # Description of argument(s):
20    # mac_address  The mac address (e.g. 00:01:6c:80:02:28).
21
22    Should Not Be Empty  ${mac_address}
23    Open Connection And Log In
24    ${bmc_mac_addr}  ${stderr}  ${rc}=  BMC Execute Command
25    ...  cat /sys/class/net/eth0/address
26    Run Keyword If  '${mac_address.lower()}' != '${bmc_mac_addr.lower()}'
27    ...  Set MAC Address
28
29
30Set MAC Address
31    [Documentation]  Update eth0 with input MAC address.
32    [Arguments]  ${mac_address}=${MAC_ADDRESS}
33
34    # Description of argument(s):
35    # mac_address  The mac address (e.g. 00:01:6c:80:02:28).
36
37    Write  fw_setenv ethaddr ${mac_address}
38    OBMC Reboot (off)
39
40    # Take SSH session post BMC reboot.
41    Open Connection And Log In
42    ${bmc_mac_addr}  ${stderr}  ${rc}=  BMC Execute Command
43    ...  cat /sys/class/net/eth0/address
44    Should Be Equal  ${bmc_mac_addr}  ${mac_address}  ignore_case=True
45
46
47Get BMC IP Info
48    [Documentation]  Get system IP address and prefix length.
49
50
51    # Get system IP address and prefix length details using "ip addr"
52    # Sample Output of "ip addr":
53    # 1: eth0: <BROADCAST,MULTIAST> mtu 1500 qdisc mq state UP qlen 1000
54    #     link/ether xx:xx:xx:xx:xx:xx brd ff:ff:ff:ff:ff:ff
55    #     inet xx.xx.xx.xx/24 brd xx.xx.xx.xx scope global eth0
56
57    ${cmd_output}  ${stderr}  ${rc}=  BMC Execute Command
58    ...  /sbin/ip addr | grep eth0
59
60    # Get line having IP address details.
61    ${lines}=  Get Lines Containing String  ${cmd_output}  inet
62
63    # List IP address details.
64    @{ip_components}=  Split To Lines  ${lines}
65
66    @{ip_data}=  Create List
67
68    # Get all IP addresses and prefix lengths on system.
69    :FOR  ${ip_component}  IN  @{ip_components}
70    \  @{if_info}=  Split String  ${ip_component}
71    \  ${ip_n_prefix}=  Get From List  ${if_info}  1
72    \  Append To List  ${ip_data}  ${ip_n_prefix}
73
74    [Return]  ${ip_data}
75
76Get BMC Route Info
77    [Documentation]  Get system route info.
78
79
80    # Sample output of "ip route":
81    # default via xx.xx.xx.x dev eth0
82    # xx.xx.xx.0/23 dev eth0  src xx.xx.xx.xx
83    # xx.xx.xx.0/24 dev eth0  src xx.xx.xx.xx
84
85    ${cmd_output}  ${stderr}  ${rc}=  BMC Execute Command
86    ...  /sbin/ip route
87
88    [Return]  ${cmd_output}
89
90# TODO: openbmc/openbmc-test-automation#1331
91Get BMC MAC Address
92    [Documentation]  Get system MAC address.
93
94
95    # Sample output of "ip addr | grep ether":
96    # link/ether xx.xx.xx.xx.xx.xx brd ff:ff:ff:ff:ff:ff
97
98    ${cmd_output}  ${stderr}  ${rc}=  BMC Execute Command
99    ...  /sbin/ip addr | grep ether
100
101    # Split the line and return MAC address.
102    # Split list data:
103    # link/ether | xx:xx:xx:xx:xx:xx | brd | ff:ff:ff:ff:ff:ff
104
105    @{words}=  Split String  ${cmd_output}
106
107    [Return]  ${words[1]}
108
109
110Get BMC MAC Address List
111    [Documentation]  Get system MAC address
112
113    # Sample output of "ip addr | grep ether":
114    # link/ether xx.xx.xx.xx.xx.xx brd ff:ff:ff:ff:ff:ff
115
116    ${cmd_output}  ${stderr}  ${rc}=  BMC Execute Command
117    ...  /sbin/ip addr | grep ether
118
119    # Split the line and return MAC address.
120    # Split list data:
121    # link/ether | xx:xx:xx:xx:xx:xx | brd | ff:ff:ff:ff:ff:ff
122    # link/ether | xx:xx:xx:xx:xx:xx | brd | ff:ff:ff:ff:ff:ff
123
124    ${mac_list}=  Create List
125    @{lines}=  Split To Lines  ${cmd_output}
126    :FOR  ${line}  IN  @{lines}
127    \  @{words}=  Split String  ${line}
128    \   Append To List  ${mac_list}  ${words[1]}
129
130    [Return]  ${mac_list}
131
132Get BMC Hostname
133    [Documentation]  Get BMC hostname.
134
135    # Sample output of  "hostname":
136    # test_hostname
137
138    ${output}  ${stderr}  ${rc}=  BMC Execute Command  hostname
139
140    [Return]  ${output}
141
142Get List Of IP Address Via REST
143    [Documentation]  Get list of IP address via REST.
144    [Arguments]  @{ip_uri_list}
145
146    # Description of argument(s):
147    # ip_uri_list  List of IP objects.
148    # Example:
149    #   "data": [
150    #     "/xyz/openbmc_project/network/eth0/ipv4/e9767624",
151    #     "/xyz/openbmc_project/network/eth0/ipv4/31f4ce8b"
152    #   ],
153
154    ${ip_list}=  Create List
155
156    : FOR  ${ip_uri}  IN  @{ip_uri_list}
157    \  ${ip_addr}=  Read Attribute  ${ip_uri}  Address
158    \  Append To List  ${ip_list}  ${ip_addr}
159
160    [Return]  @{ip_list}
161
162Delete IP And Object
163    [Documentation]  Delete IP and object.
164    [Arguments]  ${ip_addr}  @{ip_uri_list}
165
166    # Description of argument(s):
167    # ip_addr      IP address to be deleted.
168    # ip_uri_list  List of IP object URIs.
169
170    # Find IP object having this IP address.
171
172    : FOR  ${ip_uri}  IN  @{ip_uri_list}
173    \  ${ip_addr1}=  Read Attribute  ${ip_uri}  Address
174    \  Run Keyword If  '${ip_addr}' == '${ip_addr1}'  Exit For Loop
175
176    # If the given IP address is not configured, return.
177    # Otherwise, delete the IP and object.
178
179    Run Keyword And Return If  '${ip_addr}' != '${ip_addr1}'
180    ...  Pass Execution  IP address to be deleted is not configured.
181
182    Run Keyword And Ignore Error  OpenBMC Delete Request  ${ip_uri}
183
184    # After any modification on network interface, BMC restarts network
185    # module, wait until it is reachable. Then wait 15 seconds for new
186    # configuration to be updated on BMC.
187
188    Wait For Host To Ping  ${OPENBMC_HOST}  ${NETWORK_TIMEOUT}
189    ...  ${NETWORK_RETRY_TIME}
190    Sleep  15s
191
192    # Verify whether deleted IP address is removed from BMC system.
193
194    ${ip_data}=  Get BMC IP Info
195    Should Not Contain Match  ${ip_data}  ${ip_addr}*
196    ...  msg=IP address not deleted.
197
198Get First Non Pingable IP From Subnet
199    [Documentation]  Find first non-pingable IP from the subnet and return it.
200    [Arguments]  ${host}=${OPENBMC_HOST}
201
202    # Description of argument(s):
203    # host  Any valid host name or IP address
204    #       (e.g. "machine1" or "9.xx.xx.31").
205
206    # Non-pingable IP is unused IP address in the subnet.
207    ${host_name}  ${ip_addr}=  Get Host Name IP
208
209    # Split IP address into network part and host part.
210    # IP address will have 4 octets xx.xx.xx.xx.
211    # Sample output after split:
212    # split_ip  [xx.xx.xx, xx]
213
214    ${split_ip}=  Split String From Right  ${ip_addr}  .  1
215    # First element in list is Network part.
216    ${network_part}=  Get From List  ${split_ip}  0
217
218    : FOR  ${octet4}  IN RANGE  1  255
219    \  ${new_ip}=  Catenate  ${network_part}.${octet4}
220    \  ${status}=  Run Keyword And Return Status  Ping Host  ${new_ip}
221    # If IP is non-pingable, return it.
222    \  Return From Keyword If  '${status}' == 'False'  ${new_ip}
223
224    Fail  msg=No non-pingable IP could be found in subnet ${network_part}.
225
226
227Validate MAC On BMC
228    [Documentation]  Validate MAC on BMC.
229    [Arguments]  ${mac_addr}
230
231    # Description of argument(s):
232    # mac_addr  MAC address of the BMC.
233
234    ${system_mac}=  Get BMC MAC Address
235
236    ${status}=  Compare MAC Address  ${system_mac}  ${mac_addr}
237    Should Be True  ${status}
238    ...  msg=MAC address ${system_mac} does not match ${mac_addr}.
239
240
241Run Build Net
242    [Documentation]  Run build_net to preconfigure the ethernet interfaces.
243
244    OS Execute Command  build_net help y y
245    # Run pingum to check if the "build_net" was run correctly done.
246    ${output}  ${stderr}  ${rc}=  OS Execute Command  pingum
247    Should Contain  ${output}  All networks ping Ok
248
249
250Configure Hostname
251    [Documentation]  Configure hostname on BMC via Redfish.
252    [Arguments]  ${hostname}
253
254    # Description of argument(s):
255    # hostname  A hostname value which is to be configured on BMC.
256
257    ${data}=  Create Dictionary  HostName=${hostname}
258    Redfish.patch  ${REDFISH_NW_PROTOCOL_URI}  body=&{data}
259
260