File: open_alliance_helpers.h

package info (click to toggle)
linux 6.12.43-1
  • links: PTS, VCS
  • area: main
  • in suites: trixie-proposed-updates
  • size: 1,676,260 kB
  • sloc: ansic: 25,921,022; asm: 269,579; sh: 136,424; python: 65,440; makefile: 55,721; perl: 37,752; xml: 19,284; cpp: 5,895; yacc: 4,927; lex: 2,939; awk: 1,594; sed: 28; ruby: 25
file content (47 lines) | stat: -rw-r--r-- 1,774 bytes parent folder | download | duplicates (7)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
/* SPDX-License-Identifier: GPL-2.0 */

#ifndef OPEN_ALLIANCE_HELPERS_H
#define OPEN_ALLIANCE_HELPERS_H

/*
 * These defines reflect the TDR (Time Delay Reflection) diagnostic feature
 * for 1000BASE-T1 automotive Ethernet PHYs as specified by the OPEN Alliance.
 *
 * The register values are part of the HDD.TDR register, which provides
 * information about the cable status and faults. The exact register offset
 * is device-specific and should be provided by the driver.
 */
#define OA_1000BT1_HDD_TDR_ACTIVATION_MASK		GENMASK(1, 0)
#define OA_1000BT1_HDD_TDR_ACTIVATION_OFF		1
#define OA_1000BT1_HDD_TDR_ACTIVATION_ON		2

#define OA_1000BT1_HDD_TDR_STATUS_MASK			GENMASK(7, 4)
#define OA_1000BT1_HDD_TDR_STATUS_SHORT			3
#define OA_1000BT1_HDD_TDR_STATUS_OPEN			6
#define OA_1000BT1_HDD_TDR_STATUS_NOISE			5
#define OA_1000BT1_HDD_TDR_STATUS_CABLE_OK		7
#define OA_1000BT1_HDD_TDR_STATUS_TEST_IN_PROGRESS	8
#define OA_1000BT1_HDD_TDR_STATUS_TEST_NOT_POSSIBLE	13

/*
 * OA_1000BT1_HDD_TDR_DISTANCE_MASK:
 * This mask is used to extract the distance to the first/main fault
 * detected by the TDR feature. Each bit represents an approximate distance
 * of 1 meter, ranging from 0 to 31 meters. The exact interpretation of the
 * bits may vary, but generally:
 * 000000 = no error
 * 000001 = error about 0-1m away
 * 000010 = error between 1-2m away
 * ...
 * 011111 = error about 30-31m away
 * 111111 = resolution not possible / out of distance
 */
#define OA_1000BT1_HDD_TDR_DISTANCE_MASK			GENMASK(13, 8)
#define OA_1000BT1_HDD_TDR_DISTANCE_NO_ERROR			0
#define OA_1000BT1_HDD_TDR_DISTANCE_RESOLUTION_NOT_POSSIBLE	0x3f

int oa_1000bt1_get_ethtool_cable_result_code(u16 reg_value);
int oa_1000bt1_get_tdr_distance(u16 reg_value);

#endif /* OPEN_ALLIANCE_HELPERS_H */