CoCalc -- device-attribute-test.c

GitHub Repository: torvalds/linux
Path: blob/master/drivers/firewire/device-attribute-test.c
²⁶³⁷⁸ views
1
// SPDX-License-Identifier: GPL-2.0-only
2
//
3
// device-attribute-test.c - An application of Kunit to test implementation for device attributes.
4
//
5
// Copyright (c) 2023 Takashi Sakamoto
6
//
7
// This file can not be built independently since it is intentionally included in core-device.c.
8

9
#include <kunit/test.h>
10

11
// Configuration ROM for AV/C Devices 1.0 (Dec. 12, 2000, 1394 Trading Association)
12
// Annex C:Configuration ROM example(informative)
13
// C.1 Simple AV/C device
14
//
15
// Copied from the documentation.
16
static const u32 simple_avc_config_rom[] = {
17
	0x0404eabf,
18
	0x31333934,
19
	0xe0646102,
20
	0xffffffff,
21
	0xffffffff,
22
	0x00063287, // root directory.
23
	0x03ffffff,
24
	0x8100000a,
25
	0x17ffffff,
26
	0x8100000e,
27
	0x0c0083c0,
28
	0xd1000001,
29
	0x0004442d, // unit 0 directory.
30
	0x1200a02d,
31
	0x13010001,
32
	0x17ffffff,
33
	0x81000007,
34
	0x0005c915, // leaf for textual descriptor.
35
	0x00000000,
36
	0x00000000,
37
	0x56656e64,
38
	0x6f72204e,
39
	0x616d6500,
40
	0x00057f16, // leaf for textual descriptor.
41
	0x00000000,
42
	0x00000000,
43
	0x4d6f6465,
44
	0x6c204e61,
45
	0x6d650000,
46
};
47

48
// Ibid.
49
// Annex A:Consideration for configuration ROM reader design (informative)
50
// A.1 Vendor directory
51
//
52
// Written by hand.
53
static const u32 legacy_avc_config_rom[] = {
54
	0x04199fe7,
55
	0x31333934,
56
	0xe0644000,
57
	0x00112233,
58
	0x44556677,
59
	0x0005dace, // root directory.
60
	0x03012345,
61
	0x0c0083c0,
62
	0x8d000009,
63
	0xd1000002,
64
	0xc3000004,
65
	0x0002e107, // unit 0 directory.
66
	0x12abcdef,
67
	0x13543210,
68
	0x0002cb73, // vendor directory.
69
	0x17fedcba,
70
	0x81000004,
71
	0x00026dc1, // leaf for EUI-64.
72
	0x00112233,
73
	0x44556677,
74
	0x00050e84, // leaf for textual descriptor.
75
	0x00000000,
76
	0x00000000,
77
	0x41424344,
78
	0x45464748,
79
	0x494a0000,
80
};
81

