blob: 9fe5733f8779740d0a2d1f7dcf65b700ca117acb [file] [log] [blame]
Tom Rini83d290c2018-05-06 17:58:06 -04001/* SPDX-License-Identifier: GPL-2.0+ */
Simon Glassaa532332014-06-11 23:29:41 -06002/*
3 * Copyright (c) 2014 Google, Inc.
Simon Glassaa532332014-06-11 23:29:41 -06004 */
5
6#ifndef __IOTRACE_H
7#define __IOTRACE_H
8
9#include <linux/types.h>
10
11/*
12 * This file is designed to be included in arch/<arch>/include/asm/io.h.
13 * It redirects all IO access through a tracing/checksumming feature for
14 * testing purposes.
15 */
16
17#if defined(CONFIG_IO_TRACE) && !defined(IOTRACE_IMPL) && \
18 !defined(CONFIG_SPL_BUILD)
19
20#undef readl
21#define readl(addr) iotrace_readl((const void *)(addr))
22
23#undef writel
24#define writel(val, addr) iotrace_writel(val, (const void *)(addr))
25
26#undef readw
27#define readw(addr) iotrace_readw((const void *)(addr))
28
29#undef writew
30#define writew(val, addr) iotrace_writew(val, (const void *)(addr))
31
32#undef readb
Simon Glass709e98b2016-05-01 11:35:53 -060033#define readb(addr) iotrace_readb((const void *)(uintptr_t)addr)
Simon Glassaa532332014-06-11 23:29:41 -060034
35#undef writeb
Simon Glass709e98b2016-05-01 11:35:53 -060036#define writeb(val, addr) \
37 iotrace_writeb(val, (const void *)(uintptr_t)addr)
Simon Glassaa532332014-06-11 23:29:41 -060038
39#endif
40
41/* Tracing functions which mirror their io.h counterparts */
42u32 iotrace_readl(const void *ptr);
43void iotrace_writel(ulong value, const void *ptr);
44u16 iotrace_readw(const void *ptr);
45void iotrace_writew(ulong value, const void *ptr);
46u8 iotrace_readb(const void *ptr);
47void iotrace_writeb(ulong value, const void *ptr);
48
49/**
50 * iotrace_reset_checksum() - Reset the iotrace checksum
51 */
52void iotrace_reset_checksum(void);
53
54/**
55 * iotrace_get_checksum() - Get the current checksum value
56 *
57 * @return currect checksum value
58 */
59u32 iotrace_get_checksum(void);
60
61/**
62 * iotrace_set_enabled() - Set whether iotracing is enabled or not
63 *
64 * This controls whether the checksum is updated and a trace record added
65 * for each I/O access.
66 *
67 * @enable: true to enable iotracing, false to disable
68 */
69void iotrace_set_enabled(int enable);
70
71/**
72 * iotrace_get_enabled() - Get whether iotracing is enabled or not
73 *
74 * @return true if enabled, false if disabled
75 */
76int iotrace_get_enabled(void);
77
78/**
79 * iotrace_set_buffer() - Set position and size of iotrace buffer
80 *
81 * Defines where the iotrace buffer goes, and resets the output pointer to
82 * the start of the buffer.
83 *
84 * The buffer can be 0 size in which case the checksum is updated but no
85 * trace records are writen. If the buffer is exhausted, the offset will
86 * continue to increase but not new data will be written.
87 *
88 * @start: Start address of buffer
89 * @size: Size of buffer in bytes
90 */
91void iotrace_set_buffer(ulong start, ulong size);
92
93/**
94 * iotrace_get_buffer() - Get buffer information
95 *
96 * @start: Returns start address of buffer
97 * @size: Returns size of buffer in bytes
98 * @offset: Returns the byte offset where the next output trace record will
99 * @count: Returns the number of trace records recorded
100 * be written (or would be if the buffer was large enough)
101 */
102void iotrace_get_buffer(ulong *start, ulong *size, ulong *offset, ulong *count);
103
104#endif /* __IOTRACE_H */