/**/
#include "FreeRTOS_IO.h"

void vAFunction( void )
{
/**/
Peripheral_Descriptor_t xOpenedPort;
BaseType_t xReturned;
const uint32_t ulMaxBlock100ms = ( 100UL / portTICK_PERIOD_MS );

    /* 使用“SPI2”这个字符串打开SPI端口，第二个参数现在用不到，

      可以设置成任何东西，为了将来的兼容性，推荐设置为NULL */
    xOpenedPort = FreeRTOS_open( "/SPI2/", NULL );

    if( xOpenedPort != NULL )
    {
        /* 设置端口：现在xOpenedPort包含了一个合法的描述符，可以被其他FreeRTOS+IO函数使用
        
        外设默认使用轮询模式去读写，要把这个默认模式改变成中断的zero copy写模式。

        FreeRTOS_ioctl()的第三个参数不需要使用可以设置成任何数值，但推荐设置为NULL，为了将来的兼容性；

        一个调用成功的FreeRTOS_ioctl()调用会返回pdPASS,为了简单起见，这个例子没有展示出检查返回值。

	 */
        FreeRTOS_ioctl( xOpenedPort, ioctlUSE_ZERO_COPY_TX, NULL );
                
        /* 使用端口：要使用zero copy传输模式，在FreeRTOS_write()调用之前必须获得写操作锁。

        接下来的调用将试图取得锁。如果锁不能马上获得，则任务将阻塞起来等待锁可用。

        但这个任务不会等待超过100ms，如果任务成功获得锁，FreeRTOS_ioctl()将返回pdPASS,否则，

        将返回pdFALL*/

        xReturned = FreeRTOS_ioctl( xOpenedPort, ioctlOBTAIN_WRITE_MUTEX, ulMaxBlock100ms );
        
        if( xReturned == pdTRUE )
        {
            /*  现在锁已经成功获得了，可以使用

             FreeRTOS_write()了，这个调用将从ucBuffer发出100个字节，ucBuffer假设定义在本函数外部。*/

            xReturned = FreeRTOS_write( xOpenedPort, ucBuffer, 100 );
            
            if( xReturned == 100 )
            {
                /*现在写已经成功了，但是，还没有完成，外设的中断服务函数将访问ucBuffer,但

               这个任务可以自由的去做任何事情，而ucBuffer里的数据不会改变。*/
            }
        }

        /* 一会后，任务想要更改ucBuffer里的数据，并且写另外的数据，首先要保证

        原来的写已经完成了，假如可以成功获得写操作锁，则可以知道已经成功地访问ucBuffer了，

        再一次，最大延迟100ms已经过了 */
        xReturned = FreeRTOS_ioctl( xOpenedPort, ioctlOBTAIN_WRITE_MUTEX, ulMaxBlock100ms );
        
        if( xReturned == pdTRUE )
        {
            /*锁获得了，所以任务可以继续执行并且更改buffer,在这个例子，所有要接着做的就是把

            它们清除为零*/
            memset( ucBuffer, 0, 100 );
            
            /* 这个任务已经获得了锁，所以可以写了。 */

            xReturned = FreeRTOS_write( xOpenedPort, ucBuffer, 100 );
            
            /* 再一次，如果返回xReturned == 100.则写已经成功了，它将可以继续执行 */
        }

        /* 在离开函数之前，这个任务要确定 写操作 已经完成，但是这个时候它并不需要执行另一次写操作，所以使用

               FreeRTOS_ioctl()函数，如果（预先）设置了宏ioctlOBTAIN_WRITE_MUTEX ioctlWAIT_PREVIOUS_WRITE_COMPLETE.......

               ——这地方很拗口，我理解是，只要原来设置了 ioctlOBTAIN_WRITE_MUTEX这个宏，然后用宏 ioctlWAIT_

              PREVIOUS_WRITE_COMPLETE这个宏作为参数调用FreeRTOS_ioctl()来释放写操作锁。*/

        FreeRTOS_ioctl( xOpenedPort, ioctlWAIT_PREVIOUS_WRITE_COMPLETE, ulMaxBlock100ms );
    }
}
						

当选择了字符型队列传输模式 写 时，FreeRTOS_write()并不会直接往外设写，反而，它会把数据送到一个队列里，然后外设的中断服务函数会把它们从队列里出队，送到外设里去。

 队列传输模式 读，FreeRTOS_read()不会直接从外设读数据，而是通过一个接收队列，它由FreeRTOS+IO中断服务函数把数据压入队列。

中断服务函数，以及FreeRTOS队列，都包含在FreeRTOS+IO的代码里，不需要应用作者提供

在调用FreeRTOS_ioctl()设置外设使用中断驱动的字符型队列读写类型时，要使用ioctlUSE_CHARACTER_QUEUE_TX and ioctlUSE_CHARACTER_QUEUE_RX来设置；主义这些配置会使能外设中断，而这个中断的优先级被配置的尽可能低，如有必要，可以通过ioctlSET_INTERRUPT_PRIORITY来提升。

例程

/* */
#include "FreeRTOS_IO.h"

void vAFunction( void )
{
/**/
Peripheral_Descriptor_t xOpenedPort;
BaseType_t xReturned;
const uint32_t ulMaxBlock100ms = ( 100UL / portTICK_PERIOD_MS );

    /**/
    xOpenedPort = FreeRTOS_open( "/SPI2/", NULL );

    if( xOpenedPort != NULL )
    {
        /* 上同，我只有一个问题，为什么要两次调用设置，难道不可以 位操作同时操作呢？

         另外就是，两次设置同一个端口，不会覆盖么？*/
        FreeRTOS_ioctl( xOpenedPort, ioctlUSE_CHARACTER_QUEUE_RX, ( void * ) 20 );
        FreeRTOS_ioctl( xOpenedPort, ioctlUSE_CHARACTER_QUEUE_TX, ( void * ) 20 );
                
        /*默认设置下，将会一直阻塞等待。

         低的读写阻塞时间可以保证FreeRTOS_read() 和FreeRTOS_write()调用后，即使出现了错误，

                  也可以返回。在这个例子中，读写都设置阻塞时间是100ms，同样的，为简单起见，这里也是不检查返回值。 */

        FreeRTOS_ioctl( xOpenedPort, ioctlSET_RX_TIMEOUT, ( void * ) ulMaxBlock100ms );
        FreeRTOS_ioctl( xOpenedPort, ioctlSET_TX_TIMEOUT, ( void * ) ulMaxBlock100ms );

        for( ;; )
        {
            /* 从ucBuffer写10个字节到打开的端口，注意到ucBuffer是在本函数之外定义的 */

            xBytesTransferred = FreeRTOS_write( xOpenedPort, ucBuffer, 10 );
            
            /* 这个时候，10个字节将被写到Tx队列里，但并没必要马上写到外设上去，

            检查是个字节都被写到队列里去了——他们应该拥有一个20字节长的队列 */
            configASSERT( xBytesTransferred == 10 );
            
            /*从同一个端口，读10个字节到ucBuffer,注意到，这同样不会直接从外设读字节，而是从Rx队列中读，那是

            FreeRTOS+IO中断服务函数读到的，被调用的任务将保持阻塞状态直到10个字节可用，如果他们并不是

            立马可用，这个任务也不会阻塞到超过100ms*/
            xBytesTransferred = FreeRTOS_read( xOpenedPort, ucBuffer, 10 );
            
            if( xBytesTransferred == 10 )
            {
                /* 超时之前读到了10个字节*/
            }
            else
            {
                /*超时*/
            }
        }
    }
    else
    {
        /*端口打开失败*/
    }
}