在DS80C400应用中使用SDCC编译器

    sdcc -mds400 --model-flat24 --stack-10bit -Wl-r --xram-loc
0x10000 --xram-size 0x3fff --code-loc 0x400000 main.rel startup400.rel -l
rominit.lib

将示例应用程序加载到TINIm400模块

本节说明如何使用Maxim/Dallas Semiconductor提供的微控制器工具包(MTK)向TINIm400验证模块中加载由SDCC编译器生成的十六进制文件。目前可用的MTK版本只支持Windows®。

如果您的开发环境不是Windows，需要使用JavaKit应用程序来下载和执行应用程序。要使用JavaKit，您必须有Java运行环境³ (版本至少为1.2)并且安装Java Communications API⁴。JavaKit工具包含在TINI软件开发包中。写本文的时候，发布的最新固件是固件版本1.13。运行JavaKit的指导说明可以在TINI SDK docs目录下的Running_JavaKit.txt文件中找到。如果您在运行MTK或JavaKit时遇到技术问题，可能其他人已经遇到过类似问题并且已经发表在Dallas Semiconductor的讨论区中。

最新版本的MTK应用软件可下载。要安装MTK，请运行安装文件并遵照提示操作。成功安装后，会增加一个新的菜单项： Start->All Programs->Dallas Semiconductor MTK。 MTK启动后，会出现图1所示的对话框。

图1. 启动时MTK选项

选择选项TINI，以操作TINIm400评估板。

选择了TINI之后，会打开MTK主窗口。从Options->Configure Serial Port菜单选项中选择您将用来和TINIm400通讯的串口。然后，选择Tini->Tini Options菜单项，就会出现下面的对话框。选择DSTINIm400按钮，配置MTK用于和TINIm400板通讯。图2显示了带有DSTINIm400按钮的对话框。

图2. 选择TINIm400配置选项

选择Tini->Open COMx at xxx baud菜单选项打开串口。接着选择Tini->Reset选项复位评估板。会出现DS80C400的加载提示：

DS80C400 Silicon Software - Copyright (C) 2002 Maxim Integrated
Detailed product information available at http://www.maximintegrated.com

Welcome to the TINI DS80C400 Auto Boot Loader 1.0.1
> 

> B40 
> X 

> E 

   .area CSEG    (CODE)
interrupt_vect:
   ; DS80C400 IVT must be generated at runtime.
	sjmp	__sdcc_400boot
	.ascii	'TINI'	; required signature for 400 boot loader.
	.db	0	; selected bank or zero...
__sdcc_400boot:
	ljmp	__sdcc_gsinit_startup

和ROM以及SDCC ROM库接口

在高速微控制器用户指南DS80C400补充资料中说明了在汇编语言中调用ROM函数的过程。但是，在C中调用这些ROM函数会复杂一些。必须将参数从SDCC C编译器的规则转换成ROM使用的规则。SDCC编译器通过硬件堆栈、累加器和数据指针相结合的方式来传递参数。ROM函数采用许多不同的方式来接受参数。例如，socket函数接收存储在一个外部RAM缓冲区中的参数。相反地，许多功能函数接收由特殊功能寄存器或直接存储器位置传递的参数。为了从SDCC调用方式转换成ROM参数方式，Dallas Semiconductor已经编写了访问ROM函数的库。

在您的C程序中使用ROM函数只需包含一个头文件并与相应的库文件连接即可。用于SDCC编译器的ROM库包括：

• ROM初始化程序
• DHCP客户端
• 进程调度
• Sockets (TCP、UDP和Multicast)
• TFTP客户端
• 功能函数(CRC16, 随机数)

简单应用：HTTP服务器

编写了一个简单的http服务器来说明如何使用一些ROM库函数，特别是socket和进程调度库。这个示例会偶尔通过网络时间服务器更新它的时间，并且通过它的web服务器提供这个信息。

示例应用程序由两个模块组成，一个HTTP服务器和SNTP客户端。主程序生成一个新的子任务来运行http服务器，用于处理80端口上的客户连接。父任务每60秒会试图通过时间服务器同步当前时间。

SNTP客户端模块

以下代码段实现SNTP客户端模块的核心功能。

socket_handle = socket(0, SOCKET_TYPE_DATAGRAM, 0);

// set a timeout of about 2 seconds
for (i=0;i<256;i++)
    buffer[i] = 0;
buffer[0] = 0x0;
buffer[1] = 0x0;
buffer[2] = 0x8;
buffer[3] = 0x0;
setsockopt(socket_handle, 0, SO_TIMEOUT, buffer, 200);

buffer[2] = 0;       //reset since we used this in call to setsockopt
buffer[0] = 0x23;    // No warning/NTP Ver 4/Client