82
static void device_attr_simple_avc(struct kunit *test)
83
{
84
	static const struct fw_device node = {
85
		.device = {
86
			.type = &fw_device_type,
87
		},
88
		.config_rom = simple_avc_config_rom,
89
		.config_rom_length = sizeof(simple_avc_config_rom),
90
	};
91
	static const struct fw_unit unit0 = {
92
		.device = {
93
			.type = &fw_unit_type,
94
			.parent = (struct device *)&node.device,
95
		},
96
		.directory = &simple_avc_config_rom[12],
97
	};
98
	struct device *node_dev = (struct device *)&node.device;
99
	struct device *unit0_dev = (struct device *)&unit0.device;
100
	static const int unit0_expected_ids[] = {0x00ffffff, 0x00ffffff, 0x0000a02d, 0x00010001};
101
	char *buf = kunit_kzalloc(test, PAGE_SIZE, GFP_KERNEL);
102
	KUNIT_ASSERT_NOT_ERR_OR_NULL(test, buf);
103
	int ids[4] = {0, 0, 0, 0};
104

105
	// Ensure associations for node and unit devices.
106

107
	KUNIT_ASSERT_TRUE(test, is_fw_device(node_dev));
108
	KUNIT_ASSERT_FALSE(test, is_fw_unit(node_dev));
109
	KUNIT_ASSERT_PTR_EQ(test, fw_device(node_dev), &node);
110

111
	KUNIT_ASSERT_FALSE(test, is_fw_device(unit0_dev));
112
	KUNIT_ASSERT_TRUE(test, is_fw_unit(unit0_dev));
113
	KUNIT_ASSERT_PTR_EQ(test, fw_parent_device((&unit0)), &node);
114
	KUNIT_ASSERT_PTR_EQ(test, fw_unit(unit0_dev), &unit0);
115

116
	// For entries in root directory.
117

118
	// Vendor immediate entry is found.
119
	KUNIT_EXPECT_GT(test, show_immediate(node_dev, &config_rom_attributes[0].attr, buf), 0);
120
	KUNIT_EXPECT_STREQ(test, buf, "0xffffff\n");
121

122
	// Model immediate entry is found.
123
	KUNIT_EXPECT_GT(test, show_immediate(node_dev, &config_rom_attributes[4].attr, buf), 0);
124
	KUNIT_EXPECT_STREQ(test, buf, "0xffffff\n");
125

126
	// Descriptor leaf entry for vendor is found.
127
	KUNIT_EXPECT_GT(test, show_text_leaf(node_dev, &config_rom_attributes[5].attr, buf), 0);
128
	KUNIT_EXPECT_STREQ(test, buf, "Vendor Name\n");
129

130
	// Descriptor leaf entry for model is found.
131
	KUNIT_EXPECT_GT(test, show_text_leaf(node_dev, &config_rom_attributes[6].attr, buf), 0);
132
	KUNIT_EXPECT_STREQ(test, buf, "Model Name\n");
133

134
	// For entries in unit 0 directory.
135

136
	// Vendor immediate entry is not found.
137
	KUNIT_EXPECT_LT(test, show_immediate(unit0_dev, &config_rom_attributes[0].attr, buf), 0);
138

139
	// Model immediate entry is found.
140
	KUNIT_EXPECT_GT(test, show_immediate(unit0_dev, &config_rom_attributes[4].attr, buf), 0);
141
	KUNIT_EXPECT_STREQ(test, buf, "0xffffff\n");
142

143
	// Descriptor leaf entry for vendor is not found.
144
	KUNIT_EXPECT_LT(test, show_text_leaf(unit0_dev, &config_rom_attributes[5].attr, buf), 0);
145

146
	// Descriptor leaf entry for model is found.
147
	KUNIT_EXPECT_GT(test, show_text_leaf(unit0_dev, &config_rom_attributes[6].attr, buf), 0);
148
	KUNIT_EXPECT_STREQ(test, buf, "Model Name\n");
149

150
	// Specifier_ID immediate entry is found.
151
	KUNIT_EXPECT_GT(test, show_immediate(unit0_dev, &config_rom_attributes[2].attr, buf), 0);
152
	KUNIT_EXPECT_STREQ(test, buf, "0x00a02d\n");
153

154
	// Version immediate entry is found.
155
	KUNIT_EXPECT_GT(test, show_immediate(unit0_dev, &config_rom_attributes[3].attr, buf), 0);
156
	KUNIT_EXPECT_STREQ(test, buf, "0x010001\n");
157

158
	kunit_kfree(test, buf);
159

160
	get_modalias_ids(&unit0, ids);
161
	KUNIT_EXPECT_MEMEQ(test, ids, unit0_expected_ids, sizeof(ids));
162
}
163

