shell_history.h

Go to the documentation of this file.

/*
 * Copyright (c) 2018 Nordic Semiconductor ASA
 *
 * SPDX-License-Identifier: Apache-2.0
 */
 
#ifndef ZEPHYR_INCLUDE_SHELL_HISTORY_H_
#define ZEPHYR_INCLUDE_SHELL_HISTORY_H_
 
#include <zephyr/kernel.h>
#include <zephyr/sys/util.h>
#include <zephyr/sys/dlist.h>
#include <zephyr/sys/ring_buffer.h>
#include <stdbool.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
 
struct shell_history {
        struct k_heap *heap;
        sys_dlist_t list;
        sys_dnode_t *current;
};

#define Z_SHELL_HISTORY_DEFINE(_name, _size)                    \
        K_HEAP_DEFINE(_name##_heap, _size);                     \
        static struct shell_history _name = {                   \
                .heap = &_name##_heap,                          \
                .list = SYS_DLIST_STATIC_INIT(&_name.list),     \
        }

void z_shell_history_purge(struct shell_history *history);

void z_shell_history_mode_exit(struct shell_history *history);

bool z_shell_history_get(struct shell_history *history, bool up,
                         uint8_t *dst, uint16_t *len);

void z_shell_history_put(struct shell_history *history, uint8_t *line,
                         size_t len);

static inline bool z_shell_history_active(struct shell_history *history)
{
        return (history->current) ? true : false;
}
 
#ifdef __cplusplus
}
#endif
 
#endif /* ZEPHYR_INCLUDE_SHELL_HISTORY_H_ */