用開始寫的驅動程序的文檔替代此文檔.

從該設備的概要開始.指出該驅動實現整個設備的部分還是全部細節.

描述所有該設備的操作模式,指出該驅動所實現的是哪種.

寫出該設備在BSP中創建和初始化的步驟.寫出可把該驅動定制為特殊硬件環境的所有宏(macros).

寫出所有可幫助用戶理解該設備如何工作和設備的接口.

模板概要:

這是一個串口驅動模板.可用來作為寫Vxworks5.3或更新版本的新驅動的起點.

這些驅動支持舊串口驅動沒有的新功能,首先,它們提供一個設置硬件選項的接口;

例如,停止位數,數據位,奇偶,等等.

其次,它們提供可用來提供串口線上的外部模式調試(如,ROM監視器調試)的輪巡通訊(polled communication)接口.通常只支持異步模式驅動. 貫穿整個文件,單詞"template"用來替換一個真實的設備名,按慣例采用廠商名的第一個字母加產品編號.例如,Zilog 8530 串口設備應一個名為Z8530——DUSAART

數據結構，好過TEMPLATE_DUSART.

數據結構

設備數據結構在文件 h/drv/sio/templateSio.h里定義。一個數據結構——TEMPLATE_CHAN被定義，為每個通道。具有多串口通道的設備也為整個芯片定義了一個數據結構.例如，此驅動有一個芯片級的，有兩個通道結構作為成員數據結構叫TEMPLATE_DUSART。

回調

傳輸準備就緒(transmitter ready)中斷調用服務采用回調至高層庫以獲得一個字符來傳送。 默認地，此驅動安裝不做任何事情的傀儡回調程序。使用此驅動的高層庫(例如,ttyDrv)將用SIO_INSTALL_CALLBACK控制命令(ioctl command)安裝自己的回調程序. 同樣，一個接受中斷處理采用回調來將字符傳給高層庫。

模式

理想模式下該驅動應支持輪巡和中斷模式，并可動態切換模式。但這并非必須。Vxworks可支持此設備上的tty設備,即使該驅動只支持

中斷模式.

增加動態模式切換允許當信息送至時將外部代理激活(例如，在第一楨時中斷). 對允許動態模式切換的驅動，注意驅動將在其輸入ISR中間被要求切換模式.一個驅動的輸入ISR看起來應如此: inChar = *pDev->dr;/@ 從數據寄存器里讀一個字符 @/ *pDev->cr = GOT_IT;/@ 承認中斷@/ pDev->putRcvChar (...);/@ 發送字符到高層 @/ /@ give the character to the higher layer @/ 如果該通道用作外部模式調試的通訊路徑,且接收的該字符是"幀結束"字符，則代理的回調會鎖定中斷，切換設備到輪巡模式,并使用輪巡模式下的設備片刻.此后代理會解鎖中斷，切換模式到中斷模式，并返回ISR. 特別地，回調能使兩模式切換，首先到輪巡模式然后到中斷模式，后返回. 這要求小心處理中斷處理內的回調。例如，在調用回調前你必須先承認中斷。

用法:

該驅動通常為BSP調用.該模塊里直接調用程序是 templateDevInit(), templateDevInit2(),templateIntRcv(), templateIntTx(), and templateIntErr(). BSP調用templateDevInit()來初始化或重啟芯片.它用intConnect()連接中斷處理(templateIntRcv, templateIntTx,和 templateIntErr). 連接中斷處理后，BSP調用templateDevInit2()來告訴驅動中斷模式操作已可行.

BSP: 按常規所有BSP特定的串口初始化在sysSerial.c(被sysLib.c包含)里進行, sysSerial.c實現至少4個函數:sysSerialHwInit(),sysSerialHwInit2(), sysSerialChanGet(),和sysSerialReset(),如下工作: sysSerialHwInit被sysHwInit調用來初始化串口設備.此程序將在調用能復位設備及安裝驅動函數指針的templateDevinit前初始化TEMPLATE_DUSART結構的所有板特定的區域(如,寄存器的I/O地址，等等).sysSerialHwInit還將執其他所有串口驅動所需要的過程，比如適當配置板上的中斷控制器. sysSerialHwInit2被sysHwInit2調用來用intConnect連接驅動的中斷處理.連接好中斷處理后，templateDevInit2的調用允許中斷模式操作開始. sysSerialChanGet被usrRoot調用來取得與串口通道號相關的串口通描述.該程序使用一個0-NUM_TTY之間的一個數為單一的參數.它返回一個指向相應通道描述——SIO_CHAN * 的指針,它正好是TEMPLATE_CHAN結構的地址. sysSerialReset被sysToMonitor()調用且會復位串口設備到一個不活動的狀態. 該驅動可通過重定義TEMPLATE_REG_READ和TEMPLATE_REG_WRITE宏來定制.這兩個宏用來訪問實際的芯片.如不定義，源代碼會假定用對所有寄存的read/write訪問來對設備進行簡單內存映射.

測試:

中斷驅動接口可用通常方法來測試.當它(測試信息,譯者如是猜測)來到時Vxworks打印到串口控制臺,于是看到加電后VxWorks輸出表示該驅動基本開始工作. VxWorks的Portkit測試也可用來進行更嚴格的測試. 輪巡接口容易被檢驗——你可調用通道的SIO_MODE_SET ioctllai使它進入輪巡模式.注意通常的打印工具不能在輪巡模式下與串口通道一起工作.一些代理必須執行輪巡循環來處理基于字符的字符輸入/輸出.這不是自動進行.當切換WDB串口線到輪巡模式時，WDB代理執行它自己的輪巡循環. 動態模式切換可用tornado工具來檢查.重新配置代理使用WDB_COMM_UDLP_SLIP通訊路徑(詳見VxWorks run_time Guide的配置章節). 如下開始wtxtcl %wtxtcl 從tcl提示符,連接到target server: wtxtcl.ex> wtxToolAttach 通知代理來轉換外部模式檢查回應是OK(0). wtxtcl.ex>wtxAgentModeSet 2 0 要求代理掛起系統(請求會以中斷模式傳到，但回應會以輪巡模式被傳送): wtxtcl.ex>wtxContextSuspend 0 0 0 在此時目標將被掛起.控制臺將顯示凍結(果板卡有一個控制臺設備),你不能"ping"目標的網絡接口.

恢復目標:

wtxtcl.ex>wtxContextResume 0 0 0 現在目標將重新運行，于是你能敲信息到控制臺(如果板卡有一個控制臺設備)并可從主機"ping"目標的網絡接口.

vxworks下bsp制作教程

1 vxworks概述

vxworks是WIND RIVER公司的產品。作為一種商用的嵌入式操作系統?vxworks擁有強大的功能和友好的用戶界面。與免費的嵌入式操作系統相比?商用操作系統經過嚴格的測試?具有良好的實時性?易用性和大量的文檔支持?但是它的源碼是不公開的并且價格昂貴;免費的嵌入式操作系統有很多?大都是linux的移植?公開源代碼?但缺乏文檔?要對照源碼進行開發。

2 BSP的流程

BSP流程分成兩部分。首先是位于BootRom中的Boot代碼?它的作用是實現配置硬件和啟動vxworks下載程序。接下來是下載后跳轉到vxworks的入口地址運行操作系統和應用程序。

流程入圖:

ROM中的啟動代碼部分:RomInit在文件在文件romInit.s中。它是運行的開始?實現這一部分是首先的。它實現判斷啟動類型?配置內核和非內核寄存器以及內存和外圍設備的讀寫時序?因此可以在此處加入內存檢測功能。在BSP中無法進行調試?只能通過閃燈實現云信正確與否的判斷。閃燈功能函數也要在此加入。判斷啟動類型和配置寄存器?這一部分不需要改動。配置內存和外圍設備讀寫時序?要進行改動。這一部分的SDRAM?ROM?FLASH?FPGA有相應的模板可以參考。它的實現是通過使用宏定義來實現的。但是要改動的話也不難?一般是改動空間大小的屏蔽位?讀寫位數?以及片選寄存器OR和BR。至于特殊外設的讀寫有待討論。內存檢測在這里實現較復雜?它根據相應的內存檢測算法實現。主要是對地址線和數據線的檢測。通過寫入數據再會讀出數據來判斷。使用"走步1"和"走步0"
算法。這一部分較多的依賴硬件?可移植性較差?根據自己的單板改動。閃燈在這一部分是強烈推薦的。因為閃燈才能定位程序的運行位置。閃燈函數可移植?一般要改動?因為燈可能接在不同的I/O口上。另外注意860SAR的PORT B是32位的。具體的端口見相應的CPU的I/O口的參數?配置相應的寄存器。

RomInit在函數結尾跳入RomStart。

RomStart在BootInt.c文件中。它是系統運行的第一個C函數。這一部分是Wind River公司提供的標準程序?一般不需改動。該函數是C的入口函數，由匯編程序調用，主要完成清內存，將ROM中的程序拷貝到RAM，解壓并跳至解壓后的程序處運行。UsrInit在BootConfig.c文件中。它主要是實現硬件的初始化。其中涉及到串口?網口的初始化?CONSOLE的配置等。其中串口和網口的配置BSP的重要部分?但860CPU對串口和王口有很好的支持?只要做很小的改動即可?串口很簡單?網口較復雜一些。UsrRoot在BootConfig.c文件中。它主要是實現vxworks文件的下載?并且跳轉到vxworks的入口地址。從而進入到操作系統中去。

VXWORKS文件中的代碼部分:

SysInit在sysAlib.s中。它是vxworks的啟動代碼。它與RomInit的作用相同?對于這個文件?我們一般不需要去改動它。UsrInit在Usrconfig.c中。它的作用與Boot中的UsrInit的作用相同?他們都調用SysLib.c中的子函數。實現相同的硬件初始化功能。UsrRoot在UsrConfig.c中。它的作用與Boot中的UsrRoot的作用類似。但是這里的UsrRoot是最終進入到應用程序中去。