Changeset 22c3a54b in rtems

Timestamp:

06/21/16 04:59:38 (7 years ago)

Author:

Sebastian Huber <sebastian.huber@…>

Branches:

5, master

Children:

3d9fd2ce

Parents:

f1531574

git-author:

Sebastian Huber <sebastian.huber@…> (06/21/16 04:59:38)

git-committer:

Sebastian Huber <sebastian.huber@…> (06/22/16 05:45:49)

Message:

Add printer task

Location:

cpukit

Files:

• include/rtems/printer.h (modified) (2 diffs)
• libcsupport/Makefile.am (modified) (1 diff)
• libcsupport/src/printertask.c (added)

cpukit/include/rtems/printer.h

@@ -20 +20 @@
 
 #include <rtems/print.h>
+#include <rtems/chain.h>
+#include <rtems/rtems/intr.h>
+#include <rtems/rtems/tasks.h>
 
 #include <stdio.h>
@@ -111 +114 @@
 extern void rtems_print_printer_fprintf(rtems_printer *printer, FILE *file);
 
+typedef struct {
+  rtems_id                     task;
+  RTEMS_INTERRUPT_LOCK_MEMBER( lock )
+  rtems_chain_control          free_buffers;
+  rtems_chain_control          todo_buffers;
+  size_t                       task_stack_size;
+  rtems_task_priority          task_priority;
+  int                          fd;
+  void                        *buffer_table;
+  size_t                       buffer_count;
+  size_t                       buffer_size;
+} rtems_printer_task_context;
+
+static inline void rtems_printer_task_initialize(
+  rtems_printer_task_context *context
+)
+{
+  memset( context, 0, sizeof( *context ) );
+}
+
+static inline void rtems_printer_task_set_stack_size(
+  rtems_printer_task_context *context,
+  size_t                    stack_size
+)
+{
+  context->task_stack_size = stack_size;
+}
+
+static inline void rtems_printer_task_set_priority(
+  rtems_printer_task_context *context,
+  rtems_task_priority       priority
+)
+{
+  context->task_priority = priority;
+}
+
+static inline void rtems_printer_task_set_file_descriptor(
+  rtems_printer_task_context *context,
+  int                       fd
+)
+{
+  context->fd = fd;
+}
+
+static inline void rtems_printer_task_set_buffer_table(
+  rtems_printer_task_context *context,
+  void                     *buffer_table
+)
+{
+  context->buffer_table = buffer_table;
+}
+
+static inline void rtems_printer_task_set_buffer_count(
+  rtems_printer_task_context *context,
+  size_t                    buffer_count
+)
+{
+  context->buffer_count = buffer_count;
+}
+
+static inline void rtems_printer_task_set_buffer_size(
+  rtems_printer_task_context *context,
+  size_t                    buffer_size
+)
+{
+  context->buffer_size = buffer_size;
+}
+
+/**
+ * @brief Creates a printer task.
+ *
+ * Print requests via rtems_printf() or rtems_vprintf() using a printer task
+ * printer are output to a buffer and then placed on a work queue in FIFO
+ * order.  The work queue is emptied by the printer task.  The printer task
+ * writes the buffer content to the file descriptor specified by the context.
+ * Buffers are allocated from a pool of buffers as specified by the context.
+ *
+ * @param[in] printer Pointer to the printer structure.
+ * @param[in] context The initialized printer task context.
+ *
+ * @retval 0 Successful operation.
+ * @retval EINVAL Invalid context parameters.
+ * @retval ENOMEM Not enough resources.
+ */
+int rtems_print_printer_task(
+  rtems_printer              *printer,
+  rtems_printer_task_context *context
+);
+
+/**
+ * @brief Drains the work queue of the printer task.
+ *
+ * Waits until all output buffers in the work queue at the time of this
+ * function call are written to the file descriptor and an fsync() completed.
+ *
+ * The printer task must be successfully started via rtems_print_printer_task()
+ * before this function can be used.  Otherwise, the behaviour is undefined.
+ *
+ * @param[in] context The printer task context of a successfully started
+ *   printer task.
+ */
+void rtems_printer_task_drain(rtems_printer_task_context *context);
+
 /** @} */
 

cpukit/libcsupport/Makefile.am

@@ -129 +129 @@
     $(BSD_LIBC_C_FILES) $(BASE_FS_C_FILES) $(MALLOC_C_FILES) \
     $(ERROR_C_FILES) $(ASSOCIATION_C_FILES)
+libcsupport_a_SOURCES += src/printertask.c
 
 libcsupport_a_SOURCES += $(LIBC_GLUE_C_FILES) $(PASSWORD_GROUP_C_FILES) \