Tern E-Engine 80x186 RTOS 移植
[嵌入式以太网示例]

演示应用程序仅限于小型内存模型，以便使用 Paradigm C/C++ 编译器的评估版 - 随控制器套件交付的 Tern 版，进行构建和 调试。

E-Engine 通过内存映射接口连接 i2chip。 单独的 FreeRTOS 演示应用程序 演示了使用 ARM7 处理器通过 I²C 接口与同一 TCP/IP 协处理器连接。

请注意，经 Tern Inc 许可，文件 socket.c、i2chip_hw.c 与相关标头和库包含在内。 这些文件的版权归 Tern Inc 所有， 不受修改后的 GPL 覆盖。

Paradigm C/C++ 第 7 版用户请注意： 第 7 版使用了略微不同的堆栈框架，因此需要对 RTOS 内核移植文件 文件进行一些修改。 Dave Lyneham 慷慨地提供了一个包含必要更改的项目，以及 readme.txt 文件，以解释为什么需要这些更改。 文件可以从 FreeRTOS Interactive x86 论坛获取。 感谢 Dave！

重要提示！Tern Inc. 80x186 RTOS 演示使用说明

1. 源代码组织
2. 演示应用程序
3. 配置和使用详情

源代码组织

可以使用预配置的 Paradigm Tern 版编译器项目文件构建 E-Engine 演示应用程序，该文件名为 RTOSDemo.ide ，位于 FreeRTOS/Demo/WizNET_DEMO_TERN_186 目录。

演示应用程序

演示应用程序设置

演示使用的 IP 地址由 FreeRTOS/Demo/WizNET_DEMO_TERN_186/HTTPTask.c 顶部定义的常量 "ucIPAddress" 设置。 Web 浏览器计算机和控制器板使用的 IP 地址必须兼容。 为此，可以将二者 IP 地址中的前三个八位元组设置成相同的值。 例如，如果运行 Web 浏览器的计算机所用 IP 地址是 192.168.100.1，那么控制器板的 IP 地址可以使用 192.168.100.2 到 192.168.100.254 范围内的任何地址 网络上已经存在的任何地址）。

演示使用的 MAC 地址由同一文件中的常量 “ucMacAddress” 设置。 必须确保所配置的 MAC 地址在控制器板所连接的网络上是唯一的。

演示应用程序包含通过串行端口发送和接收字符的任务。 一个任务发送的字符 需要另一个任务来接收，如果任何字符被遗漏或接收顺序错误，则标记错误情况。 串行端口上 需要环回连接器才能运行此机制。 串行端口测试被预配置为在控制器板上使用 COM2，因为 调试器接口默认使用 COM1。 要将 COM2 Tx 引脚循环到 E-Engine 板上的 COM2 Rx 引脚，最简单的方法是 在 COM2 连接器的引脚 2 和 3 上放置跳线，使两个引脚短接在一起。

构建和执行演示应用程序

1. 使用控制板随附的 RS232 带状电缆将 E-Engine 连接到主机 PC。 控制器板上应使用 COM1。

2. 在 Paradigm IDE 中打开 RTOSDemo.ide 项目文件。
   
   Paradigm IDE 中显示的演示项目。

   项目分区如下：

   • i2chip_src - 包含 i2chip 驱动程序的源池。 大部分代码由 Tern Inc 提供且版权归 Tern Inc 所有。

   • FreeRTOS_source - 包含 FreeRTOS 内核源代码的源池。

   • DemmoApp_source - 包含标准 FreeRTOS 演示应用程序文件的源池。

   • RTOSDemo - 此项目包含对上述三个源池的引用。 它还包含 main.c 和 httptask.c。 main.c 是程序入口点。 它创建所有演示应用程序任务，然后启动 RTOS 调度器。 httptask.c 包含简单的 http 服务。

3. 在项目窗口中（如上图所示） ，右键单击“RTOSDemo [.axe]”行，然后从弹出菜单中选择“Edit local options”。 将显示 以下项目选项对话框。

