Sitronix Technical Develop Sitronix Zardoz Builder 使用說明 使用 SSI Zardoz Project Creator 範例說明 目前於 SSI 中操作 Zardoz Project 有下列三種建立方式 1. 使用 SSI 建立 Project => 請參考 SSI.chm 2. User 以批次檔或手動建立 Project => 請參考 SB2 所產生之 (ProjectName).bat 檔 3. 使用 SB2.EXE (Zardoz Project Creating Tool) 建立 Project 其中 SB2.EXE 的用法茲說明如下: (起始環境) SB2.EXE 經過 Windows XP/2000/98se Command Mode 測試 使用者所建立的所有檔案應符合 DOS 8.3 格式檔名規範, 並將所有 Project 所需檔案複製到單一目錄中,最後適當修改 Linking File 以利執行 SB2.EXE (相關檔案) 目前建立完整 Project 共需要四個檔案 1. ZAS.exe 2. ZLN.exe 3. ZOBJ.exe 3. SB2.EXE Project 建立前應確認下列檔案 A. Source File (.ASM) B. Linking File (.SET/.LNK) C. 某些特定情況使用者會有一些沒有 Source File 的 Object File (.OBJ) (其它注意事項) 1. 請勿同時使用 SSI 與 SB2 操作同一 Project。 2. 已知使用超過 8bytes 名稱長度的 Symbol，當前 8bytes 名稱與其他 Symbol 名稱相同時將產 生錯誤；或於同一 Source File 使用過多 Symbol 將無法產生正確 Zardoz Debug Information 。 (SSI 開啟 Project 後將有警告訊息，使用者亦可由.mp2 File 中發現有一堆亂碼產生) 3. 當使用-X 參數操作 ZLN 時請開啟 EMS Memory，如附錄 A。 Sitronix Technical Develop (SB2.EXE 操作範例說明) 假設該 Project 包含下列檔案 Source File => Main.asm / Main2.asm Linking File => DOS.set Include File => USER.def / ST2202.def / ST22XX.inc / T3D.b0 / 01D.b0 該 Project 完成後將會產生下列檔案 Main.obj / Main2.obj / ICE.set OUT.hex / OUT.ssi / OUT.map / OUT.mp2 / OUT.bat 建立 Project 需使用下列檔案 ZAS.exe / ZLN.exe / ZOBJ.exe / SB2.EXE Step1: 建立一目錄 Multiobj 於 C:\ 並將上述檔案 Copy 至 Multiobj Step2: 檢查 DOS.set 並確認參數(-HIE -T)及目的檔符合 Linking File 說明中的 CASE1 或 CASE2 格 式 Step3: 執行 SB2.EXE Step4: 輸入 Link File Name => DOS.set Step5: 輸入 Output Project Name (請勿輸入副檔名) => OUT Step6: 選擇 Use -X Parameter for ZLN.exe ? (Y/N) : => 選擇 Y 使用 EMS Memory(請參閱附錄 A) Step7: 選擇 Show each ZAS Step? (Y/N) : => 依照需求選擇是否每個 ZAS 步驟均暫停。 Step8: (若 MP2 File 已經存在請選擇 Y 將其刪除或 Q 跳出 SB2 程序) Step9: ZAS DONE ~ 按任意鍵繼續 (若 Enable Show each ZAS Step) . . . Step10: ZAS / ZOBJ DONE ~ 按任意鍵繼續 Step11: ZLN DONE ~ 按任意鍵繼續 Step12: Project File DONE ~ 完成 Command Mode 下的 Project 製作 Step13: 開啟 SSI -> Project -> Open Project "OUT.ssi" -> Debugger -> 開始 Debug~ Sitronix Technical Develop (Linking File 說明) 一般而言一個完整 Linking File 包含下列內容: 命令參數 (包含使用 Section 定義) / 欲連接之目的檔.obj 命令參數請參考 ZLN 說明,而欲連結之目的檔(.OBJ) 一般建議放在命令參數之後 實際開啟一典型 Linking File 如下:(其中()中的內容為講解之用,實際狀況並不會出現) ------------------------------------------------------------------------------HIE –T (操作 SSI 的標準參數) -ALJB0=4000,4000 -ALJB1=4000,0000 -ALJB2=4000,C000 -ALJB3=4000,8000 -ALJB6=4000,1C000 -ALJB7=4000,18000 -APS0=40A0,40A0 -APS1=40A0,00A0 -APS2=40A0,C0A0 -APS3=40A0,80A0 -APS6=40A0,1C0A0 -APS7=40A0,180A0 -AVS0=FFEE,7FEE -AVS1=FFEE,3FEE -AVS2=FFEE,FFEE -AVS3=FFEE,BFEE -AVS6=FFEE,1FFEE -AVS7=FFEE,1BFEE source1 (Case1 僅有主檔名) source2.obj (Case2 有完整檔名) .\source3.obj (Case3 含相對路徑及完整檔名) ..\temp\test\source4 (Case4 含相對路徑及主檔名) c:\temp\test\source5.obj (Case5 含絕對路徑及完整檔名) d:\zardoz\c2\source6 (Case6 含絕對路徑及主檔名) --------------------------------------------------------------------------------------(PS: 所有開頭不含”-“符號的字串均會被當成欲 Link 的 Object File 處理，且每行視為一個 Object File) 目前 SSI 所需要的參數為-HIE -T 使用者應適當調整 Linkign File 內容 其中 Object File 的設定有六種形式 Case1~6 ZLN 均可接受,但目前 SB2.EXE 不支援路徑設 定,因此使用者應以 Case1/Case2 配合 SB2.EXE 進行操作~ Sitronix Technical Develop 附錄 A(如何開啟 EMS Memory) 開啟我的電腦找到欲使用的 ZLN.exe，點選滑鼠右鍵如下圖: 記憶體 Æ 延伸記憶體(EMS) Æ 開啟 EMS(Max 16384) 註：有任何使用上問題請洽 TDD 部門。