CHAPTER 12 OBJECT RESET FUNCTIONS
The object reset function returns Data Queues, Mailboxes, Message Buffers, Fixed-Sized Memory Pools and Variable-Sized Memory Pools to the initial state. The object reset function falls outside mITRON4.0 specification.
- vrst_dtq
This service call reset the data queue specified by parameter dtqid.
The data having been accumulated by the data queue area are annulled. The tasks to wait to send data to the target data queue are released from the WAITING state, and EV_RST is returned as a return value for the tasks.
The following describes an example for coding this service call.
This service call reset the data queue specified by parameter dtqid.
The data having been accumulated by the data queue area are annulled. The tasks to wait to send data to the target data queue are released from the WAITING state, and EV_RST is returned as a return value for the tasks.
The following describes an example for coding this service call.
#include "kernel.h" /*Standard header file definition*/ #include "kernel_id.h" /*Header file generated by cfg600*/ void task (VP_INT exinf) { ER ercd; /*Declares variable*/ ID dtqid = 1; /*Declares and initializes variable*/ /* ......... */ ercd = vrst_dtq ( dtqid ); /*Reset data queue*/ /* ......... */ } |
Note In this service call, the tasks to wait to receive data do not released from the WAITING state.
- vrst_mbx
This service call reset the mailbox specified by parameter mbxid.
The messages having been accumulated by the mailbox come off from the management of the RI600V4.
The following describes an example for coding this service call.
This service call reset the mailbox specified by parameter mbxid.
The messages having been accumulated by the mailbox come off from the management of the RI600V4.
The following describes an example for coding this service call.
#include "kernel.h" /*Standard header file definition*/ #include "kernel_id.h" /*Header file generated by cfg600*/ void task (VP_INT exinf) { ER ercd; /*Declares variable*/ ID mbxid = 1; /*Declares and initializes variable*/ /* ......... */ ercd = vrst_mbx ( mbxid) ; /*Reset mailbox*/ /* ......... */ } |
Note In this service call, the tasks to wait to receive message do not released from the WAITING state.
- vrst_mbf
This service call reset the message buffer specified by parameter mbfid.
The messages having been accumulated by the message buffer area are annulled. The tasks to wait to send message to the target message buffer are released from the WAITING state, and EV_RST is returned as a return value for the tasks.
The following describes an example for coding this service call.
This service call reset the message buffer specified by parameter mbfid.
The messages having been accumulated by the message buffer area are annulled. The tasks to wait to send message to the target message buffer are released from the WAITING state, and EV_RST is returned as a return value for the tasks.
The following describes an example for coding this service call.
#include "kernel.h" /*Standard header file definition*/ #include "kernel_id.h" /*Header file generated by cfg600*/ void task (VP_INT exinf) { ER ercd; /*Declares variable*/ ID mbfid = 1; /*Declares and initializes variable*/ /* ......... */ ercd = vrst_mbf ( mbfid ); /*Reset message buffer*/ /* ......... */ } |
Note In this service call, the tasks to wait to receive message do not released from the WAITING state.
A fixed-sized memory pool is reset by issuing the following service call from the processing program.
- vrst_mpf
This service call reset the fixed-sized memory pool specified by parameter mpfid.
The tasks to wait to get memory block from the target fixed-sized memory pool are released from the WAITING state, and EV_RST is returned as a return value for the tasks.
All fixed-sized memory blocks that had already been acquired are returned to the target fixed-sized memory pool. Therefore, do not access those fixed-sized memory blocks after issuing this service call.
The following describes an example for coding this service call.
This service call reset the fixed-sized memory pool specified by parameter mpfid.
The tasks to wait to get memory block from the target fixed-sized memory pool are released from the WAITING state, and EV_RST is returned as a return value for the tasks.
All fixed-sized memory blocks that had already been acquired are returned to the target fixed-sized memory pool. Therefore, do not access those fixed-sized memory blocks after issuing this service call.
The following describes an example for coding this service call.
#include "kernel.h" /*Standard header file definition*/ #include "kernel_id.h" /*Header file generated by cfg600*/ void task (VP_INT exinf) { ER ercd; /*Declares variable*/ ID mpfid = 1; /*Declares and initializes variable*/ /* ......... */ ercd = vrst_mpf ( mpfid ); /*Reset fixed-sized memory pool*/ /* ......... */ } |
A variable-sized memory pool is reset by issuing the following service call from the processing program.
- vrst_mpl
This service call reset the variable-sized memory pool specified by parameter mpfid. The tasks to wait to get memory block from the target variable-sized memory pool are released from the WAITING state, and EV_RST is returned as a return value for the tasks.
All variable-sized memory blocks that had already been acquired are returned to the target variable-sized memory pool. Therefore, do not access those variable-sized memory blocks after issuing this service call.
The following describes an example for coding this service call.
This service call reset the variable-sized memory pool specified by parameter mpfid. The tasks to wait to get memory block from the target variable-sized memory pool are released from the WAITING state, and EV_RST is returned as a return value for the tasks.
All variable-sized memory blocks that had already been acquired are returned to the target variable-sized memory pool. Therefore, do not access those variable-sized memory blocks after issuing this service call.
The following describes an example for coding this service call.
#include "kernel.h" /*Standard header file definition*/ #include "kernel_id.h" /*Header file generated by cfg600*/ void task (VP_INT exinf) { ER ercd; /*Declares variable*/ ID mplid = 1; /*Declares and initializes variable*/ /* ......... */ ercd = vrst_mpl ( mplid ); /*Reset variable-sized memory pool*/ if (ercd == E_OK) { /* ......... */ } |