address.sin_addr[12] = TIME_NIST_GOV_IP_MSB;
address.sin_addr[13] = TIME_NIST_GOV_IP_2;
address.sin_addr[14] = TIME_NIST_GOV_IP_3;
address.sin_addr[15] = TIME_NIST_GOV_IP_LSB;
address.sin_port_high = (NTP_PORT/0x100); //higher byte of port number
address.sin_port_low = (NTP_PORT%0x100); //lower byte of port number

sendto(socket_handle, buffer, 48, 0, &address, sizeof(struct sockaddr));
recvfrom(socket_handle, buffer, 256, 0, &address, sizeof(struct sockaddr));

//SDCC uses little Endian for storing data, so reorganize the data before converting it to long
buffer[0]=buffer[43];
buffer[1]=buffer[42];
buffer[2]=buffer[41];
buffer[3]=buffer[40];

timeStamp = *(unsigned long *)(&buffer[0]);

formatTimeString(timestamp - (5 * SECONDS_PER_HOUR), "Tampa, USA",
                 last_time_reading_1);
formatTimeString(timeStamp - (3 * SECONDS_PER_HOUR), "Sao Paulo, Brazil",
                 last_time_reading_2);
formatTimeString(timeStamp + (1 * SECONDS_PER_HOUR),"Marseille, France",
                 last_time_reading_3);
formatTimeString(timeStamp + (5 * SECONDS_PER_HOUR) + (30 *
                 SECONDS_PER_MINUTE), "Bangalore, India",
                 last_time_reading_4);
formatTimeString(timeStamp +  (8 * SECONDS_PER_HOUR), "Hsinchu, Taiwan",
                 last_time_reading_5);
last_reading_seconds = getTimeSeconds();
closesocket(socket_handle);

首先，创建一个数据包socket并分配一个大约2秒(0x800==2048 milliseconds)的超时。这样会保证如果和我们选择的服务器通讯失败，我们不会无休止地等待响应。

接下来的一行用来设置请求的参数。在RFC 1361的第3节对这些位进行了说明。值0x23在一个跳秒时不要求产生警告，要求使用版本4的NTP，并声明模式为"Client"。我们使用普通数据包函数sendto和recvfrom发送请求和接收响应之后，将时间戳数值的秒部分赋予变量timeStamp，然后调整至参考日期1970年1月1日。用函数formatTimeString将时间戳转换成一个可读的字符串，比如说"In Marseille, France it is 9:37:37 on September 3, 2000。"

用getTimeSeconds函数来确定基于DS80C400内部时钟的最后一次更新的时间。由于程序只是大约每60秒更新一次，HTML网页time.html将会使用这一数值来报告上一次时间更新后已经过了多长时间。最后，socket关闭并且SNTP客户端进入另一个60秒的休眠期。

简易的HTTP服务器

这个时间服务器应用程序的另一个子模块为一个web服务器。此应用程序中的服务器实现了一个RFC 2068中描述的HTTP服务器简易版本。只支持"GET"方法--忽略输入包头，并且几乎不给出输出包头。当编写这个应用笔记时尚未提供文件系统库，因此示例应用程序动态地生成HTML页面。

通过调用Berkley-style socket函数来创建服务器soket。这使得建立一个服务器socket十分容易。下面的代码给出了我们的简易HTTP服务器如何创建、绑定和接收新的连接。

struct sockaddr local;
unsigned int socket_handle, new_socket_handle, temp;

socket_handle = socket(0, SOCKET_TYPE_STREAM, 0);
local.sin_port = 80;
bind(socket_handle, &local, sizeof(local));
listen(socket_handle, 5);

printf("Ready to accept HTTP connections...\r
");

// here is the main loop of the HTTP server
while (1)
{
    new_socket_handle = accept(socket_handle, &address, sizeof(address));
    handleRequest(new_socket_handle);
    closesocket(new_socket_handle);
}

HandleRequest方法从接入的请求中解析出文件名并且检查验证请求方法为'GET'。不允许使用其它的方法(即使是'POST'、 'HEAD'或'OPTIONS')。

为SDCC编译器编写DS80C400汇编函数的注意事项

虽然SDCC提供了丰富的库函数集合，但是有时我们会想用汇编语言编写优化的模块，或将现有的8051汇编模块移植到我们的应用程序中。若8051汇编语言函数由SDCC编译器编写的C程序来调用时，在编写这些汇编函数时需切记以下要点：

1. 函数参变量传递约定：下表说明了重入函数的变量传递方式
   

   Argument position	Character	Integer	Long	Address
   First argument	Dpl	Dph:dpl	B:dpx:dph:dpl	B:dpx:dph:dpl
   Second argument onwards	the values will be passed through hardware stack from right to left

   
   函数void sample_func(long x, long y,int z) reentrant;的参数传递如下：