2022-02-11 17:15:58

by Paulo Miguel Almeida

[permalink] [raw]
Subject: [PATCH] staging: pi433: add rf69_dbg_hex function

dev_<level> functions don't support printing hex dumps and the
alternative available (print_hex_dump_debug) doesn't print the device
information such as device's driver name and device name. That type of
information which comes in handy for situations in which you can more
than 1 device attached at the same type.

this patch adds a utility function that can obtain the same result as
print_hex_dump_debug while being able to honour all possible flags that
one may be interested in when dynamic debug is used.

Signed-off-by: Paulo Miguel Almeida <[email protected]>
---
Meta-comments:

the initial discussion to use print_hex_dump_debug started in this patch
but the original idea got merged into the brach.

https://lore.kernel.org/lkml/[email protected]/#t

---
drivers/staging/pi433/rf69.c | 39 ++++++++++++++++++++++++++++--------
1 file changed, 31 insertions(+), 8 deletions(-)

diff --git a/drivers/staging/pi433/rf69.c b/drivers/staging/pi433/rf69.c
index 901f8db3e3ce..82d4ba24c35f 100644
--- a/drivers/staging/pi433/rf69.c
+++ b/drivers/staging/pi433/rf69.c
@@ -822,9 +822,37 @@ int rf69_set_dagc(struct spi_device *spi, enum dagc dagc)

/*-------------------------------------------------------------------------*/

