RTOS/rtems
1
0
Fork 0
forked from Imagelibrary/rtems
Code Pull Requests Activity

adaption of calling convention to console my_driver_write function

Browse Source
This commit is contained in:
Thomas Doerfler
2009-12-16 10:45:01 +00:00
parent b056194ce3
commit dddcb78e00
2 changed files with 19 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
doc/ChangeLog
View File

@@ -1,3 +1,8 @@
2009-12-16 Thomas Doerfler <Thomas.Doerfler@embedded-brains.de>
* bsp_howto/console.t: adaption to ssize_t return value for
my_driver_write() function
2009-11-23 Joel Sherrill <joel.sherrill@oarcorp.com> 2009-11-23 Joel Sherrill <joel.sherrill@oarcorp.com>
PR 1460/cpukit PR 1460/cpukit

18
doc/bsp_howto/console.t
View File

@@ -260,9 +260,15 @@ Termios for simple character IO.
The @code{my_driver_poll_write} routine is responsible for writing @code{n} The @code{my_driver_poll_write} routine is responsible for writing @code{n}
characters from @code{buf} to the serial device specified by @code{minor}. characters from @code{buf} to the serial device specified by @code{minor}.
On success, the number of bytes written is returned (zero indicates nothing
was written). On error, @code{-1} is returned.
NOTE: Due to the current implementation of termios, any data passed into
the write function will be lost.
@example @example
@group @group
static int my_driver_poll_write(int minor, const char *buf, int n) static ssize_t my_driver_poll_write(int minor, const char *buf, size_t n)
@{ @{
my_driver_entry *e = &my_driver_table [minor]; my_driver_entry *e = &my_driver_table [minor];
int i = 0; int i = 0;
@@ -278,7 +284,7 @@ static int my_driver_poll_write(int minor, const char *buf, int n)
my_driver_write_char(e, buf [i]); my_driver_write_char(e, buf [i]);
@} @}
return 0; return n;
@} @}
@end group @end group
@end example @end example
@@ -380,9 +386,13 @@ to fill the output buffer. If the transmit interrupt arises before Termios was
able to fill the transmit buffer you will end up with one interrupt per able to fill the transmit buffer you will end up with one interrupt per
character. character.
On error, the function should return @code{-1}. On success, it should return
@code{0}, since it the interrupt handler will report the actual number of
characters transmitted.
@example @example
@group @group
static int my_driver_interrupt_write(int minor, const char *buf, int n) static ssize_t my_driver_interrupt_write(int minor, const char *buf, size_t n)
@{ @{
my_driver_entry *e = &my_driver_table [minor]; my_driver_entry *e = &my_driver_table [minor];
@@ -394,7 +404,7 @@ static int my_driver_interrupt_write(int minor, const char *buf, int n)
/* /*
* Tell the device to transmit some characters from buf (less than * Tell the device to transmit some characters from buf (less than
* or equal to n). If the device is finished it should raise an * or equal to n). When the device is finished it should raise an
* interrupt. The interrupt handler will notify Termios that these * interrupt. The interrupt handler will notify Termios that these
* characters have been transmitted and this may trigger this write * characters have been transmitted and this may trigger this write
* function again. You may have to store the number of outstanding * function again. You may have to store the number of outstanding