164
static void device_attr_legacy_avc(struct kunit *test)
165
{
166
	static const struct fw_device node = {
167
		.device = {
168
			.type = &fw_device_type,
169
		},
170
		.config_rom = legacy_avc_config_rom,
171
		.config_rom_length = sizeof(legacy_avc_config_rom),
172
	};
173
	static const struct fw_unit unit0 = {
174
		.device = {
175
			.type = &fw_unit_type,
176
			.parent = (struct device *)&node.device,
177
		},
178
		.directory = &legacy_avc_config_rom[11],
179
	};
180
	struct device *node_dev = (struct device *)&node.device;
181
	struct device *unit0_dev = (struct device *)&unit0.device;
182
	static const int unit0_expected_ids[] = {0x00012345, 0x00fedcba, 0x00abcdef, 0x00543210};
183
	char *buf = kunit_kzalloc(test, PAGE_SIZE, GFP_KERNEL);
184
	KUNIT_ASSERT_NOT_ERR_OR_NULL(test, buf);
185
	int ids[4] = {0, 0, 0, 0};
186

187
	// Ensure associations for node and unit devices.
188

189
	KUNIT_ASSERT_TRUE(test, is_fw_device(node_dev));
190
	KUNIT_ASSERT_FALSE(test, is_fw_unit(node_dev));
191
	KUNIT_ASSERT_PTR_EQ(test, fw_device((node_dev)), &node);
192

193
	KUNIT_ASSERT_FALSE(test, is_fw_device(unit0_dev));
194
	KUNIT_ASSERT_TRUE(test, is_fw_unit(unit0_dev));
195
	KUNIT_ASSERT_PTR_EQ(test, fw_parent_device((&unit0)), &node);
196
	KUNIT_ASSERT_PTR_EQ(test, fw_unit(unit0_dev), &unit0);
197

198
	// For entries in root directory.
199

200
	// Vendor immediate entry is found.
201
	KUNIT_EXPECT_GT(test, show_immediate(node_dev, &config_rom_attributes[0].attr, buf), 0);
202
	KUNIT_EXPECT_STREQ(test, buf, "0x012345\n");
203

204
	// Model immediate entry is found.
205
	KUNIT_EXPECT_GT(test, show_immediate(node_dev, &config_rom_attributes[4].attr, buf), 0);
206
	KUNIT_EXPECT_STREQ(test, buf, "0xfedcba\n");
207

208
	// Descriptor leaf entry for vendor is not found.
209
	KUNIT_EXPECT_LT(test, show_text_leaf(node_dev, &config_rom_attributes[5].attr, buf), 0);
210

211
	// Descriptor leaf entry for model is found.
212
	KUNIT_EXPECT_GT(test, show_text_leaf(node_dev, &config_rom_attributes[6].attr, buf), 0);
213
	KUNIT_EXPECT_STREQ(test, buf, "ABCDEFGHIJ\n");
214

215
	// For entries in unit 0 directory.
216

217
	// Vendor immediate entry is not found.
218
	KUNIT_EXPECT_LT(test, show_immediate(unit0_dev, &config_rom_attributes[0].attr, buf), 0);
219

220
	// Model immediate entry is not found.
221
	KUNIT_EXPECT_LT(test, show_immediate(unit0_dev, &config_rom_attributes[4].attr, buf), 0);
222

223
	// Descriptor leaf entry for vendor is not found.
224
	KUNIT_EXPECT_LT(test, show_text_leaf(unit0_dev, &config_rom_attributes[5].attr, buf), 0);
225

226
	// Descriptor leaf entry for model is not found.
227
	KUNIT_EXPECT_LT(test, show_text_leaf(unit0_dev, &config_rom_attributes[6].attr, buf), 0);
228

229
	// Specifier_ID immediate entry is found.
230
	KUNIT_EXPECT_GT(test, show_immediate(unit0_dev, &config_rom_attributes[2].attr, buf), 0);
231
	KUNIT_EXPECT_STREQ(test, buf, "0xabcdef\n");
232

233
	// Version immediate entry is found.
234
	KUNIT_EXPECT_GT(test, show_immediate(unit0_dev, &config_rom_attributes[3].attr, buf), 0);
235
	KUNIT_EXPECT_STREQ(test, buf, "0x543210\n");
236

237
	kunit_kfree(test, buf);
238

239
	get_modalias_ids(&unit0, ids);
240
	KUNIT_EXPECT_MEMEQ(test, ids, unit0_expected_ids, sizeof(ids));
241
}
242

243
static struct kunit_case device_attr_test_cases[] = {
244
	KUNIT_CASE(device_attr_simple_avc),
245
	KUNIT_CASE(device_attr_legacy_avc),
246
	{}
247
};
248

249
static struct kunit_suite device_attr_test_suite = {
250
	.name = "firewire-device-attribute",
251
	.test_cases = device_attr_test_cases,
252
};
253
kunit_test_suite(device_attr_test_suite);
254

255
Product

Resources

Company