4. 在项目选项窗口中，选择“Directories”主题，然后编辑 include（包含）和 library（库）路径名称，以正确指向您的 Paradigm C/C++ 安装（我的安装位于 c:devtoolsparadigm 目录中，如下图所示）。
   

5. 关闭项目选项窗口，然后在 IDE 的“Project”菜单中选择“Build All”。 源构建和链接时不应报错或出现警告。

6. 最后从 IDE 的“Debug”菜单中选择“Run”。 IDE 应连接到目标板，下载可执行文件并启动应用程序运行。 请注意，使用此方法时，程序正在从 RAM 执行，如果目标板重启，程序将丢失。

7. 打开 Web 浏览器，并在地址栏类型“http://192.168.0.23”中，将此 IP 地址替换为 ucIPAddress 常量设定的地址。
   
   在 Web 浏览器中输入 IP 地址
   （当然，根据您的系统，使用正确的 IP 地址）

功能

演示应用程序可创建 25 个任务，主要包括标准演示应用程序任务（请参阅 （演示应用程序部分，了解各个任务的详细信息）。 此外，另有 4 个任务反复动态创建和删除（遵循标准的"死亡"演示）。 正确执行时，演示应用程序将为左侧显示的网页提供服务。 该页面每秒都会自动刷新。 表中列出了 RTOS 调度器控制下的每个任务以及以下任务： 状态（请参阅密钥的跟踪可视化文档页面 ）。 优先级 （高水位线）剩余未使用的堆栈空间量。 任务编号。 空闲任务执行循环的计数来自空闲任务钩子，参见 HTTPTask.c 中的定义。 滴答数应以 configTICK_RATE_HZ 常量指定的速率递增，参见 FreeRTOSConfig.h 中的定义。 最后，main() 还创建了一个“检查”任务。 该检查任务可以监控系统中的所有其他任务。 如果检查任务发现任何其他任务的潜在错误， 将显示红色的错误消息。 如果从未检测到错误，则显示 "No errors detected"（未检测到错误）。 如需测试这个机制，可以 移除 COM2 上的环回连接器，以故意生成错误。

配置和用法详情

HTML 页面

自此演示创建以来，FreeRTOS 已对 uIP 堆栈做出一些修改。 请参阅嵌入式以太网示例列表页面，获取更多详细信息。

任务状态表

中断服务程序

/* This is the lower level function called from the top level 
ISR function. */
int iCalledFunction( void )
{
/* Variables can be declared here. */
int iSwitchRequired = false;

    /* ... ISR code goes here ... */

    /* Assume the ISR code necessitates a context switch. */
    iSwitchRequired = true;

    return iSwitchRequired;
}


/* This is the top level function in which variables cannot be 
declared on the stack.  This is the function installed on the 
vector. */
void __interrupt prvISRFunction( void )
{
/* Variables cannot be declared here! */

    /* Call the lower level function to do the work. */
    if( iCalledFunction() )
    {
        /* If the called function necessitates a context switch
        then call portEND_SWITCHING_ISR() immediately prior to
        exiting. */
        portEND_SWITCHING_ISR();
    }
}

E-Engine 演示应用程序中包含的串行端口和 WIZnet 驱动程序证明了这一机制。

将 ISR 使用的变量声明为静态变量可能会具有相同的效果。

不会引起上下文切换的中断服务程序没有特殊要求。

i2Chip 驱动程序

• 选择哪些中断应该唤醒 HTTPTask，哪些不应该。 目前，任何事件都会唤醒 HTTPTask，即使没有要执行的 处理。
• 取消 ISR 之外的驱动程序代码内的状态位轮询，取而代之的是， 在 ISR 和任务代码之间使用更加面向状态机的组织。

浮点

RTOS 移植特定配置

每个端口会定义 (#define) 'BaseType_t' 为该处理器的最有效数据类型。此端口将 BaseType_t 定义为 short（16 位）类型。

请注意，vPortEndScheduler() 尚未实现。

RTOS Tick 中断使用定时器 1 和 2。 使用快速滴答率将取消对定时器预分频的要求，因此仅使用定时器 2。

优化