+static void rf69_dbg_hex(struct spi_device *spi, u8 *buf, unsigned int size,
+ const char *fmt, ...)
+{
+ va_list args;
+ char textbuf[512] = {};
+ char *text = textbuf;
+ int text_pos;
+
+ int rowsize = 16;
+ int i, linelen, remaining = size;
+
+ va_start(args, fmt);
+ text_pos = vscnprintf(text, sizeof(textbuf), fmt, args);
+ text += text_pos;
+ va_end(args);
+
+ for (i = 0; i < size; i += rowsize) {
+ linelen = min(remaining, rowsize);
+ remaining -= rowsize;
+
+ hex_dump_to_buffer(buf + i, linelen, rowsize, 1,
+ text, sizeof(textbuf) - text_pos, false);
+
+ dev_dbg(&spi->dev, "%s\n", textbuf);
+
+ memset(text, 0, sizeof(textbuf) - text_pos);
+ }
+}
+
int rf69_read_fifo(struct spi_device *spi, u8 *buffer, unsigned int size)
{
- int i;
struct spi_transfer transfer;
u8 local_buffer[FIFO_SIZE + 1];
int retval;
@@ -844,9 +872,7 @@ int rf69_read_fifo(struct spi_device *spi, u8 *buffer, unsigned int size)

retval = spi_sync_transfer(spi, &transfer, 1);

- /* print content read from fifo for debugging purposes */
- for (i = 0; i < size; i++)
- dev_dbg(&spi->dev, "%d - 0x%x\n", i, local_buffer[i + 1]);
+ rf69_dbg_hex(spi, local_buffer + 1, size, "%s - ", __func__);

memcpy(buffer, &local_buffer[1], size);

@@ -855,7 +881,6 @@ int rf69_read_fifo(struct spi_device *spi, u8 *buffer, unsigned int size)

int rf69_write_fifo(struct spi_device *spi, u8 *buffer, unsigned int size)
{
- int i;
u8 local_buffer[FIFO_SIZE + 1];

if (size > FIFO_SIZE) {
@@ -867,9 +892,7 @@ int rf69_write_fifo(struct spi_device *spi, u8 *buffer, unsigned int size)
local_buffer[0] = REG_FIFO | WRITE_BIT;
memcpy(&local_buffer[1], buffer, size);

- /* print content written from fifo for debugging purposes */
- for (i = 0; i < size; i++)
- dev_dbg(&spi->dev, "0x%x\n", buffer[i]);
+ rf69_dbg_hex(spi, local_buffer + 1, size, "%s - ", __func__);

return spi_write(spi, local_buffer, size + 1);
}
--
2.34.1


2022-02-12 16:48:41

by Dan Carpenter

[permalink] [raw]
Subject: Re: [PATCH] staging: pi433: add rf69_dbg_hex function

On Fri, Feb 11, 2022 at 09:07:32PM +1300, Paulo Miguel Almeida wrote:
> dev_<level> functions don't support printing hex dumps and the
> alternative available (print_hex_dump_debug) doesn't print the device
> information such as device's driver name and device name. That type of
> information which comes in handy for situations in which you can more
> than 1 device attached at the same type.
>
> this patch adds a utility function that can obtain the same result as
> print_hex_dump_debug while being able to honour all possible flags that
> one may be interested in when dynamic debug is used.
>
> Signed-off-by: Paulo Miguel Almeida <[email protected]>
> ---

I feel like this patch is over engineering your debug code. Is this
really worthwhile? If you really prefer the new format that's fine but
it seems like not necessarily a good use of energy.

> Meta-comments:
>
> the initial discussion to use print_hex_dump_debug started in this patch
> but the original idea got merged into the brach.
>
> https://lore.kernel.org/lkml/[email protected]/#t
>
> ---
> drivers/staging/pi433/rf69.c | 39 ++++++++++++++++++++++++++++--------
> 1 file changed, 31 insertions(+), 8 deletions(-)
>
> diff --git a/drivers/staging/pi433/rf69.c b/drivers/staging/pi433/rf69.c
> index 901f8db3e3ce..82d4ba24c35f 100644
> --- a/drivers/staging/pi433/rf69.c
> +++ b/drivers/staging/pi433/rf69.c
> @@ -822,9 +822,37 @@ int rf69_set_dagc(struct spi_device *spi, enum dagc dagc)
>
> /*-------------------------------------------------------------------------*/
>
> +static void rf69_dbg_hex(struct spi_device *spi, u8 *buf, unsigned int size,
> + const char *fmt, ...)
> +{
> + va_list args;
> + char textbuf[512] = {};

No need to initialize this.

> + char *text = textbuf;
> + int text_pos;
> +

Don't put a blank line in the middle of the declaration block.

> + int rowsize = 16;
> + int i, linelen, remaining = size;
> +
> + va_start(args, fmt);
> + text_pos = vscnprintf(text, sizeof(textbuf), fmt, args);
> + text += text_pos;

When you're printing to a buffer like this then I find it's easier to
leave the start of the buffer constant. So get rid of the text pointer
and just use "textbuf + prefix_len" instead of having a "text" pointer.


> + va_end(args);
> +
> + for (i = 0; i < size; i += rowsize) {
> + linelen = min(remaining, rowsize);
> + remaining -= rowsize;
> +
> + hex_dump_to_buffer(buf + i, linelen, rowsize, 1,
> + text, sizeof(textbuf) - text_pos, false);
> +
> + dev_dbg(&spi->dev, "%s\n", textbuf);
> +
> + memset(text, 0, sizeof(textbuf) - text_pos);

No need for this.

> + }

Instead of printing lineline at a time in a loop, what happens if you
just print size bytes? (I honestly don't know because I have never used
this function before).

regards,
dan carpenter

2022-02-14 15:01:53

by Paulo Miguel Almeida

[permalink] [raw]
Subject: Re: [PATCH] staging: pi433: add rf69_dbg_hex function

thanks for taking the time to review my patch

On Fri, Feb 11, 2022 at 05:25:28PM +0300, Dan Carpenter wrote:
>
> I feel like this patch is over engineering your debug code. Is this
> really worthwhile? If you really prefer the new format that's fine but
> it seems like not necessarily a good use of energy.
>

After reflecting on it for while, I think that you and Greg are right
not to like the approach taken.

> > + }
>
> Instead of printing lineline at a time in a loop, what happens if you
> just print size bytes? (I honestly don't know because I have never used
> this function before).
>

It gets truncated as hex_dump_to_buffer prints at most 32 bytes.

thanks,

Paulo Almeida