o_195h4n6al16jb186b1b2qs7fgssa.pdf

2004 Microchip Technology Inc. DS51456B 

dsPIC 

® 

Language Tools 

Libraries 

2004 Microchip Technology Inc DS51456B 

dsPIC 

® 

Công cụ Ngôn ngữ 

Thư viện 

DS51456B-page ii 

2004 Microchip Technology Inc. 

DS51456B trang ii 

2004 Microchip Technology Inc 

Information contained in this publication regarding device 

applications and the like is provided only for your convenience 

and may be superseded by updates. It is your responsibility to 

ensure that your application meets with your specifications. 

MICROCHIP MAKES NO REPRESENTATIONS OR WARRANTIES OF 

ANY KIND WHETHER EXPRESS OR IMPLIED, 

WRITTEN OR ORAL, STATUTORY OR OTHERWISE, 

RELATED TO THE INFORMATION, INCLUDING BUT NOT 

LIMITED TO ITS CONDITION, QUALITY, PERFORMANCE, 

MERCHANTABILITY OR FITNESS FOR PURPOSE. 

Microchip disclaims all liability arising fromthis information and 

its use. Use of Microchip’s products as critical components in 

life support systems is not authorized except with express 

written approval by Microchip. No licenses are conveyed, 

implicitly or otherwise, under anyMicrochip intellectual property 

rights. 

Trademarks 

The Microchip name and logo, the Microchip logo, Accuron, 

dsPIC, KEELOQ, microID, MPLAB, PIC, PICmicro, PICSTART, 

PRO MATE, PowerSmart, rfPIC, and SmartShunt are 

registered trademarks of Microchip Technology Incorporated 

in the U.S.A. and other countries. 

AmpLab, FilterLab, MXDEV, MXLAB, PICMASTER, SEEVAL, 

SmartSensor and The Embedded Control Solutions Company 

are registered trademarks of Microchip Technology 

Incorporated in the U.S.A. 

Analog-for-the-Digital Age, Application Maestro, dsPICDEM, 

dsPICDEM.net, dsPICworks, ECAN, ECONOMONITOR, 

FanSense, FlexROM, fuzzyLAB, In-Circuit Serial 

Programming, ICSP, ICEPIC, Migratable Memory, MPASM, 

MPLIB, MPLINK, MPSIM, PICkit, PICDEM, PICDEM.net, 

PICLAB, PICtail, PowerCal, PowerInfo, PowerMate, 

PowerTool, rfLAB, rfPICDEM, Select Mode, Smart Serial, 

Thông tin trong ấn phẩm này liên quan đến thiết bị 

ứng dụng và như thế chỉ được cung cấp thuận tiện cho bạn 

và có thể được thay thế bởi bản cập nhật. Đó là trách nhiệm của bạn để 

đảm bảo rằng ứng dụng của bạn đáp ứng với các thông số kỹ thuật của bạn. 

Microchip KHÔNG GIỚI THIỆU HOẶC BẢO ĐẢM NÀO CHO DÙ RÕ 

RÀNG HAY NGỤ Ý, 

VĂN BẢN HAY LỜI NÓI, LUẬT ĐỊNH HAY, 

LIÊN QUAN ĐẾN NHỮNG THÔNG TIN, BAO GỒM NHƯNG KHÔNG 

GIỚI HẠN CỦA ĐIỀU KIỆN, CHẤT LƯỢNG, HIỆU QUẢ, 

MUA BÁN, HOẶC CHO MỤC ĐÍCH. 

Microchip từ chối mọi trách nhiệm pháp lý phát sinh fromthis thông tin và 

sử dụng của nó. Sử dụng các sản phẩm của Microchip là thành phần quan trọng 

trong 

hệ thống hỗ trợ cuộc sống không được phép trừ với tốc 

Văn bản chấp thuận Microchip. Không có giấy phép được truyền đạt, 

ngầm hay không, sở hữu trí tuệ thuộc anyMicrochip 

quyền. 

Nhãn hiệu hàng hóa 

Tên Microchip, biểu tượng, biểu tượng Microchip, Accuron, 

dsPIC, KEELOQ, microID, MPLAB, PIC, PICmicro, picstart, 

PRO MATE, PowerSmart, rfPIC, và là SmartShunt 

thương hiệu đã đăng ký của Microchip Technology Incorporated 

ở Mỹ và các nước khác. 

AmpLab, Filterlab, MXDEV, MXLAB, PICMASTER, SEEVAL, 

Các nhúng Công ty Giải pháp kiểm soát và SmartSensor 

là thương hiệu đã đăng ký của công nghệ vi mạch 

Thành lập tại Hoa Kỳ 

Analog-cho-the-đại kỹ thuật số, ứng dụng Maestro, dsPICDEM, 

dsPICDEM.net, dsPICworks, ECAN, ECONOMONITOR, 

FanSense, FlexROM, fuzzyLAB, In-Circuit Serial 

Lập trình, ICSP, ICEPIC, Migratable nhớ, MPASM, 

MPLIB, MPLINK, MPSIM, PICkit, PICDEM, PICDEM.net, 

PICLAB, PICtail, PowerCal, PowerInfo, PowerMate, 

PowerTool, rfLAB, rfPICDEM, Chọn chế độ, Smart Serial,

SmartTel and Total Endurance are trademarks of Microchip 

Technology Incorporated in the U.S.A. and other countries. 

SQTP is a service mark of Microchip Technology Incorporated 

in the U.S.A. 

All other trademarks mentioned herein are property of their 

respective companies. 

© 2004, Microchip Technology Incorporated, Printed in the 

U.S.A., All Rights Reserved. 

Printed on recycled paper. 

Note the following details of the code protection feature on Microchip devices: 

• Microchip products meet the specification contained in their particular 

Microchip Data Sheet. 

• Microchip believes that its family of products is one of the mostsecure 

families of its kind on the market today, when used in the 

intended manner and under normal conditions. 

• There are dishonest and possibly illegal methods used to breach the code 

protection feature. All of these methods, to our 

knowledge, require using the Microchip products in a manner outside the 

operating specifications contained in Microchip’s Data 

Sheets. Most likely, the person doing so isengaged in theft of intellectual 

property. 

• Microchip is willing to work with the customer who is concerned about the 

integrity of their code. 

• Neither Microchip nor any other semiconductor manufacturer can guarantee 

the security of their code. Code protection does not 

mean that we are guaranteeing the product as “unbreakable.” 

Code protection is constantly evolving. We at Microchip are committed to 

continuously improving the code protection features ofour 

products. Attempts to break Microchip’s code protection feature may be a 

violation of the Digital Millennium Copyright Act. If such acts 

allow unauthorized access to your software or other copyrighted work, you may 

have a right to sue for relief under that Act. 

Microchip received ISO/TS-16949:2002 quality systemcertification for 

its worldwide headquarters, design and wafer fabrication facilities in 

Chandler and Tempe, Arizona and Mountain View, California in 

October 2003. The Company’squality system processes and 

procedures are for its PICmicro 

® 

8-bit MCUs, KEELOQ® 

code hopping 

devices, Serial EEPROMs, microperipherals, nonvolatile memory and 

analog products. In addition, Microchip’s quality system for the design 

and manufacture of development systems is ISO 9001:2000 certified. 

SmartTel và Tổng Sức chịu đựng là thương hiệu của Microchip 

Công nghệ Được thành lập tại Hoa Kỳ và các nước khác. 

SQTP là nhãn hiệu của Microchip Technology Incorporated 

ở Mỹ 

Tất cả thương hiệu khác được đề cập trong tài liệu này là tài sản của họ 

công ty tương ứng. 

© 2004, Microchip Technology Incorporated, in trong 

Mỹ, Tất cả các quyền. 

Được in trên giấy tái chế. 

Lưu ý các chi tiết sau đây của tính năng mã bảo vệ trên các thiết bị vi mạch: 

• Các sản phẩm vi mạch đáp ứng các đặc điểm kỹ thuật đặc biệt chứa dữ liệu 

Microchip Bảng của họ. 

• Microchip tin rằng gia đình của các sản phẩm là một trong những gia đình 

mostsecure của loại hình này trên thị trường hiện nay, khi được sử dụng trong 

định cách thức và điều kiện bình thường. 

• Có nhiều phương pháp không trung thực và có thể là bất hợp pháp được sử 

dụng để vi phạm các tính năng bảo vệ mã. Tất cả những phương pháp này, để 

chúng tôi 

kiến thức, yêu cầu sử dụng các sản phẩm vi mạch một cách bên ngoài các thông 

số kỹ thuật điều hành có trong dữ liệu của Microchip 

Tờ. Nhiều khả năng, người làm như vậy isengaged trong hành vi trộm cắp sở 

hữu trí tuệ. 

• Microchip sẵn sàng làm việc với các khách hàng quan tâm đến tính toàn vẹn 

của mã của họ. 

• Không Microchip cũng không phải bất kỳ nhà sản xuất bán dẫn khác có thể 

đảm bảo sự an toàn của mã của họ. Mã bảo vệ không 

có nghĩa là chúng tôi đảm bảo sản phẩm là "không thể phá vỡ." 

Mã bảo vệ không ngừng phát triển. Hiện tại Microchip cam kết liên tục cải thiệ 

các tính năng bảo vệ mã ofour 

sản phẩm. Những nỗ lực để phá vỡ tính năng mã bảo vệ vi mạch có thể là một 

vi phạm Đạo luật Bản quyền Thiên niên kỷ kỹ thuật số. Nếu hành vi đó 

cho phép truy cập trái phép vào phần mềm của bạn hoặc tác phẩm khác, bạn có 

thể có quyền khởi kiện cho cứu trợ theo Đạo luật đó. 

Microchip nhận chứng chỉ ISO / TS-16949: 2002 chất lượng cho 

systemcertification 

trụ sở chính trên toàn thế giới, thiết kế và chế tạo wafer cơ sở của nó trong 

Chandler và Tempe, Arizona và Mountain View, California 

Tháng Mười năm 2003 quy trình hệ thống và Company'squality 

thủ tục cho PICmicro của mình 

® 

8-bit MCUs, KEELOQ® 

đang nhảy 

thiết bị, EEPROM Serial, microperipherals, bộ nhớ không bay hơi và 

các sản phẩm tương tự. Ngoài ra, hệ thống chất lượng của Microchip cho việc 

thiết kế 

và sản xuất các hệ thống phát triển là tiêu chuẩn ISO 9001: 2000 được chứng

dsPIC 

®LANGUAGE TOOLS 

LIBRARIES 

2004 Microchip Technology Inc. DS51456B-page iii 

Table of Contents 

Preface 

........................................................................................................................... 1 

Chapter 1. Library Overview 

1.1 Introduction ..................................................................................................... 

7 

1.2 OMF-Specific Libraries/StarTup Modules ...................................................... 

7 

1.3 Startup Code .................................................................................................. 

8 

1.4 DSP Library .................................................................................................... 

8 

1.5 dsPIC Peripheral Libraries ............................................................................. 

8 

1.6 Standard C Libraries (with Math Functions) ................................................... 

8 

1.7 MPLAB C30 Built-in Functions 

....................................................................... 8 

Chapter 2. DSP Library 

2.1 Introduction ..................................................................................................... 

9 

2.2 Using the DSP Library .................................................................................. 

10 

2.3 Vector Functions .......................................................................................... 

13 

2.4 Window Functions ........................................................................................ 

26 

2.5 Matrix Functions ........................................................................................... 

31 

2.6 Filtering Functions ........................................................................................ 

38 

2.7 Transform Functions .................................................................................... 

58 

Chapter 3. dsPIC Peripheral Libraries 

3.1 Introduction ................................................................................................... 

73 

3.2 Using the dsPIC Peripheral Libraries ........................................................... 

74 

3.3 External LCD Functions ............................................................................... 

74 

3.4 CAN Functions ............................................................................................. 

81 

3.5 ADC12 Functions ......................................................................................... 

95 

nhận. 

dsPIC 

®LANGUAGE CÔNG CỤ 

THƯ VIỆN 

2004 Microchip Technology Inc DS51456B trang iii 

Mục lục 

Lời nói đầu 1 

Chương 1 Thư viện Tổng quan 

1.1 Giới thiệu 7 

1.2 OMF-cụ thể thư viện / khởi động module .......................................... ........... 

7 

1.3 Startup Mã ............................................... .................................................. . 8 

1.4 DSP Thư viện ............................................... ................................................. 

8 ... 

1,5 dsPIC Thư viện ngoại vi .............................................. ............................... 8 

1.6 Tiêu chuẩn C Thư viện (với các hàm toán học) ......................................... 

.......... 8 

1,7 MPLAB C30 Built-in chức năng ........................................... 

............................ 8 

Chương 2 DSP Thư viện 

2.1 Giới thiệu 9 

2.2 Sử dụng thư viện DSP ............................................. ..................................... 

10 

2.3 Chức năng Vector ............................................... ........................................... 

13 

2.4 Chức năng Window ............................................... ........................................ 

26 

2.5 Chức năng Matrix ............................................... ........................................... 

31 

2.6 Chức năng lọc ............................................... ......................................... 38 

2.7 Chuyển đổi chức năng ............................................... .................................... 

58 

Chương 3: dsPIC Thư viện ngoại vi 

3.1 Giới thiệu ................................................ .................................................. . 

73 

3.2 Sử dụng thư viện dsPIC ngoại vi ............................................ ............... 74 

3.3 Chức năng màn hình LCD bên ngoài .............................................. 

................................. 74 

3.4 Chức năng CAN ............................................... ............................................. 

81 

3,5 ADC12 Chức năng ............................................... ......................................... 

95 

3.6 Chức năng ADC10 ............................................... ........................................ 

102 

3.7 Chức năng hẹn giờ ............................................... .......................................... 

109 

Chức năng lập lại 3,8 / Control ............................................. ...............................

3.6 ADC10 Functions ....................................................................................... 

102 

3.7 Timer Functions .......................................................................................... 

109 

3.8 Reset/Control Functions ............................................................................. 

117 

3.9 I/O Port Functions ...................................................................................... 

120 

3.10 Input Capture Functions ........................................................................... 

125 

3.11 Output Compare Functions ...................................................................... 

131 

3.12 UART Functions ....................................................................................... 

141 

3.13 DCI Functions ........................................................................................... 

150 

3.14 SPI Functions ........................................................................................... 

158 

3.15 QEI Functions ........................................................................................... 

166 

3.16 PWM Functions ........................................................................................ 

171 

3.17 I2C Functions ........................................................................................... 

183 

dsPIC 

® 

Language Tools Libraries 

DS51456B-page iv 


Chapter 4. Standard C Libraries with Math Functions 

4.1 Introduction ................................................................................................. 

193 

4.2 Using the Standard C Libraries .................................................................. 

194 

4.3 diagnostics ............................................................................... 

195 

4.4 character handling ..................................................................... 

196 

4.5 errors ......................................................................................... 

205 

4.6 floating-point characteristics ........................................................ 

206 

4.7 implementation-defined limits .................................................... 

211 

4.8 localization ................................................................................ 

213 

4.9 non-local jumps ....................................................................... 

214 

4.10 signal handling ........................................................................ 

117 

3,9 I / O Port Chức năng ............................................ .......................................... 

120 

3.10 Input Capture chức năng .............................................. ............................. 

125 

3.11 ra so sánh chức năng .............................................. ........................ 131 

3.12 Chức năng UART ............................................... ........................................ 

141 

3.13 DCI chức năng ............................................... ............................................ 

150 

3.14 SPI Chức năng ............................................... ............................................ 

158 

3.15 QEI Chức năng ............................................... ............................................ 

166 

3.16 Chức năng PWM ............................................... ......................................... 

171 

3.17 I2C chức năng ............................................... ............................................ 

183 

dsPIC 

® 

Thư viện Công cụ Ngôn ngữ 

DS51456B trang iv 


Chương 4 Thư viện chuẩn C với các hàm toán 

4.1 Giới thiệu ................................................ ................................................. 193 

4.2 Sử dụng thư viện chuẩn C ............................................ ...................... 194 

4.3 chẩn đoán ................................................. .............................. 195 

4.4 xử lý nhân vật ................................................ ..................... 196 

4.5 lỗi ................................................. ........................................ 205 

4.6 đặc điểm nổi .............................................. .......... 206 

4.7 giới hạn thực hiện xác định .............................................. ...... 211 

4.8 nội địa hóa ................................................. ............................... 213 

4.9 nhảy không địa phương .............................................. ......................... 214 

4.10 xử lý tín hiệu ................................................ ........................ 215 

4.11 danh sách đối số biến ............................................... ............ 221 

4.12 định nghĩa chung ................................................ ................ 223 

4.13 đầu vào và đầu ra ............................................... ......................... 225 

4.14 chức năng tiện ích ................................................ ......................... 270 

4.15 chức năng chuỗi ................................................ ........................ 294 

4.16 ngày và thời gian chức năng .............................................. ............... 317 

4.17 chức năng toán học ................................................ ............ 325 

4.18 pic30-libs .............................................. .................................................. 36 

.. 

Chương 5 MPLAB C30 Built-in chức năng 

5.1 Giới thiệu ................................................ ................................................. 375

215 

4.11 variable argument lists ........................................................... 

221 

4.12 common definitions ................................................................ 

223 

4.13 input and output ........................................................................ 

225 

4.14 utility functions ......................................................................... 

270 

4.15 string functions ........................................................................ 

294 

4.16 date and time functions ............................................................. 

317 

4.17 mathematical functions............................................................ 325 

4.18 pic30-libs .................................................................................................. 

366 

Chapter 5. MPLAB C30 Built-in Functions 

5.1 Introduction ................................................................................................. 

375 

5.2 Built-In Function List ................................................................................... 

376 

5.3 Built-In Function Error Messages ............................................................... 

379 

Appendix A. ASCII Character Set 

.............................................................................381 

Index 

...........................................................................................................................383 

Worldwide Sales and Service 

...................................................................................400 

dsPIC 


LIBRARIES 

2004 Microchip Technology Inc. DS51456B-page 1 

Preface 

INTRODUCTION 

The purpose of this document is to define and describe the libraries that are 

available 

for use with Microchip Technology’s dsPIC language tools, based on GCC 

(GNU 

Compiler Collection) technology. The related language tools are: 

•MPLAB® 

ASM30 Assembler 

• MPLAB C30 C Compiler 

• MPLAB LINK30 Linker 

• MPLAB LIB30 Archiver/Librarian 

• Other Utilities 

5.2 Built-In Danh sách Chức năng ............................................ 

....................................... 376 

5.3 Tin nhắn Chức năng Lỗi Built-In ........................................... .................... 

379 

Phụ lục A. ASCII Character Set ............................................ 

................................. 381 

Chỉ số 

...........................................................................................................................38 

Bán hàng trên toàn thế giới và Dịch vụ .............................................. 

..................................... 400 

dsPIC 


THƯ VIỆN 

2004 Microchip Technology Inc DS51456B trang 1 

Lời nói đầu 

GIỚI THIỆU 

Mục đích của tài liệu này là để xác định và mô tả các thư viện có sẵn 

để sử dụng với các công cụ ngôn ngữ dsPIC của Microchip Technology, dựa 

trên GCC (GNU 

Bộ sưu tập) công nghệ biên dịch. Các công cụ ngôn ngữ liên quan là: 

• MPLAB® 

ASM30 Assembler 

• MPLAB C30 C Compiler 

• MPLAB LINK30 Linker 

• MPLAB LIB30 Archiver / Thư viện 

• Các tiện ích khác 

Mục thảo luận trong chương này bao gồm: 

• Về hướng dẫn này 

• Giới thiệu sách 

• Khắc phục sự cố 

• Các trang web Microchip 

• Hệ thống Phát triển Dịch vụ khách hàng thông báo thay đổi 

• Hỗ trợ khách hàng 

THÔNG BÁO CHO KHÁCH HÀNG 

Tất cả tài liệu trở nên lỗi thời, và sách hướng dẫn này cũng không ngoại 

lệ. Công cụ Microchip 

và các tài liệu liên tục phát triển để đáp ứng nhu cầu khách hàng, vì vậy một số 

thực tế 

hộp thoại và / hoặc mô tả cụ thể khác fromthose trong tài liệu này. Vui lòng 

tham khảo 

để trang web của chúng tôi (www.microchip.com) để có được những tài liệu 

mới nhất hiện có. 

Các tài liệu được xác định với một "DS" number.This số nằm ở phía dưới 

mỗi trang, ở phía trước của số trang. Công ước số cho DS

Items discussed in this chapter include: 

• About This Guide 

• Recommended Reading 

• Troubleshooting 

• The Microchip Web Site 

• Development Systems Customer Change Notification Service 

• Customer Support 

NOTICE TO CUSTOMERS 

All documentation becomes dated, and this manual is no exception. Microchip 

tools 

and documentation are constantly evolving to meet customer needs, so some 

actual 

dialogs and/or tool descriptions may differ fromthose in this document. Please 

refer 

to our web site (www.microchip.com) to obtain the latest documentation 

available. 

Documents are identified with a “DS” number.This number is located on the 

bottom 

of each page, in front of the page number. The numbering convention for the 

DS 

number is “DSXXXXXA”, where “XXXXX” isthe document number and “A” 

is the 

revision level of the document. 

For the most up-to-date information on development tools, see the MPLAB IDE 

on-line help. Select the Help menu, and then Topics to open a list of available 

on-line 

help files. 

dsPIC 

® 


số là "DSXXXXXA", trong đó "XXXXX" isthe số tài liệu và "A" là 

mức độ sửa đổi của tài liệu. 

Đối với các thông tin mới nhất được cập nhật lên công cụ phát triển, xem 

MPLAB IDE 

giúp đỡ trên mạng. Chọn menu Help, và sau đó chủ đề để mở một danh sách có 

sẵn trên mạng 

tập tin trợ giúp. 

dsPIC 

® 


DS51456B trang 2 

VỀ HƯỚNG DẪN NÀY 

Giao diện tài liệu 


Tài liệu này mô tả làm thế nào để sử dụng công cụ ngôn ngữ GNU để viết mã 

cho dsPIC 

® 

ứng dụng vi điều khiển. Cách bố trí tài liệu như sau: 

• Chương 1: Thư viện Overview- đưa ra một cái nhìn tổng quan của các thư 

viện. 

• Chương 2: DSP Library- liệt kê các chức năng thư viện cho các hoạt động 

DSP. 

• Chương 3: Thiết bị ngoại vi dsPIC Libraries- liệt kê các chức năng thư viện và 

macro cho 

phần mềm điện thoại dsPIC và phần cứng hoạt động ngoại vi. 

• Chương 4: Thư viện chuẩn C với Toán Functions- liệt kê các chức năng thư 

viện 

và macro cho hoạt động C chuẩn. 

• Chương 5: MPLAB C30 Built-in Functions- liệt kê các chức năng tích hợp củ 

C 

biên dịch, MPLAB C30. 

Lời nói đầu 

DS51456B-page 2 



ABOUT THIS GUIDE 

Document Layout 

This document describes how to use GNU language tools to write code for 

dsPIC 

® 

microcontroller applications. The document layout is as follows: 

• Chapter 1: Library Overview– gives an overview of libraries. 

• Chapter 2: DSP Library– lists the library functions for DSP operation. 

• Chapter 3: dsPIC Peripherals Libraries– lists the library functions and macros 

for 

dsPIC device software and hardware peripheral operation. 

• Chapter 4: Standard C Library with Math Functions– lists the library functions 

Ước sử dụng trong hướng dẫn này 

Hướng dẫn này sử dụng các công ước tài liệu sau đây: 

ƯỚC TÀI LIỆU 

Mô tả Đại diện Ví dụ 

Font Arial: 

Hướng dẫn nhân vật nghiêng sách Tham chiếu MPLAB IDE của người sử dụng 

Văn bản nhấn mạnh ... là onlycompiler ... 

Mũ ban đầu Một cửa sổ cửa sổ Output 

Một hộp thoại hộp thoại Settings 

Một lựa chọn trình đơn chọn Enable Lập trình viên 

Giá Một tên trường trong một cửa sổ hoặc

and macros for standard C operation. 

• Chapter 5: MPLAB C30 Built-in Functions– lists the built-in functions of the 

C 

compiler, MPLAB C30. 

Preface 


Conventions Used in this Guide 

This manual uses the following documentation conventions: 

DOCUMENTATION CONVENTIONS 

Description Represents Examples 

Arial font: 

Italic characters Referenced books MPLAB IDE User’s Guide 

Emphasized text ...is the onlycompiler... 

Initial caps A window the Output window 

A dialog the Settings dialog 

A menu selection select Enable Programmer 

Quotes A field name in a window or 

dialog 

“Save project before build” 

Underlined, italic text with 

right angle bracket 

A menu path File>Save 

Bold characters A dialog button ClickOK 

A tab Click the Powertab 

‘bnnnn A binary number where nis a 

digit 

‘b00100, ‘b10 

Text in angle brackets < > A key on the keyboard Press , 

Courier font: 

Plain Courier Sample source code #define START 

Filenames autoexec.bat 

File paths c:\mcc18\h 

Keywords _asm, _endasm, static 

Command-line options -Opa+, -OpaBit values 0, 1 

Italic Courier A variable argument file.o, where filecan be 

any valid filename 

0xnnnn A hexadecimal number where 

nis a hexadecimal digit 

0xFFFF, 0x007A 

thoại 

"Lưu dự án trước khi xây dựng" 

Gạch chân, in nghiêng với 

khung góc bên phải 

Một con đường menu File> Save 

Một nhân vật đậm ClickOK nút thoại 

Một tab Nhấp vào PowerTab 

'Bnnnn Một số nhị phân, nơi một NIS 

chữ số 

'B00100,' b10 

Văn bản trong dấu ngoặc nhọn Một phím trên bàn phím Nhấn , 

Phông chữ Courier: 

Đồng bằng chuyển phát nhanh Mẫu mã nguồn # xác định BẮT ĐẦU 

Tên tập tin autoexec.bat 

File đường dẫn C: \ mcc18 \ h 

Từ khóa _asm, _endasm, tĩnh 

Tùy chọn dòng lệnh -Opa +, -OpaBit giá trị 0, 1 

Nghiêng Courier Một lập luận biến file.o, nơi filecan được 

bất cứ tên tập tin hợp lệ 

0xnnnn Một số hệ thập lục phân nơi 

NIS một chữ số thập lục phân 

0xFFFF, 0x007A 

Dấu ngoặc vuông [] đối số tùy chọn mcc18 [tùy chọn] tập tin 

[Tùy chọn] 

Dấu ngoặc nhọn và ống 

nhân vật: {|} 

Lựa chọn loại trừ lẫn nhau 

lập luận; một lựa chọn hoặc 

errorlevel {0 | 1} 

Bầu dục ... thay thế lặp đi lặp lại var_name văn bản [, 

var_name ...] 

Đại diện cho mã được cung cấp bởi 

người sử dụng 

void main (void) 

{... 

} 

dsPIC 

® 

Thư viện Công cụ Ngôn ngữ

Square brackets [ ] Optional arguments mcc18 [options] file 

[options] 

Curly brackets and pipe 

character: { | } 

Choice of mutually exclusive 

arguments; an OR selection 

errorlevel {0|1} 

Ellipses... Replaces repeated text var_name [, 

var_name...] 

Represents code supplied by 

user 


{ ... 

} 

dsPIC 

® 



ĐỌC ĐỀ NGHỊ 


Tài liệu này mô tả chức năng thư viện dsPIC và các macro. Để biết thêm thông 

tin về 

dsPIC công cụ ngôn ngữ và sử dụng các công cụ khác, sau đây được khuyến cá 

đọc: 

README tập tin 

Đối với các thông tin mới nhất về các công cụ vi mạch, đọc các tập tin 

README liên quan (ASCII 

tập tin văn bản) kèm với phần mềm. 

Bắt đầu với dsPIC bằng các ngôn ngữ (DS51316) 

Hướng dẫn cài đặt và làm việc với các công cụ ngôn ngữ Microchip (MPLAB 

ASM30, 

MPLAB LINK30 và MPLAB C30) cho dsPIC điều khiển tín hiệu số (DSC của) 

Ví dụ bằng cách sử dụng mô phỏng dsPIC, MPLAB SIM30, được cung cấp. 

Hướng dẫn MPLAB ASM30, MPLAB LINK30 và tiện ích của người sử dụng 

(DS51317) 

Hướng dẫn sử dụng để lắp ráp dsPIC DSC, MPLAB ASM30, dsPIC DSC mối 

liên kết, 

MPLAB LINK30 và tiện ích DSC dsPIC khác nhau, bao gồm MPLAB LIB30 



Archiver / thư viện. 

RECOMMENDED READING 

This document describes dsPIC library functions and macros. For more 

information on 

dsPIC language tools and the use of other tools, the following are recommended 

reading: 

README Files 

For the latest information on Microchip tools, read the associated README 

files (ASCII 

text files) included with the software. 

Getting Started with dsPIC Language Tools (DS51316) 

A guide to installing and working with the Microchip language tools (MPLAB 

ASM30, 

MPLAB LINK30 and MPLAB C30) for dsPIC digital signal controllers 

(DSC’s). 

Examples using the dsPIC simulator, MPLAB SIM30, are provided. 

MPLAB ASM30, MPLAB LINK30 and Utilities User's Guide (DS51317) 

A guide to using the dsPIC DSC assembler, MPLAB ASM30, dsPIC DSC 

linker, 

MPLAB LINK30 and various dsPIC DSC utilities, including MPLAB LIB30 

archiver/librarian. 

MPLAB C30 C Compiler User's Guide (DS51284) 

A guide to using the dsPIC DSC C compiler. MPLAB LINK30 is used with this 

tool. 

GNU HTML documentation 

Hướng dẫn MPLAB C30 C Compiler của người sử dụng (DS51284) 

Hướng dẫn sử dụng trình biên dịch C dsPIC DSC. MPLAB LINK30 được sử 

dụng với công cụ này. 

Tài liệu GNU HTML 

Tài liệu này được cung cấp trên các công cụ ngôn ngữ CD-ROM. Nó mô tả các 

công cụ phát triển tiêu chuẩn GNU, khi mà những công cụ này được dựa. 

dsPIC30F gia đình Tổng quan (DS70043) 

Tổng quan về các thiết bị và kiến trúc dsPIC30F. 

Reference Manual dsPIC30F Lập trình (DS70030) 

Hướng dẫn lập trình để thiết bị dsPIC30F. Bao gồm mô hình của lập trình viên 

và 

hướng dẫn thiết lập. 

Trang web Microchip 

Các trang web của Microchip (http://www.microchip.com) có chứa một sự giàu 

có của 

tài liệu hướng dẫn. Bảng dữ liệu cá nhân, ứng dụng ghi chú, hướng dẫn và 

hướng dẫn sử dụng 

tất cả đều có sẵn để dễ dàng tải về. Tất cả tài liệu trong Adobe Acrobat (pdf) 

định dạng. 

Giải đáp thắc mắc 

Xem READMEfiles thông tin về các vấn đề chung không được giải quyết trong 

này 

tài liệu. 

Lời nói đầu

This documentation is provided on the language tool CD-ROM. It describes the 

standard GNU development tools, upon which these tools are based. 

dsPIC30F Family Overview (DS70043) 

An overview of the dsPIC30F devices and architecture. 

dsPIC30F Programmer’s Reference Manual (DS70030) 

Programmer’s guide to dsPIC30F devices. Includes the programmer’s model 

and 

instruction set. 

Microchip Web Site 

The Microchip web site (http://www.microchip.com) contains a wealth of 

documentation. Individual data sheets, application notes, tutorials and user’s 

guides 

are all available for easy download. All documentation is in Adobe Acrobat 

(pdf) format. 

TROUBLESHOOTING 

See the READMEfiles for information on common problems not addressed in 

this 

document. 

Preface 


THE MICROCHIP WEB SITE 

Microchip provides online support via our WWW site at www.microchip.com. 

This web 

site is used as a means to make files and information easily available to 

customers. 

Accessible by using your favorite Internet browser, the web site contains the 

following 

information: 

• Product Support– Data sheets and errata, application notes and sample 

programs, design resources, user’s guides and hardware support documents, 

latest software releases and archived software 

• General Technical Support– Frequently Asked Questions (FAQ), technical 

support requests, online discussion groups, Microchip consultant program 

member listing 

• Business of Microchip– Product selector and ordering guides, latest Microchip 

press releases, listing of seminars and events, listings of Microchip sales offices, 

distributors and factory representatives 

DEVELOPMENT SYSTEMS CUSTOMER CHANGE NOTIFICATION 

SERVICE 

Microchip’s customer notification service helps keep customers current on 

Microchip 

products. Subscribers will receive e-mail notification whenever there are 

changes, 


THE vi mạch WEBSITE 

Microchip cung cấp hỗ trợ trực tuyến thông qua trang web cá nhân của chúng 

tôi tại www.microchip.com. Web này 

trang web được sử dụng như một phương tiện để làm cho các tập tin và thông 

tin dễ dàng có sẵn cho khách hàng. 

Truy cập bằng cách sử dụng trình duyệt Internet yêu thích của bạn, các trang 

web có chứa những điều sau đây 

thông tin: 

• Sản phẩm tấm Support dữ liệu và errata, ứng dụng ghi chú và mẫu 

các chương trình, nguồn lực thiết kế, hướng dẫn sử dụng và các tài liệu hỗ trợ 

phần cứng, 

phiên bản phần mềm mới nhất và phần mềm lưu trữ 

• Tổng kỹ thuật Support câu hỏi thường gặp (FAQ), kỹ thuật 

yêu cầu hỗ trợ, các nhóm thảo luận trực tuyến, chương trình tư vấn Microchip 

danh sách thành viên 

• kinh doanh của Vi mạch chọn sản phẩm và đặt hàng hướng dẫn, vi mạch mới 

nhất 

thông cáo báo chí, danh sách các cuộc hội thảo và các sự kiện, danh sách các vi 

mạch văn phòng kinh doanh, 

các nhà phân phối và đại diện nhà máy 

HỆ THỐNG PHÁT TRIỂN KHÁCH HÀNG DỊCH VỤ THAY ĐỔI THÔNG 

BÁO 

Dịch vụ thông báo khách hàng của Microchip giúp giữ khách hàng hiện tại về v 

mạch 

sản phẩm. Thuê bao sẽ nhận được thông báo e-mail bất cứ khi nào có sự thay 

đổi, 

cập nhật, sửa đổi hoặc errata liên quan đến một gia đình phát triển sản phẩm 

hoặc công cụ định 

quan tâm. 

Để đăng ký, truy cập vào trang web của Microchip tại www.microchip.com, hã 

nhấp vào khách hàng 

Thay đổi Thông báo và làm theo hướng dẫn đăng ký. 

Các hệ thống phát triển loại nhóm sản phẩm là: 

• Compilers- Các thông tin mới nhất về các trình biên dịch Microchip C và ngô 

ngữ khác 

công cụ. Chúng bao gồm các MPLAB C17, MPLAB C18 và MPLAB C30 C 

trình biên dịch; 

Lắp ráp MPASM và MPLAB ASM30; MPLINK và MPLAB LINK30 

Các mối liên kết đối tượng; và MPLIB và MPLAB LIB30 đối tượng thư 

viện. 

• Emulators- Các thông tin mới nhất về Microchip emulators.This trong mạch 

bao gồm ICE 4000 MPLAB ICE 2000 và MPLAB. 

• In-Circuit Debuggers- Các thông tin mới nhất về vi mạch trong mạch 

gỡ rối, MPLAB ICD 2. 

• MPLAB IDE- Các thông tin mới nhất về Microchip MPLAB IDE, Windows

updates, revisions or errata related to a specified product family or development 

tool of 

interest. 

To register, access the Microchip web site at www.microchip.com, click on 

Customer 

Change Notification and follow the registration instructions. 

The Development Systems product group categories are: 

• Compilers– The latest information on Microchip C compilers and other 

language 

tools. These include the MPLAB C17, MPLAB C18 and MPLAB C30 C 

compilers; 

MPASM and MPLAB ASM30 assemblers; MPLINK and MPLAB 

LINK30 

object linkers; and MPLIB and MPLAB LIB30 object librarians. 

• Emulators– The latest information on Microchip in-circuit emulators.This 

includes the MPLAB ICE 2000 and MPLAB ICE 4000. 

• In-Circuit Debuggers– The latest information on the Microchip in-circuit 

debugger, MPLAB ICD 2. 

• MPLAB IDE– The latest information on Microchip MPLAB IDE, the 

Windows 

® 

Integrated Development Environment for development systems tools. This list 

is 

focused on the MPLAB IDE, MPLAB SIM and MPLAB SIM30 simulators, 

MPLAB 

IDE Project Manager and general editing and debugging features. 

• Programmers– The latest information on Microchip programmers. These 

include 

the MPLAB PM3 and PRO MATE 

® 

II device programmers and the PICSTART 

® 

Plus development programmer. 

dsPIC 

® 


® 

Môi trường phát triển tích hợp cho các hệ thống công cụ phát triển. Danh sách 

này là 

tập trung vào các IDE MPLAB, MPLAB SIM và MPLAB SIM30 mô phỏng, 

MPLAB 

IDE Quản lý dự án và chỉnh sửa và gỡ lỗi các tính năng nói chung. 

• Programmers- Các thông tin mới nhất về lập trình vi mạch. Chúng bao gồm 

MPLAB PM3 và PRO MATE 

® 

Lập trình thiết bị II và Picstart 

® 

Cộng với lập trình viên phát triển. 

dsPIC 

® 



HỖ TRỢ KHÁCH HÀNG 


Người sử dụng các sản phẩm vi mạch có thể nhận được hỗ trợ thông qua một số 

kênh: 

• Nhà phân phối hoặc đại diện 

• Văn phòng kinh doanh địa phương 

• Kỹ sư ứng dụng Field (FAE) 

• Hỗ trợ kỹ thuật 

• Phát triển hệ thống thông tin đường 

Khách hàng nên liên hệ với nhà phân phối, đại diện, lĩnh vực kỹ sư ứng dụng 

của họ 

(FAE) để hỗ trợ. Văn phòng kinh doanh tại địa phương cũng có sẵn để giúp 

khách hàng. Một danh sách các 

văn phòng bán hàng và các địa điểm được bao gồm trong phần sau của tài liệu 

này. 

Hỗ trợ kỹ thuật có sẵn thông qua trang web tại địa chỉ: 

http://support.microchip.com 

Ngoài ra, có một Hệ thống Thông tin Phát triển dòng trong đó liệt kê mới nhất 

các phiên bản của hệ thống sản phẩm phần mềm phát triển của vi mạch. Đây là 

đường 

cung cấp thông tin về cách khách hàng có thể nhận được bộ dụng cụ nâng cấp 

hiện có. 



Các con số Hệ thống thông tin phát triển dòng là: 

CUSTOMER SUPPORT 

Users of Microchip products can receive assistance through several channels: 

• Distributor or Representative 

• Local Sales Office 

• Field Application Engineer (FAE) 

• Technical Support 

1-800-755-2345 - Hoa Kỳ và hầu hết Canada 

1-480-792-7302 - Địa điểm quốc tế khác 

dsPIC 


THƯ VIỆN 

2004 Microchip Technology Inc DS51456B trang 7

• Development Systems Information Line 

Customers should contact their distributor, representative or field application 

engineer 

(FAE) for support. Local sales offices are also available to help customers. A 

listing of 

sales offices and locations is included in the back of this document. 

Technical support is available through the web site at: 

http://support.microchip.com 

In addition, there is a Development Systems Information Line which lists the 

latest 

versions of Microchip's development systems software products. This line also 

provides information on how customers can receive currently available upgrade 

kits. 

The Development Systems Information Line numbers are: 

1-800-755-2345 – United States and most of Canada 

1-480-792-7302 – Other International Locations 

dsPIC 


LIBRARIES 


Chapter 1. Library Overview 

1.1 INTRODUCTION 

A library is a collection of functions grouped for reference and ease of linking. 

See the 

MPLAB ASM30, MPLAB LINK30 and Utilities User's Guidefor more 

information about 

making and using libraries. 

1.1.1 Assembly Code Applications 

Free versions of the dsPIC language tool libraries are available from the 

Microchip web 

site. DSP and dsPIC peripheral libraries are provided with object files and 

source code. 

A math library containing functionsfrom the standard C header file is 

provided as an object file only. The completestandard C library is provided with 

the 

MPLAB C30 C compiler. 

1.1.2 C Code Applications 

The dsPIC language tool libraries are included in the c:\pic30_tools\lib 

directory, where c:\pic30_toolsis the MPLAB C30 C compiler install directory. 

These can be linked directly into an application with MPLAB LINK30. 

1.1.3 Chapter Organization 

This chapter is organized as follows: 

• OMF-Specific Libraries/StarTup Modules 

Chương 1 Thư viện Tổng quan 

1.1 GIỚI THIỆU 

Một thư viện là một tập hợp các chức năng được nhóm lại để tham khảo và dễ 

dàng liên kết. Xem 

MPLAB ASM30, MPLAB LINK30 và Guidefor tiện ích của người sử dụng 

thêm thông tin về 

lập và sử dụng thư viện. 

1.1.1 ứng dụng Mã hội 

Phiên bản miễn phí của các thư viện công cụ ngôn ngữ dsPIC có sẵn từ các 

trang web Microchip 

trang web. DSP và dsPIC thư viện ngoại vi được cung cấp với các tập tin đối 

tượng và mã nguồn. 

Một thư viện toán học có chứa functionsfrom tiêu chuẩn tập tin C tiêu đề là 

cung cấp như một tập tin duy nhất đối tượng. Thư viện completestandard C 

được cung cấp cùng với 

Trình biên dịch MPLAB C30 C. 

1.1.2 ứng dụng C Mã 

Các thư viện công cụ ngôn ngữ dsPIC có trong c: \ pic30_tools \ lib 

thư mục, trong đó c: \ pic30_toolsis trình biên dịch MPLAB C30 C thư mục cài 

đặt. 

Đây có thể được liên kết trực tiếp vào một ứng dụng với MPLAB LINK30. 

1.1.3 Tổ chức Chương 

Chương này được tổ chức như sau: 

• OMF-cụ thể thư viện / khởi động mô-đun 

• Startup Mã 

• Thư viện DSP 

• Thư viện ngoại vi dsPIC 

• Tiêu chuẩn C Thư viện (với các hàm toán học) 

• MPLAB C30 Built-in chức năng 

THƯ VIỆN 1.2 OMF-CỤ THỂ / MODULES STARTUP 

Tập tin thư viện và mô-đun khởi động là OMF specificto (Object Định dạng 

Module). Một OMF 

có thể là một trong các cách sau: 

• COFF - Đây là mặc định. 

• ELF - Các định dạng được sử dụng để gỡ lỗi các tập tin đối tượng là ELF lùn 

2.0. 

Có hai cách để chọn OMF: 

1 Đặt biến môi trường được gọi là PIC30_OMFfor tất cả các công cụ. 

2. Chọn OMF trên dòng lệnh khi envoking công cụ, ví dụ, -omf = omfor 

-momf = OMF. 

công cụ dsPIC đầu tiên sẽ tìm kiếm tập tin thư viện chung khi xây dựng ứng 

dụng của bạn (không OMF 

đặc điểm kỹ thuật). Nếu những điều này không thể được tìm thấy, công cụ sẽ 

xem xét chi tiết kỹ thuật của bạn OMF

• Startup Code 

• DSP Library 

• dsPIC Peripheral Libraries 

• Standard C Libraries (with Math Functions) 

• MPLAB C30 Built-in Functions 

1.2 OMF-SPECIFIC LIBRARIES/STARTUP MODULES 

Library files and startup modules are specificto OMF (Object Module Format). 

An OMF 

can be one of the following: 

• COFF - This is the default. 

• ELF - The debugging format used for ELF object files is DWARF 2.0. 

There are two ways to select the OMF: 

1. Set an environment variable called PIC30_OMFfor all tools. 

2. Select the OMF on the command line when envoking the tool, i.e., - 

omf=omfor 

-momf=omf. 

dsPIC tools will first look for generic library files when building your 

application (no OMF 

specification). If these cannot be found, the tools will look at your OMF 

specifications 

and determine which library file to use. 

As an example, if libdsp.ais not found and no environment variable or 

command-line opton is set, the file libdsp-coff.awill be used by default. 

dsPIC 

® 



1.3 STARTUP CODE 


In order to initialize variables in data memory, the linker creates a data 

initialization 

template. This template must be processed at startup, before the application 

proper 

takes control. For C programs, this function is performed by the startup modules 

in 

libpic30-coff.a (either crt0.oor crt1.o) or libpic30-elf.a (either 

crt0.eoor crt1.eo). Assembly language programs can utilize these modules 

directly by linking with the desired startup module file. The source code for the 

startup 

modules is provided in corresponding .sfiles. 

The primary startup module (crt0) initializes all variables (variables without 

initializers 

are set to zero as required by the ANSI standard) except for variables in the 

persistent 

và xác định các tập tin thư viện để sử dụng. 

Ví dụ, nếu libdsp.ais không tìm thấy và không có biến môi trường hoặc 

dòng lệnh opton được thiết lập, các tập tin libdsp-coff.awill được sử dụng theo 

mặc định. 

dsPIC 

® 



1.3 STARTUP MÃ 


Để khởi tạo các biến trong bộ nhớ dữ liệu, các mối liên kết tạo ra một khởi tạo 

dữ liệu 

mẫu. Mẫu này phải được xử lý lúc khởi động, trước khi áp dụng thích hợp 

mất quyền kiểm soát. Đối với chương trình C, chức năng này được thực hiện 

bằng các bộ phận khởi động trong 

libpic30-coff.a (hoặc crt1.o crt0.oor) hoặc libpic30-elf.a (hoặc 

crt0.eoor crt1.eo). Các chương trình ngôn ngữ lắp ráp có thể sử dụng các môđun 

trực tiếp bằng cách liên kết với các tập tin khởi động mô-đun mong muốn. Các 

mã nguồn cho khởi động 

module được cung cấp trong .sfiles tương ứng. 

Các mô-đun khởi động chính (crt0) khởi tạo tất cả các biến (biến mà không cần 

khởi tạo 

được thiết lập để không theo yêu cầu của tiêu chuẩn ANSI), trừ các biến trong 

dai dẳng 

phần dữ liệu. Các mô-đun khởi động thay thế (crt1) không thực hiện khởi tạo dữ 

liệu. 

Để biết thêm về mã khởi động, xem MPLAB ASM30, MPLAB LINK30 và tiện 

ích của người sử dụng 

Guideand, cho các ứng dụng C, hướng dẫn người sử dụng MPLAB C30 C 

Compiler. 

1.4 DSP THƯ VIỆN 

Thư viện DSP (libdsp-omf.a) cung cấp một tập hợp các hoạt động xử lý tín hiệu 

kỹ thuật số để một chương trình mục tiêu để thực hiện trên một dsPIC30F điều 

khiển tín hiệu số (DSC). 

Tổng cộng, 49 chức năng được hỗ trợ bởi các thư viện DSP. 

1,5 dsPIC PERIPHERAL THƯ VIỆN 

Các dsPIC (phần mềm và phần cứng) peripherallibraries cung cấp chức năng và 

macro 

lập và kiểm soát thiết bị ngoại vi dsPIC30F DSC. Ví dụ về sử dụng cũng có 

cung cấp trong mỗi chương liên quan đến cuốn sách này. 

Các thư viện này là bộ xử lý cụ thể và các hình thức libpDevice-omf.a, nơi 

Thiết bị = dsPIC số thiết bị (ví dụ, libp30F6014-coff.afor các dsPIC30F6014 

thiết bị.) 

1.6 TIÊU CHUẨN THƯ VIỆN C (với các hàm toán) 

Một bộ hoàn chỉnh của ANSI-89 thư viện phù hợp được cung cấp. Các tiêu 

chuẩn thư viện C 

tập tin được libc-omf.a (được viết bởi Dinkumware, một nhà lãnh đạo ngành

data section. The alternate startup module (crt1) performs no data initialization. 

For more on startup code, see the MPLAB ASM30, MPLAB LINK30 and 

Utilities User’s 

Guideand, for C applications, the MPLAB C30 C Compiler User’s Guide. 

1.4 DSP LIBRARY 

The DSP library (libdsp-omf.a) provides a set of digital signal processing 

operations to a program targeted for execution on a dsPIC30F digital signal 

controller (DSC). 

In total, 49 functions are supported by the DSP Library. 

1.5 dsPIC PERIPHERAL LIBRARIES 

The dsPIC (software and hardware) peripherallibraries provide functions and 

macros 

for setting up and controlling dsPIC30F DSC peripherals. Examples of use are 

also 

provided in each related chapter of this book. 

These libraries are processor-specific and of the form libpDevice-omf.a, where 

Device= dsPIC device number (e.g., libp30F6014-coff.afor the dsPIC30F6014 

device.) 

1.6 STANDARD C LIBRARIES (WITH MATH FUNCTIONS) 

A complete set of ANSI-89 conforming libraries are provided. The standard C 

library 

files are libc-omf.a(written by Dinkumware, an industry leader) and libm-omf.a 

(math functions, written by Microchip.) 

Additionally, some dsPIC standard C library helper functions, and standard 

functions 

that must be modified for use with dsPIC devices, are in libpic30-omf.a. 

A typical C application will require all three libraries. 

1.7 MPLAB C30 BUILT-IN FUNCTIONS 

The MPLAB C30 C compiler contains built-in functions that, to the developer, 

work like 

library functions. 

dsPIC 


LIBRARIES 


Chapter 2. DSP Library 


The DSP Library provides a set of digital signal processing operations to a 

program targeted for execution on a dsPIC30F digital signalcontroller (DSC). 

The library has been 

designed to provide you, the C software developer, with efficient 

implementation of the 

most common signal processing functions. In total, 49 functions are supported 

by the 

công nghiệp) và libm-omf.a 

(Chức năng toán học, được viết bởi Microchip.) 

Ngoài ra, một số tiêu chuẩn dsPIC chức năng trợ giúp thư viện C, và các chức 

năng tiêu chuẩn 

đó phải được sửa đổi để sử dụng với các thiết bị dsPIC, trong libpic30-omf.a. 

Một ứng dụng điển hình C sẽ yêu cầu tất cả ba thư viện. 

1,7 MPLAB C30 chức năng được xây dựng-IN 

Trình biên dịch MPLAB C30 C có tích hợp chức năng đó, để phát triển, làm 

việc như thế 

chức năng thư viện. 

dsPIC 


THƯ VIỆN 


Chương 2 DSP Thư viện 


Thư viện DSP cung cấp một tập hợp các hoạt động xử lý tín hiệu kỹ thuật số để 

một chương trình mục tiêu để thực hiện trên một số signalcontroller dsPIC30F 

(DSC). Các thư viện đã được 

được thiết kế để cung cấp cho bạn, các nhà phát triển phần mềm C, với việc 

thực hiện có hiệu quả các 

hầu hết các chức năng xử lý tín hiệu thông thường. Tổng cộng, 49 chức năng 

được hỗ trợ bởi 

Thư viện DSP. 

Mục tiêu hàng đầu của thư viện là để giảm thiểu thời gian thực hiện từng chức 

năng. Để 

đạt được mục tiêu này, Thư viện DSP chủ yếu viết bằng lắp ráp tối ưu hóa 

ngôn ngữ. Bằng cách sử dụng thư viện DSP, bạn có thể nhận ra lợi ích quan 

trọng trong thực hiện 

tốc độ trên mã tương đương viết bằng ANSI C.Additionally, kể từ khi Thư viện 

DSP có 

được thử nghiệm chặt chẽ, sử dụng thư viện DSP sẽ cho phép bạn rút ngắn ứng 

dụng của bạn 

thời gian phát triển. 


Một phiên bản miễn phí của thư viện này và tập tin tiêu đề liên quan của nó có 

sẵn từ 

Trang web của Microchip. Mã nguồn được bao gồm. 


Trình biên dịch MPLAB C30 C thư mục cài đặt (C: \ pic30_tools) chứa các 

thư mục con với các tập tin thư viện liên quan sau đây: 

• thư viện DSP lib- / lưu trữ các tập tin 

• src \ dsp- mã nguồn cho các chức năng thư viện và một tập tin thực thi để xây 

dựng lại thư viện 

• Hỗ trợ \ h- tập tin tiêu đề cho thư viện DSP

DSP Library. 

A primary goal of the library is to minimize the execution time of each function. 

To 

achieve this goal, the DSP Library is predominantly written in optimized 

assembly 

language. By using the DSP Library, you can realize significant gains in 

execution 

speed over equivalent code written in ANSI C.Additionally, since the DSP 

Library has 

been rigorously tested, using the DSP Library will allow you to shorten your 

application 

development time. 


A free version of this library and its associated header file is available from the 

Microchip web site. Source code is included. 


The MPLAB C30 C compiler install directory (c:\pic30_tools) contains the 

following subdirectories with library-related files: 

• lib– DSP library/archive files 

• src\dsp– source code for library functions and a batch file to rebuild the library 

• support\h– header file for DSP library 



• Using the DSP Library 

• Vector Functions 

• Window Functions 

• Matrix Functions 

• Filtering Functions 

• Transform Functions 

dsPIC 

® 



2.2 USING THE DSP LIBRARY 

2.2.1 Building with the DSP Library 


Building an application which utilizes the DSP Library requires only two files: 

dsp.h 

and libdsp-omf.a. dsp.his a header file which provides all the function 

prototypes, 

#definesand typedefsused by the library. libdsp-omf.ais the archived library 

file which contains all the individual object files for each library function. (See 

Section 1.2 “OMF-Specific Libraries/StarTup Modules”for more on OMF- 



• Sử dụng thư viện DSP 

• Chức năng Vector 

• Chức năng Window 

• Chức năng Matrix 

• Chức năng lọc 

• Chuyển đổi chức năng 

dsPIC 

® 



2.2 SỬ DỤNG THƯ VIỆN DSP 

2.2.1 Xây dựng với Thư viện DSP 


Xây dựng một ứng dụng mà sử dụng các thư viện DSP chỉ yêu cầu hai tập tin: 

dsp.h 

và libdsp-omf.a. dsp.his một tập tin tiêu đề, cung cấp tất cả các mẫu thử nghiệm 

chức năng, 

#definesand typedefsused bởi thư viện. libdsp-omf.ais thư viện lưu trữ 

tập tin có chứa tất cả các tập tin đối tượng riêng cho mỗi chức năng thư 

viện. (Xem 

Mục 1.2 "Thư viện OMF-cụ thể / khởi động mô-đun" để biết thêm về OMF cụ 

thể 

thư viện). 

Khi biên dịch một ứng dụng, dsp.hmust được tham chiếu (sử dụng # include) 

của tất cả các 

tập tin mã nguồn mà gọi một chức năng trong thư viện DSP hoặc sử dụng các 

ký hiệu hoặc typedefs của nó. 

Khi kết nối một ứng dụng, libdsp-omf.amust được cung cấp như một đầu vào 

cho các mối liên kết 

(Bằng cách sử dụng chuyển đổi -llinker --libraryor) như vậy mà các chức năng 

được sử dụng bởi 

ứng dụng có thể được kết nối vào ứng dụng. 

Các mối liên kết sẽ đặt các chức năng của thư viện DSP thành một phần văn bả 

đặc biệt có tên 

.libdsp. Điều này có thể được nhìn thấy bằng cách nhìn vào các tập tin bản đồ 

được tạo ra bởi các mối liên kết. 

2.2.2 Mô hình bộ nhớ 

Thư viện DSP được xây dựng withthe "mã nhỏ" và "dữ liệu nhỏ" mô hình bộ 

nhớ để tạo ra các thư viện nhỏ nhất có thể. Kể từ khi một số các DSP chức năng 

thư viện được viết 

trong C và sử dụng các thư viện nổi điểm của trình biên dịch, mối liên kết kịch 

bản MPLAB C30 

các tập tin đặt .libmand .libdsptext phần tiếp theo với nhau. Điều này đảm bảo 

rằng 

thư viện DSP có thể sử dụng các hướng dẫn an toàn RCALL để gọi cần dấu 

chấm động

specific 

libraries.) 

When compiling an application, dsp.hmust be referenced (using #include) by all 

source files which call a function in the DSP Library or use its symbols or 

typedefs. 

When linking an application, libdsp-omf.amust be provided as an input to the 

linker 

(using the --libraryor -llinker switch) such that the functions used by the 

application may be linked into the application. 

The linker will place the functions of the DSP library into a special text section 

named 

.libdsp. This may be seen by looking at the map file generated by the linker. 

2.2.2 Memory Models 

The DSP Library is built withthe “small code” and “small data” memory models 

to create the smallest library possible. Since several of the DSP library functions 

are written 

in C and make use of the compiler’s floating-point library, the MPLAB C30 

linker script 

files place the .libmand .libdsptext sections next to each other. This ensures that 

the DSP library may safely use the RCALL instruction to call the required 

floating-point 

routines in the floating-point library. 

2.2.3 DSP Library Function Calling Convention 

All the object modules within the DSP Library are compliant with the C 

compatibility 

guidelines for the dsPIC30F DSC and follow the function call conventions 

documented 

in the Microchip MPLAB C30 C Compiler User’s Guide. Specifically, 

functions may use 

the first eight working registers (W0 through W7) as function arguments. Any 

additional 

function arguments are passed through the stack. 

The working registers W0 to W7 are treated as scratch memory, and their values 

may 

not be preserved after the function call. On the other hand, if any of the working 

registers W8 to W13 are used by a function, the working register is first saved, 

the register 

is used and then its original value is restored upon function return. The return 

value of 

a (non void) function is available in working register W0 (also referred to as 

WREG). 

When needed, the run time software stack is used following the C system stack 

rules 

described in the MPLAB C30 Compiler User’s Guide. Based on these 

guidelines, the 

object modules of the DSP Library can be linked to either a C program, an 

assembly 

program or a program which combines code in both languages. 

thói quen trong thư viện nổi-điểm. 

2.2.3 DSP Thư viện Chức năng gọi hội nghị 

Tất cả các mô-đun đối tượng trong thư viện DSP là phù hợp với khả năng tương 

thích C 

hướng dẫn cho dsPIC30F DSC và thực hiện theo các quy ước chức năng gọi tài 

liệu 

trong hướng dẫn người sử dụng Microchip MPLAB C30 C Compiler. Cụ thể, c 

thể sử dụng chức năng 

tám đăng ký làm việc đầu tiên (W0 qua W7) như các đối số chức năng. Bất kỳ 

bổ sung 

đối số chức năng được chuyển qua ống khói. 

Các hoạt động đăng ký W0 để W7 đang được coi là bộ nhớ đầu, và giá trị của 

chúng có thể 

không được bảo quản sau khi cuộc gọi chức năng. Mặt khác, nếu một trong các 

hoạt động đăng ký W8 để W13 được sử dụng bởi một chức năng, đăng ký làm 

việc lần đầu tiên được cứu, đăng ký 

sử dụng và sau đó là giá trị ban đầu của nó được phục hồi chức năng sau khi trở 

lại. Giá trị trả lại 

một (không void) chức năng có sẵn trong hoạt động đăng ký W0 (còn được gọi 

là WREG). 

Khi cần thiết, thời gian chạy phần mềm ngăn xếp được sử dụng theo các quy tắ 

ngăn xếp hệ thống C 

được mô tả trong hướng dẫn người sử dụng MPLAB C30 Compiler. Dựa trên 

các nguyên tắc này, các 

module đối tượng của Thư viện DSP có thể được liên kết đến một chương trình 

C, một hội đồng 

chương trình hoặc một chương trình kết hợp mã trong cả hai ngôn ngữ. 

2.2.4 Các loại dữ liệu 

Các hoạt động được cung cấp bởi thư viện DSP đã được thiết kế để tận dụng lợ 

thế 

các tập lệnh DSP và các tính năng kiến trúc của dsPIC30F DSC. Trong ý nghĩa 

này, 

hầu hết các hoạt động được tính bằng số học phân đoạn. 

Thư viện DSP định nghĩa một kiểu phân đoạn từ một loại nguyên: 

ifndef phân đoạn 

typedef int phân đoạn; 

# endif 

Các loại dữ liệu phân đoạn được sử dụng để đại diện cho dữ liệu có 1 dấu hiệu 

bit và 15 

bit phân đoạn. Dữ liệu trong đó sử dụng định dạng này thường được gọi là 

"1,15" dữ liệu. 

DSP Thư viện 


Đối với các chức năng mà sử dụng số nhân, kết quả được tính toán bằng cách sử 

dụng ắc quy 40-bit, và "9,31" số học được sử dụng. Định dạng dữ liệu này có 9 

bit dấu hiệu / độ lớn và 

31 bit phân đoạn, trong đó quy định thêm tính toán khoảng không trên phạm vi 

(-1.00 Đến ~ + 1,00) được cung cấp bởi các định dạng 1.15. Đương nhiên khi 

các chức năng cung cấp

2.2.4 Data Types 

The operations provided by the DSP Library have been designed to take 

advantage of 

the DSP instruction set and architectural features of the dsPIC30F DSC. In this 

sense, 

most operations are computed using fractional arithmetic. 

The DSP Library defines a fractional type from an integer type: 

#ifndef fractional 

typedef int fractional; 

#endif 

The fractional data type is used to represent data that has 1 sign bit, and 15 

fractional bits. Data which uses this format is commonly referred to as “1.15” 

data. 

DSP Library 


For functions which use the multiplier, results are computed using the 40-bit 

accumulator, and “9.31” arithmetic is utilized. This data format has 9 

sign/magnitude bits and 

31 fractional bits, which provides for extra computational headroom above the 

range 

(-1.00 to ~+1.00) provided by the 1.15 format. Naturally when these functions 

provide 

a result, they revert to a fractional data type, with 1.15 format. 

The use of fractional arithmetic imposes some constraints on the allowable set 

of values to be input to a particular function. If these constraints are ensured, the 

operations 

provided by the DSP Library typically produce numerical results correct to 14 

bits. However, several functions perform implicit scaling to the input data 

and/or output results, 

which may decrease the resolution of the output values (when compared to a 

floating 

point implementation.) 

A subset of operations in the DSP Library,which require a higher degree of 

numerical 

resolution, do operate in floating point arithmetic. Nevertheless, the results of 

these 

operations are transformed into fractional values for integration with the 

application. 

The only exception to this is the MatrixInvertfunction which computes the 

inversion of a floating point matrix in floating point arithmetic, and provides the 

results in 

floating point format. 

2.2.5 Data Memory Usage 

The DSP Library performs no allocation of RAM, and leaves this task to you. If 

you do 

not allocate the appropriate amount of memory and align the data properly, 

undesired 

Kết quả là, họ trở lại với một kiểu dữ liệu phân đoạn, với các định dạng 1.15. 

Việc sử dụng số học phân đoạn áp đặt một số hạn chế trên các thiết lập cho 

phép các giá trị là đầu vào cho một chức năng cụ thể. Nếu những khó khăn này 

được đảm bảo, các hoạt động 

được cung cấp bởi thư viện DSP thường tạo ra kết quả tính toán chính xác đến 

14 bit. Tuy nhiên, một số chức năng thực hiện ngầm rộng để các dữ liệu đầu và 

và / hoặc kết quả đầu ra, 

mà có thể làm giảm độ phân giải của các giá trị đầu ra (khi so sánh với một nổi 

thực hiện điểm.) 

Một tập hợp các hoạt động trong thư viện DSP, đòi hỏi một mức độ cao hơn củ 

số 

độ phân giải, không hoạt động nổi điểm số học. Tuy nhiên, kết quả của những 

hoạt động được chuyển thành giá trị phân đoạn hội nhập với các ứng dụng. 

Ngoại lệ duy nhất này là MatrixInvertfunction mà tính đảo ngược của một ma 

trận điểm nổi trong số học dấu chấm, và cung cấp các kết quả trong 

nổi định dạng điểm. 

2.2.5 Bộ nhớ sử dụng dữ liệu 

Thư viện DSP thực hiện không phân bổ bộ nhớ RAM, và để lại nhiệm vụ này 

cho bạn. Nếu bạn làm 

không phân bổ số tiền thích hợp của bộ nhớ và sắp xếp dữ liệu đúng cách, 

không mong muốn 

Kết quả sẽ xảy ra khi chức năng thực hiện. Ngoài ra, để giảm thiểu thời gian 

thực hiện, 

Thư viện DSP sẽ làm không có kiểm tra trên các đối số chức năng cung cấp 

(bao gồm cả 

con trỏ đến bộ nhớ dữ liệu), để xác định xem họ có giá trị. 

Hầu hết các chức năng chấp nhận dữ liệu con trỏ như là đối số chức năng, có 

chứa các dữ liệu 

được vận hành trên, và thường cũng là vị trí để lưu kết quả. Để thuận tiện, 

hầu hết các chức năng trong thư viện DSP mong đợi đối số đầu vào của họ đượ 

phân bổ trong 

không gian mặc định bộ nhớ RAM (X-dữ liệu hoặc Y-Data), và đầu ra được lưu 

trữ trở lại 

không gian bộ nhớ RAM mặc định. Tuy nhiên, chức năng tính toán chuyên sâu 

hơn 

yêu cầu một số toán hạng nằm trong X-Data và Y-Data (hoặc bộ nhớ chương 

trình và 

Y-Data), để các hoạt động có thể tận dụng lợi thế của dữ liệu kép khả năng lấy 

kiến trúc dsPIC30F. 

2.2.6 CORCON Đăng ký sử dụng 

Nhiều chức năng của thư viện DSP đặt điện thoại dsPIC30F thành một hoạt 

động đặc biệt 

chế độ bằng cách thay đổi đăng ký CORCON. Trên sự xâm nhập của các chức 

năng này, các 

CORCON đăng ký được đẩy vào stack. Sau đó nó được sửa đổi để thực hiện 

một cách chính xác 

mong muốn hoạt động, và cuối cùng đăng ký CORCON được xuất hiện từ ngăn 

xếp để bảo toàn giá trị ban đầu của nó. Cơ chế này cho phép các thư viện để 

thực thi như một cách chính xác như

esults will occur when the function executes. In addition, to minimize 

execution time, 

the DSP Library will do no checking on the provided function arguments 

(including 

pointers to data memory), to determine if they are valid. 

Most functions accept data pointers as function arguments, which contain the 

data to 

be operated on, and typically also the location to store the result. For 

convenience, 

most functions in the DSP Library expect their input arguments to be allocated 

in the 

default RAM memory space (X-Data or Y-Data), and the output to be stored 

back into 

the default RAM memory space. However, the more computational intensive 

functions 

require that some operands reside in X-Data and Y-Data (or program memory 

and 

Y-Data), so that the operation can take advantage of the dual data fetch 

capability of 

the dsPIC30F architecture. 

2.2.6 CORCON Register Usage 

Many functions of the DSP Library place the dsPIC30F device into a special 

operating 

mode by modifying the CORCON register. On the entry of these functions, the 

CORCON register is pushed to the stack. It is then modified to correctly 

perform the 

desired operation, and lastly the CORCON register is popped from the stack to 

preserve its original value. This mechanism allows the library to execute as 

correctly as 

possible, without disrupting CORCON setting. 

When the CORCON register is modified, it is typically set to 0x00F0. This 

places the 

dsPIC30F device into the following operational mode: 

• DSP multiplies are set to used signed and fractional data 

• Accumulator saturation is enabled for Accumulator A and Accumulator B 

• Saturation mode is set to 9.31 saturation (Super Saturation) 

• Data Space Write Saturation is enabled 

• Program Space Visibility disabled 

• Convergent (unbiased) rounding is enabled 

For a detailed explanation of the CORCON register and its effects, refer to the 

dsPIC30F Family Reference Manual. 

dsPIC 

® 


có thể, mà không làm gián đoạn thiết lập CORCON. 

Khi đăng ký CORCON được sửa đổi, nó thường được thiết lập để 0x00F0. Điều 

này đặt các 

dsPIC30F thiết bị vào chế độ hoạt động sau đây: 

• bội DSP được thiết lập để được sử dụng chữ ký và dữ liệu phân đoạn 

• ác bão hòa được kích hoạt cho ác A và B ác 

• Chế độ bão hòa được thiết lập là 9,31 bão hòa (Super Saturation) 

• Không gian dữ liệu Viết Saturation được kích hoạt 

• Không gian Chương trình Tầm nhìn bị vô hiệu hóa 

• hội tụ (không thiên vị) làm tròn được kích hoạt 

Đối với một lời giải thích chi tiết về đăng ký CORCON và ảnh hưởng của nó, 

hãy tham khảo 

dsPIC30F Family Reference Manual. 

dsPIC 

® 



2.2.7 tràn và Saturation Xử lý 


Thư viện DSP thực hiện computationsusing nhất 9,31 bão hòa, nhưng phải lưu 

trữ 

đầu ra của chức năng định dạng 1.15. Nếu trong quá trình hoạt động của ắc quy 

trong bão hòa sử dụng (đi trên 0x7F FFFFFFFF hoặc thấp hơn 0x80 0000 

0000), các bit bão hòa tương ứng (SA hoặc SB) trong Statusregister sẽ được 

thiết lập. Bit này sẽ ở lại thiết lập 

cho đến khi nó bị xóa. Điều này cho phép bạn kiểm tra SA hoặc SB sau khi 

chức năng thực hiện và 

để xác định xem hành động cần được thực hiện để mở rộng các dữ liệu đầu vào 

cho các chức năng. 

Tương tự như vậy, nếu tính toán thực hiện với kết quả ác trong một tràn (các 

ắc đi trên 0x00 7FFF FFFF hoặc thấp hơn 0xFF 8000 0000), bit tràn tương ứng 

(viêm khớp hoặc OB) trong tình trạng đăng ký sẽ được thiết lập.Không giống 

như các bit trạng thái SA và SB, viêm khớp và OB sẽ không ở lại cho đến khi 

thiết lập theyare xóa. Những bit này được cập nhật mỗi 

Hiện một thao tác dùng ắc được thực hiện. Nếu vượt quá phạm vi quy định này 

đánh dấu một sự kiện quan trọng, bạn nên cho phép bẫy ác tràn 

thông qua các bit hình trứng và OVBTE vào sổ đăng ký INTCON1. Điều này s 

có tác dụng 

tạo ra một lỗi số học Trap ngay asthe tình trạng tràn xảy ra, và bạn 

sau đó có thể có những hành động cần thiết. 

2.2.8 Tích hợp với ngắt và một RTOS 

Thư viện DSP có thể dễ dàng được tích hợp vào một ứng dụng mà sử dụng ngắ 

hoặc một RTOS, nhưng nguyên tắc nhất định phải được tuân thủ. Để giảm thiểu 

thời gian thực hiện, các 

DSP Thư viện sử dụng DOloops, REPEATloops, modulo địa chỉ và đảo ngược 

bit 



giải quyết. Mỗi thành phần này là một nguồn tài nguyên hữu hạn phần cứng trê

2.2.7 Overflow and Saturation Handling 

The DSP Library performs most computationsusing 9.31 saturation, but must 

store the 

output of the function in 1.15 format. If during the course of operation the 

accumulator 

in use saturates (goes above 0x7F FFFFFFFF or below 0x80 0000 0000), the 

corresponding saturation bit (SA or SB) in the Statusregister will be set. This bit 

will stay set 

until it is cleared. This allows you to inspect SA or SB after the function 

executes and 

to determine if action should be taken to scale the input data to the function. 

Similarly, if a computation performed with the accumulator results in an 

overflow (the 

accumulator goes above 0x00 7FFF FFFF or below 0xFF 8000 0000), the 

corresponding overflow bit (OA or OB) in the Status register will be set. Unlike 

the SA and SB status bits, OA and OB will not stay set until theyare cleared. 

These bits are updated each 

time an operation using accumulator is executed. If exceeding this specified 

range 

marks an important event, you are advised to enable the Accumulator Overflow 

Trap 

via the OVATE and OVBTE bits in the INTCON1 register. This will have the 

effect of 

generating an Arithmetic Error Trap as soon asthe Overflow condition occurs, 

and you 

may then take the required action. 

2.2.8 Integrating with Interrupts and an RTOS 

The DSP Library may easily be integrated into an application which utilizes 

interrupts 

or an RTOS, yet certain guidelines must be followed. To minimize execution 

time, the 

DSP Library utilizes DOloops, REPEATloops, modulo addressing and bitreversed 

addressing. Each of these components is a finite hardware resource on the 

dsPIC30F 

DSC, and the background code must consider the use of each resource when 

disrupting execution of a DSP Library function. 

When integrating with the DSP Library, you must examine the Function Profile 

of each 

function description to determine which resources are used. If a library function 

will be 

interrupted, it is your responsibility to save and restore the contents of all 

registers used 

by the function, including the state of the DO, REPEATand special addressing 

hardware. Naturally this also includes saving and restoring the contents of the 

CORCON 

and Status registers. 

2.2.9 Rebuilding the DSP Library 

dsPIC30F 

DSC, và mã nền phải xem xét việc sử dụng tài nguyên mỗi khi 

làm gián đoạn thực hiện một chức năng DSP Thư viện. 

Khi kết hợp với Thư viện DSP, bạn phải kiểm tra các chức năng của từng hồ sơ 

Mô tả chức năng để xác định các nguồn lực được sử dụng. Nếu một chức năng 

thư viện sẽ 

bị gián đoạn, bạn có trách nhiệm lưu và khôi phục lại nội dung của tất cả các 

đăng ký sử dụng 

bởi các chức năng, bao gồm cả trạng thái của DO, REPEATand đặc biệt phần 

cứng giải quyết. Đương nhiên điều này cũng bao gồm lưu trữ và khôi phục lại 

nội dung của CORCON 

và tình trạng đăng ký. 

2.2.9 Xây dựng lại thư viện DSP 

Một tập tin thực thi có tên makedsplib.batis cung cấp để xây dựng lại thư viện 

DSP. Các 

Trình biên dịch MPLAB C30 là cần thiết để xây dựng lại các thư viện DSP, và 

hàng loạt tập tin giả 

trình biên dịch được cài đặt trong thư mục mặc định, c: \ pic30_tools. Nếu công 

cụ ngôn ngữ của bạn được cài đặt trong một thư mục khác, bạn phải thay đổi 

các thư mục trong 

tập tin thực thi để phù hợp với vị trí của công cụ ngôn ngữ của bạn. 



2.3 chức năng VECTOR 

Phần này trình bày các khái niệm về một vector phân đoạn, như xem xét bởi 

DSP 

Thư viện, và mô tả các chức năng cá nhân đó thực hiện các hoạt động vector. 

2.3.1 Fractional Vector hoạt động 

Một vector phân đoạn là một tập hợp các giá trị số, các yếu tố vector, phân bổ 

liên tục kế nhau trong bộ nhớ, với người đầu tiên elementAt địa chỉ bộ nhớ thấp 

nhất. Một từ 

bộ nhớ (hai byte) được sử dụng để lưu trữ các giá trị của mỗi phần tử, và số 

lượng này 

phải được hiểu như là một phân số đại diện trong các định dạng dữ liệu 1.15. 

Một con trỏ giải quyết các yếu tố đầu tiên của vector được sử dụng như một xử 

lý cung cấp 

tiếp cận với mỗi giá trị vector. Địa chỉ của phần tử đầu tiên được gọi là 

địa chỉ cơ sở của vector. Bởi vì mỗi phần tử của vector là 16 bit, các cơ sở 

địa chỉ mustbe liên kết đến một địa chỉ mặc. 

Một thỏa thuận chiều của một vector chứa để lưu trữ bộ nhớ 

mô hình của thiết bị, do đó yếu tố thứ n của một vector N phần tử có thể được 

truy cập 

từ địa chỉ cơ sở BA của vector như: 

BA + 2 (n-1), cho 1 ≤n ≤N. 

Các hệ số 2 được sử dụng vì các byte khả năng của dsPIC30F giải quyết 

thiết bị.

A batch file named makedsplib.batis provided to rebuild the DSP library. The 

MPLAB C30 compiler is required to rebuild the DSP library, and the batch file 

assumes 

that the compiler is installed in the default directory, c:\pic30_tools. If your 

language tools are installed in a different directory, you must modify the 

directories in the 

batch file to match the location of your language tools. 

DSP Library 


2.3 VECTOR FUNCTIONS 

This section presents the concept of a fractional vector, as considered by the 

DSP 

Library, and describes the individual functions which perform vector operations. 

2.3.1 Fractional Vector Operations 

A fractional vector is a collection of numerical values, the vector elements, 

allocated 

contiguously in memory, with the first elementat the lowest memory address. 

One word 

of memory (two bytes) is used to store the value of each element, and this 

quantity 

must be interpreted as a fractional number represented in the 1.15 data format. 

A pointer addressing the first element of the vector is used as a handle which 

provides 

access to each of the vector values. The address of the first element is referred 

to as 

the base address of the vector. Because each element of the vector is 16 bits, the 

base 

address mustbe aligned to an even address. 

The one dimensional arrangement of a vector accommodates to the memory 

storage 

model of the device, so that the n-th element of an N-element vector can be 

accessed 

from the vector's base address BA as: 

BA + 2(n-1), for 1 ≤n ≤N. 

The factor of 2 is used because of the byte addressing capabilities of the 

dsPIC30F 

device. 

Unary and binary fractional vector operations are implemented in this library. 

The operand vector in a unary operation is called the source vector. In a binary 

operation the 

first operand is referred to as the source one vector, and the second as the source 

two 

vector. Each operation applies some computation to one or several elements of 

the 

source vector(s). Some operations produce a result which is a scalar value (also 

to be 

interpreted as a 1.15 fractional number), while other operations produce a result 

Hoạt động vector phân đoạn nguyên phân và nhị phân được thực hiện trong thư 

viện này. Các vector toán hạng trong một hoạt động nguyên phân được gọi là 

vector nguồn. Trong một hoạt động nhị phân 

toán hạng đầu tiên được gọi là một trong những nguồn vector, và thứ hai là 

nguồn hai 

vector. Mỗi hoạt động áp dụng một số tính toán cho một hoặc một số yếu tố của 

vector nguồn (s). Một số hoạt động sản xuất một kết quả mà là một giá trị vô 

hướng (cũng được 

hiểu là một số phân đoạn 1.15), trong khi các hoạt động khác tạo ra một kết quả 

mà 

là một vector. Khi kết quả cũng là một vector, điều này được gọi là vector đích. 

Một số hoạt động dẫn đến một vector cho phép tính toán tại chỗ. Điều này có 

nghĩa 

kết quả của các hoạt động được đặt trở lại vào vector nguồn (hoặc nguồn một 

vector 

cho các hoạt động nhị phân). Trong trường hợp này, các vector điểm đến được 

cho là (vật lý) thay thế 

nguồn (một) vector. Nếu một hoạt động có thể được tính tại chỗ, nó được chỉ 

định như vậy 

trong các ý kiến được cung cấp với mô tả chức năng. 

Đối với một số hoạt động nhị phân, hai toán hạng có thể giống nhau (vật lý) 

nguồn 

vector, có nghĩa là các hoạt động được áp dụng cho các vector nguồn và bản 

thân. Nếu loại 

tính toán là có thể cho một hoạt động nào đó, nó được chỉ định như vậy trong 

các ý kiến 

cung cấp với mô tả chức năng. 

Một số hoạt động có thể được cả hai tự áp dụng và tính toán tại chỗ. 

Tất cả các hoạt động vector phân đoạn trong thislibrary mất như một tham số số 

phần tử 

(Số phần tử) của vector toán hạng (s). Căn cứ vào giá trị của tham số này 

giả định sau đây được thực hiện: 

a) Tổng kích thước của tất cả các vectơ tham gia vào một hoạt động cụ thể nằm 

trong 

phạm vi của bộ nhớ dữ liệu có sẵn cho các thiết bị mục tiêu. 

b) Trong trường hợp hoạt động nhị phân, cardinalities của cả hai vectơ toán 

hạng phải 

tuân thủ các quy tắc của vector đại số (đặc biệt, xem các ghi nhận cho 

VectorConvolveand VectorCorrelatefunctions). 

c) Các vector đích mustbe đủ để chấp nhận các kết quả của một lớn 

hoạt động. 

dsPIC 

® 



2.3.2 Xem xét tài khoản 


a) Không kiểm tra ranh giới được thực hiện bởi các chức năng này. Trong phạm

which 

is a vector. When the result is also a vector, this is referred to as the destination 

vector. 

Some operations resulting in a vector allow computation in place. This means 

the 

results of the operation are placed back into the source vector (or the source one 

vector 

for binary operations). In this case, the destination vector is said to (physically) 

replace 

the source (one) vector. If an operation can be computed in place, it is indicated 

as such 

in the comments provided with the function description. 

For some binary operations, the two operands can be the same (physical) source 

vector, which means the operation is applied to the source vector and itself. If 

this type 

of computation is possible for a given operation,it is indicated as such in the 

comments 

provided with the function description. 

Some operations can be both self applicable and computed in place. 

All the fractional vector operations in thislibrary take as an argument the 

cardinality 

(number of elements) of the operand vector(s). Based on the value of this 

argument the 

following assumptions are made: 

a) The sum of sizes of all the vectors involved in a particular operation falls 

within 

the range of available data memory for the target device. 

b) In the case of binary operations, the cardinalities of both operand vectors 

must 

obey the rules of vector algebra (particularly, see remarks for the 

VectorConvolveand VectorCorrelatefunctions). 

c) The destination vector mustbe large enough to accept the results of an 

operation. 

dsPIC 

® 



2.3.2 User Considerations 


a) No boundary checking is performed by these functions. Out of range 

cardinalities 

(including zero length vectors) as well as nonconforming use of source vector 

sizes in binary operations may produce unexpected results. 

b) The vector addition and subtraction operations could lead to saturation if the 

sum 

of corresponding elements in the source vector(s) is greater than 1-2 

vi cardinalities 

(Bao gồm cả không vector chiều dài) cũng như sử dụng không phù hợp của 

vector nguồn 

kích thước trong các hoạt động nhị phân có thể tạo ra kết quả bất ngờ. 

b) Các cộng và trừ các hoạt động vector có thể dẫn đến bão hòa nếu tổng 

các yếu tố tương ứng trong vector nguồn (s) lớn hơn 1-2 

-15 

hoặc 

nhỏ hơn -1,0. Tương tự, các vector chấm sản phẩm và các hoạt động năng lượn 

có thể dẫn đến bão hòa nếu tổng sản phẩm lớn hơn 1-2 

-15 

hoặc nhỏ hơn 

hơn -1,0. 

c) Đó là khuyến cáo rằng tình trạng đăng ký (SR) được xem xét sau khi hoàn 

thành 

mỗi lần gọi hàm. Đặc biệt, người dùng có thể kiểm tra việc SA, SB và SAB cờ 

sau 

hàm trả về để xác định độ bão hòa xảy ra. 

d) Tất cả các chức năng đã được thiết kế để hoạt động trên các vector phân đoạn 

phân bổ 

trong không gian bộ nhớ RAM mặc định (X-Y-dữ liệu hoặc dữ liệu). 

e) Các hoạt động đó trả về một vector đích có thể được lồng vào nhau, do đó, v 

dụ 

nếu: 

a = OP1 (b, c), với b = OP2 (d) và c = op3 (e, f), sau đó 

a = OP1 (OP2 (d), op3 (e, f)) 

2.3.3 Bình luận khác 

Mô tả các chức năng giới hạn phạm vi của nó những gì có thể được coi là 

thường xuyên 

sử dụng các hoạt động này. Tuy nhiên, vì không có kiểm tra biên giới được thự 

hiện trong quá trình 

tính toán của các chức năng này, bạn có quyền tự do để giải thích các hoạt động 

của mình và 

kết quả là nó phù hợp với một số nhu cầu đặc biệt. 

Ví dụ, trong khi tính toán VectorMaxfunction, chiều dài của vector nguồn 

có thể là lớn hơn numElems. Trong trường hợp này, các chức năng sẽ được sử 

dụng để tìm 

giá trị tối đa onlyamong các numElemselements đầu tiên của vector nguồn. 

Một ví dụ khác, bạn có thể quan tâm đến việc thay thế numElemselements của 

một vector điểm nằm giữa Nand N + numElems-1, với numElemselements từ 

một vector nguồn nằm giữa các yếu tố mand M + numElems-1. Sau đó, 

VectorCopyfunction có thể được sử dụng như sau: 

phân đoạn * DSTV [DST_ELEMS] = {...}; 

phân đoạn * srcV [SRC_ELEMS] = {...};

-15 

or 

smaller than -1.0. Analogously, the vector dot product and power operations 

could lead to saturation if the sum of products is greater than 1-2 

-15 

or smaller 

than -1.0. 

c) It is recommended that the Status register (SR) be examined after completion 

of 

each function call. In particular, users can inspect the SA, SB and SAB flags 

after 

the function returns to determine if saturation occurred. 

d) All the functions have been designed to operate on fractional vectors 

allocated 

in default RAM memory space (X-Data or Y-Data). 

e) Operations which return a destination vector can be nested, so that for 

instance 

if: 

a = Op1 (b, c), with b = Op2 (d), and c = Op3 (e, f), then 

a = Op1 (Op2 (d), Op3 (e, f)) 

2.3.3 Additional Remarks 

The description of the functions limits its scope to what could be considered the 

regular 

usage of these operations. However, since no boundary checking is performed 

during 

computation of these functions, you have the freedom to interpret the operation 

and its 

results as it fits some particular needs. 

For instance, while computing the VectorMaxfunction, the length of the source 

vector 

could be greater than numElems. In this case, the function would be used to find 

the 

maximum value onlyamong the first numElemselements of the source vector. 

As another example, you may be interested in replacing numElemselements of a 

destination vector located between Nand N+numElems-1, with 

numElemselements from 

a source vector located between elements Mand M+numElems-1. Then, the 

VectorCopyfunction could be used as follows: 

fractional* dstV[DST_ELEMS] = {...}; 

fractional* srcV[SRC_ELEMS] = {...}; 

int n = NUM_ELEMS; 

int N = N_PLACE; /* NUM_ELEMS+N ≤DST_ELEMS */ 

int M = M_PLACE; /* NUM_ELEMS+M ≤SRC_ELEMS */ 

fractional* dstVector = dstV+N; 

int n = NUM_ELEMS; 

int N = N_PLACE; / * NUM_ELEMS + N ≤DST_ELEMS * / 

int M = M_PLACE; / * NUM_ELEMS + M ≤SRC_ELEMS * / 

phân đoạn * dstVector = DSTV + N; 

phân đoạn * srcVector = srcV + M; 

dstVector VectorCopy = (n, dstVector, srcVector); 

Cũng trong bối cảnh này, VectorZeroPadfunction có thể hoạt động tại chỗ, nơi 

bây giờ 

DSTV = srcV, numElemsis số phần tử atthe đầu vector nguồn 

bảo tồn, và numZerosthe số phần tử ở đuôi vector để thiết lập để không. 

Khả năng khác có thể được khai thác từ thực tế là không có kiểm tra ranh giới 

thực hiện. 



2.3.4 Chức năng cá nhân 

Trong phần tiếp theo, các chức năng cá nhân thực hiện các hoạt động vector 

được mô tả. 

VectorAdd 

Mô tả: VectorAddadds giá trị của mỗi elementin nguồn một vector 

với đối tác của mình trong nguồn hai véc tơ, và đặt kết quả trong 

vector đích. 

Bao gồm: dsp.h 

Nguyên mẫu: ở ngoài phân đoạn * VectorAdd ( 

int numElems, 

phân đoạn * DSTV, 

phân đoạn * srcV1, 

phân đoạn * srcV2 

); 

Đối số: numElems số phần tử trong vector nguồn 

DSTV con trỏ tới vector điểm đến 

con trỏ srcV1 nguồn một vector 

con trỏ srcV2 nguồn hai vector 

Quay trở lại giá trị: Con trỏ trỏ tới địa chỉ cơ sở của vector đích. 

Ghi chú: Nếu giá trị tuyệt đối của srcV1 [n] + srcV2 [n] là lớn hơn 1-2 

-15 

, 

hoạt động này dẫn đến độ bão hòa cho các phần tử n-thứ. 

Chức năng này có thể được tính tại chỗ. 

Chức năng này có thể tự áp dụng. 

Source File: vadd.asm

fractional* srcVector = srcV+M; 

dstVector = VectorCopy (n, dstVector, srcVector); 

Also in this context, the VectorZeroPadfunction can operate in place, where 

now 

dstV = srcV, numElemsis the number of elements atthe beginning of source 

vector 

to preserve, and numZerosthe number of elements at the vector tail to set to 

zero. 

Other possibilities can be exploited from the fact that no boundary checking is 

performed. 

DSP Library 


2.3.4 Individual Functions 

In what follows, the individual functions implementing vector operations are 

described. 

VectorAdd 

Description: VectorAddadds the value of each elementin the source one vector 

with its counterpart in the source two vector, and places the result in the 

destination vector. 

Include: dsp.h 

Prototype: extern fractional* VectorAdd ( 

int numElems, 

fractional* dstV, 

fractional* srcV1, 

fractional* srcV2 

); 

Arguments: numElems number of elements in source vectors 

dstV pointer to destination vector 

srcV1 pointer to source one vector 

srcV2 pointer to source two vector 

Return Value: Pointer to base address of destination vector. 

Remarks: If the absolute value of srcV1[n] + srcV2[n]is larger than 1-2 

-15 

, 

this operation results in saturation for the n-th element. 

This function can be computed in place. 

This function can be self applicable. 

Source File: vadd.asm 

Function Profile: System resources usage: 

W0..W4 used, not restored 

ACCA used, not restored 

Chức năng thông tin: sử dụng nguồn tài nguyên của hệ thống: 

W0..W4 sử dụng, không được khôi phục 

ACCA được sử dụng, không được khôi phục 

CORCON lưu, sử dụng, phục hồi 

DOand REPEATinstruction sử dụng: 

1 DOinstructions cấp 

không REPEATinstructions 

Từ chương trình (hướng dẫn 24-bit): 

13 

Chu kỳ (bao gồm cả cuộc gọi C-chức năng và trả các chi phí): 

17 + 3 (numElems) 

dsPIC 

® 


DS51456B trang 16 2004 Microchip Technology Inc 

VectorConvolve 

Mô tả: VectorConvolvecomputes chập giữa hai nguồn 

vectơ, và lưu trữ các kết quả trong một vector đích. Kết quả là 

tính như sau: 

, 0 ≤n

CORCON saved, used, restored 

DOand REPEATinstruction usage: 

1 level DOinstructions 

no REPEATinstructions 

Program words (24-bit instructions): 

13 

Cycles (including C-function call and return overheads): 

17 + 3(numElems) 

dsPIC 

® 


DS51456B-page 16 2004 Microchip Technology Inc. 


Description: VectorConvolvecomputes the convolution between two source 

vectors, and stores the result in a destination vector. The result is 

computed as follows: 

, for 0 ≤n

This function can beself applicable. 

Source File: vcon.asm 

yn() xk()hn k – () 

k0= 

n 

∑ = 

yn() xk()hn k – () 

knM–1+ = 

n 

∑ = 

yn() xk()hn k – () 

knM–1+ = 

N1– 

∑ = 

DSP Library 


. 



W8..W10 saved, used, restored 







58 


For N = numElems1, and M = numElems2, 

, for M

fractional* srcV 

); 

Arguments: numElems number of elements in source vector 


srcV pointer to source vector 


Remarks: The destination vector mustalready exist. Destination vectors must 

have, at least, numElemselements, but could be longer. 

This function can be computed in place. See Additional Remarks at the 

end of the section for comments on this mode of operation. 

Source File: vcopy.asm 




no DOinstructions 

1 level REPEATinstructions 


6 


12 + numElems 

VectorConvolve (Continued) 

28 13M 6 m 

m1= 

M 

∑ NM– ()73M + () ++ + 

28 13M 6 m 

m1= 

M 

∑ ++ 

dsPIC 

® 



VectorCorrelate 

Description: VectorCorrelatecomputes the correlation between two source 

vectors, and stores the result in a destination vector. The result is 

computed as follows: 

, for 0 ≤n

size M (with M ≤N.) 


Prototype: extern fractional* VectorCorrelate ( 

int numElems1, 

int numElems2, 




); 

Arguments: numElems1 number of elements in source one vector 

numElems2 number of elements in source two vector 





Remarks: The number of elements in the source two vector mustbe less than or 

equal to the number of elements in the source one vector. 

The destination vector mustalready exist, with exactly 

numElems1+numElems2-1number of elements. 


This function uses VectorConvolve. 

Source File: vcor.asm 


W0..W7 used, not restored, 

plus resources from VectorConvolve 



no REPEATinstructions, 

plus DO/REPEATinstructions from 



14, 

plus program words from VectorConvolve 


19 + floor(M/2)*3, with M = numElems2, 

plus cycles from VectorConvolve. 

Note:In the description of VectorConvolvethe number of cycles 

reported includes 4 cycles of C-function call overhead. Thus, the 

number of actual cycles from VectorConvolveto add to 

Lưu ý: Trong các mô tả về số VectorConvolvethe của chu kỳ 

báo cáo bao gồm 4 chu kỳ của C-chức năng gọi điện trên không. Như vậy, 

số chu kỳ thực tế từ VectorConvolveto thêm vào 

VectorCorrelateis 4 ít hơn bất cứ số được báo cáo cho một 

đứng một mình VectorConvolve. 

rn () xk () yk n + () 

k0 = 

N1- 

Σ = 



. 

VectorDotProduct 

Mô tả: VectorDotProductcomputes tổng các sản phẩm giữa 

các yếu tố tương ứng của nguồn một và nguồn hai vectơ. 


Nguyên mẫu: ở ngoài VectorDotProduct phân đoạn ( 

int numElems, 



); 




Quay trở lại giá trị: Giá trị tổng sản phẩm. 

Ghi chú: Nếu giá trị tuyệt đối của ofproducts tiền lớn hơn 1-2 

-15 

, Điều này 

hoạt động dẫn đến bão hòa. 


Source File: vdot.asm 








không REPEATinstructions

VectorCorrelateis 4 less than whatever number is reported for a 

stand alone VectorConvolve. 

rn () xk()yk n + () 

k0= 

N1– 

∑ = 

DSP Library 


. 

VectorDotProduct 

Description: VectorDotProductcomputes the sum of the products between 

corresponding elements of the source one and source two vectors. 


Prototype: extern fractional VectorDotProduct ( 

int numElems, 



); 




Return Value: Value of the sum of products. 

Remarks: If the absolute value of the sum ofproducts is larger than 1-2 

-15 

, this 

operation results in saturation. 


Source File: vdot.asm 










13 



13 



VectorMax 

Mô tả: VectorMaxfinds yếu tố cuối cùng trong vector nguồn có giá trị 

lớn hơn hoặc bằng bất kỳ yếu tố vector trước. Sau đó, kết quả đầu ra 

rằng giá trị tối đa và chỉ số của phần tử tối đa. 


Nguyên mẫu: ở ngoài phân đoạn VectorMax ( 

int numElems, 

phân đoạn * srcV, 

int * maxIndex 

); 


srcV con trỏ tới vector nguồn 

maxIndex con trỏ để giữ cho chỉ số (cuối cùng) yếu tố tối đa 

Quay trở lại giá trị: giá trị tối đa trong vector. 

Ghi chú: Nếu srcV [i] = srcV [j] = maxVal, và i


VectorMax 

Description: VectorMaxfinds the last element in the source vector whose value 

is 

greater than or equal to any previous vector element. Then, it outputs 

that maximum value and the index of the maximum element. 


Prototype: extern fractional VectorMax ( 

int numElems, 

fractional* srcV, 

int* maxIndex 

); 



maxIndex pointer to holder for index of (last) maximum element 

Return Value: Maximum value in vector. 

Remarks: If srcV[i] = srcV[j] = maxVal, and i < j, then 

*maxIndex= j. 

Source File: vmax.asm 

dsPIC 

® 


VectorMin 

Mô tả: VectorMinfinds yếu tố cuối cùng trong vector nguồn có giá trị 

nhỏ hơn hoặc bằng bất kỳ yếu tố vector trước. Sau đó, nó ra mà 

giá trị tối thiểu và chỉ số của các yếu tố tối thiểu. 


Nguyên mẫu: ở ngoài VectorMin phân đoạn ( 

int numElems, 


int * minIndex 

); 



minIndex con trỏ để giữ cho chỉ số (cuối cùng) yếu tố tối thiểu 

Quay trở lại giá trị: giá trị tối thiểu trong vector. 

Ghi chú: Nếu srcV [i] = srcV [j] = minVal, và i srcV[n+1], 0 ≤n < numElems-1 

VectorMin 

Description: VectorMinfinds the last element in the source vector whose value 

is 

13 


14 

nếu numElems = 1 

20 + 8 (numElems-2) 

nếu srcV [n] ≥ srcV [n + 1], 0 ≤n

less than or equal to any previous vector element. Then, it outputs that 

minimum value and the index of the minimum element. 


Prototype: extern fractional VectorMin ( 

int numElems, 


int* minIndex 

); 



minIndex pointer to holder for index of (last) minimum element 

Return Value: Minimum value in vector. 

Remarks: If srcV[i] = srcV[j] = minVal, and i < j, then 

*minIndex= j. 

Source File: vmin.asm 







13 


14 

if numElems= 1 

20 + 8(numElems-2) 

if srcV[n] ≥ srcV[n+1], 0 ≤n < numElems-1 

19 + 7(numElems-2) 

if srcV[n] < srcV[n+1], 0 ≤n < numElems-1 

VectorMax (Continued) 

DSP Library 


VectorMultiply 

Description: VectorMultiplymultiplies the value of each element in source one 

vector with its counterpart in source two vector, and places the result in 

the corresponding element of destination vector. 


Prototype: extern fractional* VectorMultiply ( 

int numElems, 

Nguyên mẫu: ở ngoài phân đoạn * VectorMultiply ( 

int numElems, 




); 






Bình luận: hoạt động này còn được gọi là vector yếu tố-by-yếu tố 

nhân. 



Source File: vmul.asm 









14 



VectorNegate 

Mô tả: VectorNegatenegates (thay đổi là dấu hiệu của) các giá trị của 

các yếu tố trong vector nguồn, và những nơi họ ở đích đến 

vector. 


Nguyên mẫu: ở ngoài phân đoạn * VectorNeg ( 

int numElems, 


phân đoạn * srcV 

); 


DSTV con trỏ tới vector điểm đến




); 






Remarks: This operation is also known as vector element-by-element 

multiplication. 



Source File: vmul.asm 









14 



VectorNegate 

Description: VectorNegatenegates (changes the sign of) the values of the 

elements in the source vector, and places them in the destination 

vector. 


Prototype: extern fractional* VectorNeg ( 

int numElems, 



); 







Bình luận: Giá trị đảo dấu của 0x8000 được thiết lập để 0x7FFF. 


Source File: vneg.asm 

dsPIC 

® 











16 



VectorPower 

Mô tả: VectorPowercomputes sức mạnh của một vector nguồn là tổng của 

các ô vuông của các yếu tố của nó. 


Prototype: fractionalVectorPower ở ngoài ( 

int numElems, 

phân đoạn * srcV 

); 



Quay trở lại giá trị: Giá trị của quyền lực của vector (tổng bình phương). 

Ghi chú: Nếu giá trị tuyệt đối của tổng bình phương lớn hơn 1-2 

-15 

, Điều này 

kết quả hoạt động trong độ bão hòa 

Chức năng này có thể áp dụng beself. 

Source File: vpow.asm 


W0..W2 sử dụng, không được khôi phục

Remarks: The negated value of 0x8000 is set to 0x7FFF. 


Source File: vneg.asm 

dsPIC 

® 











16 



VectorPower 

Description: VectorPowercomputes the power of a source vector as the sum of 

the squares of its elements. 


Prototype: extern fractionalVectorPower ( 

int numElems, 


); 



Return Value: Value of the vector’s power (sum of squares). 

Remarks: If the absolute value of the sum of squares is larger than 1-2 

-15 

, this 

operation results in saturation 


Source File: vpow.asm 



W4 used, not restored 


W4 sử dụng, không được khôi phục 




không DOinstructions 

1 REPEATinstructions cấp 


12 



VectorNegate (Tiếp theo) 



VectorScale 

Mô tả: VectorScalescales (bội) các giá trị của tất cả các yếu tố trong 

vector nguồn bởi một giá trị quy mô, và đặt kết quả ở đích đến 

vector. 


Nguyên mẫu: ở ngoài phân đoạn * VectorScale ( 

int numElems, 



phân đoạn sclVal 

); 




sclVal giá trị mà quy mô các yếu tố vector 


Bình luận: sclValmust là một số phân đoạn trong định dạng 1.15. 


Source File: vscl.asm 













12 



VectorNegate (Continued) 

DSP Library 


VectorScale 

Description: VectorScalescales (multiplies) the values of all the elements in the 

source vector by a scale value, and places the result in the destination 

vector. 


Prototype: extern fractional* VectorScale ( 

int numElems, 



fractional sclVal 

); 




sclVal value by which to scale vector elements 


Remarks: sclValmust be a fractional number in 1.15 format. 


Source File: vscl.asm 









14 


14 



VectorSubtract 

Mô tả: VectorSubtractsubtracts giá trị của mỗi phần tử trong mã nguồn 

hai vector từ đối tác của mình trong nguồn một véc tơ, và những nơi 

dẫn đến việc vector đích. 


Nguyên mẫu: ở ngoài phân đoạn * VectorSubtract ( 

int numElems, 




); 



con trỏ srcV1 nguồn onevector (để trừ) 

srcV2 con trỏ đến nguồn hai vector (số bị trừ) 


Ghi chú: Nếu giá trị tuyệt đối của srcV1 [n] - srcV2 [n] là lớn hơn 1-2 

-15 

, 

hoạt động này dẫn đến độ bão hòa cho các phần tử n-thứ. 



dsPIC 

® 



Source File: vsub.asm 




ACCB sử dụng, không được khôi phục 







VectorSubtract 

Description: VectorSubtractsubtracts the value of each element in the source 

two vector from its counterpart in the source one vector, and places the 

result in the destination vector. 


Prototype: extern fractional* VectorSubtract ( 

int numElems, 




); 



srcV1 pointer to source onevector (minuend) 

srcV2 pointer to source two vector (subtrahend) 


Remarks: If the absolute value of srcV1[n] - srcV2[n]is larger than 1-2 

-15 

, 

this operation results in saturation for the n-th element. 



dsPIC 

® 



14 



VectorZeroPad 

Mô tả: VectorZeroPadcopies vector nguồn vào đầu 

(Đã có sẵn) vector đích, và sau đó lấp đầy với các số không 

numZeroselements của vector điểm còn lại: 

DSTV [n] = srcV [n], 0 ≤n



VectorZeroPad 

Description: VectorZeroPadcopies the source vector into the beginning of the 

(already existing) destination vector, and then fills with zeros the 

remaining numZeroselements of destination vector: 

dstV[n]= srcV[n], 0 ≤n < numElems 

dstV[n]= 0, numElems≤n

plus program words from VectorCopy 


18 + numZeros 

plus cycles from VectorCopy. 

Note:In the description of VectorCopy, the number of cycles reported 

includes 3 cycles of C-function calloverhead. Thus, the number of 

actual cycles from VectorCopyto add to VectorCorrelateis 3 less 

than whatever number is reported for a stand alone VectorCopy. 

VectorZeroPad (Continued) 

dsPIC 

® 


thành 

mỗi lần gọi hàm. 

d) Kể từ khi chức năng khởi tạo cửa sổ được thực hiện trong C, tham khảo ý 

kiến 

tài liệu điện tử bao gồm trong bản phát hành cho số cập nhật lên chu kỳ 

thông tin. 


Trong phần tiếp theo, các chức năng cá nhân thực hiện các hoạt động cửa sổ là 

mô tả. 

BartlettInit 

Mô tả: BartlettInitinitializes một cửa sổ Barlett numElems dài. 


Nguyên mẫu: ở ngoài phân đoạn * BartlettInit ( 



int numElems, 

2.4 WINDOW FUNCTIONS 

A window is a vector with a specific value distribution within its domain (0 ≤n 

< 

numElems). The particular value distribution depends on the characteristics of 

the 

window being generated. 

Given a vector, its value distribution may be modified by applying a window to 

it. In 

these cases, the window musthave the same number of elements as the vector to 

modify. 

Before a vector can be windowed, the window must be created. Window 

initialization 

operations are provided which generate the values of the window elements. For 

higher 

numerical precision, these values are computed in floating point arithmetic, and 

the 

resulting quantities stored as 1.15 fractionals. 

To avoid excessive overhead when applying a window operation, a particular 

window 

could be generated once and used many times during the execution of the 

program. 

Thus, it is advisable to store the window returned by any of the initialization 

operations 

in a permanent (static) vector. 


a) All the window initialization functions have been designed to generate 

window 

vectors allocated in default RAM memory space (X-Data or Y-Data). 

b) The windowing function is designed to operate on vectors allocated in default 

RAM memory space (X-Data or Y-Data). 

* phân đoạn cửa sổ 

); 

Đối số: numElems số phần tử trong cửa sổ 

cửa sổ con trỏ đến cửa sổ phải được khởi tạo 

Quay trở lại giá trị: Con trỏ trỏ tới địa chỉ cơ sở của cửa sổ khởi tạo. 

Chú ý: windowvector mustalready tồn tại, với chính xác numElemsnumber 

các yếu tố. 

Source File: initbart.c 





W8..W14 lưu, sử dụng, không được khôi phục 


Không 


Xem các tập tin "Readme cho dsPIC bằng các ngôn ngữ Libraries.txt" cho 

thông tin này. 


Xem các tập tin "Readme cho dsPIC bằng các ngôn ngữ Libraries.txt" cho 

thông tin này. 

BlackmanInit 

Mô tả: BlackmanInitinitializes một Blackman (3 học kỳ) cửa sổ của chiều dài 

numElems. 


Nguyên mẫu: ở ngoài phân đoạn * BlackmanInit (

c) It is recommended that the Status register (SR) be examined after completion 

of 

each function call. 

d) Since the window initialization functions are implemented in C, consult the 

electronic documentation included in the release for up-to-date cycle count 

information. 


In what follows, the individual functions implementing window operations are 

described. 

BartlettInit 

Description: BartlettInitinitializes a Barlett window of length numElems. 


Prototype: extern fractional* BartlettInit ( 

int numElems, 

fractional* window 

); 

Arguments: numElems number of elements in window 

window pointer to window to be initialized 

Return Value: Pointer to base address of initialized window. 

Remarks: The windowvector mustalready exist, with exactly numElemsnumber 

of elements. 

Source File: initbart.c 

int numElems, 


); 






Source File: initblck.c 





Không 


Xem file "readme.txt" trong pic30_tools \ src \ DSP cho thông tin này. 



BartlettInit (Tiếp theo) 

dsPIC 

® 


DSP Library 



HammingInit 




W8..W14 saved, used, not restored 


None 


See the file “Readme for dsPIC Language Tools Libraries.txt” for 

this information. 


See the file “Readme for dsPIC Language Tools Libraries.txt” for 

this information. 

BlackmanInit 

Description: BlackmanInitinitializes a Blackman (3 terms) window of length 

numElems. 


Mô tả: HammingInitinitializes một cửa sổ Hamming của numElems dài. 


Nguyên mẫu: ở ngoài phân đoạn * HammingInit ( 

int numElems, 


); 






Source File: inithamm.c 



W8..W14 lưu, sử dụng, không được khôi phục

Prototype: extern fractional* BlackmanInit ( 

int numElems, 


); 





of elements. 

Source File: initblck.c 





None 


See the file “readme.txt” in pic30_tools\src\dsp for this information. 



BartlettInit (Continued) 

dsPIC 

® 



HammingInit 

Description: HammingInitinitializes a Hamming window of length numElems. 


Prototype: extern fractional* HammingInit ( 

int numElems, 


); 





of elements. 

Source File: inithamm.c 




Không 





HanningInit 

Mô tả: HanningInitinitializes một cửa sổ Hanning của numElems dài. 


Nguyên mẫu: ở ngoài phân đoạn * HanningInit ( 

int numElems, 


); 






Source File: inithann.c 





Không 







KaiserInit 

Mô tả: KaiserInitinitializes một cửa sổ Kaiser với hình dạng xác định bằng 

Lập luận của betaValand numElems dài. 


Nguyên mẫu: ở ngoài phân đoạn * KaiserInit ( 

int numElems, 

* phân đoạn cửa sổ, 

nổi betaVal 

);



None 





HanningInit 

Description: HanningInitinitializes a Hanning window of length numElems. 


Prototype: extern fractional* HanningInit ( 

int numElems, 


); 





of elements. 

Source File: inithann.c 





None 





DSP Library 


KaiserInit 

Description: KaiserInitinitializes a Kaiser window with shape determined by 

argument betaValand of length numElems. 


Prototype: extern fractional* KaiserInit ( 

int numElems, 

fractional* window, 

float betaVal 



betaVal tham số hình cửa sổ 




Source File: initkais.c 





Không 





VectorWindow 

Mô tả: VectorWindowapplies một cửa sổ để một vector nguồn được đưa ra, và 

các cửa hàng 

vector cửa sổ kết quả trong một vector đích. 


Nguyên mẫu: ở ngoài phân đoạn * VectorWindow ( 

int numElems, 




); 




cửa sổ con trỏ đến cửa sổ khởi tạo 


Chú ý: musthave windowvector đã được khởi tạo, với chính xác 

numElemsnumber của các yếu tố. 



Chức năng này sử dụng VectorMultiply. 

Source File: dowindow.asm 

dsPIC 

®

); 



betaVal window shaping parameter 



of elements. 

Source File: initkais.c 





None 





VectorWindow 

Description: VectorWindowapplies a window to a given source vector, and 

stores 

the resulting windowed vector in a destination vector. 


Prototype: extern fractional* VectorWindow ( 

int numElems, 




); 




window pointer to initialized window 


Remarks: The windowvector musthave already been initialized, with exactly 

numElemsnumber of elements. 



This function uses VectorMultiply. 

Source File: dowindow.asm 





nguồn lực từ VectorMultiply 



không REPEATinstructions, 

cộng với DO / REPEATfrom VectorMultiply 


3, 

cộng thêm từ chương trình từ VectorMultiply 


9, 

cộng với chu kỳ từ VectorMultiply. 

Lưu ý: Trong các mô tả về số VectorMultiplythe của chu kỳ 


số chu kỳ thực tế từ VectorMultiplyto thêm vào 

VectorWindowis 3 ít hơn bất cứ số được báo cáo cho một đứng 

một mình 

VectorMultiply. 

VectorWindow (Tiếp theo) 



2,5 chức năng MATRIX 

Phần này trình bày các khái niệm về một ma trận phân đoạn, như xem xét bởi 

DSP 

Thư viện, và mô tả các chức năng cá nhân đó thực hiện hoạt động ma trận. 

2.5.1 Fractional hoạt động Matrix 

Một ma trận phân đoạn là một tập hợp các giá trị số, các yếu tố ma trận, phân b 

liên tục kế nhau trong bộ nhớ, với người đầu tiên elementAt địa chỉ bộ nhớ thấp 

nhất. Một từ 

bộ nhớ (hai byte) được sử dụng để lưu trữ các giá trị của mỗi phần tử, và số 

lượng này 

phải được hiểu như là một phân số đại diện trong định dạng 1.15. 

Một con trỏ địa chỉ phần tử đầu tiên của ma trận được sử dụng như một xử lý 

cung cấp 

tiếp cận với mỗi giá trị ma trận. Địa chỉ của phần tử đầu tiên được gọi là 

địa chỉ cơ sở của ma trận. Bởi vì mỗi phần tử của ma trận là 16 bit, các cơ sở 

địa chỉ mustbe liên kết đến một địa chỉ mặc. 

Việc bố trí hai chiều của một matrixis mô phỏng trong lĩnh vực bộ nhớ lưu trữ 

bằng cách đặt các thành phần của nó được tổ chức hàng để lớn. Như vậy, giá trị 

đầu tiên trong bộ nhớ là

dsPIC 

® 





resources from VectorMultiply 



no REPEATinstructions, 

plus DO/REPEATfrom VectorMultiply 


3, 

plus program words from VectorMultiply 


9, 

plus cycles from VectorMultiply. 

Note:In the description of VectorMultiplythe number of cycles 


number of actual cycles from VectorMultiplyto add to 

VectorWindowis 3 less than whatever number is reported for a stand 

alone 

VectorMultiply. 

VectorWindow (Continued) 

DSP Library 


2.5 MATRIX FUNCTIONS 

This section presents the concept of a fractional matrix, as considered by the 

DSP 

Library, and describes the individual functions which perform matrix 

operations. 

2.5.1 Fractional Matrix Operations 

A fractional matrix is a collection of numerical values, the matrix elements, 

allocated 

contiguously in memory, with the first elementat the lowest memory address. 

One word 

of memory (two bytes) is used to store the value of each element, and this 

quantity 

must be interpreted as a fractional number represented in 1.15 format. 

A pointer addressing the first element of the matrix is used as a handle which 

provides 

access to each of the matrix values. The address of the first element is referred 

to as 

các yếu tố đầu tiên của dòng đầu tiên. Tiếp sau đó là phần còn lại của các phần 

tử của hàng đầu tiên. 

Sau đó, các phần tử của hàng thứ hai được lưu trữ, và như vậy, cho đến khi tất 

cả các hàng trong 

bộ nhớ. Bằng cách này, các phần tử ở hàng r và cột c của một ma trận với hàng 

R và C 

cột nằm từ ma trận cơ sở địa chỉ cử nhân tại: 

BA + 2 (C (r-1) + c-1), cho 1 ≤r ≤R, 1 ≤c ≤C. 

Lưu ý rằng hệ số 2 được sử dụng vì các byte khả năng của địa chỉ 

dsPIC30F. 

Hoạt động ma trận phân đoạn nguyên phân và nhị phân được thực hiện trong 

thư viện này. Các 

ma trận toán hạng trong một hoạt động nguyên phân được gọi là nguồn ma 

trận. Trong một hoạt động nhị phân 

toán hạng đầu tiên được gọi là nguồn một ma trận, và ma trận thứ hai là 

nguồn hai ma trận. Mỗi hoạt động áp dụng một số tính toán cho một hoặc một 

số 

các yếu tố của nguồn ma trận (CES). Các hoạt động hợp kết quả trong một ma 

trận, gọi là 

ma trận đích. 

Một số hoạt động kết quả trong một ma trận cho phép tính toán tại chỗ. Điều 

này có nghĩa 

kết quả của các hoạt động được đặt trở lại vào ma trận nguồn (hoặc nguồn một 

ma trận 

cho một hoạt động nhị phân). Trong trường hợp này, ma trận điểm đến được 

cho là (vật lý) thay thế 

nguồn (một) ma trận. Nếu một hoạt động có thể được tính tại chỗ, nó được chỉ 

định như 

như trong các ý kiến được cung cấp với mô tả chức năng. 

Đối với một số hoạt động nhị phân, hai toán hạng có thể giống nhau (vật lý) 

nguồn 

ma trận, có nghĩa là các hoạt động được áp dụng cho ma trận nguồn và bản 

thân. Nếu loại 

tính toán là có thể cho một hoạt động nào đó, nó được chỉ định như vậy trong 

các ý kiến 

cung cấp với mô tả chức năng. 

Một số hoạt động có thể tự áp dụng và tính toán tại chỗ. 

dsPIC 

® 




Tất cả các hoạt động ma trận phân đoạn trong thư viện này có số lượng hàng 

như các đối số 

và số lượng các cột của ma trận toán hạng (CES). Căn cứ vào các giá trị của các 

đối số giả định sau đây được thực hiện: 

a) Tổng kích thước của tất cả các ma trận tham gia vào một hoạt động cụ thể 

nằm trong

the base address of the matrix. Because each element of the matrix is 16 bits, the 

base 

address mustbe aligned to an even address. 

The two dimensional arrangement of a matrixis emulated in the memory storage 

area 

by placing its elements organized in row major order. Thus, the first value in 

memory is 

the first element of the first row. It is followed by the rest of the elements of the 

first row. 

Then, the elements of the second row are stored, and so on, until all the rows are 

in 

memory. This way, the element at row r and column c of a matrix with R rows 

and C 

columns is located from the matrix base address BA at: 

BA + 2(C(r-1) + c-1), for 1 ≤r ≤R, 1 ≤c ≤C. 

Note that the factor of 2 is used because of the byte addressing capabilities of 

the 

dsPIC30F. 

Unary and binary fractional matrix operations are implemented in this library. 

The 

operand matrix in a unary operation is called the source matrix. In a binary 

operation 

the first operand is referred to as the source one matrix, and the second matrix 

as the 

source two matrix. Each operation applies some computation to one or several 

elements of the source matrix(ces). The operations result in a matrix, referred to 

as the 

destination matrix. 

Some operations resulting in a matrix allow computation in place. This means 

the 

results of the operation is placed back into the source matrix (or the source one 

matrix 

for a binary operation). In this case, the destination matrix is said to (physically) 

replace 

the source (one) matrix. If an operation can be computed in place, it is indicated 

as 

such in the comments provided with the function description. 

For some binary operations, the two operands can be the same (physical) source 

matrix, which means the operation is applied to the source matrix and itself. If 

this type 

of computation is possible for a given operation,it is indicated as such in the 

comments 

provided with the function description. 

Some operations can be self applicable and computed in place. 

dsPIC 

® 

phạm vi của bộ nhớ dữ liệu có sẵn cho các thiết bị mục tiêu. 

b) Trong trường hợp hoạt động nhị phân số hàng và cột của toán hạng 

ma trận mustobey các quy tắc của vector đại số; tức là, cho ma trận cộng và trừ 

hai ma trận phải có cùng số hàng và cột, 

trong khi cho phép nhân ma trận, số lượng các cột của toán hạng phải đầu tiên 

giống như số lượng hàng của toán hạng thứ hai. Nguồn ma trận 

các hoạt động đảo ngược phải vuông (cùng một số hàng như của 

cột), và không ít (yếu tố quyết định của nó khác nhau hơn không). 

c) ma trận điểm đến mustbe đủ lớn để chấp nhận các kết quả của một hoạt động 


a) Không kiểm tra ranh giới được thực hiện bởi các chức năng này. Trong phạm 

vi kích thước 

(Bao gồm cả hàng không và / hoặc không có ma trận cột) cũng như sử dụng 

không phù hợp 

nguồn kích thước ma trận trong hoạt động nhị phân có thể tạo ra kết quả bất 

ngờ. 

b) Các cộng và trừ các hoạt động ma trận có thể dẫn đến bão hòa nếu tổng 

các yếu tố tương ứng trong nguồn (s) ma trận (CES) lớn hơn 1-2 

-15 

hoặc 

nhỏ hơn -1. 

c) Các hoạt động nhân ma trận có thể dẫn đến bão hòa nếu tổng sản phẩm 

các hàng và cột bộ kết quả tương ứng trong giá trị lớn hơn 1-2 

-15 

hoặc 

nhỏ hơn -1. 

d) Đó là khuyến cáo rằng tình trạng đăng ký (SR) được kiểm tra sau khi hoàn 

thành 


sau 


e) Tất cả các chức năng đã được thiết kế để hoạt động trên các ma trận phân 

đoạn phân bổ 

trong không gian bộ nhớ RAM mặc định (X-Y-dữ liệu hoặc dữ liệu). 

e) Các hoạt động đó trả về một ma trận điểm đến có thể được lồng vào nhau, do 

đó ví dụ 

nếu: 


a = OP1 (OP2 (d), op3 (e, f)) 

2.5.3 Bình luận khác 

Mô tả các chức năng giới hạn phạm vi của nó những gì có thể được coi là 

thường xuyên 

sử dụng các hoạt động này. Tuy nhiên, vì không có kiểm tra biên giới được thự 

hiện trong quá trình 

tính toán của các chức năng này, bạn có quyền tự do để giải thích các hoạt động




All the fractional matrix operations in this library take as arguments the number 

of rows 

and the number of columns of the operand matrix(ces). Based on the values of 

these 

argument the following assumptions are made: 

a) The sum of sizes of all the matrices involved in a particular operation falls 

within 

the range of available data memory for the target device. 

b) In the case of binary operations the number of rows and columns of the 

operand 

matrices mustobey the rules of vector algebra; i.e., for matrix addition and 

subtraction the two matrices must have the same number of rows and columns, 

while for matrix multiplication, the number of columns of the first operand must 

be the same as the number of rows of the second operand. The source matrix to 

the inversion operation must be square (the same number of rows as of 

columns), and non-singular (its determinant different than zero). 

c) The destination matrix mustbe large enough to accept the results of an 

operation. 


a) No boundary checking is performed by these functions. Out of range 

dimensions 

(including zero row and/or zero column matrices) as well as nonconforming use 

of source matrix sizes in binary operations may produce unexpected results. 

b) The matrix addition and subtraction operations could lead to saturation if the 

sum 

of corresponding elements in the source(s) matrix(ces) is greater than 1-2 

-15 

or 

smaller than -1. 

c) The matrix multiplication operation could lead to saturation if the sum of 

products 

of corresponding row and column sets results in a value greater than 1-2 

-15 

or 

hnical Support1. 

d) It is recommended that the status register (SR) is examined after completion 

of 


after 


e) All the functions have been designed to operate on fractional matrices 

allocated 

của mình và 

kết quả là nó phù hợp với một số nhu cầu đặc biệt. 

Ví dụ, trong khi tính toán MatrixMultiplyfunction, kích thước của 

intervining ma trận không nhất thiết cần phải được {numRows1, 

numCos1Rows2} cho 

nguồn một ma trận, {numCols1Rows2, numCols2} cho nguồn hai ma trận, và 

{numRows1, 

numCols2} cho ma trận đích. Trong thực tế, tất cả các thatis cần thiết là kích 

thước của chúng lớn 

đủ để trong quá trình tính toán các con trỏ cũng không vượt quá mức phạm vi 

bộ nhớ của họ. 

Một ví dụ khác, khi một ma trận nguồn kích thước {numrows, numCols} là 

hoán, ma trận điểm có kích thước {numCols, numrows}. Như vậy, đúng cách 

nói các hoạt động có thể được tính ở vị trí onlyif ma trận nguồn là hình vuông. 

Tuy nhiên, các hoạt động có thể được áp dụng thành công tại chỗ để không 

vuông 

ma trận; tất cả những gì cần phải được giữ trong tâm trí là implicitchange kích 

thước. 



Khả năng khác có thể được khai thác từ thực tế là không có kiểm tra ranh giới 

thực hiện. 


Trong phần tiếp theo, các chức năng cá nhân thực hiện hoạt động ma trận được 

mô tả. 

MatrixAdd 

Mô tả: MatrixAddadds giá trị của mỗi elementin nguồn một ma trận 

với đối tác của mình trong nguồn hai ma trận, và đặt kết quả trong 

ma trận đích. 


Nguyên mẫu: ở ngoài phân đoạn * MatrixAdd ( 

int numrows, 

numCols int, 

phân đoạn * dstM, 

phân đoạn * srcM1, 

phân đoạn * srcM2 

); 

Đối số: numrows số hàng trong ma trận nguồn 

numCols số lượng cột trong ma trận nguồn 

dstM con trỏ đến ma trận điểm 

srcM1 con trỏ đến nguồn một ma trận 

srcM2 con trỏ đến nguồn hai ma trận 

Quay trở lại giá trị: Con trỏ trỏ tới địa chỉ cơ sở của ma trận đích.

in default RAM memory space (X-Data or Y-Data). 

f) Operations which return a destination matrix can be nested, so that for 

instance 

if: 


a = Op1 (Op2 (d), Op3 (e, f)) 

2.5.3 Additional Remarks 

The description of the functions limits its scope to what could be considered the 

regular 

usage of these operations. However, since no boundary checking is performed 

during 

computation of these functions, you have the freedom to interpret the operation 

and its 

results as it fits some particular needs. 

For instance, while computing the MatrixMultiplyfunction, the dimensions of 

the 

intervining matrices does not necessarily need to be {numRows1, 

numCos1Rows2} for 

source one matrix, {numCols1Rows2, numCols2} for source two matrix, and 

{numRows1, 

numCols2} for destination matrix. In fact, all thatis needed is that their sizes are 

large 

enough so that during computation the pointers do no exceed over their memory 

range. 

As another example, when a source matrix of dimension {numRows, numCols} 

is 

transposed, the destination matrix has dimensions {numCols, numRows}. Thus, 

properly 

speaking the operation can be computed in place onlyif source matrix is square. 

Nevertheless, the operation can be successfully applied in place to non square 

matrices; all that needs to be kept in mind is the implicitchange of dimensions. 

DSP Library 


Other possibilities can be exploited from the fact that no boundary checking is 

performed. 


In what follows, the individual functions implementing matrix operations are 

described. 

MatrixAdd 

Description: MatrixAddadds the value of each elementin the source one matrix 

with its counterpart in the source two matrix, and places the result in the 

destination matrix. 


Prototype: extern fractional* MatrixAdd ( 

Ghi chú: Nếu giá trị tuyệt đối của srcM1 [r] [c] + srcM2 [r] [c] lớn hơn 

1-2 

-15 

, Kết quả hoạt động này trong độ bão hòa cho (r, c) các yếu tố -thứ. 



Source File: madd.asm 









14 


20 + 3 (numrows * numCols) 

dsPIC 

® 



MatrixMultiply 

Mô tả: MatrixMultiplyperforms phép nhân ma trận giữa 

một nguồn và nguồn hai ma trận, và đặt kết quả trong 

ma trận đích. Tượng trưng: 

trong đó: 

0 ≤i

int numRows, 

int numCols, 

fractional* dstM, 

fractional* srcM1, 

fractional* srcM2 

); 

Arguments: numRows number of rows in source matrices 

numCols number of columns in source matrices 

dstM pointer to destination matrix 

srcM1 pointer to source one matrix 

srcM2 pointer to source two matrix 

Return Value: Pointer to base address of destination matrix. 

Remarks: If the absolute value of srcM1[r][c]+srcM2[r][c]is larger than 

1-2 

-15 

, this operation results in saturation for the (r,c)-th element. 



Source File: madd.asm 









14 


20 + 3(numRows*numCols) 

dsPIC 

® 



MatrixMultiply 

Description: MatrixMultiplyperforms the matrix multiplication between the 

source one and source two matrices,and places the result in the 

destination matrix. Symbolically: 

where: 

Đối số: số numRows1 hàng trong nguồn một ma trận 

numCols1Rows2 số lượng cột trong nguồn một ma trận; mà 

mustbe giống như số hàng trong nguồn 

hai ma trận 

numCols2 số lượng cột trong hai nguồn ma trận 


srcM1 con trỏ đến nguồn một ma trận 

srcM2 con trỏ đến nguồn hai ma trận 

Quay trở lại giá trị: Con trỏ trỏ tới địa chỉ cơ sở của ma trận đích. 

Ghi chú: Nếu giá trị tuyệt đối của 

lớn hơn 1-2 

-15 

, Hoạt động này dẫn đến độ bão hòa cho 

(I, j) yếu tố -thứ. 

Nếu nguồn một ma trận hình vuông, sau đó chức năng này có thể được tính 

tại chỗ và có thể tự áp dụng. Xem Bình luận bổ sung tại các 

bắt đầu của phần cho ý kiến về chế độ này hoạt động. 

Source File: mmul.asm 



W8..W13 lưu, sử dụng, phục hồi 







35 


36 + numRows1 * (8 + numCols2 * (7 + 4 * numCols1Rows2)) 

dstM tôi [] j [] srcM1 tôi [] k [] () srcM2i k [] j [] () k 

Σ = 

srcM1 tôi [] k [] () srcM2i k [] j [] () k 

Σ 



MatrixScale 

Mô tả: MatrixScalescales (bội) các giá trị của tất cả các yếu tố trong 

nguồn ma trận bởi một giá trị quy mô, và đặt kết quả ở đích đến

0 ≤i < numRows1 

0 ≤j < numCols2 

0 ≤k < numCols1Rows2 


Prototype: extern fractional* MatrixMultiply ( 

int numRows1, 

int numCols1Rows2, 

int numCols2, 




); 

Arguments: numRows1 number of rows in source one matrix 

numCols1Rows2 number of columns in source one matrix; which 

mustbe the same as number of rows in source 

two matrix 

numCols2 number of columns in source two matrix 


srcM1 pointer to source one matrix 

srcM2 pointer to source two matrix 


Remarks: If the absolute value of 

is larger than 1-2 

-15 

, this operation results in saturation for the 

(i,j)-th element. 

If the source one matrix is squared,then this function can be computed 

in place and can be self applicable. See Additional Remarks at the 

beginning of the section for comments on this mode of operation. 

Source File: mmul.asm 










ma trận. 


Nguyên mẫu: ở ngoài phân đoạn * MatrixScale ( 

int numrows, 

numCols int, 


phân đoạn * srcM, 

phân đoạn sclVal 

); 




con trỏ srcM để ma trận nguồn 

sclVal giá trị mà quy mô các yếu tố ma trận 


Bình luận: Chức năng này có thể được tính tại chỗ. 

Source File: mscl.asm 









14 



MatrixSubtract 

Mô tả: MatrixSubtractsubtracts giá trị của mỗi phần tử trong mã nguồn 

hai ma trận từ đối tác của mình trong nguồn một ma trận, và đặt 

kết quả trong ma trận đích. 


Nguyên mẫu: ở ngoài phân đoạn * MatrixSubtract ( 

int numrows, 

numCols int, 


phân đoạn * srcM1, 

phân đoạn * srcM2

35 


36+numRows1*(8+numCols2*(7+4*numCols1Rows2)) 

dstM i []j [] srcM1 i []k [] ()srcM2i k []j [] () k 

∑ = 

srcM1 i []k [] ()srcM2i k []j [] () k 

∑ 

DSP Library 


MatrixScale 

Description: MatrixScalescales (multiplies) the values of all elements in the 

source matrix by a scale value, and places the result in the destination 

matrix. 


Prototype: extern fractional* MatrixScale ( 

int numRows, 

int numCols, 


fractional* srcM, 

fractional sclVal 

); 

Arguments: numRows number of rows in source matrix 

numCols number of columns in source matrix 


srcM pointer to source matrix 

sclVal value by which to scale matrix elements 


Remarks: This function can be computed in place. 

Source File: mscl.asm 









14 


); 

Đối số: numrows số hàng trong ma trận nguồn (CES) 

numCols số lượng cột trong ma trận nguồn (CES) 


srcM1 con trỏ đến mã nguồn một ma trận (số để trừ) 

srcM2 con trỏ đến nguồn hai ma trận (số bị trừ) 


dsPIC 

® 



Ghi chú: Nếu giá trị tuyệt đối của srcM1 [r] [c] -srcM2 [r] [c] lớn hơn 

1-2 

-15 

, Kết quả hoạt động này trong độ bão hòa cho (r, c) các yếu tố -thứ. 


Chức năng này có thể áp dụng beself. 

Source File: msub.asm 










15 



MatrixTranspose 

Mô tả: MatrixTransposetransposes các hàng của các cột trong nguồn 

ma trận, và những nơi ma trận kết quả indestination. Trong thực tế: 

dstM [i] [j] = srcM [j] [i], 

0 ≤i


MatrixSubtract 

Description: MatrixSubtractsubtracts the value of each element in the source 

two matrix from its counterpart in the source one matrix, and places the 

result in the destination matrix. 


Prototype: extern fractional* MatrixSubtract ( 

int numRows, 

int numCols, 




); 

Arguments: numRows number of rows in source matrix(ces) 

numCols number of columns in source matrix(ces) 


srcM1 pointer to source one matrix (minuend) 

srcM2 pointer to source two matrix (subtrahend) 


dsPIC 

® 



phân đoạn * srcM 

); 






Ghi chú: Nếu nguồn ma trận là hình vuông, chức năng này có thể được tính tại 

chỗ. 

Xem Bình luận bổ sung tại đầu phần cho ý kiến 

về chế độ này hoạt động. 

Source File: mtrp.asm 







14 


16 + numCols * (6 + (numrows-1) * 3) 

MatrixSubtract (Tiếp theo) 




Remarks: If the absolute value of srcM1[r][c]-srcM2[r][c]is larger than 

1-2 

-15 

, this operation results in saturation for the (r,c)-th element. 



Source File: msub.asm 




ACCB used, not restored 







2.5.5 Ma trận Inversion 

Kết quả của việc đảo ngược một không ít, hình vuông, ma trận phân đoạn là mộ 

ma trận vuông 

(Các kích thước tương tự) mà giá trị phần tử không nhất thiết phải hạn chế đến 

bộ phân đoạn rời rạc {-1, ..., 1-2 

-15 

}. Vì vậy, không có hoạt động ma trận đảo ngược được cung cấp cho 

ma trận phân đoạn. 

Tuy nhiên, kể từ khi ma trận đảo ngược là một hoạt động veryuseful, một thực 

hiện dựa trên 

ở điểm nổi đại diện số lượng và số học được cung cấp trong DSP 

Thư viện. Mô tả của nó sau. 

MatrixInvert 

Mô tả: MatrixInvertcomputes nghịch đảo của nguồn ma trận, và những nơi 

kết quả trong ma trận đích. 

Bao gồm: dsp.h

15 



MatrixTranspose 

Description: MatrixTransposetransposes the rows by the columns in the source 

matrix, and places the result indestination matrix. In effect: 

dstM[i][j]= srcM[j][i], 

0 ≤i < numRows, 0 ≤j < numCols. 


Prototype: extern fractional* MatrixTranspose ( 

int numRows, 

int numCols, 


fractional* srcM 

); 

Arguments: numRows number of rows in source matrix 

numCols number of columns in source matrix 




Remarks: If the source matrix is square, this function can be computed in place. 

See Additional Remarks at the beginning of the section for comments 

on this mode of operation. 

Source File: mtrp.asm 







14 


16 + numCols*(6 + (numRows-1)*3) 

MatrixSubtract (Continued) 

DSP Library 


2.5.5 Matrix Inversion 

The result of inverting a non-singular, square, fractional matrix is another 

square matrix 

Prototype: phao ở ngoài * MatrixInvert ( 

numRowsCols int, 

* nổi dstM, 

float * srcM, 

* nổi pivotFlag, 

int * swappedRows, 

int * swappedCols 

); 

Đối số: numRowCols số hàng và cột trong (hình vuông) nguồn 

ma trận 



Cần thiết để sử dụng nội bộ: 

pivotFlag con trỏ đến một vector numRowsCols dài 

swappedRows con trỏ đến một vector numRowsCols dài 

swappedCols con trỏ đến một vector numRowsCols dài 

Quay trở lại giá trị: Con trỏ trỏ tới địa chỉ cơ sở của ma trận điểm đến, hoặc 

NULLif nguồn ma trận 

là số ít. 

Bình luận: Mặc dù các vectơ pivotFlag, swappedRows, và 

swappedCols, là để dùng nội bộ thì phải giao trước 

gọi chức năng này. 

Nếu ma trận nguồn là số ít (yếu tố quyết định bằng không) ma trận không 

không có tính khả nghịch. Trong trường hợp này hàm trả về NULL. 


Source File: minv.asm (lắp ráp từ C-code) 



W8, W14 lưu, sử dụng, phục hồi 


Không 





dsPIC 

® 



2.6 CHỨC NĂNG LỌC 

2004 Microchip Technology Inc

(of the same dimension) whose element values are not necessarily constrained 

to the 

discrete fractional set {-1, ..., 1-2 

-15 

}. Thus, no matrix inversion operation is provided for 

fractional matrices. 

However, since matrix inversion is a veryuseful operation, an implementation 

based 

on floating point number representation and arithmetic is provided within the 

DSP 

Library. Its description follows. 

MatrixInvert 

Description: MatrixInvertcomputes the inverse of the source matrix, and places 

the result in the destination matrix. 


Prototype: extern float* MatrixInvert ( 

int numRowsCols, 

float* dstM, 

float* srcM, 

float* pivotFlag, 

int* swappedRows, 

int* swappedCols 

); 

Arguments: numRowCols number of rows and columns in (square) source 

matrix 



Required for internal use: 

pivotFlag pointer to a length numRowsCols vector 

swappedRows pointer to a length numRowsCols vector 

swappedCols pointer to a length numRowsCols vector 

Return Value: Pointer to base address of destination matrix, or NULLif source 

matrix 

is singular. 

Remarks: Even though the vectors pivotFlag, swappedRows, and 

swappedCols, are for internal use only, they must be allocated prior to 

calling this function. 

If source matrix is singular (determinant equal to zero) the matrix does 

not have an inverse. In this case the function returns NULL. 


Source File: minv.asm(assembled from C-code) 

Phần này trình bày các khái niệm về một bộ lọc phân đoạn, như xem xét bởi 

DSP 

Thư viện, và mô tả các chức năng cá nhân đó thực hiện các hoạt động lọc. 

2.6.1 Hoạt động lọc Fractional 

Lọc các chuỗi dữ liệu được đại diện bởi phân đoạn vector x [n] (0 ≤n



W8, W14 saved, used, restored 


None 





dsPIC 

® 


mà một [m] = 0 khi 1 ≤m 

rằng một [0] ≠ 0, và [m] ≠ 0 cho một số m {1, ..., M}. Phân loại khác trong FIR 

và hạch toán bộ lọc IIR gia đình cho các tác động của các hoạt động gây ra trên 

dữ liệu đầu vào 

trình tự. 

Hơn nữa, mặc dù lọc giải phương trình khác biệt consistson nói 

ở trên, một số triển khai có sẵn trong đó hiệu quả hơn tính toán trực tiếp của 

phương trình khác biệt. Ngoài ra, một số hiện thực khác được thiết kế để 

thực hiện các hoạt động lọc theo buộc áp đặt bởi số học phân đoạn. 

Tất cả những nhận xét này dẫn đến một sự gia tăng của hoạt động lọc, trong đó 

có một tập hợp con 

được cung cấp bởi thư viện DSP. 

yn [] ap [] - () yn p - [] () p1 = 

P1- 



Σ + bm [] () xn m - [] () 

2.6 FILTERING FUNCTIONS 

This section presents the concept of a fractional filter, as considered by the DSP 

Library, and describes the individual functions which perform filter operations. 

2.6.1 Fractional Filter Operations 

Filtering the data sequence represented by fractional vector x[n] (0 ≤n

history of the filter. After performing the filtering operation, the delay contains 

a set of 

the most recently filtered data samples, and of the most recent output samples. 

(Note 

that to ensure correct operation of a particular filter implementation, it is 

advisable to 

initialize the delay values to zero by calling the corresponding initialization 

function.) 

In the filter implementations provided with the DSP Library the input data 

sequence is 

referred to as the sequence of source samples, while the resulting filtered 

sequence is 

called the destination samples. The filter coefficients (a,b) and delay are usually 

thought of as making up a filter structure. In all filter implementations, the input 

and 

và bộ hệ số có thể tạo ra kết quả bất ngờ. 

d) Đó là khuyến cáo rằng tình trạng đăng ký (SR) được kiểm tra sau khi hoàn 

thành 


sau 


e) Các hoạt động đó trả về một vector đích có thể được lồng vào nhau, do đó, v 

dụ 

nếu: 


a = OP1 (OP2 (d), op3 (e, f)) 

dsPIC 

® 


output data samples may be allocated in default RAM memory space (X-Data or 



Y-Data). Filter coefficients may reside either in X-Data memory or program 

memory, 

and filter delay values must be accessed onlyfrom Y-Data. 

2.6.2 FIR and IIR Filter Implementations 

The properties of a filter depend on the value distribution of its coefficients. In 

particular, 

two types of filters are of special interest: Finite Impulse Response (FIR) filters, 

for 

which a[m] = 0 when 1 ≤m

DSP Library 


2.6.3 Single Sample Filtering 

The filtering functions provided in the DSP Library are designed for block 

processing. 

Each filter function accepts an argument named numSampswhich indicates the 

number of words of input data (block size) to operate on. If single sample 

filtering is desired, 

you may set numSampsto 1. This will have the effect of filtering one input 

sample, and 

the function will compute a singleoutput sample from the filter. 


All the fractional filtering operations in this library rely on the values of either 

input 

parameters or data structure elements to specify the number of samples to 

process, 

and the sizes of the coefficients and delay vectors. Based on these values the 

following 

assumptions are made: 

a) The sum of sizes of all the vectors (sample sequences) involved in a 

particular 

operation falls within the range of available data memory for the target device. 

b) The destination vector mustbe large enough to accept the results of an 

operation. 

c) No boundary checking is performed by these functions. Out of range sizes 

(including zero length vectors) as well as nonconforming use of source vectors 

and coefficient sets may produce unexpected results. 

d) It is recommended that the Status register (SR) is examined after completion 

of 


after 


e) Operations which return a destination vector can be nested, so that for 

instance 

if: 


a = Op1 (Op2 (d), Op3 (e, f)) 

dsPIC 

® 





In what follows, the individual functions implementing filtering operations are 

described. For further discussions on digital filters, please consult Alan 

delayBase địa chỉ cơ sở cho sự chậm trễ đệm 

địa chỉ kết thúc delayEnd cho sự chậm trễ đệm 

trì hoãn giá trị hiện tại của con trỏ chậm trễ (cũng d) 

Bình luận: Số lượng các hệ số trong bộ lọc là M. 

Hệ số, h [m], được định nghĩa trong 0 ≤m 

bộ nhớ. 

Chậm trễ đệm d [m], được định nghĩa trong 0 ≤m 

Nếu hệ số được lưu trữ trong không gian X-Data, coeffsBasepoints đến 

địa chỉ thực tế mà hệ số được phân bổ. Nếu hệ số là 

lưu trữ trong bộ nhớ chương trình, coeffsBaseis bù đắp từ chương trình 

trang ranh giới có chứa các hệ số địa chỉ trong trang 

nơi mà hệ số được phân bổ. Giá trị sau này có thể được tính toán 

bằng cách sử dụng psvoffset hành lắp ráp nội tuyến (). 

coeffsEndis địa chỉ trong không gian X-Data (hoặc bù đắp nếu trong chương 

trình 

bộ nhớ) của byte cuối cùng của bộ đệm hệ số bộ lọc. 

Nếu hệ số được lưu trữ trong không gian X-Data, coeffsPagemust được thiết lập 

để 

0xff00 (được định nghĩa COEFFS_IN_DATA giá trị). Nếu hệ số được lưu trữ 

trong 

bộ nhớ chương trình, nó là số trang chương trình có chứa các hệ số. Giá trị sau 

này có thể được tính toán bằng cách sử dụng lắp ráp nội tuyến 

điều hành psvpage (). 

delayBasepoints đến địa chỉ thực tế nơi mà các bộ đệm chậm trễ được phân bổ. 

delayEndis địa chỉ của người cuối cùng byteof bộ đệm chậm trễ lọc. 



Khi các hệ số và bộ đệm chậm trễ được thực hiện như tròn 

tăng bộ đệm modulo, cả coeffsBaseand 

delayBase mustbe liên kết đến một quyền lực 'không' của hai địa chỉ 

(coeffsEndand delayEndare địa chỉ lẻ). Cho dù các bộ đệm 

thực hiện như bộ đệm tròn tăng modulo hoặc không được chỉ định trong 

phần nhận xét của mỗi bộ lọc FIR mô tả chức năng. 

Khi các hệ số và bộ đệm chậm trễ không được thực hiện như tròn (tăng) theo 

modulo bộ đệm, coeffsBaseand 

delayBase không cần tobe liên kết quyền lực một 'không' của hai địa chỉ, 

và các giá trị của coeffsEndand delayEndare bỏ qua trong 

đặc biệt FIR Bộ lọc chức năng thực hiện. 

FIR 

Mô tả: FIRapplies một bộ lọc FIR với chuỗi các mẫu nguồn, đặt 

kết quả trong các mẫu đến sequenceof, và cập nhật sự chậm trễ 

giá trị.

Oppenheim and 

Ronald Schafer’s Discrete-Time Signal Processing, Prentice Hall, 1989. For 

implementation details of Least Mean Square FIR filters, please refer to T. 

Hsia’s Convergence 

Analysis of LMS and NLMS Adaptive Algorithms, Proc. ICASSP, pp. 667-670, 

1983, as 

well as Sangil Park and Garth Hillman’s On Acoustic-Echo Cancellation 

Implementation with Multiple Cascadable Adaptive FIR Filter Chips, Proc. 

ICASSP, 

1989. 

FIRStruct 

Structure: FIRStructdescribes the filter structure for any of the FIR filters. 


Declaration: typedef struct { 

int numCoeffs; 

fractional* coeffsBase; 

fractional* coeffsEnd; 

int coeffsPage; 

fractional* delayBase; 

fractional* delayEnd; 

fractional* delay; 

} FIRStruct; 

Parameters: numCoeffs number of coefficients in filter (also M) 

coeffsBase base address for filtercoefficients (also h) 

coeffsEnd end address for filter coefficients 

coeffsPage coefficients buffer page number 

delayBase base address for delay buffer 

delayEnd end address for delay buffer 

delay current value of delay pointer (also d) 

Remarks: Number of coefficients in filter is M. 

Coefficients, h[m], defined in 0 ≤m

If coefficients are stored in X-Data space, coeffsPagemust be set to 

0xFF00 (defined value COEFFS_IN_DATA). If coefficients are stored in 

program memory, it is the program page number containing the coefficients. 

This latter value can be calculated using the inline assembly 

operator psvpage(). 

delayBasepoints to the actual address where the delay buffer is allocated. 

delayEndis the address of the last byteof the filter delay buffer. 

DSP Library 


When the coefficients and delay buffers are implemented as circular 

increasing modulo buffers, both coeffsBaseand 

delayBase mustbe aligned to a ‘zero’ power of two address (coeffsEndand 

delayEndare odd addresses). Whether these buffers are 

implemented as circular increasing modulo buffers or not is indicated in 

the remarks section of each FIR filter function description. 

When the coefficients and delay buffers are not implemented as circular 

(increasing) modulo buffers, coeffsBaseand 

delayBase do not need tobe aligned to a ‘zero’ power of two address, 

and the values of coeffsEndand delayEndare ignored within the 

particular FIR Filter function implementation. 

FIR 

Description: FIRapplies an FIR filter to the sequence of source samples, places 

the 

results in the sequenceof destination samples, and updates the delay 

values. 


Prototype: extern fractional* FIR ( 

int numSamps, 

fractional* dstSamps, 

fractional* srcSamps, 

FIRStruct* filter 

); 

Arguments: numSamps number of input samples to filter (also N) 

dstSamps pointer to destination samples (also y) 

srcSamps pointer to source samples (also x) 

filter pointer to FIRStructfilter structure 

Return Value: Pointer to base address of destination samples. 



modulo buffer. 

Source samples, x[n], defined in 0 ≤n

int numSamps, 



FIRStruct* filter, 

int rate 

); 

Arguments: numSamps number of outputsamples (also N, N = Rp, p integer) 

dstSamp pointer to destination samples (also y) 



rate rate of decimation (downsampling factor, also R) 


Remarks: Number of coefficients in filter is M,with M an integer multiple of R. 


FIRDelayInit 

Description: FIRDelayInitinitializes to zero the delay values in an FIRStruct 

filter structure. 


Prototype: extern void FIRDelayInit ( 

FIRStruct* filter 

); 

Arguments: filter pointer to FIRStructfilter structure. 

Remarks: See description of FIRStructstructure above. 

Note:FIR interpolator's delay is initialized by function 

FIRInterpDelayInit. 

Source File: firdelay.asm 







7 


11 + M 

FIRDecimate (Continued) 

dsPIC 

® 



FIRInterpolate 

Description: FIRInterpolateinterpolates the sequence of source samples at a 

rate of 1 to R; or equivalently, it upsamples the signal by a factor of R. 

Effectively, 

y[n] = x[n/R]. 

To diminish the effect of aliasing, the source samples are first 

upsampled and then filtered. The interpolated results are stored in the 

sequence of destination samples,and the delay values updated. 


Prototype: extern fractional* FIRInterpolate ( 

int numSamps, 




PSVPAG lưu, sử dụng, phục hồi (nếu 

hệ số P trong bộ nhớ) 





63 


45 + 6 (M / R) + N (14 + M / R + 3M + 5R), hoặc 

48 + 6 (M / R) + N (14 + M / R + 4M + 5R) nếu hệ số P trong bộ nhớ. 



FIRInterpDelayInit 

Mô tả: FIRInterpDelayInitinitializes bằng không các giá trị chậm trễ trong một 

Cấu trúc FIRStructfilter, tối ưu hóa để sử dụng với một nội suy FIR 

bộ lọc. 


Prototype: ngoài void FIRDelayInit ( 

FIRStruct * bộ lọc, 

int tỷ lệ 

); 

Đối số: lọc con trỏ đến cấu trúc FIRStructfilter 

tỷ lệ tỷ lệ nội suy (upsampling yếu tố, cũng R) 

Bình luận: Delay, d [m], được định nghĩa trong 0 ≤m 

hệ số trong xen vào. 

Xem mô tả các FIRStructstructure trên. 

Source File: firintdl.asm 







13 


10 + 7M / R 

FIRLattice 

Mô tả: FIRLatticeuses thực hiện một cấu trúc mạng tinh thể áp dụng một FIR


int rate 

); 

Arguments: numSamps number of input samples (also N, N = Rp, p integer) 




rate rate of interpolation (upsampling factor, also R) 


Remarks: Number of coefficients in filter is M,with M an integer multiple of R. 


filter. 


Prototype: extern void FIRDelayInit ( 


int rate 

); 

Arguments: filter pointer to FIRStructfilter structure 

rate rate of interpolation (upsampling factor, also R) 

Remarks: Delay, d[m], defined in 0 ≤m

circular modulo buffer. 

Delay, d[m], defined in 0 ≤m


fractional* refSamps, 

fractional muVal 

); 

Arguments: numSamps number of input samples (also N) 




refSamps pointer to reference samples (also r) 

muVal adapting factor (also mu) 


FIRLattice (Continued) 

DSP Library 




XMODSTRT saved, used, restored 

XMODEND saved, used, restored 

YMODSTRT saved, used, restored 





76 


61 + N(13 + 5M) 

FIRLMSNorm 

Description: FIRLMSNormapplies an adaptive FIR filter to the sequence of 

source 

samples, stores the results in the sequence of destination samples, 

and updates the delay values. 

The filter coefficients are also updated, at a sample-per-sample basis, 

using a Normalized Least Mean Square algorithm applied according to 

the values of the reference samples. 


FIRLMS (Continued) 

dsPIC 

® 


energyEstimateis cập nhật với giá trị E [N-1] (có thể được sử dụng 

là giá trị khởi động cho một cuộc gọi chức năng tiếp theo nếu lọc một 

mở rộng của tín hiệu đầu vào). 

Các hoạt động có thể dẫn đến bão hòa nếu giá trị tuyệt đối của (r [n] - 

y [n]) lớn hơn hoặc bằng một. 

Lưu ý: Một biểu hiện cho ước tính năng lượng là: 

E [n] = (x [n]) 

2 

+ (X [n-1) 

2 

+ ... + (X [n-M + 2]) 

2 

. 

Vì vậy, để tránh bão hòa trong khi tính toán dự toán, đầu vào 

giá trị mẫu nên bị trói buộc để 

, 0 ≤n

energyEstimate estimated energy value for the last M input 

signal samples, with M the number of filter 

coefficients 




, for 0 ≤n

fractional* delayBase 

); 

Arguments: filter pointer to FIRStructfilter structure 

numCoeffs number of coefficients in filter (also M) 

coeffsBase base address for filter coefficients (also h) 

coeffsPage coefficient buffer page number 

delayBase base address for delay buffer 

Remarks: See description of FIRStructstructure above. 

Upon completion, FIRStructInitinitializes the coeffsEndand 

delayEndpointers accordingly. Also, delayis set equal to 

delayBase. 

Source File: firinit.asm 







10 


19 

FIRLMSNorm (Continued) 

dsPIC 

® 

anguage Tools Libraries 

Bình luận: Có 5 hệ số mỗi secondorder (trùng phương) phần 

sắp xếp trong tập lệnh {a2 [s], a1 [s], b2 [s], b1 [s], b0 [s]}, 0 ≤s 

Giá trị hệ số nên được tạo ra với thiết kế bộ lọc dsPICFD 

gói từ Momentum Data Systems, Inc, hoặc công cụ tương tự. 

Việc chậm trễ được tạo thành oftwo lời của nhà nước lọc mỗi section {d1 [s], 

d2 [s]}, 0 ≤s

} IIRCanonicStruct; 

extern fractional* IIRCanonic ( 

int numSamps, 



IIRCanonicStruct* filter 

); 

Arguments: Filter structure: 

numSectionsLess1 1 less than number of cascaded second 

order (biquadratic) sections (also S-1) 

coeffsBase pointer to filter coefficients (also {a, b}), 

either within X-Data or program memory 

coeffsPage coefficients buffer page number, or 0xFF00 

(defined value COEFFS_IN_DATA)if 

coefficients in data space 

delayBase pointer to filter delay (also d), onlyin Y-Data 

initialGain initial gain value 

finalShift output scaling (shift left) 

Filter Description: 

numSamps number of input samples to filter (also N) 



filter pointer to IIRCanonicStructfilter structure 


Remarks: There are 5 coefficients per secondorder (biquadratic) sections 

arranged in the ordered set {a2[s], a1[s], b2[s], b1[s], b0[s]}, 0 ≤s

Source File: iircan.asm 

DSP Library 







PSVPAG saved, used, restored 





42 


36 + N(8 + 7S), or 

39 + N(9 + 12S) if coefficients in program memory. 

IIRCanonicInit 

Description: IIRCanonicInitinitializes to zero the delay values in an 

IIRCanonicStructfilter structure. 


Prototype: extern void IIRCanonicInit ( 

IIRCanonicStruct* filter 

); 


(See description of IIRCanonicfunction). 

Initialization Description: 

filter pointer to IIRCanonicStructfilter structure 

Remarks: Two words of filter state per second order section {d1[s], d2[s]}, 

0 ≤s

10 + S2. 

IIRCanonic (Continued) 

dsPIC 

® 



IIRLattice 

Description: IIRLatticeuses a lattice structure implementation to apply an IIR 

filter to the sequence ofsource samples. It thenplaces the results in 

the sequence of destination samples, and updates the delay values. 


Prototype: typedef struct { 

int order; 

fractional* kappaVals; 

fractional* gammaVals; 

int coeffsPage; 

fractional* delay; 

} IIRLatticeStruct; 

extern fractional* IIRLattice ( 

int numSamps, 



IIRLatticeStruct* filter 

); 


order filter order (also M, M ≤N; see FIRLatticefor N) 

kappaVals base address for lattice coefficients (also k), either in 

X-Data or program memory 

gammaVals base address for ladder coefficients (also g), either in 

X-Data or program memory. If NULL, the function will 

implement an all-pole filter. 

coeffsPage coefficients buffer page number, or 0xFF00 



delay base address for delay (also d), onlyin Y-Data 


numSamps number of input samples to filter (also N, N ≥M; see 

IIRLatticeStructfor M) 











76 


46 + N (16 + 7M), hoặc 

49 + N (20 + 8M) nếu hệ số trong bộ nhớ chương trình. 

Nếu thực hiện một bộ lọc tất cả cực: 

46 + N (16 + 6M), hoặc 

49 + N (16 + 7M) nếu hệ số trong bộ nhớ chương trình 

IIRLatticeInit 

Mô tả: IIRLatticeInitinitializes bằng không các giá trị chậm trễ trong một 

Cấu trúc IIRLatticeStructfilter. 


Prototype: ngoài void IIRLatticeInit ( 

IIRLatticeStruct * bộ lọc 

); 

Lập luận: Cấu trúc bộ lọc: 

(Xem mô tả các IIRLatticefunction). 

Khởi tạo Mô tả: 

lọc con trỏ đến cấu trúc IIRLatticeStructfilter. 

Source File: iirlattd.asm 







6 


10 + M 

IIRLattice (Tiếp theo) 

dsPIC


filter pointer to IIRLatticeStructfilter structure 


Remarks: Lattice coefficients, k[m], defined in 0 ≤m ≤M. 

Ladder coefficients, g[m], defined in 0 ≤m ≤M (unless if implementing 

an all-pole filter). 

Delay, d[m], defined in 0 ≤m ≤M. 

Source samples, x[n], defined in 0 ≤n

IIRLatticeInit 

Description: IIRLatticeInitinitializes to zero the delay values in an 

IIRLatticeStructfilter structure. 


Prototype: extern void IIRLatticeInit ( 

IIRLatticeStruct* filter 

); 


(See description of IIRLatticefunction). 


filter pointer to IIRLatticeStructfilter structure. 

Source File: iirlattd.asm 







6 


10 + M 

IIRLattice (Continued) 

dsPIC 

® 


numSamps số lượng mẫu đầu vào để lọc (còn N) 

dstSamps con trỏ đến mẫu đích (còn y) 

srcSamps con trỏ đến mã nguồn mẫu (còn x) 

lọc con trỏ đến cấu trúc IIRTransposedStructfilter 

Quay trở lại giá trị: Con trỏ trỏ tới địa chỉ cơ sở của mẫu đích. 

Bình luận: Có 5 hệ số mỗi đơn hàng thứ hai (trùng phương) phần 

sắp xếp trong tập lệnh {b0 [s], b1 [s], a1 [s], b2 [s], a2 [s]}, 0 ≤s 

Giá trị hệ số nên được tạo ra với thiết kế bộ lọc dsPICFD 

gói từ Momentum Data Systems, Inc, hoặc công cụ tương tự. 

Việc chậm trễ được tạo thành từ hai bộ đệm độc lập, mỗi bộ đệm 

có chứa một từ của nhà nước lọc mỗi section {d2 [s], d1 [s]}, 0 ≤s

} IIRTransposedStruct; 

extern fractional* IIRTransposed ( 

int numSamps, 



IIRTransposedStruct* filter 

); 


numSectionsLess1 1 less than number of cascaded second 

order (biquadratic) sections (also S-1) 

coeffsBase pointer to filter coefficients (also {a, b}), 

either in X-Data or program memory 

coeffsPage coefficient buffer page number, or 0xFF00 



delayBase1 pointer to filter state 1, with one word of 

delay per second order section (also d1), 

onlyin Y-Data 

delayBase2 pointer to filter state 2, with one word of 

delay per second order section (also d2), 

onlyin Y-Data 

finalShift output scaling (shift left) 


numSamps number of input samples to filter (also N) 



filter pointer to IIRTransposedStructfilter structure 

Mô tả: IIRTransposedInitinitializes bằng không các giá trị chậm trễ trong một 

Cấu trúc IIRTransposedStructfilter. 


Prototype: ngoài void IIRTransposedInit ( 

IIRTransposedStruct * bộ lọc 

); 

Lập luận: Cấu trúc bộ lọc: 

(Xem mô tả các IIRTransposedfunction). 

Khởi tạo Mô tả: 

lọc con trỏ đến cấu trúc IIRTransposedStructfilter. 

Bình luận: Sự chậm trễ được tạo thành từ hai bộ đệm độc lập, mỗi bộ đệm 

có chứa một từ của nhà nước lọc mỗi section {d2 [s], d1 [s]}, 0 ≤s

the number of bits to shift: negativeindicates shift left, positive is shift 

right. 

Source File: iirtrans.asm 

DSP Library 








PSVPAG saved, used, restored 





48 


35 + N(11 + 11S), or 

38 + N( 9 + 17S) if coefficients in P memory. 

S is number of second order sections. 

IIRTransposedInit 

Description: IIRTransposedInitinitializes to zero the delay values in an 

IIRTransposedStructfilter structure. 


Prototype: extern void IIRTransposedInit ( 

IIRTransposedStruct* filter 

); 


(See description of IIRTransposedfunction). 


filter pointer to IIRTransposedStructfilter structure. 

Remarks: The delay is made up of two independent buffers, each buffer 

containing one word of filter state per section {d2[s], d1[s]}, 0 ≤s



8 


11 + 2S, 

S is number of second order sections. 

IIRTransposed (Continued) 

dsPIC 

® 




2.6.6 OCTAVE model for analysis of IIRLatticefilter 

The following OCTAVE model may be used to examine the performance of an 

IIR 

Lattice Filter prior to using the fractionalimplementation provided by the 

function 

IIRLattice. 

function [out, del, forward, backward] = iirlatt (in, kappas, gammas, delay) 

## FUNCTION.-## IIRLATT: IIR Fileter Lattice implementation. 

## 

## [out, del, forward, backward] = iirlatt (in,kappas, gammas, delay) 

## 

## forward: records intermediate forward values. 

## backward: records intermediate backward values. 

#.............................................................................. 

## Get implicit parameters. 

numSamps = length(in); numKapps = length(kappas); 

if (gammas != 0) 

numGamms = length(gammas); 

else 

numGamms = 0; 

endif 

numDels = length(delay); filtOrder = numDels-1; 

## Error check. 

if (numGamms != 0) 

if (numGamms != numKapps) 

fprintf ("ERROR! %d should be equal to%d.\n", numGamms, numKapps); 

return; 

endif 

endif 

hiện tại = sau; 

cuối 

del (M + 1) = sau; 

## Cấu trúc thang (tính đầu ra). 

if (gam mầu == 0) 

ra (n) = del (M + 1); 

khác 

cho m = 1: M + 1 

ra (n) = ra (n) + gam mầu (M + 2-m) * del (m); 

endfor 

endif 

endfor 

## Quay trở lại. 

trở lại; 

# ................................................. ............................. 

endfunction 

dsPIC 

® 



2.7 BIẾN ĐỔI CHỨC NĂNG 


Phần này trình bày các khái niệm về một phân đoạn chuyển đổi, như xem xét 

bởi DSP 

Thư viện, và mô tả các chức năng cá nhân đó thực hiện chuyển đổi hoạt động. 

2.7.1 Fractional Chuyển đổi hoạt động 

Một phân đoạn chuyển đổi là một tuyến tính, thời gian bất biến, hoạt động rời 

rạc mà khi áp dụng cho 

một chuỗi mẫu miền thời gian phân đoạn, kết quả trong một tần số phân đoạn 

trong miền tần số. Ngược lại, ngược lại phân đoạn chuyển đổi hoạt động, khi áp 

dụng cho 

dữ liệu miền tần số, kết quả là đại diện miền thời gian của mình. 

Một tập hợp các biến đổi (và một tập hợp các biến đổi nghịch đảo) được cung 

cấp bởi DSP 

Thư viện. Tập đầu tiên áp dụng một biến đổi Fourier rời rạc (hoặc nghịch đảo 

của nó) vào một phức tạp 

tập hợp dữ liệu (xem dưới đây để mô tả các giá trị phân số phức tạp). Tập thứ 

hai 

áp dụng một loại II Discrete Cosine Transform (DCT) cho một chuỗi giá trị 

thực. Những 

biến đổi đã được thiết kế toeither hoạt động out-of-địa điểm, hoặc tại chỗ. Các 

cựu 

loại populates một chuỗi đầu ra với kết quả của việc chuyển đổi. Năm thứ hai, 

trình tự đầu vào (vật lý) được thay thế bằng các trình tự chuyển đổi. Đối với 

ngoài ra hoạt động, đủ bộ nhớ để chấp nhận các kết quả của việc tính toán phải

if (numDels != numKapps) 

fprintf ("ERROR! %d should equal to %d.\n", numDels, numKapps); 

return; 

endif 

## Initialize. 

M = filtOrder; out = zeros(numSamps,1); del = delay; 

forward = zeros(numSamps*M,1); backward = forward; i = 0; 

## Filter samples. 

for n = 1:numSamps 

## Get new sample. 

current = in(n); 

IIRLattice OCTAVE model 

DSP Library 


## Lattice structure. 

for m = 1:M 

after = current - kappas(M+1-m) * del(m+1); 

del(m) = del(m+1) + kappas(M+1-m) * after; 

i = i+1; 

forward(i) = current; 

backward(i) = after; 

current = after; 

end 

del(M+1) = after; 

## Ladder structure (computes output). 

if (gammas == 0) 

out(n) = del(M+1); 

else 

for m = 1:M+1 

out(n) = out(n) + gammas(M+2-m)*del(m); 

endfor 

endif 

endfor 

## Return. 

return; 

#.............................................................................. 

endfunction 

dsPIC 

® 

được cung cấp. 

Các biến đổi sử dụng chuyển đổi các yếu tố (hoặc hằng số) mà phải được cung 

cấp cho 

chức năng biến đổi trong các yếu tố invocation.These của nó, đó là dữ liệu phức 

tạp 

bộ, được tính trong số học dấu chấm, và sau đó chuyển đổi thành fractionals ch 

sử dụng bởi các hoạt động. Để tránh chi phí tính toán quá nhiều khi áp dụng 

chuyển đổi, một tập hợp các yếu tố chuyển đổi có thể được tạo ra một lần và sử 

dụng 

nhiều lần trong quá trình thực hiện chương trình. Vì vậy, nó được khuyến khích 

để lưu trữ các 

yếu tố trở bởi bất kỳ hoạt động khởi tạo trong một vĩnh viễn (tĩnh) phức tạp 

vector. Nó cũng là thuận lợi để tạo ra các yếu tố "off-line", và đặt chúng trong 

bộ nhớ chương trình, và sử dụng chúng khi chương trình được thực hiện sau 

đó. Bằng cách này, không chỉ 

chu kỳ, nhưng cũng có bộ nhớ RAM sẽ được lưu khi thiết kế một ứng dụng liên 

quan đến việc 

biến đổi. 

2.7.2 Vectors Complex Fractional 

Một vector dữ liệu phức tạp được thể hiện bằng một tập hợp dữ liệu trong đó 

mỗi cặp giá trị 

đại diện cho một phần tử của vector. Giá trị đầu tiên trong cặp là một phần thực 

sự của 

yếu tố, và thứ hai phần ảo của nó. Cả hai phần thực và phần ảo là 

được lưu trữ trong bộ nhớ bằng cách sử dụng một từ (hai byte) cho mỗi, và phả 

được hiểu là 

1,15 fractionals. Như với các vector phân đoạn, phân đoạn phức tạp vector lưu 

trữ của nó 

các yếu tố liên tiếp trong bộ nhớ. 

Việc tổ chức dữ liệu trong một phân đoạn vector phức tạp có thể được giải 

quyết bằng các 

cấu trúc dữ liệu sau đây: 

#ifdef phân đoạn 

ifndef fractcomplex 

struct { 

phân đoạn sản; 

IMAG phân đoạn; 

} Fractcomplex; 

# endif 

# endif 




a) Không kiểm tra ranh giới được thực hiện bởi các chức năng này. Trong phạm 

vi kích thước 

(Bao gồm cả không vector chiều dài) cũng như sử dụng không phù hợp của



2.7 TRANSFORM FUNCTIONS 


This section presents the concept of a fractional transform, as considered by the 

DSP 

Library, and describes the individual functions which perform transform 

operations. 

2.7.1 Fractional Transform Operations 

A fractional transform is a linear, time invariant, discrete operation that when 

applied to 

a fractional time domain sample sequence, results in a fractional frequency in 

the frequency domain. Conversely, inverse fractional transform operation, when 

applied to 

frequency domain data, results in its time domain representation. 

A set of transforms (and a subset of inverse transforms) are provided by the 

DSP 

Library. The first set applies a Discrete Fourier transform (or its inverse) to a 

complex 

data set (see below for a description of fractional complex values). The second 

set 

applies a Type II Discrete Cosine Transform (DCT) to a real valued sequence. 

These 

transforms have been designed toeither operate out-of-place, or in-place. The 

former 

type populates an output sequence with the results of the transformation. In the 

latter, 

the input sequence is (physically) replaced by the transformed sequence. For 

out-of-place operations, enough memory to accept the results of the 

computation must 

be provided. 

The transforms make use of transform factors (or constants) which must be 

supplied to 

the transforming function during its invocation.These factors, which are 

complex data 

sets, are computed in floating point arithmetic, and then transformed into 

fractionals for 

use by the operations. To avoid excessive computational overhead when 

applying a 

transformation, a particular set of transform factors could be generated once and 

used 

many times during the execution of the program. Thus, it is advisable to store 

the 

factors returned by any of the initialization operations in a permanent (static) 

complex 

vector. It is also advantageous to generate the factors “off-line”, and place them 

in program memory, and use them when the program is later executing. This 

way, not only 

cycles, but also RAM memory is saved when designing an application which 

nguồn phức tạp 

vectơ và bộ yếu tố có thể tạo ra kết quả bất ngờ. 

b) Đó là khuyến cáo rằng tình trạng đăng ký (SR) được kiểm tra sau khi hoàn 

thành 


sau 


c) Các vectơ đầu vào và đầu ra phức tạp liên quan đến gia đình của biến đổi 

mustbe phân bổ trong bộ nhớ Y-Data. Chuyển dạng các yếu tố có thể được phân 

bổ hoặc 

trong X-dữ liệu hoặc bộ nhớ chương trình. 

d) Bởi vì chút đảo ngược quyết yêu cầu vector thiết lập để được Modulo liên 

kết, các 

đầu vào và đầu ra phức tạp vector trong hoạt động bằng cách sử dụng một cách 

rõ ràng hoặc ngầm 

các BitReverseComplexfunction phải được phân bổ đúng cách. 

e) Các hoạt động đó trở về một điểm đến vector phức tạp có thể được lồng vào 

nhau, để cho 

Chẳng hạn, nếu: 


a = OP1 (OP2 (d), op3 (e, f)). 

dsPIC 

® 





Trong phần tiếp theo, các chức năng cá nhân thực hiện chuyển đổi và nghịch 

đảo 

hoạt động được mô tả. 

BitReverseComplex 

Mô tả: BitReverseComplexreorganizes các yếu tố của một vector phức tạp 

trong bit thứ tự ngược lại. 


Prototype: fractcomplex extern * BitReverseComplex ( 

int log2N, 

fractcomplex * srcCV 

); 

Đối số: log2N dựa 2 logarit của N (số yếu tố phức tạp trong 

vector nguồn) 

srcCV con trỏ đến nguồn vector phức tạp 

Quay trở lại giá trị: Con trỏ trỏ tới địa chỉ cơ sở của nguồn vector phức tạp. 

Bình luận: N mustbe một sức mạnh nguyên 2. 

Các srcCVvector phải được phân bổ tại một liên kết modulo N.

involves 

transformations. 

2.7.2 Fractional Complex Vectors 

A complex data vector is represented by a data set in which every pair of values 

represents an element of the vector. The first value in the pair is the real part of 

the 

element, and the second its imaginary part. Both the real and imaginary parts are 

stored in memory using one word (two bytes) for each, and must be interpreted 

as 

1.15 fractionals. As with the fractional vector, the fractional complex vector 

stores its 

elements consecutively in memory. 

The organization of data in a fractional complex vector may be addressed by the 

following data structure: 

#ifdef fractional 

#ifndef fractcomplex 

typedef struct { 

fractional real; 

fractional imag; 

} fractcomplex; 

#endif 

#endif 

DSP Library 



a) No boundary checking is performed by these functions. Out of range sizes 

(including zero length vectors) as well as nonconforming use of source complex 

vectors and factor sets may produce unexpected results. 

b) It is recommended that the Status register (SR) is examined after completion 

of 


after 


c) The input and output complex vectors involved in the family of 

transformations 

mustbe allocated in Y-Data memory. Transforms factors may be allocated either 

in X-Data or program memory. 

d) Because bit reverse addressing requires the vector set to be modulo aligned, 

the 

input and output complex vectors in operations using either explicitly or 

implicitly 

the BitReverseComplexfunction must be properly allocated. 

e) Operations which return a destination complex vector can be nested, so that 

Chức năng này hoạt động tại chỗ. 

Source File: bitrev.asm 



MODCON lưu, sử dụng, phục hồi 

XBREV lưu, sử dụng, phục hồi 





27 


Chuyển đổi Size # # Complex yếu tố chu kỳ 

32 điểm 32 245 

64 điểm 64 485 

128 điểm 128 945 

256 điểm 256 1905 



CosFactorInit 

Mô tả: CosFactorInitgenerates nửa đầu tập hợp các yếu tố cosin 

yêu cầu của một loại II Discrete Cosine Transform, và đặt kết quả 

trong vector đến phức tạp. Hiệu quả, tập chứa 

giá trị: 

, Trong đó 0 ≤k 


Prototype: fractcomplex extern * CosFactorInit ( 

int log2N, 

fractcomplex * cosFactors 

); 

Đối số: log2N dựa 2 logarit của N (số yếu tố phức tạp 

cần thiết bởi một DCT) 

cosFactors con trỏ đến các yếu tố phức tạp cosine 

Quay trở lại giá trị: Con trỏ trỏ tới địa chỉ cơ sở các yếu tố cos. 


Chỉ có N / 2 cosinefactors đầu tiên được tạo ra. 

Một vector phức tạp có kích thước N / 2 musthave đã được phân bổ và 

giao cho cosFactorsprior để gọi hàm. Các phức tạp 

vector shouldreside trong bộ nhớ X-Data.

for 

instance if: 


a = Op1 (Op2 (d), Op3 (e, f)). 

dsPIC 

® 


Các yếu tố được tính trong số học dấu chấm và chuyển đổi thành 1,15 

fractionals phức tạp. 

Source File: initcosf.c 







Không 


In what follows, the individual functions implementing transform and inverse 

transform 

operations are described. 

BitReverseComplex 

Description: BitReverseComplexreorganizes the elements of a complex vector 

in bit reverse order. 


Prototype: extern fractcomplex* BitReverseComplex ( 

int log2N, 

fractcomplex* srcCV 

); 

Arguments: log2N based 2 logarithm of N (number of complex elements in 

source vector) 

srcCV pointer to source complex vector 

Return Value: Pointer to base address of source complex vector. 

Remarks: N mustbe an integer power of 2. 

The srcCVvector must be allocated at a modulo alignment of N. 

This function operates in place. 

Source File: bitrev.asm 



MODCON saved, used, restored 

XBREV saved, used, restored 





27 


Transform Size # Complex Elements # Cycles 

32 point 32 245 





DCT 

Mô tả: DCTcomputes rời rạc Cosine Transform của một vector nguồn, và 

lưu trữ các kết quả trong vector đích. 


Nguyên mẫu: ở ngoài phân đoạn * DCT ( 

int log2N, 



fractcomplex * cosFactors, 

fractcomplex * twidFactors, 

int factPage 

); 

CN k () e 

j 

πk 

2N 

------- = 

dsPIC 

® 



Đối số: log2N dựa 2 logarit của N (số phức tạp 

phần tử trong vector nguồn) 

dstCV con trỏ tới vector điểm đến 

srcCV con trỏ tới vector nguồn 

cosFactors con trỏ đến các yếu tố cosin 

twidFactors con trỏ đến các yếu tố quay vòng

64 point 64 485 

128 point 128 945 

256 point 256 1905 

DSP Library 


CosFactorInit 

Description: CosFactorInitgenerates the first half of the set of cosine factors 

required by a Type II Discrete Cosine Transform, and places the result 

in the complex destination vector. Effectively, the set contains the 

values: 

, where 0 ≤k

and 

stores the results in the destination vector. 


Prototype: extern fractional* DCT ( 

int log2N, 



fractcomplex* cosFactors, 

fractcomplex* twidFactors, 

int factPage 

); 

CN k () e 

j 

πk 

2N 

-------= 

dsPIC 

® 


cộng thêm từ chương trình từ VectorZeroPad, và DCTIP. 


22 

cộng với chu kỳ từ VectorZeroPad, và DCTIP. 

Lưu ý: Trong các mô tả về số VectorZeroPadthe của chu kỳ 


số chu kỳ thực tế từ VectorZeroPadto thêm vào DCTis 4 ít 

hơn bất cứ số được báo cáo cho một đứng một mình VectorZeroPad. 

Trong cùng một cách, số chu kỳ thực tế từ DCTIPto thêm vào DCT 

3 ít hơn bất cứ điều gì numberis báo cáo cho một đứng một mình DCTIP. 

DCT (Tiếp theo) 

12N () / 



DCTIP 

Mô tả: DCTIPcomputes rời rạc Cosine Transform của một vector nguồn trong 

nơi. 


Nguyên mẫu: ở ngoài phân đoạn * DCTIP ( 



int log2N, 

Arguments: log2N based 2 logarithm of N (number of complex 

elements in source vector) 

dstCV pointer to destination vector 

srcCV pointer to source vector 

cosFactors pointer to cosine factors 

twidFactors pointer to twiddle factors 

factPage memory page for transform factors 



This function operates out of place. A vector of size 2N elements, must 

already have been allocated and assigned to dstV. 

The dstVvector must be allocated at a modulo alignment of N. 

The results of computation are stored in the first N elements of the 

destination vector. 

To avoid saturation (overflow) during computation, the values of the 

source vector shouldbe in the range [-0.5, 0.5]. 

Only the first N/2 cosine factors are needed. 

Only the first N/2 twiddle factors are needed. 

If the transform factors are stored in X-Data space, cosFactorsand 


fractcomplex * cosFactors, 


int factPage 

); 


trong vector nguồn) 

srcCV con trỏ tới vector nguồn 

cosFactors con trỏ đến các yếu tố cosin 

twidFactors con trỏ đến các yếu tố quay vòng 

trang bộ nhớ factPage cho chuyển đổi các yếu tố 



Chức năng này hy vọng rằng sourcevector đã không đệm để 

chiều dài 2N. 

Các srcVvector phải được phân bổ tại một liên kết modulo N. 

Các kết quả tính toán được lưu trữ trong các yếu tố đầu tiên của nguồn N 

vector. 

Để tránh bão hòa (overflow) trong tính toán, giá trị của các

twidFactorspoint to the actual address where the factors are 

allocated. If the transform factors are stored in program memory, 

cosFactorsand twidFactorsare the offset from the program page 

boundary where the factors are allocated. This latter value can be 

calculated using the inline assembly operator psvoffset(). 

If the transform factors are stored in X-Data space, factPagemust be 

set to 0xFF00 (defined value COEFFS_IN_DATA). If they are stored in 

program memory, factPageis the program page number containing 

the factors. This latter value can be calculated using the inline 

assembly operator psvpage(). 

The twiddle factors mustbe initialized with conjFlagset to a value 

different than zero. 


Output is scaled by the factor 

Source File: dctoop.asm 



plus system resources from VectorZeroPad, and DCTIP. 




plus DO/REPEATinstructions from VectorZeroPad, and DCTIP. 


nguồn vector shouldbe trong khoảng [-0.5, 0.5]. 

Chỉ có các yếu tố N / 2 cos đầu tiên là cần thiết. 

Chỉ có các yếu tố N / 2 quay vòng đầu tiên là cần thiết. 

Nếu các yếu tố chuyển đổi được lưu trữ trong không gian X-Data, 

cosFactorsand 

twidFactorspoint đến địa chỉ thực tế nơi mà các yếu tố này 

phân bổ. Nếu các yếu tố chuyển đổi được lưu trữ trong bộ nhớ chương trình, 

cosFactorsand twidFactorsare bù đắp từ trang chương trình 

ranh giới nơi các yếu tố được phân bổ. Giá trị sau này có thể 

tính bằng cách sử dụng psvoffset hành lắp ráp nội tuyến (). 

Nếu các yếu tố chuyển đổi được lưu trữ trong không gian X-Data, factPagemus 

được 

thiết lập để 0xff00 (được định nghĩa COEFFS_IN_DATA giá trị). Nếu chúng 

được lưu trữ trong 

bộ nhớ chương trình, factPageis số trang có chứa chương trình 

các yếu tố. Giá trị sau này có thể được tính toán bằng cách sử dụng nội tuyến 

hành lắp ráp psvpage (). 

Các yếu tố quay vòng mustbe khởi tạo với conjFlagset đến một giá trị 

khác nhau hơn không. 

Kết quả sẽ được thu nhỏ lại bởi yếu tố. 


12N () / 

dsPIC 

® 


16 



plus program words from VectorZeroPad, and DCTIP. 


22 

plus cycles from VectorZeroPad, and DCTIP. 

Note:In the description of VectorZeroPadthe number of cycles 


number of actual cycles from VectorZeroPadto add to DCTis 4 less 

than whatever number is reported for a stand alone VectorZeroPad. 

In the same way, the number of actual cycles from DCTIPto add to DCT 

is 3 less than whatever numberis reported for a stand alone DCTIP. 

DCT (Continued) 

12N () ⁄ 

DSP Library 


DCTIP 











cộng với DO / REPEATinstructions từ 

IFFTComplexIP. 


92 

cộng thêm từ chương trình từ IFFTComplexIP.

Description: DCTIPcomputes the Discrete Cosine Transform of a source vector 

in 

place. 


Prototype: extern fractional* DCTIP ( 

int log2N, 


fractcomplex* cosFactors, 


int factPage 

); 

Arguments: log2N based 2 logarithm of N (number of complex elements 

in source vector) 

srcCV pointer to source vector 

cosFactors pointer to cosine factors 

twidFactors pointer to twiddle factors 




This function expects that the sourcevector has been zero padded to 

length 2N. 

The srcVvector must be allocated at a modulo alignment of N. 

The results of computation are stored in the first N elements of source 

vector. 

To avoid saturation (overflow) during computation, the values of the 

source vector shouldbe in the range [-0.5, 0.5]. 



If the transform factors are stored in X-Data space, cosFactorsand 

twidFactorspoint to the actual address where the factors are 

allocated. If the transform factors are stored in program memory, 

cosFactorsand twidFactorsare the offset from the program page 

boundary where the factors are allocated. This latter value can be 

calculated using the inline assembly operator psvoffset(). 

If the transform factors are stored in X-Data space, factPagemust be 






71 + 10N, hoặc 

73 + 11N nếu các yếu tố trong bộ nhớ chương trình, 

cộng với chu kỳ từ IFFTComplexIP 

Lưu ý: Trong các mô tả về số IFFTComplexIPthe của chu kỳ 


số chu kỳ thực tế từ IFFTComplexIPto thêm vào DCTIPis 4 

ít hơn bất cứ số được báo cáo cho một đứng một mình 


FFTComplex 

Mô tả: FFTComplexcomputes rời rạc đổi Fourier của một nguồn 

vector phức tạp, và lưu trữ các kết quả trong các địa điểm phức tạp 

vector. 


Prototype: fractcomplex extern * FFTComplex ( 

int log2N, 

fractcomplex * dstCV, 

fractcomplex * srcCV, 


int factPage 

); 



dstCV con trỏ đến đích vector phức tạp 


địa chỉ twidFactors cơ sở các yếu tố quay vòng 


Quay trở lại giá trị: Con trỏ trỏ tới địa chỉ cơ sở của địa điểm vector phức tạp. 

DCTIP (Tiếp theo) 




Chức năng này hoạt động trên place.A vector phức tạp, đủ để lớn 

nhận được kết quả của hoạt động này, mustalready đã được giao 

và giao cho dstCV. 

Các dstCVvector phải được phân bổ tại một liên kết modulo N. 

Các yếu tố trong nguồn vector phức tạp được dự kiến trong trật tự tự nhiên. 

Các yếu tố trong điểm đến vector phức tạp được tạo ra trong tự nhiên 

trật tự.


different than zero. 

Output is scaled by the factor . 


12N () ⁄ 

dsPIC 

® 


Để tránh bão hòa (overflow) duringcomputation, tầm quan trọng của 

giá trị của các nguồn phức tạp vector shouldbe trong khoảng [-0.5, 0.5]. 


Nếu các yếu tố quay vòng được lưu trữ trong không gian X-Data, 

twidFactorspoints 

đến địa chỉ thực tế mà các yếu tố được phân bổ. Nếu quay vòng 

yếu tố được lưu trữ trong bộ nhớ chương trình, twidFactorsis bù đắp từ 

ranh giới trang chương trình mà các yếu tố được phân bổ. Sau này 

giá trị có thể được tính bằng cách sử dụng toán tử lắp ráp nội tuyến 



psvoffset (). 






PSVPAG saved, used, restored (only if 

coefficients in P memory) 




plus DO/REPEATinstructions from 



92 

plus program words from IFFTComplexIP. 


71 + 10N, or 

73 + 11N if factors in program memory, 

plus cycles from IFFTComplexIP 

Note:In the description of IFFTComplexIPthe number of cycles 


number of actual cycles from IFFTComplexIPto add to DCTIPis 4 

less than whatever number is reported for a stand alone 


FFTComplex 

Description: FFTComplexcomputes the Discrete Fourier Transform of a source 

complex vector, and stores the results in the destination complex 

vector. 


Prototype: extern fractcomplex*FFTComplex ( 

Nếu các yếu tố quay vòng được lưu trữ trong không gian X-Data, factPagemust 

được 






Các yếu tố quay vòng mustbe khởi tạo với conjFlagset không. 

Kết quả sẽ được thu nhỏ lại bởi yếu tố 1 / N. 

Source File: fftoop.asm 



cộng với tài nguyên hệ thống từ VectorCopy, FFTComplexIP, và 

BitReverseComplex. 




cộng với DO / REPEATinstructions từ VectorCopy, FFTComplexIP, 

và BitReverseComplex. 


17 

cộng thêm từ chương trình từ VectorCopy, FFTComplexIP, và 



23 

cộng với chu kỳ từ VectorCopy, FFTComplexIP, và 


Lưu ý: Trong các mô tả về số VectorCopythe chu kỳ báo cáo 

bao gồm 3 chu kỳ của C-chức năng calloverhead. Như vậy, số lượng 

chu kỳ thực tế từ VectorCopyto thêm vào FFTComplexis 3 ít hơn 

bất cứ số được báo cáo cho một đứng một mình VectorCopy. Trong

int log2N, 

fractcomplex* dstCV, 

fractcomplex* srcCV, 


int factPage 

); 



dstCV pointer to destination complex vector 


twidFactors base address of twiddle factors 


Return Value: Pointer to base address of destination complex vector. 

DCTIP (Continued) 

DSP Library 



This function operates out of place.A complex vector, large enough to 

receive the results of the operation, mustalready have been allocated 

and assigned to dstCV. 

The dstCVvector must be allocated at a modulo alignment of N. 

The elements in source complex vector are expected in natural order. 

The elements in destination complex vector are generated in natural 

order. 

To avoid saturation (overflow) duringcomputation, the magnitude of the 

values of the source complex vector shouldbe in the range [-0.5, 0.5]. 


If the twiddle factors are stored in X-Data space, twidFactorspoints 

to the actual address where the factors are allocated. If the twiddle 

factors are stored in program memory, twidFactorsis the offset from 

the program page boundary where the factors are allocated. This latter 

value can be calculated using the inline assembly operator 

psvoffset(). 

If the twiddle factors are stored in X-Data space, factPagemust be 





The twiddle factors mustbe initialized with conjFlagset to zero. 

cùng một cách, số chu kỳ thực tế từ FFTComplexIPto thêm vào 

FFTComplexis 4 ít hơn bất cứ số được báo cáo cho một đứng 

FFTComplexIP mình. Và những từ BitReverseComplexare 2 

ít hơn bất cứ số được báo cáo cho một FFTComplex đứng một mình. 

FFTComplex (Tiếp theo) 

dsPIC 

® 



FFTComplexIP 


Mô tả: FFTComplexIPcomputes rời rạc đổi Fourier của một nguồn 

vector phức tạp tại chỗ .. 


Prototype: fractcomplex extern * FFTComplexIP ( 

int log2N, 



int factPage 

); 

Đối số: log2N dựa 2 logarit của N (số phức tạp 

phần tử trong vector nguồn) 







Các kết quả chuyển đổi được lưu trữ trong bit thứ tự ngược. 

Để tránh bão hòa (overflow) trong tính toán, độ lớn của 

giá trị của các vector phức tạp nguồn nên trong khoảng [-0.5, 0.5]. 








psvoffset (). 


được 

thiết lập để 0xff00 (được định nghĩa COEFFS_IN_DATA giá trị). Nếu chúng

Output is scaled by the factor 1/N. 

Source File: fftoop.asm 



plus system resources from VectorCopy, FFTComplexIP, and 





plus DO/REPEATinstructions from VectorCopy, FFTComplexIP, 

and BitReverseComplex. 


17 

plus program words from VectorCopy, FFTComplexIP, and 



23 

plus cycles from VectorCopy, FFTComplexIP, and 


Note:In the description of VectorCopythe number of cycles reported 

includes 3 cycles of C-function calloverhead. Thus, the number of 

actual cycles from VectorCopyto add to FFTComplexis 3 less than 

whatever number is reported for a stand alone VectorCopy. In the 

same way, the number of actual cycles from FFTComplexIPto add to 

FFTComplexis 4 less than whatever number is reported for a stand 

alone FFTComplexIP. And those from BitReverseComplexare 2 

less than whatever number is reported for a stand alone FFTComplex. 

FFTComplex (Continued) 

dsPIC 

® 



FFTComplexIP 


Description: FFTComplexIPcomputes the Discrete Fourier Transform of a 

source 

complex vector in place.. 


Prototype: extern fractcomplex*FFTComplexIP ( 

int log2N, 





Các yếu tố quay vòng mustbe khởi tạo với conjFlagset không. 

Kết quả sẽ được thu nhỏ lại bởi yếu tố 1 / N. 

Source File: fft.asm 















59 

Chu kỳ (bao gồm C-functioncall và trả các chi phí): 

Chuyển đổi kích thước 

# Nếu chu kỳ quay vòng 

Các yếu tố trong X-mem 

# Nếu chu kỳ quay vòng 

Các yếu tố trong P-mem 

32 điểm 1633 1795 

64 điểm 3739 4125 

128 điểm 8485 9383 

256 điểm 19.055 21.105 

IFFTComplex 

Mô tả: IFFTComplexcomputes các Inverse Discrete đổi Fourier của một 

nguồn vector phức tạp, và lưu trữ các kết quả ở đích đến 

vector phức tạp. 


Prototype: fractcomplex extern * IFFTComplex ( 

int log2N,



int factPage 

); 

Arguments: log2N based 2 logarithm of N (number of complex 

elements in source vector) 







The resulting transform is stored in bit reverse order. 

To avoid saturation (overflow) during computation, the magnitude of the 

values of the source complex vector should be in the range [-0.5, 0.5]. 







psvoffset(). 






The twiddle factors mustbe initialized with conjFlagset to zero. 

Output is scaled by the factor 1/N. 

Source File: fft.asm 

DSP Library 








PSVPAG saved, used, restored (only if 

fractcomplex * dstCV, 



int factPage 

); 



dstCV con trỏ đến đích vector phức tạp 




Quay trở lại giá trị: Con trỏ trỏ tới địa chỉ cơ sở của địa điểm vector phức tạp. 

FFTComplexIP (Tiếp theo) 

dsPIC 

® 





Chức năng này hoạt động trên place.A vector phức tạp, đủ để lớn 

nhận được kết quả của hoạt động này, mustalready đã được giao 

và giao cho dstCV. 

Các dstCVvector phải được phân bổ tại một liên kết modulo N. 


Các yếu tố trong điểm đến vector phức tạp được tạo ra trong tự nhiên 

trật tự. 

Để tránh bão hòa (overflow) trong tính toán, độ lớn của 








psvoffset (). 


được 





hành lắp ráp psvpage ().

coefficients in P memory) 





59 

Cycles (including C-functioncall and return overheads): 

Transform Size 

# Cycles if Twiddle 

Factors in X-mem 

# Cycles if Twiddle 

Factors in P-mem 

32 point 1,633 1,795 

64 point 3,739 4,125 

128 point 8,485 9,383 

256 point 19,055 21,105 

IFFTComplex 

Description: IFFTComplexcomputes the Inverse Discrete Fourier Transform of 

a 

source complex vector, and stores the results in the destination 

complex vector. 


Prototype: extern fractcomplex*IFFTComplex ( 

int log2N, 

fractcomplex* dstCV, 



int factPage 

); 



dstCV pointer to destination complex vector 




Return Value: Pointer to base address of destination complex vector. 

FFTComplexIP (Continued) 

dsPIC 

® 


khác hơn không. 


Source File: ifftoop.asm 



cộng với tài nguyên hệ thống từ VectorCopy, và IFFTComplexIP. 




cộng với DO / REPEATinstructions từ VectorCopy, và 



12 

cộng thêm từ chương trình từ VectorCopy, và IFFTComplexIP. 


15 

cộng với chu kỳ từ VectorCopy, và IFFTComplexIP. 

Lưu ý: Trong các mô tả về số VectorCopythe chu kỳ báo cáo 

bao gồm 3 chu kỳ của C-chức năng gọi điện trên không. Như vậy, số lượng 

chu kỳ thực tế từ VectorCopyto thêm vào IFFTComplexis 3 ít hơn 

bất cứ số được báo cáo cho một đứng một mình VectorCopy. Trong 

cùng một cách, số chu kỳ thực tế từ IFFTComplexIPto thêm vào 

IFFTComplexis 4 ít hơn bất cứ số được báo cáo cho một đứng 

IFFTComplexIP mình. 

IFFTComplex (Tiếp theo) 



IFFTComplexIP 

Mô tả: IFFTComplexIPcomputes các Inverse Discrete đổi Fourier của 

một nguồn vector phức tạp tại chỗ .. 


Prototype: fractcomplex extern * IFFTComplexIP ( 

int log2N, 



int factPage 

); 

Đối số: log2N dựa 2 logarit của N (số yếu tố phức tạp




This function operates out of place.A complex vector, large enough to 

receive the results of the operation, mustalready have been allocated 

and assigned to dstCV. 

The dstCVvector must be allocated at a modulo alignment of N. 


The elements in destination complex vector are generated in natural 

order. 

To avoid saturation (overflow) during computation, the magnitude of the 







psvoffset(). 







other than zero. 


Source File: ifftoop.asm 



plus system resources from VectorCopy, and IFFTComplexIP. 







Các yếu tố trong nguồn vector phức tạp được dự kiến trong bit ngược 

trật tự. Các kết quả chuyển đổi được lưu trữ trong trật tự tự nhiên. 

Các srcCVvector phải được phân bổ tại một liên kết modulo N. 

Để tránh bão hòa (overflow) duringcomputation, tầm quan trọng của 








psvoffset (). 


được 







khác hơn không. 


Source File: ifft.asm 

dsPIC 

® 







plus DO/REPEATinstructions from VectorCopy, and 



12 

plus program words from VectorCopy, and IFFTComplexIP. 




cộng với tài nguyên hệ thống từ FFTComplexIP, và 





cộng với DO / REPEATinstructions từ FFTComplexIP, và

15 

plus cycles from VectorCopy, and IFFTComplexIP. 

Note:In the description of VectorCopythe number of cycles reported 

includes 3 cycles of C-function call overhead. Thus, the number of 

actual cycles from VectorCopyto add to IFFTComplexis 3 less than 

whatever number is reported for a stand alone VectorCopy. In the 

same way, the number of actual cycles from IFFTComplexIPto add to 

IFFTComplexis 4 less than whatever number is reported for a stand 

alone IFFTComplexIP. 

IFFTComplex (Continued) 

DSP Library 


IFFTComplexIP 

Description: IFFTComplexIPcomputes the Inverse Discrete Fourier Transform 

of 

a source complex vector in place.. 


Prototype: extern fractcomplex*IFFTComplexIP ( 

int log2N, 



int factPage 

); 








The elements in source complex vector are expected in bit reverse 

order. The resulting transform is stored in natural order. 

The srcCVvector must be allocated at a modulo alignment of N. 

To avoid saturation (overflow) duringcomputation, the magnitude of the 








11 

cộng thêm từ chương trình từ FFTComplexIP, và 



15 

cộng với chu kỳ từ FFTComplexIP, và BitReverseComplex. 

Lưu ý: Trong các mô tả về số FFTComplexIPthe của chu kỳ 


số chu kỳ thực tế từ FFTComplexIPto thêm vào 

IFFTComplexIPis 3 ít hơn bất cứ số được báo cáo cho một 

đứng một mình 

FFTComplexIP. Trong cùng một cách, số chu kỳ thực tế từ 

BitReverseComplexto thêm vào IFFTComplexIPis 2 ít hơn 

bất cứ số được báo cáo cho một đứng một mình BitReverseComplex. 

TwidFactorInit 

Mô tả: TwidFactorInitgenerates nửa đầu tập hợp các yếu tố quay vòng 

yêu cầu của một Discrete Fourier Transform hoặc rời rạc Cosine Transform, 

và đặt kết quả trong vector đến phức tạp. Có hiệu quả, 

tập hợp chứa các giá trị: 

, Trong đó 0 ≤k ≤N / 2, cho conjFlag = 0 

, Trong đó 0 ≤k ≤N / 2, cho conjFlag! = 0 


Prototype: fractcomplex extern * TwidFactorInit ( 

int log2N, 


int conjFlag 

); 


cần thiết bởi một DFT) 

twidFactors con trỏ đến các yếu tố quay vòng phức tạp 

conjFlag cờ để cho biết giá trị liên hợp ornot là 

để được tạo ra 

Quay trở lại giá trị: Con trỏ trỏ tới địa chỉ cơ sở các yếu tố quay vòng. 

IFFTComplexIP (Tiếp theo) 

WN k () e 

j 

2πk


psvoffset(). 







other than zero. 


Source File: ifft.asm 

dsPIC 

® 





plus system resources from FFTComplexIP, and 





plus DO/REPEATinstructions from FFTComplexIP, and 



11 

plus program words from FFTComplexIP, and 



15 

plus cycles from FFTComplexIP, and BitReverseComplex. 

Note:In the description of FFTComplexIPthe number of cycles 


number of actual cycles from FFTComplexIPto add to 

IFFTComplexIPis 3 less than whatever number is reported for a 

stand alone 

FFTComplexIP. In the same way, the number of actual cycles from 

BitReverseComplexto add to IFFTComplexIPis 2 less than 

whatever number is reported for a stand alone BitReverseComplex. 

N 

--------- - - 

= 

WN k () e 

j 

2πk 

N 

--------- - = 




Chỉ có các yếu tố N / 2 quay vòng đầu tiên được tạo ra. 

Giá trị của conjFlagdetermines dấu trong lập luận của 

hàm mũ. Đối với phía trước phép biến đổi Fourier, conjFlag 

nên được thiết lập để "0". Đối nghịch đảo phép biến đổi Fourier rời rạc và 

Cosin Transforms, conjFlagshould được thiết lập để "1". 

Một vector phức tạp có kích thước N / 2 phải đã được phân bổ và 

giao cho twidFactorsprior để gọi hàm. Các phức tạp 

vector shouldbe phân bổ trong bộ nhớ X-Data. 

Các yếu tố tính toán trong số học dấu chấm và chuyển đổi thành 1,15 

fractionals phức tạp. 

Source File: inittwid.c 





Không 





TwidFactorInit (Tiếp theo) 

dsPIC 

® 



GHI CHÚ: 

dsPIC 

®LANGUAGE CÔNG CỤ

TwidFactorInit 

Description: TwidFactorInitgenerates the first half of the set of twiddle factors 

required by a Discrete Fourier Transform or Discrete Cosine Transform, 

and places the result in the complex destination vector. Effectively, the 

set contains the values: 

, where 0 ≤k ≤N/2, for conjFlag= 0 

, where 0 ≤k ≤N/2, for conjFlag! = 0 


Prototype: extern fractcomplex*TwidFactorInit ( 

int log2N, 


int conjFlag 

); 

Arguments: log2N based 2 logarithm of N (number of complex factors 

needed by a DFT) 

twidFactors pointer to complex twiddle factors 

conjFlag flag to indicate whether ornot conjugate values are 

to be generated 

Return Value: Pointer to base address of twiddle factors. 

IFFTComplexIP (Continued) 

WN k() e 

j 

2πk 

N 

--------- - – 

= 

WN k() e 

j 

2πk 

N 

--------- -= 

DSP Library 



Only the first N/2 twiddle factors are generated. 

The value of conjFlagdetermines the sign in the argument of the 

exponential function. For forward Fourier Transforms, conjFlag 

should be set to ‘0’. For inverse Fourier Transforms and Discrete 

Cosine Transforms, conjFlagshould be set to ‘1’. 

THƯ VIỆN 


Chương 3: dsPIC Thư viện ngoại vi 


Chương này làm rõ chức năng và các macro có trong thiết bị ngoại vi dsPIC 

thư viện. Ví dụ về sử dụng cũng được cung cấp. 

Mã kích thước cho mỗi chức năng thư viện hoặc vĩ mô có thể được tìm thấy 

trong các tập tin readme.txtin 

pic30_tools \ src \ ngoại vi. 

3.1.1 ứng dụng .Assembly Mã 

Phiên bản miễn phí của các thư viện và các tập tin tiêu đề liên quan có sẵn từ 

Trang web của Microchip. Mã nguồn được bao gồm. 




• lib- dsPIC tập tin thư viện ngoại vi 

• src \ peripheral- mã nguồn cho các chức năng thư viện và một tập tin thực thi 

để xây dựng lại 

thư viện 

• tập tin tiêu đề hỗ trợ \ h- cho các thư viện 



• Sử dụng thư viện dsPIC ngoại vi 

Chức năng phần mềm 

• Chức năng màn hình LCD bên ngoài 

Chức năng phần cứng 

• Chức năng CAN 

• Chức năng ADC12 

• Chức năng ADC10 

• Chức năng hẹn giờ 

• Chức năng lập lại / Control 

• I / O Port Chức năng 

• Input Capture chức năng 

• Đầu ra so sánh chức năng 

• Chức năng UART 

• Chức năng DCI 

• Chức năng SPI 

• Chức năng QEI 

• Chức năng PWM 

• Chức năng I2C

A complex vector of size N/2 must have already been allocated and 

assigned to twidFactorsprior to invoking the function. The complex 

vector shouldbe allocated in X-Data memory. 

Factors computed in floating point arithmetic and converted to 1.15 

complex fractionals. 

Source File: inittwid.c 





None 





TwidFactorInit (Continued) 

dsPIC 

® 



NOTES: 

dsPIC 


LIBRARIES 



Chapter 3. dsPIC Peripheral Libraries 


This chapter documents the functions and macros contained in the dsPIC 

peripheral 

libraries. Examples of use are also provided. 

Code size for each library function or macro may be found in the file 

readme.txtin 

pic30_tools\src\peripheral. 

3.1.1 .Assembly Code Applications 

Free versions of these libraries and associated header files are available from the 

Microchip web site. Source code is included. 




• lib– dsPIC peripheral library files 

dsPIC 

® 




3.2 SỬ DỤNG THƯ VIỆN dsPIC PERIPHERAL 

Xây dựng một ứng dụng mà sử dụng các thư viện ngoại vi dsPIC đòi hỏi một 

tập tin thư viện xử lý cụ thể và một tập tin tiêu đề cho mỗi module ngoại vi. 

Đối với mỗi thiết bị ngoại vi, phần đầu tập tin tương ứng cung cấp tất cả các 

mẫu thử nghiệm chức năng, 

#definesand typedefsused bởi thư viện. Các tập tin thư viện lưu trữ có chứa tất 

cả các 

đối tượng tập tin cá nhân cho mỗi chức năng thư viện. 

Các tập tin tiêu đề là của peripheral.h hình thức, nơi ngoại vi = tên của 

đặc biệt hữu thiết bị ngoại vi sử dụng (ví dụ, can.hfor CAN). 

Các tập tin thư viện có dạng libpDevice-omf.a, nơi thiết bị thiết bị = dsPIC 

số lượng (ví dụ, libp30F6014-coff.afor thiết bị dsPIC30F6014.) Xem 

Mục 1.2 "Thư viện OMF-cụ thể / khởi động mô-đun" để biết thêm về OMF cụ 

thể 

thư viện. 

Khi biên dịch một ứng dụng, tập tin tiêu đề phải được tham chiếu (sử dụng # 

include) bởi 

tất cả các file nguồn mà gọi một chức năng trong thư viện hoặc sử dụng các ký 

hiệu hoặc typedefs của nó. 

Khi kết nối một ứng dụng, tập tin thư viện phải được cung cấp như một đầu vào 

để mối liên kết 

(Bằng cách sử dụng chuyển đổi -llinker --libraryor) như vậy mà các chức năng 



Các tập tin thực thi makeplib.batmay được sử dụng để làm lại các thư viện. Mặ 

định 

Hành vi này là để xây dựng thư viện ngoại vi cho tất cả các bộ vi xử lý mục tiêu 

hỗ trợ; Tuy nhiên, 

bạn có thể chọn một bộ xử lý đặc biệt để xây dựng bằng cách đặt tên nó trên 

dòng lệnh. Đối với 

Ví dụ: 

30f6014 makeplib.bat 

hoặc 

makeplib.bat 30F6014 

sẽ xây dựng thư viện cho các thiết bị dsPIC30F6014. 

3.3 CHỨC NĂNG LCD NGOÀI 

Phần này bao gồm một danh sách các chức năng riêng biệt để giao tiếp với P-te 

PCOG1602B 

Bộ điều khiển màn hình LCD và một ví dụ về việc sử dụng các chức năng trong 

phần này. Chức năng có thể 

được thực hiện như các macro. 

Các chức năng màn hình LCD bên ngoài chỉ được hỗ trợ cho các thiết bị sau

• src\peripheral– source code for library functions and a batch file to rebuild 

the library 

• support\h– header files for libraries 



• Using the dsPIC Peripheral Libraries 

Software Functions 

• External LCD Functions 

Hardware Functions 

• CAN Functions 

• ADC12 Functions 

• ADC10 Functions 

• Timer Functions 

• Reset/Control Functions 

• I/O Port Functions 

• Input Capture Functions 

• Output Compare Functions 

• UART Functions 

• DCI Functions 

• SPI Functions 

• QEI Functions 

• PWM Functions 

• I2C Functions 

dsPIC 

® 




3.2 USING THE dsPIC PERIPHERAL LIBRARIES 

Building an application which utilizes the dsPIC Peripheral Libraries requires a 

processor-specific library file and a header file for each peripheral module. 

For each peripheral, the corresponding header file provides all the function 

prototypes, 

#definesand typedefsused by the library. The archived library file contains all 

the 

individual object files for each library function. 

The header files are of the form peripheral.h, where peripheral= name of the 

particular peripheral being used (e.g., can.hfor CAN.) 

The library files are of the form libpDevice-omf.a, where Device= dsPIC device 

number (e.g., libp30F6014-coff.afor the dsPIC30F6014 device.) See 

Section 1.2 “OMF-Specific Libraries/StarTup Modules”for more on OMFđây: 

• dsPIC30F5011 







dsPIC Thư viện ngoại vi 



BusyXLCD 

Kiểm tra chức năng này cho cờ bận rộn của P-tec PCOG1602B LCD: Mô tả 

điều khiển. 

Bao gồm: xlcd.h 

Prototype: char BusyXLCD (void); 

Lập luận: Không 

Quay trở lại giá trị: Nếu "1" được trả lại, nó cho thấy rằng bộ điều khiển màn 

hình LCD là bận rộn và không thể 

thực hiện bất kỳ lệnh. 

Nếu "0" được trả lại, nó chỉ ra rằng màn hình LCD đã sẵn sàng cho lệnh tiếp 

theo. 

Ghi chú: Chức năng này trả về trạng thái của cờ bận rộn của P-tec 

PCOG1602B LCD điều khiển. 

Source File: BusyXLCD.c 

Mã số Ví dụ: trong khi (BusyXLCD ()); 

OpenXLCD 

Mô tả: Chức năng này cấu hình I / O pins và khởi tạo các P-tec 



Prototype: void OpenXLCD (unsigned char lcdtype); 

Đối số: lcdtype này chứa các thông số điều khiển LCD được 

cấu hình như dưới đây: 

Loại giao diện 

FOUR_BIT 

EIGHT_BIT 

Số dòng 

SINGLE_LINE 

TWO_LINE 

Phân khúc hướng truyền dữ liệu

specific 

libraries. 

When compiling an application, header file must be referenced (using #include) 

by 

all source files which call a function in the library or use its symbols or 

typedefs. 

When linking an application, the library file must be provided as an input to the 

linker 

(using the --libraryor -llinker switch) such that the functions used by the 


The batch file makeplib.batmay be used to remake the libraries. The default 

behavior is to build peripheral libraries for all supported target processors; 

however, 

you may select a particular processor to build by naming it on the command 

line. For 

example: 

makeplib.bat 30f6014 

or 

makeplib.bat 30F6014 

will rebuild the library for the dsPIC30F6014 device. 

3.3 EXTERNAL LCD FUNCTIONS 

This section contains a list of individual functions for interfacing with P-tec 

PCOG1602B 

LCD controller and an example of use of the functions in this section. Functions 

may 

be implemented as macros. 

The external LCD functions are only supported for the following devices: 








dsPIC Peripheral Libraries 



BusyXLCD 

Description: This function checks for the busy flag of the P-tec PCOG1602B 

LCD 

controller. 

Include: xlcd.h 

Prototype: char BusyXLCD(void); 

SEG1_50_SEG51_100 

SEG1_50_SEG100_51 

SEG100_51_SEG50_1 

SEG100_51_SEG1_50 

COM truyền dữ liệu hướng 

COM1_COM16 

COM16_COM1 

Trở lại giá trị: Không 

Ghi chú: Chức năng này cấu hình các chân I / O dùng để điều khiển P-tec 

PCOG1602B LCD điều khiển. Nó cũng khởi tạo controller.The LCD 

I / O pin định nghĩa đó phải được thực hiện để đảm bảo rằng màn hình LCD bê 

ngoài 

hoạt động chính xác là: 

dsPIC 

® 



Điều khiển I / O pin định nghĩa 

RW_PIN PORTxbits.Rx? 

TRIS_RW TRISxbits.Rx? 

RS_PIN PORTxbits.Rx? 

TRIS_RS TRISxbits.Rx? 

E_PIN PORTxbits.Rx? 

TRIS_E TRISxbits.Rx? 

nơi XIS các PORT,? là số pin 

Pin định nghĩa dữ liệu 

DATA_PIN_? PORTxbits.RD? 


TRIS_DATA_PIN_? TRISxbits.TRISD? 

nơi XIS các PORT,? là số pin 

Các chân dữ liệu có thể từ một trong hai cảng hoặc từ nhiều cổng. 

Các chân điều khiển có thể được trên bất kỳ cổng và không phải để được vào 

cùng một cổng. Giao diện dữ liệu phải được xác định là 4-bit hoặc 8-bit. 

Giao diện 8-bit được định nghĩa khi một 

# xác định EIGHT_BIT_INTERFACE được bao gồm trong các tập tin tiêu đề 

xlcd.h. Nếu không xác định được bao gồm, thenthe giao diện 4-bit được bao 

gồm. 

Sau khi các định nghĩa này đã được thực hiện, người dùng phải biên dịch 

mã ứng dụng vào một đối tượng được liên kết. 

Chức năng này cũng đòi hỏi phải có ba thói quen bên ngoài cho sự chậm trễ cụ 

thể: 

DelayFor18TCY () 18 Tcy chậm trễ

Arguments: None 

Return Value: If ‘1’ is returned, it indicates that the LCD controller is busy and 

can not 

take any command. 

If ‘0’ is returned, it indicates that the LCD is ready for next command. 

Remarks: This function returns the status of the busy flag of the P-tec 

PCOG1602B LCD controller. 

Source File: BusyXLCD.c 

Code Example: while(BusyXLCD()); 

OpenXLCD 

Description: This function configures the I/O pins and initializes the P-tec 



Prototype: void OpenXLCD (unsigned char lcdtype); 

Arguments: lcdtype This contains the LCD controller parameters to be 

configured as defined below: 

Type of interface 

FOUR_BIT 

EIGHT_BIT 

Number of lines 

SINGLE_LINE 

TWO_LINE 

Segment data transfer direction 

SEG1_50_SEG51_100 

SEG1_50_SEG100_51 

SEG100_51_SEG50_1 

SEG100_51_SEG1_50 

COM data transfer direction 

COM1_COM16 

COM16_COM1 

Return Value: None 

Remarks: This function configures the I/O pins used to control the P-tec 

PCOG1602B LCD controller. It also initializes the LCD controller.The 

I/O pin definitions that must be made to ensure that the external LCD 

operates correctly are: 

dsPIC 

® 




DelayPORXLCD () chậm trễ 15ms 

DelayXLCD () 5ms chậm trễ 

Delay100XLCD () 100Tcy chậm trễ 

Source File: openXLCD.c 

Mã số Ví dụ: OpenXLCD (EIGHT_BIT & TWO_LINE 

& SEG1_50_SEG51_100 & COM1_COM16); 

putsXLCD 

putrsXLCD 

Mô tả: Chức năng này ghi một chuỗi ký tự cho PCOG1602B P-tec 

LCD điều khiển. 


Prototype: void putsXLCD (char * buffer); 

làm mất hiệu lực putrsXLCD (char rom const * đệm); 

Đối số: đệm Con trỏ trỏ tới các nhân vật để bewritten với bộ điều khiển màn 

hình LCD. 


Ghi chú: Các chức năng viết một chuỗi ký tự nằm trong các bufferto 

P-tec PCOG1602B LCD điều khiển cho đến khi một nhân vật NULL là gặp 

phải 

trong chuỗi. 

Đối với màn hình hiển thị liên tục của dữ liệu bằng văn bản cho P-tec 

PCOG1602B LCD 

điều khiển, bạn có thể thiết lập màn hình hiển thị trong một chế độ Shift. 

Source File: PutsXLCD.c 

PutrsXLCD.c 

Mã số Ví dụ: char display_char [13]; 

putsXLCD (display_char); 

OpenXLCD (Tiếp theo) 



ReadAddrXLCD 

Mô tả: Chức năng này đọc các byte địa chỉ từ P-tec PCOG1602B LCD 



Prototype: unsigned char ReadAddrXLCD (void); 


Trở lại giá trị: Chức năng này trả về một 8-bit là địa chỉ 7-bit ở phía dưới 

7 bit của byte và cờ BUSYstatus trong bit thứ 8. 

Ghi chú: Chức năng này đọc các byte địa chỉ từ P-tec PCOG1602B LCD 

điều khiển. Người dùng đầu tiên phải kiểm tra xem nếu bộ điều khiển màn hình 

LCD đang bận

Control I/O pin definitions 

RW_PIN PORTxbits.Rx? 

TRIS_RW TRISxbits.Rx? 

RS_PIN PORTxbits.Rx? 

TRIS_RS TRISxbits.Rx? 

E_PIN PORTxbits.Rx? 

TRIS_E TRISxbits.Rx? 

where xis the PORT, ?is the pin number 

Data pin definitions 

DATA_PIN_? PORTxbits.RD? 

TRIS_DATA_PIN_? TRISxbits.TRISD? 

where xis the PORT, ?is the pin number 

The Data pins can be from either one port or from multiple ports. 

The control pins can be on any port and are not required to be on the 

same port. The data interface must be defined as either 4-bit or 8-bit. 

The 8-bit interface is defined when a 

#define EIGHT_BIT_INTERFACE is included in the header file 

xlcd.h. If no define is included, thenthe 4-bit interface is included. 

After these definitions have been made, the user must compile the 

application code into an object to be linked. 

This function also requires three external routines for specific delays: 

DelayFor18TCY() 18 Tcy delay 

DelayPORXLCD() 15ms delay 

DelayXLCD() 5ms delay 

Delay100XLCD() 100Tcy delay 

Source File: openXLCD.c 

Code Example: OpenXLCD(EIGHT_BIT &TWO_LINE 

& SEG1_50_SEG51_100 &COM1_COM16); 

putsXLCD 

bằng cách gọi BusyXLCD () chức năng. 

Địa chỉ đọc từ bộ điều khiển cho máy phát điện nhân vật 

RAM hoặc bộ nhớ RAM hiển thị dữ liệu tùy thuộc vào trước 

Đặt ?? RamAddr () chức năng được gọi là nơi ?? có thể quản trị hoặc 

DD. 

Source File: ReadAddrXLCD.c 

Mã số Ví dụ: địa chỉ char; 

trong khi (BusyXLCD ()); 

địa chỉ = ReadAddrXLCD (); 

ReadDataXLCD 

Mô tả: Chức năng này đọc một dữ liệu bytefrom P-tec PCOG1602B LCD 



Prototype: char ReadDataXLCD (void); 


Ghi chú: Chức năng này đọc một dữ liệu bytefrom P-tec PCOG1602B LCD 


LCD đang bận 


Đọc dữ liệu từ bộ điều khiển là cho RAM máy phát điện nhân vật hoặc 

RAM hiển thị dữ liệu tùy thuộc vào trước Set ?? RamAddr () 

chức năng được gọi là nơi ?? hoặc là CG hay DD. 

Trở lại giá trị: Chức năng này trả về giá trị dữ liệu 8-bit chỉ bởi địa chỉ. 

Source File: ReadDataXLCD.c 

Mã số Ví dụ: char dữ liệu; 


dữ liệu = ReadDataXLCD (); 

dsPIC 

® 


putrsXLCD 

Description: This function writes a string of characters to the P-tec PCOG1602B 


SetCGRamAddr 


LCD controller. 


Prototype: void putsXLCD (char *buffer); 

void putrsXLCD (const rom char *buffer); 

Arguments: buffer Pointer to the characters to bewritten to the LCD controller. 


Remarks: These functions write a string of characters located in bufferto the 

P-tec PCOG1602B LCD controller till a NULL character is encountered 

Mô tả: Chức năng này đặt địa chỉ máy phát điện nhân vật. 


Prototype: void SetCGRamAddr (unsigned char CGaddr); 

Đối số: CGaddr địa chỉ máy phát điện nhân vật. 


Ghi chú: Chức năng này đặt địa chỉ máy phát điện nhân vật của P-tec 

PCOG1602B LCD điều khiển. Người dùng đầu tiên phải kiểm tra xem nếu 

điều khiển là bận rộn bằng cách gọi BusyXLCD () chức năng.

in the string. 

For continuous display of data written to the P-tec PCOG1602B LCD 

controller, you could set up the display in a Shift mode. 

Source File: PutsXLCD.c 

PutrsXLCD.c 

Code Example: char display_char[13]; 

putsXLCD(display_char); 

OpenXLCD (Continued) 



ReadAddrXLCD 

Description: This function reads the address byte from the P-tec PCOG1602B 

LCD 

controller. 


Prototype: unsigned char ReadAddrXLCD (void); 


Return Value: This function returns an 8-bit which is the 7-bit address in the 

lower 

7 bits of the byte and the BUSYstatus flag in the 8th bit. 

Remarks: This function reads the address byte from the P-tec PCOG1602B 

LCD 

controller. The user must first check to see if the LCD controller is busy 

by calling the BusyXLCD()function. 

The address read from the controller is for the character generator 

RAM or the display data RAM depending on the previous 

Set??RamAddr()function that was called where ?? can be CG or 

DD. 

Source File: ReadAddrXLCD.c 

Code Example: char address; 

while(BusyXLCD()); 

address = ReadAddrXLCD(); 

ReadDataXLCD 

Description: This function reads a data bytefrom the P-tec PCOG1602B LCD 

controller. 


Prototype: char ReadDataXLCD (void); 


Remarks: This function reads a data bytefrom the P-tec PCOG1602B LCD 


Source File: SetCGRamAddr.c 

Mã số Ví dụ: char cgaddr = 0x1f; 


SetCGRamAddr (cgaddr); 

SetDDRamAddr 

Mô tả: Chức năng này đặt địa chỉ hiển thị dữ liệu. 


Prototype: void SetDDRamAddr (unsigned char DDaddr); 

Đối số: DDaddr địa chỉ dữ liệu hiển thị. 


Ghi chú: Chức năng này đặt dataaddress hiển thị của PCOG1602B P-tec 

LCD điều khiển. Người dùng đầu tiên phải kiểm tra xem nếu bộ điều khiển là 

bận rộn 


Source File: SetDDRamAddr.c 

Mã số Ví dụ: char ddaddr = 0x10; 


SetDDRamAddr (ddaddr); 

WriteDataXLCD 

Mô tả: Chức năng này ghi một byte dữ liệu (một nhân vật) từ P-tec 



Prototype: void WriteDataXLCD (dữ liệu char); 

Đối số: dữ liệu Giá trị của datacan được bất kỳ giá trị 8-bit, nhưng nên 

tương ứng với các bảng tính RAM của P-tec 



Ghi chú: Chức năng này ghi một dữ liệu byteto P-tec PCOG1602B LCD 




Đọc dữ liệu từ bộ điều khiển là cho RAM máy phát điện nhân vật hoặc 

RAM hiển thị dữ liệu tùy thuộc vào trước Set ?? RamAddr () 

chức năng được gọi là nơi ?? đề cập đến một trong hai CG hoặc DD. 

Source File: WriteDataXLCD.c 

Mã số Ví dụ: WriteDataXLCD (0x30); 



WriteCmdXLCD 

Mô tả: Chức năng này ghi một commandto P-tec PCOG1602B LCD

y calling the BusyXLCD()function. 

The data read from the controller is for the character generator RAM or 

the display data RAM depending on the previous Set??RamAddr() 

function that was called where ?? is either CG or DD. 

Return Value: This function returns the 8-bit data value pointed by the address. 

Source File: ReadDataXLCD.c 

Code Example: char data; 

while (BusyXLCD()); 

data = ReadDataXLCD(); 

dsPIC 

® 




Prototype: void WriteCmdXLCD (unsigned char cmd); 

Đối số: cmd này chứa các thông số điều khiển màn hình LCD được cấu hình 

như 

quy định dưới đây: 

Loại giao diện 

FOUR_BIT 

EIGHT_BIT 

Số dòng 

SINLE_LINE 

TWO_LINE 

Phân khúc hướng truyền dữ liệu 


SetCGRamAddr 


SEG1_50_SEG51_100 

SEG1_50_SEG100_51 

Description: This function sets the character generator address. 


Prototype: void SetCGRamAddr(unsigned char CGaddr); 

Arguments: CGaddr Character generator address. 


Remarks: This function sets the character generator address of the P-tec 

PCOG1602B LCD controller. The user must first check to see if the 

controller is busy by calling the BusyXLCD()function. 

Source File: SetCGRamAddr.c 

Code Example: char cgaddr = 0x1F; 


SetCGRamAddr(cgaddr); 

SetDDRamAddr 

Description: This function sets the display data address. 


Prototype: void SetDDRamAddr(unsigned char DDaddr); 

Arguments: DDaddr Display data address. 


Remarks: This function sets the display dataaddress of the P-tec PCOG1602B 

LCD controller. The user must first check to see if the controller is busy 


Source File: SetDDRamAddr.c 

Code Example: char ddaddr = 0x10; 


SetDDRamAddr(ddaddr); 

SEG100_51_SEG50_1 

SEG100_51_SEG1_50 

COM truyền dữ liệu hướng 

COM1_COM16 

COM16_COM1 

Hiển thị On / Off kiểm soát 

DON 

Lột nón 

CURSOR_ON 

CURSOR_OFF 

BLINK_ON 

BLINK_OFF 

Con trỏ hoặc hiển thị định nghĩa phím Shift 

SHIFT_CUR_LEFT 

SHIFT_CUR_RIGHT 

SHIFT_DISP_LEFT 

SHIFT_DISP_RIGHT 


Ghi chú: Chức năng này viết các byte lệnh cho P-tec PCOG1602B LCD 




Source File: WriteCmdXLCD.c 

Mã số Ví dụ: trong khi (BusyXLCD ()); 

WriteCmdXLCD (EIGHT_BIT & TWO_LINE);

WriteDataXLCD 

Description: This function writes a data byte (one character) from the P-tec 



Prototype: void WriteDataXLCD (char data); 

Arguments: data The value of datacan be any 8-bit value, but should 

correspond to the character RAM table of the P-tec 



Remarks: This function writes a data byteto the P-tec PCOG1602B LCD 



The data read from the controller is for the character generator RAM or 

the display data RAM depending on the previous Set??RamAddr() 

function that was called where ??refers to either CG or DD. 

Source File: WriteDataXLCD.c 

Code Example: WriteDataXLCD(0x30); 



WriteCmdXLCD 

Description: This function writes a commandto the P-tec PCOG1602B LCD 

controller. 


Prototype: void WriteCmdXLCD (unsigned char cmd); 

Arguments: cmd This contains the LCD controller parameters to be configured 

as 

defined below: 

Type of interface 

FOUR_BIT 

EIGHT_BIT 

Number of lines 

SINLE_LINE 

TWO_LINE 

Segment data transfer direction 

SEG1_50_SEG51_100 

SEG1_50_SEG100_51 

SEG100_51_SEG50_1 

SEG100_51_SEG1_50 

COM data transfer direction 

WriteCmdXLCD (DON); 

WriteCmdXLCD (SHIFT_DISP_LEFT); 

dsPIC 

® 



3.3.2 Ví dụ về sử dụng 

# xác định __dsPIC30F6014__ 

# include 

# include 

/ * Giữ địa chỉ của tin nhắn * / 

char * buffer; 

dữ liệu char; 

mesg1 char [] = {'H', 'A', 'R', 'D', 'W', 'A', 'R', 'E', '\ 0'}; 

mesg2 char [] = {'P', 'E', 'R', 'tôi', 'P', 'H', 'E', 'R', 'A', 'L' 

'', 'L', 'tôi', 'B', '', '\ 0'}; 

int main (void) 

{ 

/ * Giao diện Set 8 bit và hai màn hình hiển thị dòng * / 

OpenXLCD (EIGHT_BIT & TWO_LINE & SEG1_50_SEG51_100 

& COM1_COM16); 

/ * Chờ cho đến khi bộ điều khiển màn hình LCD đang bận rộn * / 


/ * Bật màn hình * / 

WriteCmdXLCD (DON & CURSOR_ON & BLINK_OFF); 

đệm = mesg1; 

PutsXLCD (đệm); 


/ * Thiết lập địa chỉ DDRAM đến 0x40 để dispaly dữ liệu trong dòng thứ hai * 

SetDDRamAddr (0x40); 


đệm = mesg2; 

PutsXLCD (đệm); 


trở về 0; 

} 



3.4 chức năng CAN 

Phần này bao gồm một danh sách các chức năng riêng biệt cho CAN và một ví

COM1_COM16 

COM16_COM1 

Display On/Off control 

DON 

DOFF 

CURSOR_ON 

CURSOR_OFF 

BLINK_ON 

BLINK_OFF 

Cursor or Display Shift defines 

SHIFT_CUR_LEFT 

SHIFT_CUR_RIGHT 

SHIFT_DISP_LEFT 

SHIFT_DISP_RIGHT 


Remarks: This function writes the command byte to the P-tec PCOG1602B 

LCD 


by calling the BusyXLCD() function. 

Source File: WriteCmdXLCD.c 

Code Example: while(BusyXLCD()); 

WriteCmdXLCD(EIGHT_BIT & TWO_LINE); 

WriteCmdXLCD(DON); 

WriteCmdXLCD(SHIFT_DISP_LEFT); 

dsPIC 

® 



3.3.2 Example of Use 

#define __dsPIC30F6014__ 

#include 

#include 

/* holds the address of message */ 

char * buffer; 

char data ; 


char mesg1[] = {'H','A','R','D','W','A','R','E','\0'}; 

char mesg2[] = {'P','E','R','I','P’,’H’,’E’,’R’,’A’,’L’ 

dụ về việc sử dụng 

chức năng. Chức năng có thể được thực hiện như các macro. 


CAN1AbortAll 

CAN2AbortAll 

Mô tả: Chức năng này khởi hủy bỏ ofall các truyền cấp phát. 

Bao gồm: can.h 

Prototype: void CAN1AbortAll (void); 

làm mất hiệu lực CAN2AbortAll (void); 



Ghi chú: Chức năng này đặt bit ABAT trong CiCTRL đăng ký do đó việc bắt 

đầu 

hủy bỏ tất cả các truyền cấp phát. Tuy nhiên, việc truyền tải là 

đã được tiến hành sẽ không được hủy bỏ. Bit này được xóa bởi 

phần cứng khi truyền thông đã thành công 

hủy bỏ. 

Source File: CAN1AbortAll.c 

CAN2AbortAll.c 

Mã số Ví dụ: CAN1AbortAll (); 

CAN1GetRXErrorCount 


Mô tả: Chức năng này trả về giá trị nhận được số lỗi. 


Prototype: unsigned char CAN1GetRXErrorCount (void); 

unsigned char CAN2GetRXErrorCount (void); 


Quay trở lại giá trị: nội dung của CiRERRCNT, đó là 8 bit. 

Bình luận: Chức năng này trả về nội dung của CiRERRCNT (byte thấp của 

CIEC 

đăng ký) mà chỉ ra được lỗi đếm. 

Source File: CAN1GetRXErrorCount.c 

CAN2GetRXErrorCount.c 

Mã số Ví dụ: unsigned char rx_error_count; 

rx_error_count = CAN1GetRXErrorCount (); 

dsPIC 

® 


‘ ‘, ‘L’,’I’,’B’,’ ‘,'\0'}; 



int main(void) 

CAN1GetTXErrorCount

{ 

/* Set 8bit interface and two line display */ 

OpenXLCD(EIGHT_BIT & TWO_LINE & SEG1_50_SEG51_100 

& COM1_COM16); 

/* Wait till LCD controller is busy */ 


/* Turn on the display */ 

WriteCmdXLCD(DON & CURSOR_ON & BLINK_OFF); 

buffer = mesg1; 

PutsXLCD(buffer); 


/* Set DDRam address to 0x40 to dispaly data in the second line */ 

SetDDRamAddr(0x40); 


buffer = mesg2; 

PutsXLCD(buffer); 


return 0; 

} 



3.4 CAN FUNCTIONS 

This section contains a list of individual functions for CAN and an example of 

use of the 

functions. Functions may be implemented as macros. 


CAN1AbortAll 

CAN2AbortAll 

Description: This function initiates abort ofall the pending transmissions. 

Include: can.h 

Prototype: void CAN1AbortAll(void); 

void CAN2AbortAll(void); 



Remarks: This function sets the ABAT bit in CiCTRL register thus initiating the 

abort of all pending transmission. However, the transmission which is 

already in progress will not be aborted. This bit gets cleared by 

hardware when the message transmission has been succesfully 

aborted. 

CAN2GetTXErrorCount 

Mô tả: Chức năng này trả về giá trị số lỗi truyền. 


Prototype: unsigned char CAN1GetTXErrorCount (void); 

unsigned char CAN2GetTXErrorCount (void); 


Quay trở lại giá trị: nội dung của CiTERRCNT, đó là 8 bit. 

Bình luận: Chức năng này trả về nội dung của CiTERRCNT (byte trên của 

CIEC 

đăng ký) mà chỉ ra số lượng lỗi phát. 

Source File: CAN1GetTXErrorCount.c 

CAN2GetTXErrorCount.c 

Mã số Ví dụ: unsigned char tx_error_count; 

tx_error_count = CAN1GetTXErrorCount (); 

CAN1IsBusOff 

CAN2IsBusOff 

Mô tả: Chức năng này xác định liệu các nút CAN đang ở chế độ BusOff. 


Prototype: char CAN1IsBusOff (void); 

char CAN2IsBusOff (void); 


Quay trở lại giá trị: Nếu giá trị của TXBO là "1", sau đó "1" được trả lại, chỉ ra 

rằng các xe buýt 

đã bị tắt do lỗi trong truyền tải. 

Nếu giá trị của TXBO là "0", sau đó "0" được trả lại, chỉ ra rằng các xe buýt 

không được tắt. 

Ghi chú: Chức năng này trả về tình trạng ofthe TXBO chút CiINTF đăng ký. 

Source File: CAN1IsBusOff.c 

CAN2IsBusOff.c 

Mã số Ví dụ: trong khi (CAN1IsBusOff ()); 

CAN1IsRXReady 

CAN2IsRXReady 

Mô tả: Chức năng này trả về tình trạng bộ đệm nhận đầy đủ. 


Prototype: char CAN1IsRXReady (char); 

CAN2IsRXReady char (char); 

Đối số: buffno Giá trị của buffno cho bộ đệm nhận có tình trạng 

được yêu cầu. 

Quay trở lại giá trị: Nếu RXFUL là 1, nó chỉ ra rằng bộ đệm nhận có chứa một 

đã nhận 

tin nhắn.

Source File: CAN1AbortAll.c 

CAN2AbortAll.c 

Code Example: CAN1AbortAll(); 



Description: This function returns the receive error count value. 


Prototype: unsigned char CAN1GetRXErrorCount(void); 

unsigned char CAN2GetRXErrorCount(void); 


Return Value: contents of CiRERRCNT, which is 8 bits. 

Remarks: This function returns the contents of CiRERRCNT (lower byte of 

CiEC 

register) which indicates the receive error count. 

Source File: CAN1GetRXErrorCount.c 

CAN2GetRXErrorCount.c 

Code Example: unsigned char rx_error_count; 

rx_error_count = CAN1GetRXErrorCount(); 

dsPIC 

® 






Description: This function returns the transmit error count value. 


Prototype: unsigned char CAN1GetTXErrorCount(void); 

unsigned char CAN2GetTXErrorCount(void); 


Return Value: contents of CiTERRCNT, which is 8 bits. 

Remarks: This function returns the contents of CiTERRCNT (upper byte of 

CiEC 

register) which indicates the transmit error count. 

Source File: CAN1GetTXErrorCount.c 

CAN2GetTXErrorCount.c 

Code Example: unsigned char tx_error_count; 

tx_error_count = CAN1GetTXErrorCount(); 

CAN1IsBusOff 

CAN2IsBusOff 

Description: This function determines whether the CAN node is in BusOff 

Nếu RXFUL là 0, nó chỉ ra rằng bộ đệm nhận được mở cửa để nhận 

tin nhắn mới. 

Ghi chú: Chức năng này trả về tình trạng ofthe bit RXFUL của Nhận kiểm soát 

đăng ký. 

Source File: CAN1IsRXReady.c 

CAN2IsRXReady.c 

Mã số Ví dụ: char rx_1_status; 

rx_1_status = CAN1IsRXReady (1); 



CAN1IsRXPassive 


Mô tả: Chức năng này xác định nếu người nhận là lỗi nhà nước thụ động. 


Prototype: char CAN1IsRXPassive (void); 

char CAN2IsRXPassive (void); 


Quay trở lại giá trị: Nếu giá trị của RXEP là "1", sau đó "1" được trả lại, chỉ ra 

các nút 

sẽ bị động do lỗi trong tiếp nhận. 

Nếu giá trị của RXEP là "0", sau đó "0" được trả lại, cho thấy không có lỗi trên 

xe buýt. 

Ghi chú: Chức năng này trả về tình trạng ofthe RXEP chút CiINTF đăng ký. 

Source File: CAN1IsRXPassive.c 

CAN2IsRXPassive.c 

Mã số Ví dụ: char rx_bus_status; 

rx_bus_status = CAN1IsRXPassive (); 

CAN1IsTXPassive 


Mô tả: Chức năng này xác định nếu phát là lỗi nhà nước thụ động. 


Prototype: char CAN1IsTXPassive (void); 

char CAN2IsTXPassive (void); 


Quay trở lại giá trị: Nếu giá trị của TXEP là "1", sau đó "1" được trả lại, cho 

thấy lỗi trên 

chuyển xe buýt và xe buýt sẽ bị động. 

Nếu giá trị của TXEP là "0", sau đó "0" được trả lại, cho thấy không có lỗi trên 

chuyển xe buýt. 

Ghi chú: Chức năng này trả về trạng thái của bit TXEP của CiINTF đăng ký.

mode. 


Prototype: char CAN1IsBusOff(void); 

char CAN2IsBusOff(void); 


Return Value: If the value of TXBO is ‘1’, then ‘1’ is returned, indicating that 

the bus 

has been turned off due to error in transmission. 

If the value of TXBO is ‘0’, then ‘0’ is returned, indicating that the bus 

not been turned off. 

Remarks: This function returns the status ofthe TXBO bit of CiINTF register. 

Source File: CAN1IsBusOff.c 

CAN2IsBusOff.c 

Code Example: while(CAN1IsBusOff()); 

CAN1IsRXReady 

CAN2IsRXReady 

Description: This function returns the receive buffer full status. 


Prototype: char CAN1IsRXReady(char); 

char CAN2IsRXReady(char); 

Arguments: buffno The value of buffno indicates the receive buffer whose 

status 

is required. 

Return Value: If RXFUL is 1, it indicates that the receive buffer contains a 

received 

message. 

If RXFUL is 0, it indicates that the receive buffer is open to receive a 

new message. 

Remarks: This function returns the status ofthe RXFUL bit of Receive Control 

register. 

Source File: CAN1IsRXReady.c 

CAN2IsRXReady.c 

Code Example: char rx_1_status; 

rx_1_status = CAN1IsRXReady(1); 





Description: This function determines if the receiver is in Error Passive state. 


Prototype: char CAN1IsRXPassive(void); 

Source File: CAN1IsTXPassive.c 

CAN2IsTXPassive.c 

Mã số Ví dụ: char tx_bus_status; 

tx_bus_status = CAN1IsTXPassive (); 

dsPIC 

® 



CAN1IsTXReady 

CAN2IsTXReady 


Mô tả: Chức năng này trả về tình trạng phát cho thấy nếu nút CAN 

sẵn sàng để truyền tiếp theo. 


Prototype: char CAN1IsTXReady (char); 

CAN2IsTXReady char (char); 

Đối số: buffno Giá trị của buffno cho bộ đệm truyền có 

tình trạng là bắt buộc. 

Quay trở lại giá trị: Nếu TXREQ là "1", nó sẽ trả về "0" chỉ ra rằng bộ đệm 

truyền không phải là 

sản phẩm nào. 

Nếu TXREQ là "0", nó sẽ trả về "1" chỉ ra rằng bộ đệm truyền rỗng 

và máy phát đã sẵn sàng để truyền tiếp theo. 

Ghi chú: Chức năng này trả về complimentof bit TXREQ Tình trạng trong 

Truyền đăng ký kiểm soát. 

Source File: CAN1IsTXReady.c 

CAN2IsTXReady.c 

Mã số Ví dụ: char tx_2_status; 

tx_2_status = CAN1IsTXReady (2); 

CAN1ReceiveMessage 


Mô tả: Chức năng này đọc dữ liệu từ bộ đệm nhận. 


Prototype: void CAN1ReceiveMessage (unsigned char * 

dữ liệu, datalen unsigned char, char MsgFlag); 

khoảng trống CAN2ReceiveMessage (unsigned char * 

dữ liệu, datalen unsigned char, char MsgFlag); 

Đối số: dữ liệu Con trỏ đến vị trí mà nhận được dữ liệu là được 

được lưu trữ từ. 

datalen Số lượng các byte dữ liệu dự kiến. 

MsgFlag Số đệm nơi dữ liệu được nhận.

char CAN2IsRXPassive(void); 


Return Value: If the value of RXEP is ‘1’, then ‘1’ is returned, indicating the 

node 

going passive due to error in reception. 

If the value of RXEP is ‘0’, then ‘0’ is returned, indicating no error on 

bus. 

Remarks: This function returns the status ofthe RXEP bit of CiINTF register. 

Source File: CAN1IsRXPassive.c 

CAN2IsRXPassive.c 

Code Example: char rx_bus_status; 

rx_bus_status = CAN1IsRXPassive(); 



Description: This function determines if the transmitter is in Error Passive state. 


Prototype: char CAN1IsTXPassive(void); 

char CAN2IsTXPassive(void); 


Return Value: If the value of TXEP is ‘1’, then ‘1’ is returned, indicating error 

on 

transmit bus and the bus going passive. 

If the value of TXEP is ‘0’, then ‘0’ is returned, indicating no error on 

transmit bus. 

Remarks: This function returns the status of the TXEP bit of CiINTF register. 

Source File: CAN1IsTXPassive.c 

CAN2IsTXPassive.c 

Code Example: char tx_bus_status; 

tx_bus_status = CAN1IsTXPassive(); 

dsPIC 

® 



CAN1IsTXReady 

CAN2IsTXReady 


Description: This function returns the transmitter status indicating if the CAN 

node is 

ready for next transmission. 


Prototype: char CAN1IsTXReady(char); 

Nếu "1", các dữ liệu từ CiRX1B1 để CiRX1B4 được đọc. 

Nếu "0" hay nói cách khác, các dữ liệu từ CiRX0B1 để CiRX0B4 là 

đọc. 

Ghi chú: Chức năng này đọc dữ liệu nhận được vào các vị trí chỉ bởi đầu vào 

dữ liệu tham số. 

Quay trở lại giá trị: Không có. 

Source File: CAN1ReceiveMessage.c 

CAN2ReceiveMessage.c 

Mã số Ví dụ: unsigned char * rx_data; 

CAN1ReceiveMessage (rx_data, 5, 0); 



CAN1SendMessage 


Mô tả: Chức năng này ghi dữ liệu được truyền đến TX đăng ký, thiết lập dữ liệu 

chiều dài và bắt đầu truyền. 


Prototype: void CAN1SendMessage (int sid, 

eid unsigned long, unsigned char * dữ liệu, 

datalen unsigned char, char MsgFlag); 

khoảng trống CAN2SendMessage (int sid, 

eid unsigned long, unsigned char * dữ liệu, 

datalen unsigned char, char MsgFlag); 

Đối số: Sid giá trị 16-bit được ghi vào sổ đăng ký CiTXnSID. 

CAN_TX_SID (x) XIS giá trị SID yêu cầu. 

Yêu cầu thay thế từ xa 

CAN_SUB_REM_TX_REQ 

CAN_SUB_NOR_TX_REQ 

Loại tin nhắn ID 

CAN_TX_EID_EN 

CAN_TX_EID_DIS 

Eid giá trị 32-bit được ghi vào CiTXnEID và 

CiTXnDLC đăng ký. 

CAN_TX_EID (x) XIS giá trị EID yêu cầu. 

Yêu cầu thay thế từ xa 

CAN_REM_TX_REQ 

CAN_NOR_TX_REQ 

dữ liệu Con trỏ đến vị trí mà dữ liệu được truyền là 

lưu trữ.

char CAN2IsTXReady(char); 

Arguments: buffno The value of buffno indicates the transmit buffer whose 

status is required. 

Return Value: If TXREQ is ‘1’, it returns ‘0’ indicating that the transmit buffer 

is not 

empty. 

If TXREQ is ‘0’, it returns ‘1’ indicating that the transmit buffer is empty 

and the transmitter is ready for next transmission. 

Remarks: This function returns the complimentof the TXREQ Status bit in the 

Transmit Control register. 

Source File: CAN1IsTXReady.c 

CAN2IsTXReady.c 

Code Example: char tx_2_status; 

tx_2_status = CAN1IsTXReady(2); 



Description: This function read the data from the receive buffer. 


Prototype: void CAN1ReceiveMessage(unsigned char * 

data, unsigned char datalen, char MsgFlag); 

datalen Số lượng các byte dữ liệu được truyền đi. 

MsgFlag Số lượng bộ đệm ("0", "1" hoặc "2") từ nơi dữ liệu có 

truyền đi. 

Nếu "1", dữ liệu được wriiten vào CiTX1B1 để CiTX1B4. 

Nếu '2', dữ liệu được wriiten vào CiTX2B1 để CiTX2B4. 

Nếu "0" hay nói cách khác, các dữ liệu được ghi vào CiTX0B1 để 

CiTX0B4. 


Ghi chú: Chức năng này ghi các giá trị định danh vào SID và EID đăng ký, 

dữ liệu được truyền vào TX reg, thiết lập chiều dài dữ liệu và tu 

truyền bằng cách thiết lập TXREQ bit. 

Source File: CAN1SendMessage.c 

CAN2SendMessage.c 

Mã số Ví dụ: CAN1SendMessage ((CAN_TX_SID (1920)) và 

(CAN_TX_EID_EN) & (CAN_SUB_NOR_TX_REQ), 

(CAN_TX_EID (12.344)) & (CAN_NOR_TX_REQ), 

Txdata, datalen, tx_rx_no); 

dsPIC 

® 


void CAN2ReceiveMessage(unsigned char * 

data, unsigned char datalen,char MsgFlag); 

Arguments: data The pointer to the location where received data is to be 


CAN1SetFilter 

CAN2SetFilter 


stored from. 

datalen The number of bytes of data expected. 

MsgFlag The buffer number where data is received. 

If ‘1’, the data from CiRX1B1 to CiRX1B4 is read. 

If ‘0’ or otherwise, the data from CiRX0B1 to CiRX0B4 is 

read. 

Remarks: This function reads the received data into the locations pointed by 

input 

parameter data. 

Return Value: None. 

Source File: CAN1ReceiveMessage.c 

CAN2ReceiveMessage.c 

Code Example: unsigned char*rx_data; 

CAN1ReceiveMessage(rx_data, 5, 0); 




Mô tả: Chức năng này đặt giá trị bộ lọc chấp nhận (SID và EID) cho 

bộ lọc quy định. 


Prototype: void CAN1SetFilter (char filter_no, int sid, 

unsigned eid dài); 

khoảng trống CAN2SetFilter (char filter_no, int sid, 


Đối số: filter_no Các bộ lọc (0, 1, 2, 3, 4 hoặc 5) mà giá trị bộ lọc mới 

phải được cấu hình. 

sid giá trị 16-bit được ghi vào sổ đăng ký CiRXFnSID. 

CAN_FILTER_SID (x) XIS giá trị SID yêu cầu. 

Loại tin nhắn được nhận 

CAN_RX_EID_EN 

CAN_RX_EID_DIS 

Eid giá trị 32-bit được ghi vào CiRXFnEIDH và 

CiRXFnEIDL đăng ký.


Description: This function writes data to be transmitted to TX registers, sets the 

data 

length and initiates the transmission. 


Prototype: void CAN1SendMessage(unsigned int sid, 

unsigned long eid, unsigned char *data, 

unsigned char datalen, char MsgFlag); 

void CAN2SendMessage(unsigned int sid, 

unsigned long eid, unsigned char *data, 

unsigned char datalen, char MsgFlag); 

Arguments: sid The 16-bit value to be written into CiTXnSID registers. 

CAN_TX_SID(x) xis the required SID value. 

Substitute Remote Request 

CAN_SUB_REM_TX_REQ 

CAN_SUB_NOR_TX_REQ 

Message ID Type 

CAN_TX_EID_EN 

CAN_TX_EID_DIS 

eid The 32-bit value to be written into CiTXnEID and 

CiTXnDLC registers. 

CAN_TX_EID(x) xis the required EID value. 

Substitute Remote Request 

CAN_REM_TX_REQ 

CAN_NOR_TX_REQ 

data The pointer to the location where data to be transmitted is 

stored. 

datalen The number of bytes of data to be transmitted. 

MsgFlag The buffer number (‘0’, ‘1’ or ‘2’) from where data is 

transmitted. 

If ‘1’, the data is wriiten into CiTX1B1 to CiTX1B4. 

If ‘2’, the data is wriiten into CiTX2B1 to CiTX2B4. 

If ‘0’ or otherwise, the data is written into CiTX0B1 to 

CiTX0B4. 


Remarks: This function writes the identifier values into SID and EID registers, 

data to be transmitted into TX reg, sets the data length and initiates 

transmission by setting TXREQ bit. 

Source File: CAN1SendMessage.c 

CAN_FILTER_EID (x) XIS giá trị EID yêu cầu. 


Ghi chú: Chức năng này ghi giá trị 16-bit của sidinto đăng ký CiRXFnSID 

và hoặc giá trị 32-bit của eidinto các CiRXFnEIDH và CiRXFnEIDL 

đăng ký tương ứng với bộ lọc theo quy định của filter_no. 

Lọc 0 được thực hiện như là mặc định. 

Source File: CAN1SetFilter.c 

CAN2SetFilter.c 

Mã số Ví dụ: CAN1SetFilter (1, CAN_FILTER_SID (7) & 

CAN_RX_EID_EN, CAN_FILTER_EID (3)); 

CAN1SetMask 

CAN2SetMask 

Mô tả: Chức năng này đặt giá trị mặt nạ chấp nhận (SID và EID) cho 

mặt nạ chỉ định. 


Prototype: void CAN1SetMask (char mask_no, int sid, 


khoảng trống CAN2SetMask (char mask_no, int sid, 


Đối số: mask_no Mặt nạ ("0" hoặc "1") mà giá trị mặt nạ phải 

cấu hình. 

sid giá trị 16-bit được ghi vào sổ đăng ký CiRXMnSID. 

CAN_MASK_SID (x) XIS giá trị SID yêu cầu. 

Trận đấu / bỏ qua tin nhắn typespecified trong bộ lọc 

CAN_MATCH_FILTER_TYPE 

CAN_IGNORE_FILTER_TYPE 

Eid giá trị 32-bit được ghi vào CiRXMnEIDH và 

CiRXMnEIDL đăng ký. 

CAN_MASK_EID (x) XIS giá trị EID yêu cầu. 




Ghi chú: Chức năng này ghi giá trị 16-bit của sidinto đăng ký CiRXFnSID 

và hoặc giá trị 32-bit của eidinto các CiRXFnEIDH và CiRXFnEIDL 

đăng ký tương ứng tothe mặt nạ theo quy định của mask_no. 

Lọc 0 được thực hiện như là mặc định. 

Source File: CAN1SetMask.c 

CAN2SetMask.c 

Mã số Ví dụ: CAN1SetMask (1, CAN_MASK_SID (7) &

CAN2SendMessage.c 

Code Example: CAN1SendMessage((CAN_TX_SID(1920)) & 

(CAN_TX_EID_EN) & (CAN_SUB_NOR_TX_REQ), 

(CAN_TX_EID(12344)) & (CAN_NOR_TX_REQ), 


dsPIC 

® 



CAN1SetFilter 

CAN2SetFilter 


Description: This function sets the acceptance filter values (SID and EID) for 

the 

specified filter. 


Prototype: void CAN1SetFilter(char filter_no, unsigned int sid, 

unsigned long eid); 

void CAN2SetFilter(char filter_no, unsigned int sid, 


Arguments: filter_no The filter (0, 1, 2, 3, 4 or 5) for which new filter values 

have to be configured. 

sid The 16-bit value to be written into CiRXFnSID registers. 

CAN_FILTER_SID(x) xis the required SID value. 

Type of message to be received 

CAN_RX_EID_EN 

CAN_RX_EID_DIS 

eid The 32-bit value to be written into CiRXFnEIDH and 

CiRXFnEIDL registers. 

CAN_FILTER_EID(x) xis the required EID value. 


Remarks: This function writes the 16-bit value of sidinto the CiRXFnSID 

register 

and or the 32-bit value of eidinto the CiRXFnEIDH and CiRXFnEIDL 

registers corresponding to the filter specified by filter_no. 

Filter 0 is taken as default. 

Source File: CAN1SetFilter.c 

CAN2SetFilter.c 

Code Example: CAN1SetFilter(1, CAN_FILTER_SID(7) & 

CAN_RX_EID_EN, CAN_FILTER_EID(3)); 

CAN1SetMask 

CAN_MATCH_FILTER_TYPE, CAN_MASK_EID (3)); 

CAN1SetOperationMode 


Mô tả: Chức năng này cấu hình các module CAN 


Prototype: void CAN1SetOperationMode (int config); 

khoảng trống CAN2SetOperationMode (int config); 

Đối số: cấu hình giá trị 16-bit được nạp vào CiCTRL đăng ký, các 

sự kết hợp của các định nghĩa sau đây. 

CAN_IDLE_CONCAN Mở ở chế độ nhàn rỗi 

CAN_IDLE_STOPCAN Dừng ở chế độ nhàn rỗi 

CAN_MASTERCLOCK_1FCANis ngoại tệ 

CAN_MASTERCLOCK_0FCANis 4 ngoại tệ 

CAN phương thức hoạt động 

CAN_REQ_OPERMODE_NOR 

CAN_REQ_OPERMODE_DIS 

CAN_REQ_OPERMODE_LOOPBK 

CAN_REQ_OPERMODE_LISTENONLY 

CAN_REQ_OPERMODE_CONFIG 

CAN_REQ_OPERMODE_LISTENALL 

THỂ Chụp Bật / Tắt 

CAN_CAPTURE_EN 

CAN_CAPTURE_DIS 


Ghi chú: Chức năng này cấu hình các bit sau CiCTRL: -CSIDL, 

REQOP và CANCKS 

Source File: CAN1SetOperationMode.c 

CAN2SetOperationMode.c 

Mã số Ví dụ: CAN1SetOperationMode (CAN_IDLE_STOP & 

CAN_MASTERCLOCK_0 & CAN_REQ_OPERMODE_DIS & 

CAN_CAPTURE_DIS); 

CAN1SetMask (Tiếp theo) 

CAN2SetMask 

dsPIC 

® 



CAN1SetOperationModeNoWait 

CAN2SetOperationModeNoWait

CAN2SetMask 

Description: This function sets the acceptance mask values (SID and EID) for 

the 

specified mask. 


Prototype: void CAN1SetMask(char mask_no, unsigned int sid, 


void CAN2SetMask(char mask_no, unsigned int sid, 


Arguments: mask_no The mask (‘0’ or ‘1’) for which mask values have to be 

configured. 

sid The 16-bit value to be written into CiRXMnSID registers. 

CAN_MASK_SID(x) xis the required SID value. 

Match/ignore message typespecified in filter 

CAN_MATCH_FILTER_TYPE 

CAN_IGNORE_FILTER_TYPE 

eid The 32-bit value to be written into CiRXMnEIDH and 

CiRXMnEIDL registers. 

CAN_MASK_EID(x) xis the required EID value. 




Remarks: This function writes the 16-bit value of sidinto the CiRXFnSID 

register 

and or the 32-bit value of eidinto the CiRXFnEIDH and CiRXFnEIDL 

registers corresponding tothe mask specified by mask_no. 

Filter 0 is taken as default. 

Source File: CAN1SetMask.c 

CAN2SetMask.c 

Code Example: CAN1SetMask(1, CAN_MASK_SID(7) & 

CAN_MATCH_FILTER_TYPE, CAN_MASK_EID(3)); 



Description: This function configures the CAN module 


Prototype: void CAN1SetOperationMode(unsigned int config); 

void CAN2SetOperationMode(unsigned int config); 

Arguments: config The 16-bit value to be loaded into CiCTRL register, the 

combination of the following defines. 

CAN_IDLE_CONCAN On in Idle mode 

Mô tả: Chức năng này hủy bỏ các truyền cấp phát và cấu hình CAN 

mô-đun 


Prototype: void CAN1SetOperationModeNoWait ( 

int config); 

khoảng trống CAN2SetOperationModeNoWait ( 

int config); 

Đối số: cấu hình giá trị 16-bit được loadedinto CiCTRL đăng ký, 


CAN_IDLE_CON_NO_WAITCAN Mở ở chế độ nhàn rỗi 

CAN_IDLE_STOP_NO_WAITCAN Dừng ở chế độ nhàn rỗi 

CAN_MASTERCLOCK_1_NO_WAITFCANis ngoại tệ 

CAN_MASTERCLOCK_0_NO_WAITFCANis 4 ngoại tệ 

CAN phương thức hoạt động 

CAN_REQ_OPERMODE_NOR_NO_WAIT 

CAN_REQ_OPERMODE_DIS_NO_WAIT 

CAN_REQ_OPERMODE_LOOPBK_NO_WAIT 

CAN_REQ_OPERMODE_LISTENONLY_NO_WAIT 

CAN_REQ_OPERMODE_CONFIG_NO_WAIT 

CAN_REQ_OPERMODE_LISTENALL_NO_WAIT 

THỂ Chụp Bật / Tắt 

CAN_CAPTURE_EN_NO_WAIT 

CAN_CAPTURE_DIS_NO_WAIT 


Ghi chú: Chức năng này đặt bit Abort do đó bắt đầu hủy bỏ tất cả các cấp phát 

truyền và cấu hình các bit sau CiCTRL: -CSIDL, 

REQOP và CANCKS 

Source File: CAN1SetOperationModeNoWait.c 

CAN2SetOperationModeNoWait.c 

Mã số Ví dụ: CAN1SetOperationModeNoWait (CAN_IDLE_CON & 

CAN_MASTERCLOCK_1 & CAN_REQ_OPERMODE_LISTEN & 

CAN_CAPTURE_DIS_NO_WAIT); 

CAN1SetRXMode 

CAN2SetRXMode 

Mô tả: Chức năng này cấu hình thu CAN. 


Prototype: void CAN1SetRXMode (char buffno, int 

config); 

khoảng trống CAN2SetRXMode (char buffno, int

CAN_IDLE_STOPCAN Stop in Idle mode 

CAN_MASTERCLOCK_1FCANis FCY 

CAN_MASTERCLOCK_0FCANis 4 FCY 

CAN modes of operation 

CAN_REQ_OPERMODE_NOR 

CAN_REQ_OPERMODE_DIS 

CAN_REQ_OPERMODE_LOOPBK 

CAN_REQ_OPERMODE_LISTENONLY 

CAN_REQ_OPERMODE_CONFIG 

CAN_REQ_OPERMODE_LISTENALL 

CAN Capture Enable/Disable 

CAN_CAPTURE_EN 

CAN_CAPTURE_DIS 


Remarks: This function configures the following bits of CiCTRL:-CSIDL, 

REQOP and CANCKS 

Source File: CAN1SetOperationMode.c 

CAN2SetOperationMode.c 

Code Example: CAN1SetOperationMode(CAN_IDLE_STOP & 

CAN_MASTERCLOCK_0 & CAN_REQ_OPERMODE_DIS & 


CAN1SetMask (Continued) 

CAN2SetMask 

dsPIC 

® 






Description: This function aborts the pending transmissions and configures the 

CAN 

module 


Prototype: void CAN1SetOperationModeNoWait( 

unsigned int config); 

void CAN2SetOperationModeNoWait( 


Arguments: config The 16-bit value to be loadedinto CiCTRL register, the 


config); 

Đối số: buffno buffno cho biết reg kiểm soát được cấu hình. 

cấu hình giá trị được ghi vào CiRXnCON reg, sự kết hợp 

các định nghĩa sau đây. 

Rõ ràng chút RXFUL 

CAN_RXFUL_CLEAR 

Đôi đệm cho phép / vô hiệu hóa 

CAN_BUF0_DBLBUFFER_EN 

CAN_BUF0_DBLBUFFER_DIS 




Ghi chú: Chức năng này cấu hình các bit sau CiRXnCON đăng ký: 

RXRTR, RXFUL (chỉ 0), RXM và DBEN 

Source File: CAN1SetRXMode.c 

CAN2SetRXMode.c 

Mã số Ví dụ: CAN1SetRXMode (0, CAN_RXFUL_CLEAR & 

CAN_BUF0_DBLBUFFER_EN); 

CAN1SetTXMode (chức năng) 

CAN2SetTXMode 

Mô tả: Chức năng này cấu hình các module CAN phát 


Prototype: void CAN1SetTXMode (char buffno, int 

config); 

khoảng trống CAN2SetTXMode (char buffno, int 

config); 

Đối số: buffno buffno cho biết reg kiểm soát được cấu hình. 

cấu hình giá trị được ghi vào CiTXnCON reg, sự kết hợp 

các định nghĩa sau đây. 

Gửi tin nhắn yêu cầu 

CAN_TX_REQ 

CAN_TX_STOP_REQ 

Ưu tiên truyền tin nhắn 

CAN_TX_PRIORITY_HIGH 

CAN_TX_PRIORITY_HIGH_INTER 

CAN_TX_PRIORITY_LOW_INTER 

CAN_TX_PRIORITY_LOW 


Ghi chú: Chức năng này cấu hình các bit sau CiTXnCON đăng ký:

CAN_IDLE_CON_NO_WAITCAN On in Idle mode 

CAN_IDLE_STOP_NO_WAITCAN Stop in Idle mode 

CAN_MASTERCLOCK_1_NO_WAITFCANis FCY 

CAN_MASTERCLOCK_0_NO_WAITFCANis 4 FCY 

CAN modes of operation 

CAN_REQ_OPERMODE_NOR_NO_WAIT 

CAN_REQ_OPERMODE_DIS_NO_WAIT 

CAN_REQ_OPERMODE_LOOPBK_NO_WAIT 

CAN_REQ_OPERMODE_LISTENONLY_NO_WAIT 

CAN_REQ_OPERMODE_CONFIG_NO_WAIT 

CAN_REQ_OPERMODE_LISTENALL_NO_WAIT 

CAN Capture Enable/Disable 

CAN_CAPTURE_EN_NO_WAIT 

CAN_CAPTURE_DIS_NO_WAIT 


Remarks: This function sets the Abort bit thus initiating abort of all pending 

transmissions and configures the following bits of CiCTRL:-CSIDL, 

REQOP and CANCKS 

Source File: CAN1SetOperationModeNoWait.c 

CAN2SetOperationModeNoWait.c 

Code Example: CAN1SetOperationModeNoWait(CAN_IDLE_CON & 

CAN_MASTERCLOCK_1 & CAN_REQ_OPERMODE_LISTEN & 

CAN_CAPTURE_DIS_NO_WAIT); 

CAN1SetRXMode 

CAN2SetRXMode 

Description: This function configures the CAN receiver. 


Prototype: void CAN1SetRXMode(char buffno, unsigned int 

config); 

void CAN2SetRXMode(char buffno, unsigned int 

config); 

Arguments: buffno buffno indicates the control reg to be configured. 

config The value to be written into CiRXnCON reg, the combination 

of the following defines. 

Clear RXFUL bit 

CAN_RXFUL_CLEAR 

Double buffer enable/disable 

CAN_BUF0_DBLBUFFER_EN 

CAN_BUF0_DBLBUFFER_DIS 

TXRTR, TXREQ, DLC, TXPRI 

Source File: CAN1SetTXMode.c 

CAN2SetTXMode.c 

Mã số Ví dụ: CAN1SetTXMode (1, CAN_TX_STOP_REQ & 

CAN_TX_PRIORITY_HIGH); 

CAN1SetRXMode (Tiếp theo) 

CAN2SetRXMode 

dsPIC 

® 



CAN1Initialize 


Mô tả: Chức năng này cấu hình các module CAN 


Prototype: void CAN1Initialize (int config1, 

int config2); 

khoảng trống CAN2Initialize (int config1, 

int config2); 

Đối số: config1 giá trị được ghi vào CiCFG1 đăng ký, 


Sync rộng nhảy 

CAN_SYNC_JUMP_WIDTH1 




Tốc độ Baud prescaler 

CAN_BAUD_PRE_SCALE (x) (((x-1) & 0x3F) | 0xC0) 

config2 giá trị được ghi vào CiCFG2 đăng ký, các 


Xe buýt CAN chọn lọc dòng để đánh thức 

CAN_WAKEUP_BY_FILTER_EN 

CAN_WAKEUP_BY_FILTER_DIS 

THỂ lan truyền chiều dài phân đoạn 

CAN_PROPAGATIONTIME_SEG_TQ (x) 

(((X-1) & 0x7) | 0xC7F8) 

THỂ giai đoạn đoạn 1 dài 

CAN_PHASE_SEG1_TQ (x) 

((((X-1) & 0x7) * 0x8) | 0xC7C7)




Remarks: This function configures the following bits of CiRXnCON register: 

RXRTR, RXFUL (only 0), RXM and DBEN 

Source File: CAN1SetRXMode.c 

CAN2SetRXMode.c 

Code Example: CAN1SetRXMode(0,CAN_RXFUL_CLEAR & 


CAN1SetTXMode (function) 

CAN2SetTXMode 

Description: This function configures the CAN transmitter module 


Prototype: void CAN1SetTXMode(char buffno, unsigned int 

config); 

void CAN2SetTXMode(char buffno, unsigned int 

config); 

Arguments: buffno buffno indicates the control reg to be configured. 

config The value to be written into CiTXnCON reg, the combination 

of the following defines. 

Message send request 

CAN_TX_REQ 

CAN_TX_STOP_REQ 

Message transmission priority 

CAN_TX_PRIORITY_HIGH 

CAN_TX_PRIORITY_HIGH_INTER 

CAN_TX_PRIORITY_LOW_INTER 

CAN_TX_PRIORITY_LOW 


Remarks: This function configures the following bits of CiTXnCON register: 

TXRTR, TXREQ, DLC, TXPRI 

Source File: CAN1SetTXMode.c 

CAN2SetTXMode.c 

Code Example: CAN1SetTXMode(1, CAN_TX_STOP_REQ & 


CAN1SetRXMode (Continued) 

CAN2SetRXMode 

dsPIC 

® 

THỂ giai đoạn 2 đoạn dài 

CAN_PHASE_SEG2_TQ (x) 

((((X-1) & 0x7) * 0x100) | 0xC0FF) 

THỂ giai đoạn chế độ đoạn 2 

CAN_SEG2_FREE_PROG 

CAN_SEG2_TIME_LIMIT_SET 

Mẫu của các dòng xe buýt CAN 

CAN_SAMPLE3TIMES 

CAN_SAMPLE1TIME 


Bình luận: Chức năng này cấu hình các bit sau CiCFG1 và CiCFG2 

đăng ký: 

SJW , BRP , CANCAP, WAKEFIL, SEG2PH , 

SEGPHTS, SAM, SEG1PH , PRSEG 

Source File: CAN1Initialize.c 

CAN2Initialize.c 

Mã số Ví dụ: CAN1Initialize (CAN_SYNC_JUMP_WIDTH2 & 

CAN_BAUD_PRE_SCALE (2), 

CAN_WAKEUP_BY_FILTER_DIS & 

CAN_PHASE_SEG2_TQ (5) và 

CAN_PHASE_SEG1_TQ (4) và 

CAN_PROPAGATIONTIME_SEG_TQ (4) và 

CAN_SEG2_FREE_PROG & 

CAN_SAMPLE1TIME); 



ConfigIntCAN1 

ConfigIntCAN2 

Mô tả: Chức năng này cấu hình CAN ngắt 


Prototype: void ConfigIntCAN1 (int config1, 

int config2); 

làm mất hiệu lực ConfigIntCAN2 (unsigned int config1, 

int config2); 

Đối số: config1 cá nhân ngắt bật / tắt thông tin theo quy định 

dưới đây: 

Người dùng phải nhập một trong hai tùy chọn vô hiệu hóa enableor cho tất cả 

các 

ngắt cá nhân. 

Cho phép ngắt





Description: This function configures the CAN module 


Prototype: void CAN1Initialize(unsigned int config1, 

unsigned int config2); 

void CAN2Initialize(unsigned int config1, 


Arguments: config1 The value to be written into CiCFG1 register, the 


Sync jump width 





Baud Rate prescaler 

CAN_BAUD_PRE_SCALE(x)(((x-1) & 0x3f) | 0xC0) 

config2 The value to be written into CiCFG2 register, the 


CAN bus line filter selection for wake-up 

CAN_WAKEUP_BY_FILTER_EN 

CAN_WAKEUP_BY_FILTER_DIS 

CAN propagation segment length 

CAN_PROPAGATIONTIME_SEG_TQ(x) 

(((x-1) & 0x7) | 0xC7F8) 

CAN phase segment 1 length 

CAN_PHASE_SEG1_TQ(x) 

((((x-1) & 0x7) *0x8) | 0xC7C7) 

CAN phase segment 2 length 

CAN_PHASE_SEG2_TQ(x) 

((((x-1) & 0x7) *0x100) | 0xC0FF) 

CAN phase segment 2 mode 

CAN_SEG2_FREE_PROG 

CAN_SEG2_TIME_LIMIT_SET 

Sample of the CAN bus line 

CAN_SAMPLE3TIMES 

CAN_SAMPLE1TIME 

CAN_INDI_INVMESS_EN 

CAN_INDI_WAK_EN 

CAN_INDI_ERR_EN 

CAN_INDI_TXB2_EN 



CAN_INDI_RXB1_EN 


Gián đoạn vô hiệu hóa 

CAN_INDI_INVMESS_DIS 

CAN_INDI_WAK_DIS 

CAN_INDI_ERR_DIS 

CAN_INDI_TXB2_DIS 



CAN_INDI_RXB1_DIS 


config2 THỂ gián đoạn ưu tiên và bật / tắt thông tin 


THỂ Ngắt bật / tắt 

CAN_INT_ENABLE 

CAN_INT_DISABLE 

THỂ Ngắt ưu tiên 

CAN_INT_PRI_0 

CAN_INT_PRI_1 

CAN_INT_PRI_2 

CAN_INT_PRI_3 

CAN_INT_PRI_4 

CAN_INT_PRI_5 

CAN_INT_PRI_6 

CAN_INT_PRI_7 


Bình luận: Chức năng này cấu hình ngắt CAN. Nó cho phép / vô hiệu hóa 

CAN cá nhân ngắt. Nó cũng cho phép / vô hiệu hóa các THỂ gián đoạn 

và đặt ưu tiên. 

Source File: ConfigIntCAN1.c 

ConfigIntCAN2.c 

dsPIC 

®


Remarks: This function configures the following bits of CiCFG1 and CiCFG2 

registers: 

SJW, BRP, CANCAP, WAKEFIL, SEG2PH, 

SEGPHTS, SAM, SEG1PH, PRSEG 

Source File: CAN1Initialize.c 

CAN2Initialize.c 

Code Example: CAN1Initialize(CAN_SYNC_JUMP_WIDTH2 & 

CAN_BAUD_PRE_SCALE(2), 

CAN_WAKEUP_BY_FILTER_DIS & 

CAN_PHASE_SEG2_TQ(5) & 

CAN_PHASE_SEG1_TQ(4) & 

CAN_PROPAGATIONTIME_SEG_TQ(4) & 

CAN_SEG2_FREE_PROG & 

CAN_SAMPLE1TIME); 



ConfigIntCAN1 

ConfigIntCAN2 

Description: This function configures the CAN Interrupts 


Prototype: void ConfigIntCAN1(unsigned int config1, 


void ConfigIntCAN2(unsigned int config1, 


Arguments: config1 individual interrupt enable/disable information as defined 

below: 

User must enter either enableor disable option for all the 

individual interrupts. 

Interrupt enable 

CAN_INDI_INVMESS_EN 

CAN_INDI_WAK_EN 

CAN_INDI_ERR_EN 






Interrupt disable 



3.4.2 Macros cá nhân 


Mã số Ví dụ: ConfigIntCAN1 (CAN_INDI_INVMESS_EN & 

CAN_INDI_WAK_DIS & 

CAN_INDI_ERR_DIS & 

CAN_INDI_TXB2_DIS & 



CAN_INDI_RXB1_DIS & 

CAN_INDI_RXB0_DIS, 

CAN_INT_PRI_3 & 

CAN_INT_ENABLE); 

EnableIntCAN1 

EnableIntCAN2 

Mô tả: Phần này cho phép THỂ gián đoạn. 



Bình luận: Đây bộ vĩ mô THỂ Interrupt Enable bit Interrupt Enable kiểm soát 

đăng ký. 

Mã số Ví dụ: EnableIntCAN1; 

DisableIntCAN1 


Mô tả: vĩ mô này vô hiệu hóa CAN gián đoạn. 



Bình luận: điều này sẽ xóa vĩ mô THỂ Ngắt Enablebit của Interrupt Enable 

kiểm soát 

đăng ký. 

Mã số Ví dụ: DisableIntCAN2; 

SetPriorityIntCAN1 


Mô tả: Đây bộ vĩ mô ưu tiên cho CAN gián đoạn. 


Đối số: ưu tiên 

Bình luận: Đây bộ vĩ mô THỂ Ngắt bit ưu tiên của ngắt ưu tiên kiểm soát 

đăng ký. 

Mã số Ví dụ: SetPriorityIntCAN1 (2); 

ConfigIntCAN1 (Tiếp theo) 

ConfigIntCAN2

CAN_INDI_INVMESS_DIS 

CAN_INDI_WAK_DIS 

CAN_INDI_ERR_DIS 






config2 CAN interrupt priority and enable/disable information as 


CAN Interrupt enable/disable 

CAN_INT_ENABLE 

CAN_INT_DISABLE 

CAN Interrupt priority 

CAN_INT_PRI_0 

CAN_INT_PRI_1 

CAN_INT_PRI_2 

CAN_INT_PRI_3 

CAN_INT_PRI_4 

CAN_INT_PRI_5 

CAN_INT_PRI_6 

CAN_INT_PRI_7 


Remarks: This function configures the CAN interrupts. It enables/disables the 

individual CAN interrupts. It also enables/disables the CAN interrupt 

and sets priority. 

Source File: ConfigIntCAN1.c 

ConfigIntCAN2.c 

dsPIC 

® 



3.4.2 Individual Macros 

Code Example: ConfigIntCAN1(CAN_INDI_INVMESS_EN & 

CAN_INDI_WAK_DIS & 

CAN_INDI_ERR_DIS & 








# include 

# include 

# xác định dataarray 0x1820 


{ 

/ * Chiều dài của dữ liệu truyền tobe / đọc * / 

datalen unsigned char; 

unsigned char Txdata [] = 

{'M', 'tôi', 'C', 'R', 'O', 'C', 'H', 'tôi', 'P', '\ 0'}; 

int TXConfig, RXConfig; 

unsigned longMaskID, MessageID; 

char FilterNo, tx_rx_no; 

unsigned char * datareceived = (unsigned char *) 

dataarray; / * Giữ dữ liệu nhận được * / 

/ * Thiết lập yêu cầu chế độ cấu hình * / 

CAN1SetOperationMode (CAN_IDLE_CON & 

CAN_MASTERCLOCK_1 & 

CAN_REQ_OPERMODE_CONFIG & 


trong khi (C1CTRLbits.OPMODE

CAN_INDI_RXB1_DIS & 

CAN_INDI_RXB0_DIS , 

CAN_INT_PRI_3 & 

CAN_INT_ENABLE); 

EnableIntCAN1 

EnableIntCAN2 

Description: This macro enables the CAN interrupt. 



Remarks: This macro sets CAN Interrupt Enable bit of Interrupt Enable Control 

register. 

Code Example: EnableIntCAN1; 



Description: This macro disables the CAN interrupt. 



Remarks: This macro clears CAN Interrupt Enablebit of Interrupt Enable 

Control 

CAN_MATCH_FILTER_TYPE, CAN_MASK_EID (12.344)); 

/ * Thiết lập chế độ máy phát và nhận * / 

tx_rx_no = 0; 

CAN1SetTXMode (tx_rx_no, 

CAN_TX_STOP_REQ & 


CAN1SetRXMode (tx_rx_no, 

CAN_RXFUL_CLEAR & 


/ * Tải nhắn ID, dữ liệu vào bộ đệm truyền và thiết lập 

truyền yêu cầu bit * / 

datalen = 8; 

CAN1SendMessage ((CAN_TX_SID (1920)) và CAN_TX_EID_EN & 

CAN_SUB_NOR_TX_REQ, 

(CAN_TX_EID (12.344)) & CAN_NOR_TX_REQ, 


dsPIC 

® 


register. 



Code Example: DisableIntCAN2; 



Description: This macro sets priority for CAN interrupt. 


Arguments: priority 

Remarks: This macro sets CAN Interrupt Priority bits of Interrupt Priority 

Control 

register. 

Code Example: SetPriorityIntCAN1(2); 

ConfigIntCAN1 (Continued) 

ConfigIntCAN2 





#include 

#include 

#define dataarray 0x1820 


/ * Thiết lập yêu cầu chế độ lặp vòng * / 

CAN1SetOperationMode (CAN_IDLE_CON & CAN_CAPTURE_DIS & 


CAN_REQ_OPERMODE_LOOPBK); 

trong khi (C1CTRLbits.OPMODE = 2); 

/ * Chờ cho đến khi hoàn toàn messageis truyền * / 

trong khi (! CAN1IsTXReady (0)) 

/ * Chờ cho đến khi nhận được bộ đệm chứa tin nhắn hợp lệ * / 

trong khi (CAN1IsRXReady (0)); 

/ * Đọc dữ liệu nhận được fromreceive đệm và lưu nó vào 

sử dụng dataarray xác định * / 

CAN1ReceiveMessage (datareceived, datalen, tx_rx_no); 

trong khi (1); 

trở về 0; 

} 



3,5 ADC12 chức năng 

Phần này bao gồm một danh sách các chức năng cá nhân cho 12 bit ADC và 

một ví dụ về

{ 

/* Length of data tobe transmitted/read */ 

unsigned char datalen; 

unsigned char Txdata[] = 

{'M','I','C','R','O','C','H','I','P','\0'}; 

unsigned int TXConfig, RXConfig; 

unsigned longMaskID,MessageID; 

char FilterNo,tx_rx_no; 

unsigned char * datareceived = (unsigned char *) 

dataarray; /* Holds the data received */ 

/* Set request for configuration mode */ 

CAN1SetOperationMode(CAN_IDLE_CON & 


CAN_REQ_OPERMODE_CONFIG & 


while(C1CTRLbits.OPMODE


/* Load message ID , Data into transmit buffer and set 

transmit request bit */ 

datalen = 8; 

CAN1SendMessage((CAN_TX_SID(1920)) & CAN_TX_EID_EN & 

CAN_SUB_NOR_TX_REQ, 

(CAN_TX_EID(12344))& CAN_NOR_TX_REQ, 

Txdata,datalen,tx_rx_no); 

dsPIC 

® 



/* Set request for Loopback mode */ 


CAN1SetOperationMode(CAN_IDLE_CON & CAN_CAPTURE_DIS & 


CAN_REQ_OPERMODE_LOOPBK); 

while(C1CTRLbits.OPMODE !=2); 

/* Wait till messageis transmitted completely */ 

while(!CAN1IsTXReady(0)) 

/* Wait till receive buffer contain valid message */ 

while(!CAN1IsRXReady(0)); 

/* Read received data fromreceive buffer and store it into 

user defined dataarray */ 

CAN1ReceiveMessage(datareceived, datalen, tx_rx_no); 

while(1); 

return 0; 

} 



3.5 ADC12 FUNCTIONS 

This section contains a list of individual functions for the 12 bit ADC and an 

example of 

use of the functions. Functions may be implemented as macros. 


BusyADC12 

Description: This function returns the ADC conversion status. 

Include: adc12.h 

Prototype: char BusyADC12(void); 



Ưu tiên ngắt ADC 

ADC_INT_PRI_0 

ADC_INT_PRI_1 

ADC_INT_PRI_2 

ADC_INT_PRI_3 

ADC_INT_PRI_4 

ADC_INT_PRI_5 

ADC_INT_PRI_6 

ADC_INT_PRI_7 



Bình luận: Chức năng này sẽ xóa sạch các (ADIF) bit Cờ ngắt và sau đó đặt 

gián đoạn ưu tiên và cho phép / vô hiệu hóa ngắt. 

Source File: ConfigIntADC12.c 

Mã số Ví dụ: ConfigIntADC12 (ADC_INT_PRI_6 & 

ADC_INT_ENABLE); 

ConvertADC12 

Mô tả: Chức năng này bắt đầu chuyển đổi A / D. 

Bao gồm: adc12.h 

Prototype: void ConvertADC12 (void); 



Bình luận: Chức năng này sẽ xóa sạch các ADCON1 bit và do đó dừng lại lấy 

mẫu 

và bắt đầu chuyển đổi. 

Điều này chỉ xảy ra khi nguồn kích hoạt cho việc chuyển đổi A / D 

chọn làm bằng tay, bằng cách xóa ADCON1 bit. 

Source File: ConvertADC12.c 

Mã số Ví dụ: ConvertADC12 (); 

OpenADC12 

Mô tả: Chức năng này cấu hình ADC. 


Prototype: void OpenADC12 (int config1, 

int config2, 

int config3, 

int configport, 

int configscan) 

Đối số: config1 này chứa các thông số phải được cấu hình trong 

ADCON1 đăng ký theo quy định dưới đây: 

Mô-đun On / Off

Return Value: If the value of DONE is ‘0’, then ‘1’ is returned, indicating that 

the ADC 

is busy in conversion. 

If the value of DONE is ‘1’, then ‘0’ is returned, indicating that the ADC 

has completed conversion. 

Remarks: This function returns the complement of the ADCON1 bit 

status which indicates whether the ADC is busy in conversion. 

Source File: BusyADC12.c 

Code Example: while(BusyADC12()); 

CloseADC12 

Description: This function turns off the ADC module and disables the ADC 

interrupts. 


Prototype: void CloseADC12(void); 



Remarks: This function first disables the ADC interrupt and then turns off the 

ADC 

module.The Interrupt Flag bit (ADIF) is also cleared. 

Source File: CloseADC12.c 

Code Example: CloseADC12(); 

ConfigIntADC12 

Description: This function configures the ADC interrupt. 


Prototype: void ConfigIntADC12(unsigned int config); 

Arguments: config ADC interrupt priority and enable/disable information as 


ADC Interrupt enable/disable 

ADC_INT_ENABLE 

ADC_INT_DISABLE 

dsPIC 

® 



ADC Interrupt priority 

ADC_INT_PRI_0 

ADC_INT_PRI_1 

ADC_INT_PRI_2 

ADC_INT_PRI_3 

ADC_INT_PRI_4 


ADC_MODULE_ON 

ADC_MODULE_OFF 

Hoạt động chế độ nhàn rỗi 

ADC_IDLE_CONTINUE 

ADC_IDLE_STOP 

ConfigIntADC12 (Tiếp theo) 



Định dạng đầu ra kết quả 

ADC_FORMAT_SIGN_FRACT 

ADC_FORMAT_FRACT 

ADC_FORMAT_SIGN_INT 

ADC_FORMAT_INTG 

Chuyển đổi nguồn kích hoạt 

ADC_CLK_AUTO 

ADC_CLK_TMR 

ADC_CLK_INT0 

ADC_CLK_MANUAL 

Tự động lấy mẫu chọn 

ADC_AUTO_SAMPLING_ON 

ADC_AUTO_SAMPLING_OFF 

Mẫu cho phép 

ADC_SAMP_ON 

ADC_SAMP_OFF 

config2 này chứa các thông số phải được cấu hình trong 


Điện áp tham khảo 

ADC_VREF_AVDD_AVSS 

ADC_VREF_EXT_AVSS 

ADC_VREF_AVDD_EXT 

ADC_VREF_EXT_EXT 

Lựa chọn quét 

ADC_SCAN_ON 

ADC_SCAN_OFF 

Số mẫu giữa ngắt 

ADC_SAMPLES_PER_INT_1 


..... 

ADC_SAMPLES_PER_INT_15

ADC_INT_PRI_5 

ADC_INT_PRI_6 

ADC_INT_PRI_7 


Remarks: This function clears the Interrupt Flag (ADIF) bit and then sets the 

interrupt priority and enables/disables the interrupt. 


Code Example: ConfigIntADC12(ADC_INT_PRI_6 & 

ADC_INT_ENABLE); 

ConvertADC12 

Description: This function starts A/D conversion. 


Prototype: void ConvertADC12(void); 



Remarks: This function clears the ADCON1 bit and thus stops 

sampling 

and starts conversion. 

This happens only when trigger source for the A/D conversion is 

selected as Manual, by clearing the ADCON1 bits. 


Code Example: ConvertADC12(); 


Chế độ đệm chọn 

ADC_ALT_BUF_ON 

ADC_ALT_BUF_OFF 

Chế độ mẫu thay thế đầu vào chọn 

ADC_ALT_INPUT_ON 

ADC_ALT_INPUT_OFF 



Bit Thời gian tự động mẫu 

ADC_SAMPLE_TIME_0 


..... 



Chuyển đổi đồng hồ Nguồn chọn 

ADC_CONV_CLK_INTERNAL_RC 

ADC_CONV_CLK_SYSTEM 

OpenADC12 (Tiếp theo) 

dsPIC 

® 


OpenADC12 



Description: This function configures the ADC. 


Prototype: void OpenADC12(unsigned int config1, 

unsigned int config2, 


unsigned int configport, 

unsigned int configscan) 

Arguments: config1 This contains the parameters to be configured in the 

ADCON1 register as defined below: 

Module On/Off 

ADC_MODULE_ON 


Idle mode operation 


ADC_IDLE_STOP 

ConfigIntADC12 (Continued) 

Đồng hồ chuyển đổi chọn 

ADC_CONV_CLK_Tcy2 

ADC_CONV_CLK_Tcy 

ADC_CONV_CLK_3Tcy2 

..... 

ADC_CONV_CLK_32Tcy 

configport này chứa pin chọn được cấu hình vào 

ADPCFG đăng ký theo quy định dưới đây: 

ENABLE_ALL_ANA 

ENABLE_ALL_DIG 

ENABLE_AN0_ANA 



..... 


configscan này bao gồm các lựa chọn tham số quét là



Result output format 





Conversion trigger source 

ADC_CLK_AUTO 

ADC_CLK_TMR 

ADC_CLK_INT0 


Auto sampling select 



Sample enable 

ADC_SAMP_ON 

ADC_SAMP_OFF 

config2 This contains the parameters to be configured in the 


Voltage Reference 





Scan selection 

ADC_SCAN_ON 

ADC_SCAN_OFF 

Number of samples between interrupts 



..... 



Buffer mode select 



Alternate Input Sample mode select 


cấu hình vào sổ đăng ký theo quy định ADCSSL 


SCAN_NONE 

SCAN_ALL 

SKIP_SCAN_AN0 

SKIP_SCAN_AN1 

..... 

SKIP_SCAN_AN15 


Ghi chú: Chức năng này cấu hình ADC cho các thông số sau: 

Chế độ hoạt động, hành vi chế độ Sleep, dữ liệu o / p định dạng, mẫu CLK 

Nguồn, VREFsource, Số mẫu / int, đệm chế độ Fill, thay thế i / p 

mẫu mod, tự động thời gian mẫu, Convclock nguồn, Conv Đồng hồ Chọn 

bit, các bit Cảng Config kiểm soát. 

Source File: OpenADC12.c 

Mã số Ví dụ: OpenADC12 (ADC_MODULE_OFF & 

ADC_IDLE_CONTINUE & 

ADC_FORMAT_INTG & 

ADC_AUTO_SAMPLING_ON, 

ADC_VREF_AVDD_AVSS & 

ADC_SCAN_OFF & 

ADC_BUF_MODE_OFF & 

ADC_ALT_INPUT_ON & 

ADC_SAMPLES_PER_INT_15, 

ADC_SAMPLE_TIME_4 & 

ADC_CONV_CLK_SYSTEM & 

ADC_CONV_CLK_Tcy, 

ENABLE_AN0_ANA, 

SKIP_SCAN_AN1 & 



SKIP_SCAN_AN7); 




ReadADC12 

Mô tả: Chức năng này đọc ADC Bufferregister trong đó có các 

giá trị chuyển đổi. 

Bao gồm: adc12.h




Auto Sample Time bits 



..... 



Conversion Clock Source select 



OpenADC12 (Continued) 

dsPIC 

® 


Nguyên mẫu: int ReadADC12 (unsigned char bufIndex); 

Đối số: bufIndex Đây là số lượng bộ đệm ADC mà là để được đọc. 


Bình luận: Chức năng này trả về nội dung ofthe ADC đệm đăng ký. Người sử 

dụng 

nên cung cấp bufIndexvalue giữa 0-15 để đảm bảo chính xác 

đọc của ADCBUF0 ADCBUFF để đăng ký. 

Source File: ReadADC12.c 

Mã số Ví dụ: kết quả int unsigned; 

kết quả = ReadADC12 (5); 

StopSampADC12 

Mô tả: Chức năng này giống hệt với ConvertADC12. 

Source File: #defineto ConvertADC12in adc12.h 

SetChanADC12 

Mô tả: Chức năng này đặt ra các yếu tố đầu vào tích cực và tiêu cực đối với mẫ 

ghép kênh A và B. 




Prototype: void SetChanADC12 (kênh unsigned int); 

Conversion clock select 




..... 


configport This contains the pin select to be configured into the 

ADPCFG register as defined below: 






..... 


configscan This contains the scan select parameter to be 

configured into the ADCSSL register as defined 

below: 

SCAN_NONE 

SCAN_ALL 

SKIP_SCAN_AN0 

SKIP_SCAN_AN1 

Đối số: kênh này có chứa các lựa chọn tham số đầu vào được cấu hình 

vào ADCHS đăng ký theo quy định dưới đây: 

A / D kênh 0 tích cực i / p chọn cho MẪU A 

ADC_CH0_POS_SAMPLEA_AN0 


..... 


A / D kênh 0 âm i / p chọn cho MẪU A 

ADC_CH0_NEG_SAMPLEA_AN1 

ADC_CH0_NEG_SAMPLEA_NVREF 

A / D kênh 0 tích cực i / p chọn cho MẪU B 

ADC_CH0_POS_SAMPLEB_AN0 


..... 


A / D kênh 0 âm i / p chọn cho MẪU B 

ADC_CH0_NEG_SAMPLEB_AN1 

ADC_CH0_NEG_SAMPLEB_NVREF 


Ghi chú: Chức năng này cấu hình các yếu tố đầu vào cho Multiplexers mẫu A 

và B 

bằng văn bản cho đăng ký ADCHS.

..... 



Remarks: This function configures the ADC for the following parameters: 

Operating mode, Sleep mode behavior, Data o/p format, Sample Clk 

Source, VREFsource, No of samples/int, Buffer Fill mode, Alternate i/p 

sample mod, Auto sample time, Convclock source, Conv Clock Select 

bits, Port Config Control bits. 


Code Example: OpenADC12(ADC_MODULE_OFF & 




















ReadADC12 

Description: This function reads the ADC Bufferregister which contains the 

conversion value. 


Prototype: unsigned int ReadADC12(unsigned char bufIndex); 

Arguments: bufIndex This is the ADC buffer number which is to be read. 


Remarks: This function returns the contents ofthe ADC Buffer register. User 

should provide bufIndexvalue between 0 to 15 to ensure correct 

read of the ADCBUF0 to ADCBUFF register. 

Source File: SetChanADC12.c 

Mã số Ví dụ: SetChanADC12 (ADC_CH0_POS_SAMPLEA_AN4 & 

ADC_CH0_NEG_SAMPLEA_NVREF); 

dsPIC 

® 




EnableIntADC 

Mô tả: vĩ mô này cho phép ADC gián đoạn. 



Bình luận: Đây bộ vĩ mô ADC Interrupt Enable bit Interrupt Enable kiểm soát 

đăng ký. 

Mã số Ví dụ: EnableIntADC; 

DisableIntADC 

Mô tả: vĩ mô này vô hiệu hóa ADC gián đoạn. 



Bình luận: vĩ mô này xóa ADC ngắt Enablebit của Interrupt Enable kiểm soát 

đăng ký. 

Mã số Ví dụ: DisableIntADC; 

SetPriorityIntADC 

Mô tả: Điều này đặt ra ưu tiên vĩ mô cho ADC gián đoạn. 



Bình luận: vĩ mô này đặt ADC ngắt bit ưu tiên của ngắt ưu tiên kiểm soát 

đăng ký. 

Mã số Ví dụ: SetPriorityIntADC (6); 





# include 

# include 

int Channel, PinConfig, Scanselect, Adcon3_reg, Adcon2_reg, 

Adcon1_reg; 


{


Code Example: unsigned int result; 

result = ReadADC12(5); 

StopSampADC12 

Description: This function is identical to ConvertADC12. 


SetChanADC12 

Description: This function sets the positive and negative inputs for sample 

multiplexers A and B. 


Prototype: void SetChanADC12(unsigned int channel); 

Arguments: channel This contains the input select parameter to be configured 

into ADCHS register as defined below: 

A/D Channel 0 positive i/p select for SAMPLE A 



..... 


A/D Channel 0 negative i/p select for SAMPLE A 



A/D Channel 0 positive i/p select for SAMPLE B 



..... 


A/D Channel 0 negative i/p select for SAMPLE B 




Remarks: This function configures the inputs for the sample multiplexers A and 

B 

by writing to the ADCHS register. 


Code Example: SetChanADC12(ADC_CH0_POS_SAMPLEA_AN4 & 


dsPIC 

® 


int kết quả [20], i; 

ADCON1bits.ADON = 0; / * Tắt ADC * / 

Kênh = ADC_CH0_POS_SAMPLEA_AN4 & 

ADC_CH0_NEG_SAMPLEA_NVREF & 

ADC_CH0_POS_SAMPLEB_AN2 & 

ADC_CH0_NEG_SAMPLEB_AN1; 

SetChanADC12 (Channel); 

ConfigIntADC12 (ADC_INT_DISABLE); 

PinConfig = ENABLE_AN4_ANA; 

Scanselect = SKIP_SCAN_AN2 & SKIP_SCAN_AN5 & 

SKIP_SCAN_AN9 & SKIP_SCAN_AN10 & 

SKIP_SCAN_AN14 & SKIP_SCAN_AN15; 

Adcon3_reg = ADC_SAMPLE_TIME_10 & 


ADC_CONV_CLK_13Tcy; 

Adcon2_reg = ADC_VREF_AVDD_AVSS & 


ADC_ALT_BUF_OFF & 

ADC_ALT_INPUT_OFF & 

ADC_SAMPLES_PER_INT_16; 

Adcon1_reg = ADC_MODULE_ON & 



ADC_CLK_MANUAL & 

ADC_AUTO_SAMPLING_OFF; 

OpenADC12 (Adcon1_reg, Adcon2_reg, 

Adcon3_reg, PinConfig, Scanselect); 

i = 0; 

trong khi (i

DS51456B-page 100 


EnableIntADC 


Description: This macro enables the ADC interrupt. 



Remarks: This macro sets ADC Interrupt Enable bit of Interrupt Enable Control 

register. 

Code Example: EnableIntADC; 

DisableIntADC 

Description: This macro disables the ADC interrupt. 



Remarks: This macro clears ADC Interrupt Enablebit of Interrupt Enable 

Control 

register. 

Code Example: DisableIntADC; 


Description: This macro sets priority for ADC interrupt. 



Remarks: This macro sets ADC Interrupt Priority bits of Interrupt Priority 

Control 

register. 

Code Example: SetPriorityIntADC(6); 





#include 

#include 

unsigned int Channel, PinConfig, Scanselect, Adcon3_reg, Adcon2_reg, 

Adcon1_reg; 


{ 

unsigned int result[20], i; 

ADCON1bits.ADON = 0; /* turn off ADC */ 

Channel = ADC_CH0_POS_SAMPLEA_AN4 & 


ADC_CH0_POS_SAMPLEB_AN2& 

} 

dsPIC 

® 



3,6 ADC10 chức năng 


Phần này bao gồm một danh sách các chức năng cá nhân cho 10 bit ADC và 

một ví dụ về 

sử dụng các chức năng. Chức năng có thể được thực hiện như các macro. 


BusyADC10 

Mô tả: Chức năng này trả về tình trạng chuyển đổi ADC. 


Prototype: char BusyADC10 (void); 


Quay trở lại giá trị: Nếu giá trị của DONE là "0", sau đó "1" được trả lại, chỉ ra 

rằng ADC 

đang bận rộn trong việc chuyển đổi. 

Nếu giá trị của DONE là "1", sau đó "0" được trả lại, chỉ ra rằng ADC 

đã hoàn thành chuyển đổi. 

Bình luận: Chức năng này trả về bổ sung của ADCON1 bit 

tình trạng mà chỉ ra cho dù ADC là bận rộn trong việc chuyển đổi. 


Mã số Ví dụ: trong khi (BusyADC10 ()); 

CloseADC10 

Mô tả: Chức năng này sẽ tắt các mô-đun ADC và vô hiệu hóa các ngắt ADC. 


Prototype: void CloseADC10 (void); 



Ghi chú: Chức năng này đầu tiên vô hiệu hóa các ADC gián đoạn và sau đó tắt 

ADC 

module.The Cờ ngắt bit (ADIF) cũng sẽ bị xóa. 


Mã số Ví dụ: CloseADC10 (); 


Mô tả: Chức năng này cấu hình ADC gián đoạn. 


Prototype: void ConfigIntADC10 (int config); 

Lập luận: config ADC gián đoạn ưu tiên và bật / tắt thông tin 

quy định dưới đây:


SetChanADC12(Channel); 

ConfigIntADC12(ADC_INT_DISABLE); 




SKIP_SCAN_AN14 & SKIP_SCAN_AN15 ; 














OpenADC12(Adcon1_reg, Adcon2_reg, 

Adcon3_reg,PinConfig, Scanselect); 

i = 0; 

while( i

3.6 ADC10 FUNCTIONS 

This section contains a list of individual functions for the 10 bit ADC and an 

example of 



BusyADC10 

Description: This function returns the ADC conversion status. 


Prototype: char BusyADC10(void); 


Return Value: If the value of DONE is ‘0’, then ‘1’ is returned, indicating that 

the ADC 

is busy in conversion. 

If the value of DONE is ‘1’, then ‘0’ is returned, indicating that the ADC 

has completed conversion. 

Remarks: This function returns the complement of the ADCON1 bit 

status which indicates whether the ADC is busy in conversion. 


Code Example: while(BusyADC10()); 

CloseADC10 

Description: This function turns off the ADC module and disables the ADC 

interrupts. 


Prototype: void CloseADC10(void); 



Remarks: This function first disables the ADC interrupt and then turns off the 

ADC 

module.The Interrupt Flag bit (ADIF) is also cleared. 


Code Example: CloseADC10(); 


Description: This function configures the ADC interrupt. 


Prototype: void ConfigIntADC10(unsigned int config); 

Arguments: config ADC interrupt priority and enable/disable information as 


ADC Interrupt enable/disable 

ADC_INT_ENABLE 

ADC_INT_DISABLE 

ADC Interrupt priority 

int configscan) 



Mô-đun On / Off 

ADC_MODULE_ON 




ADC_IDLE_STOP 

Định dạng đầu ra kết quả 





Chuyển đổi nguồn kích hoạt 

ADC_CLK_AUTO 

ADC_CLK_MPWM 

ADC_CLK_TMR 

ADC_CLK_INT0 


ConfigIntADC10 (Tiếp theo) 

dsPIC 

® 



Tự động lấy mẫu chọn 



Đồng thời lấy mẫu 

ADC_SAMPLE_SIMULTANEOUS 

ADC_SAMPLE_INDIVIDUAL 

Mẫu cho phép 

ADC_SAMP_ON 

ADC_SAMP_OFF 



Điện áp tham khảo 


ADC_VREF_EXT_AVSS

ADC_INT_PRI_0 

ADC_INT_PRI_1 

ADC_INT_PRI_2 

ADC_INT_PRI_3 

ADC_INT_PRI_4 

ADC_INT_PRI_5 

ADC_INT_PRI_6 

ADC_INT_PRI_7 




Remarks: This function clears the Interrupt Flag (ADIF) bit and then sets the 



Code Example: ConfigIntADC10(ADC_INT_PRI_3 & 

ADC_INT_DISABLE); 

ConvertADC10 

Description: This function starts the A/D conversion. 


Prototype: void ConvertADC10(void); 



Remarks: This function clears the ADCON1bit and thus stops 

sampling 

and starts conversion. 

This happens only when trigger source for the A/D conversion is 

selected as Manual, by clearing the ADCON1 bits. 


Code Example: ConvertADC10(); 

OpenADC10 

Description: This function configures the ADC. 


Prototype: void OpenADC10(unsigned int config1, 



unsigned int configport, 

unsigned int configscan) 





Lựa chọn quét 

ADC_SCAN_ON 

ADC_SCAN_OFF 

Kênh A / D sử dụng 

ADC_CONVERT_CH0123 



Số mẫu giữa ngắt 



..... 



Chế độ đệm chọn 



Chế độ mẫu thay thế đầu vào chọn 





Bit Thời gian tự động mẫu 



..... 



Chuyển đổi đồng hồ Nguồn chọn 



Đồng hồ chuyển đổi chọn 




..... 


OpenADC10 (Tiếp theo)

Module On/Off 

ADC_MODULE_ON 




ADC_IDLE_STOP 

Result output format 





Conversion trigger source 

ADC_CLK_AUTO 

ADC_CLK_MPWM 

ADC_CLK_TMR 

ADC_CLK_INT0 


ConfigIntADC10 (Continued) 

dsPIC 

® 



Auto sampling select 



Simultaneous Sampling 

ADC_SAMPLE_SIMULTANEOUS 

ADC_SAMPLE_INDIVIDUAL 

Sample enable 

ADC_SAMP_ON 

ADC_SAMP_OFF 



Voltage Reference 





Scan selection 



configport này chứa các selectto pin được cấu hình vào 

ADPCFG đăng ký theo quy định dưới đây: 






..... 


configscan này bao gồm các lựa chọn tham số quét là 

cấu hình vào sổ đăng ký theo quy định ADCSSL 


SCAN_NONE 

SCAN_ALL 

SKIP_SCAN_AN0 

SKIP_SCAN_AN1 

..... 



Ghi chú: Chức năng này cấu hình ADC cho các thông số sau: 

Chế độ hoạt động, hành vi chế độ Sleep, dữ liệu o / p định dạng, mẫu CLK 

Nguồn, VREFsource, Số mẫu / int, đệm chế độ Fill, thay thế i / p 

mẫu mod, tự động thời gian mẫu, Chuyển đổi nguồn đồng hồ, Đồng hồ Chọn 

Conv 

bit, các bit Cảng Config kiểm soát. 


Mã số Ví dụ: OpenADC10 (ADC_MODULE_OFF & 

ADC_IDLE_STOP & 

ADC_FORMAT_SIGN_FRACT & 

ADC_CLK_INT0 & 

ADC_SAMPLE_INDIVIDUAL & 






ADC_CONVERT_CH0 & 

ADC_SAMPLES_PER_INT_10,

ADC_SCAN_ON 

ADC_SCAN_OFF 

A/D channels utilized 




Number of samples between interrupts 



..... 



Buffer mode select 



Alternate Input Sample mode select 





Auto Sample Time bits 



..... 



Conversion Clock Source select 



Conversion clock select 




..... 





configport This contains the pin selectto be configured into the 










dsPIC 

® 



ReadADC10 


Mô tả: Chức năng này đọc ADC Bufferregister trong đó có các 

giá trị chuyển đổi. 


Nguyên mẫu: int ReadADC10 (unsigned char bufIndex); 

Đối số: bufIndex Đây là số lượng bộ đệm ADC mà là để được đọc. 


Ghi chú: Chức năng này trả về các nội dung của đăng ký ADC đệm. Người sử 

dụng 

nên cung cấp bufIndexvalue giữa "0" đến "15" để đảm bảo chính xác 

đọc của ADCBUF0 để ADCBUFF. 


Mã số Ví dụ: kết quả int unsigned; 

kết quả = ReadADC10 (3); 

StopSampADC10 

Mô tả: Chức năng này giống hệt với ConvertADC10. 


SetChanADC10 

Mô tả: Chức năng này đặt ra các yếu tố đầu vào tích cực và tiêu cực đối với mẫ 

ghép kênh A và B. 


Prototype: void SetChanADC10 (kênh unsigned int); 

Đối số: kênh này có chứa các selectparameter đầu vào phải được cấu hình 

vào ADCHS đăng ký theo quy định dưới đây: 

A / D Channel 1, 2, 3 đầu vào âm cho mẫu A 

ADC_CHX_NEG_SAMPLEA_AN9AN10AN11 

ADC_CHX_NEG_SAMPLEA_AN6AN7AN8

ADPCFG register as defined below: 






..... 


configscan This contains the scan select parameter to be 

configured into the ADCSSL register as defined 

below: 

SCAN_NONE 

SCAN_ALL 

SKIP_SCAN_AN0 

SKIP_SCAN_AN1 

..... 



Remarks: This function configures the ADC for the following parameters: 

Operating mode, Sleep mode behavior, Data o/p format, Sample Clk 

Source, VREFsource, No of samples/int, Buffer Fill mode, Alternate i/p 

sample mod, Auto sample time, Conv clock source, Conv Clock Select 

bits, Port Config Control bits. 


Code Example: OpenADC10(ADC_MODULE_OFF & 

ADC_IDLE_STOP & 

ADC_FORMAT_SIGN_FRACT & 

ADC_CLK_INT0 & 

ADC_SAMPLE_INDIVIDUAL & 











ADC_CHX_NEG_SAMPLEA_NVREF 

A / D Channel 1, 2, 3 đầu vào âm cho mẫu B 

ADC_CHX_NEG_SAMPLEB_AN9AN10AN11 


ADC_CHX_NEG_SAMPLEB_NVREF 

A / D Channel 1, 2, 3 đầu vào của mẫu A 

ADC_CHX_POS_SAMPLEA_AN3AN4AN5 


A / D Channel 1, 2, 3 đầu vào của mẫu B 


ADC_CHX_POS_SAMPLEB_AN0AN1AN2 

A / D kênh 0 tích cực i / p chọn cho mẫu A 



..... 


A / D kênh 0 âm i / p chọn cho mẫu A 






A / D kênh 0 tích cực i / p chọn cho mẫu B 



..... 


A / D kênh 0 âm i / p chọn cho mẫu B 




Ghi chú: Chức năng này cấu hình ghép kênh đầu vào cho mẫu A và B bằng 

bằng văn bản cho đăng ký ADCHS. 


Mã số Ví dụ: SetChanADC10 (ADC_CH0_POS_SAMPLEA_AN0 & 


EnableIntADC 

Mô tả: vĩ mô này cho phép ADC gián đoạn. 

Bao gồm: adc10.h







dsPIC 

® 



ReadADC10 

Description: This function reads the ADC Bufferregister which contains the 

conversion value. 


Prototype: unsigned int ReadADC10(unsigned char bufIndex); 

Arguments: bufIndex This is the ADC buffer number which is to be read. 


Remarks: This function returns the contents of the ADC Buffer register. User 

should provide bufIndexvalue between ‘0’ to ‘15’ to ensure correct 

read of the ADCBUF0 to ADCBUFF. 


Code Example: unsigned int result; 

result = ReadADC10(3); 

StopSampADC10 

Description: This function is identical to ConvertADC10. 


SetChanADC10 

Description: This function sets the positive and negative inputs for the sample 

multiplexers A and B. 


Prototype: void SetChanADC10(unsigned int channel); 

Arguments: channel This contains the input selectparameter to be configured 

into the ADCHS register as defined below: 

A/D Channel 1, 2, 3 Negative input for Sample A 



ADC_CHX_NEG_SAMPLEA_NVREF 

A/D Channel 1, 2, 3 Negative input for Sample B 



Bình luận: Đây bộ vĩ mô ADC Interrupt Enable bit Interrupt Enable kiểm soát 

đăng ký. 

Mã số Ví dụ: EnableIntADC; 

DisableIntADC 

Mô tả: vĩ mô này vô hiệu hóa ADC gián đoạn. 



Bình luận: vĩ mô này xóa ADC ngắt Enablebit của Interrupt Enable kiểm soát 

đăng ký. 

Mã số Ví dụ: DisableIntADC; 


Mô tả: Điều này đặt ra ưu tiên vĩ mô cho ADC gián đoạn. 



Bình luận: vĩ mô này đặt ADC ngắt bit ưu tiên của ngắt ưu tiên kiểm soát 

đăng ký. 

Mã số Ví dụ: SetPriorityIntADC (2); 

SetChanADC10 (Tiếp theo) 

dsPIC 

® 





# include 

# include 

int Channel, PinConfig, Scanselect, Adcon3_reg, Adcon2_reg, 

Adcon1_reg; 


{ 

int kết quả [20], i; 

ADCON1bits.ADON = 0; / * Tắt ADC * / 

Kênh = ADC_CH0_POS_SAMPLEA_AN4 & 




SetChanADC1 (Channel); 

ConfigIntADC10 (ADC_INT_DISABLE);


ADC_CHX_NEG_SAMPLEB_NVREF 

A/D Channel 1, 2, 3 Positive input for Sample A 



A/D Channel 1, 2, 3 Positive input for Sample B 


ADC_CHX_POS_SAMPLEB_AN0AN1AN2 

A/D Channel 0 positive i/p select for Sample A 



..... 


A/D Channel 0 negative i/p select for Sample A 






A/D Channel 0 positive i/p select for Sample B 



..... 


A/D Channel 0 negative i/p select for Sample B 




Remarks: This function configures the inputs for sample multiplexers A and B 

by 

writing to ADCHS register. 


Code Example: SetChanADC10(ADC_CH0_POS_SAMPLEA_AN0 & 


EnableIntADC 

Description: This macro enables the ADC interrupt. 



Remarks: This macro sets ADC Interrupt Enable bit of Interrupt Enable Control 


















ADC_SAMPLE_SIMULTANEOUS & 


OpenADC10 (Adcon1_reg, Adcon2_reg, 

Adcon3_reg, PinConfig, Scanselect); 

i = 0; 

trong khi (i

egister. 

Code Example: EnableIntADC; 

DisableIntADC 

Description: This macro disables the ADC interrupt. 



Remarks: This macro clears ADC Interrupt Enablebit of Interrupt Enable 

Control 

register. 

Code Example: DisableIntADC; 


Description: This macro sets priority for ADC interrupt. 



Remarks: This macro sets ADC Interrupt Priority bits of Interrupt Priority 

Control 

register. 

Code Example: SetPriorityIntADC(2); 

SetChanADC10 (Continued) 

dsPIC 

® 



CloseTimer1 

CloseTimer2 

CloseTimer3 

CloseTimer4 

CloseTimer5 

Mô tả: Chức năng này sẽ tắt các mô-đun bộ đếm thời gian 16-bit. 

Bao gồm: timer.h 

Prototype: void CloseTimer1 (void); 

làm mất hiệu lực CloseTimer2 (void); 






Bình luận: Chức năng này đầu tiên vô hiệu hóa 16-bit giờ gián đoạn và sau đó 

tắt 

các mô-đun bộ đếm thời gian. Các bit Cờ ngắt (TXIF) cũng sẽ bị xóa. 

Source File: CloseTimer1.c 

CloseTimer2.c 

CloseTimer3.c 

CloseTimer4.c 

DS51456B-page 108 



CloseTimer5.c 

Mã số Ví dụ: CloseTimer1 (); 


#include 

#include 

unsigned int Channel, PinConfig, Scanselect, Adcon3_reg, Adcon2_reg, 

Adcon1_reg; 


{ 

unsigned int result[20], i; 

ADCON1bits.ADON = 0; /* turn off ADC */ 

Channel = ADC_CH0_POS_SAMPLEA_AN4 & 




SetChanADC1(Channel); 

ConfigIntADC10(ADC_INT_DISABLE); 


CloseTimer23 

CloseTimer45 

Mô tả: Chức năng này sẽ tắt các mô-đun bộ đếm thời gian 32-bit. 


Prototype: void CloseTimer23 (void) 

CloseTimer45 trống (void) 



Bình luận: Chức năng này vô hiệu hóa 32-bit giờ gián đoạn và sau đó tắt 

hẹn giờ ngắt module.The Flagbit (TXIF) cũng sẽ bị xóa. 

CloseTimer23turns tắt Timer2 và vô hiệu hóa Timer3 ngắt. 

CloseTimer45turns tắt Timer4 và vô hiệu hóa Timer5 ngắt. 


CloseTimer45.c 

Mã số Ví dụ: CloseTimer23 (); 

dsPIC

















ADC_SAMPLE_SIMULTANEOUS & 


OpenADC10(Adcon1_reg, Adcon2_reg, 

Adcon3_reg,PinConfig, Scanselect); 

i = 0; 

while(i


CloseTimer1 

CloseTimer2 

CloseTimer3 

CloseTimer4 

CloseTimer5 

Description: This function turns off the 16-bit timer module. 

Include: timer.h 

Prototype: void CloseTimer1(void); 

void CloseTimer2(void); 






Remarks: This function first disables the 16-bit timer interrupt and then turns 

off 

the timer module. The Interrupt Flag bit (TxIF) is also cleared. 


CloseTimer2.c 

CloseTimer3.c 

CloseTimer4.c 

CloseTimer5.c 

Code Example: CloseTimer1(); 

CloseTimer23 

CloseTimer45 

Description: This function turns off the 32-bit timer module. 


Prototype: void CloseTimer23 (void) 

void CloseTimer45 (void) 



Remarks: This function disables the 32-bit timer interrupt and then turns off the 

timer module.The Interrupt Flagbit (TxIF) is also cleared. 

CloseTimer23turns off Timer2 and disables Timer3 Interrupt. 

CloseTimer45turns off Timer4 and disables Timer5 Interrupt. 


CloseTimer45.c 

Code Example: CloseTimer23(); 

ConfigIntTimer45 

Mô tả: Chức năng này cấu hình 32-bit giờ gián đoạn. 


Prototype: void ConfigIntTimer23 (int config); 

làm mất hiệu lực ConfigIntTimer45 (int config); 

Lập luận: config Thơi gian gián đoạn ưu tiên và bật / tắt thông tin 


Tx_INT_PRIOR_7 








Tx_INT_ON 

Tx_INT_OFF 


Bình luận: Chức năng này sẽ xóa sạch các 32-bit Cờ ngắt (TXIF) bit và sau đó 

đặt 


Source File: ConfigIntTimer23.c 

ConfigIntTimer45.c 

Mã số Ví dụ: ConfigIntTimer23 (T3_INT_PRIOR_5 & T3_INT_ON); 

OpenTimer1 

OpenTimer2 

OpenTimer3 

OpenTimer4 

OpenTimer5 

Mô tả: Chức năng này cấu hình các mô-đun bộ đếm thời gian 16-bit. 


Prototype: void OpenTimer1 (int config, 

unsigned int thời gian) 

làm mất hiệu lực OpenTimer2 (unsigned int config, 






làm mất hiệu lực OpenTimer5 (unsigned int config,

dsPIC 

® 


DS51456B-page 110 







Description: This function configures the 16-bit timer interrupt. 


Prototype: void ConfigIntTimer1(unsigned int config); 

void ConfigIntTimer2(unsigned int config); 




Arguments: config Timer interrupt priority and enable/disable information as 










Tx_INT_ON 

Tx_INT_OFF 


Remarks: This function clears the 16-bit InterruptFlag (TxIF) bit and then sets 

the 







Code Example: ConfigIntTimer1(T1_INT_PRIOR_3 & T1_INT_ON); 



Đối số: cấu hình này bao gồm các thông số phải được cấu hình trong TxCON 

đăng ký theo quy định dưới đây: 

Thơi gian Mô-đun On / Off 

Tx_ON 

Tx_OFF 

Thơi gian Mô-đun chế độ Chờ On / Off 

Tx_IDLE_CON 

Tx_IDLE_STOP 

dsPIC 

® 



Tích lũy thời gian hẹn giờ Cổng phép 

Tx_GATE_ON 

Tx_GATE_OFF 

Thơi gian prescaler 

Tx_PS_1_1 

Tx_PS_1_8 

Tx_PS_1_64 

Tx_PS_1_128 

Hẹn giờ đồng hồ đồng bộ cho phép 

Tx_SYNC_EXT_ON 

Tx_SYNC_EXT_OFF 

Nguồn đồng hồ hẹn giờ 

Tx_SOURCE_EXT 

Tx_SOURCE_INT 

Giai đoạn này có giá trị phù hợp với thời gian được lưu trữ vào 

PR đăng ký 


Ghi chú: Chức năng này cấu hình 16-bit Thơi gian kiểm soát và thiết lập 

giá trị phù hợp với thời gian vào sổ đăng ký PR 

Source File: OpenTimer1.c 

OpenTimer2.c 

OpenTimer3.c 

OpenTimer4.c 

OpenTimer5.c 

Mã số Ví dụ: OpenTimer1 (T1_ON & T1_GATE_OFF & 

T1_PS_1_8 & T1_SYNC_EXT_OFF &




Description: This function configures the 32-bit timer interrupt. 


Prototype: void ConfigIntTimer23(unsigned int config); 


Arguments: config Timer interrupt priority and enable/disable information as 










Tx_INT_ON 

Tx_INT_OFF 


Remarks: This function clears the 32-bit Interrupt Flag (TxIF) bit and then sets 

the 




Code Example: ConfigIntTimer23(T3_INT_PRIOR_5 & T3_INT_ON); 

OpenTimer1 

OpenTimer2 

OpenTimer3 

OpenTimer4 

OpenTimer5 

Description: This function configures the 16-bit timer module. 


Prototype: void OpenTimer1(unsigned int config, 

unsigned int period) 

void OpenTimer2(unsigned int config, 




T1_SOURCE_INT, 0xFF); 

OpenTimer23 

OpenTimer45 

Mô tả: Chức năng này cấu hình các mô-đun bộ đếm thời gian 32-bit. 


Prototype: void OpenTimer23 (int config, 

thời gian dài không dấu); 

khoảng trống OpenTimer45 (int config, 

thời gian dài không dấu); 

Đối số: cấu hình này bao gồm các thông số hy vọng sẽ được cấu hình trong 

TxCON 


Mô-đun giờ On / Off 

Tx_ON 

Tx_OFF 

Thơi gian Mô-đun chế độ Chờ On / Off 

Tx_IDLE_CON 

Tx_IDLE_STOP 

Tích lũy thời gian hẹn giờ Cổng phép 

Tx_GATE_ON 

Tx_GATE_OFF 

OpenTimer1 (Tiếp theo) 

OpenTimer2 

OpenTimer3 

OpenTimer4 

OpenTimer5 



Thơi gian prescaler 

Tx_PS_1_1 

Tx_PS_1_8 

Tx_PS_1_64 

Tx_PS_1_128 

Hẹn giờ đồng hồ đồng bộ cho phép 



Nguồn đồng hồ hẹn giờ 

Tx_SOURCE_EXT 

Tx_SOURCE_INT 

Giai đoạn này có giá trị phù hợp với thời gian được lưu trữ vào





Arguments: config This contains the parameters to be configured in the TxCON 

register as defined below: 

Timer Module On/Off 

Tx_ON 

Tx_OFF 

Timer Module Idle mode On/Off 

Tx_IDLE_CON 

Tx_IDLE_STOP 

dsPIC 

® 



Timer Gate time accumulation enable 

Tx_GATE_ON 

Tx_GATE_OFF 

Timer prescaler 

Tx_PS_1_1 

Tx_PS_1_8 

Tx_PS_1_64 

Tx_PS_1_128 

Timer Synchronous clock enable 



Timer clock source 

Tx_SOURCE_EXT 

Tx_SOURCE_INT 

period This contains the period match value to be stored into the 

PR register 


Remarks: This function configures the 16-bit Timer Control register and sets the 

period match value into the PR register 


OpenTimer2.c 

OpenTimer3.c 

OpenTimer4.c 

32-bit PR đăng ký. 


Ghi chú: Chức năng này cấu hình 32-bit Thơi gian kiểm soát và thiết lập 

giá trị phù hợp với thời gian vào sổ đăng ký PR 


OpenTimer45.c 

Mã số Ví dụ: OpenTimer23 (T2_ON & T2_GATE_OFF & 

T2_PS_1_8 & T2_32BIT_MODE_ON & 

T2_SYNC_EXT_OFF & 

T2_SOURCE_INT, 0xFFFF); 

ReadTimer1 

ReadTimer2 

ReadTimer3 

ReadTimer4 

ReadTimer5 

Mô tả: Chức năng này sẽ đọc nội dung của 16-bit Thơi gian đăng ký. 


Nguyên mẫu: int ReadTimer1 (void); 

int ReadTimer2 (void); 






Ghi chú: Chức năng này trả về các nội dung của 16-bit TMR đăng ký. 

Source File: ReadTimer1.c 

ReadTimer2.c 

ReadTimer3.c 

ReadTimer4.c 

ReadTimer5.c 

Mã số Ví dụ: int timer1_value; 

timer1_value = ReadTimer1 (); 

OpenTimer23 (Tiếp theo) 

OpenTimer45 

dsPIC 

® 



ReadTimer23

OpenTimer5.c 

Code Example: OpenTimer1(T1_ON & T1_GATE_OFF & 

T1_PS_1_8 & T1_SYNC_EXT_OFF & 

T1_SOURCE_INT, 0xFF); 

OpenTimer23 

OpenTimer45 

Description: This function configures the 32-bit timer module. 


Prototype: void OpenTimer23(unsigned int config, 

unsigned long period); 


unsigned long period); 

Arguments: config This contains the parameters tobe configured in the TxCON 


Timer module On/Off 

Tx_ON 

Tx_OFF 

Timer Module Idle mode On/Off 

Tx_IDLE_CON 

Tx_IDLE_STOP 

Timer Gate time accumulation enable 

Tx_GATE_ON 

Tx_GATE_OFF 

OpenTimer1 (Continued) 

OpenTimer2 

OpenTimer3 

OpenTimer4 

OpenTimer5 



Timer prescaler 

Tx_PS_1_1 

Tx_PS_1_8 

Tx_PS_1_64 

Tx_PS_1_128 

Timer Synchronous clock enable 



Timer clock source 

ReadTimer45 

Mô tả: Chức năng này sẽ đọc nội dung của 32-bit Thơi gian đăng ký. 


Prototype: ReadTimer23 unsigned dài (void); 

ReadTimer45 unsigned dài (void); 



Ghi chú: Chức năng này trả về contentsof 32-bit TMR đăng ký. 


ReadTimer45.c 

Mã số Ví dụ: unsigned timer23_value dài; 

timer23_value = ReadTimer23 (); 

WriteTimer1 

WriteTimer2 

WriteTimer3 

WriteTimer4 

WriteTimer5 

Mô tả: Chức năng này ghi giá trị 16-bit vào sổ đăng ký hẹn giờ. 


Prototype: void WriteTimer1 (int giờ); 

làm mất hiệu lực WriteTimer2 (int giờ); 




Đối số: giờ này là giá trị 16-bit được lưu trữ vào TMR đăng ký. 


Bình luận: Không có 

Source File: WriteTimer1.c 

WriteTimer2.c 

WriteTimer3.c 

WriteTimer4.c 

WriteTimer5.c 

Mã số Ví dụ: int timer_init = 0xAB; 

WriteTimer1 (timer_init); 




WriteTimer23 

WriteTimer45

Tx_SOURCE_EXT 

Tx_SOURCE_INT 

period This contains the period match value to be stored into the 

32-bit PR register. 


Remarks: This function configures the 32-bit Timer Control register and sets the 

period match value into the PR register 


OpenTimer45.c 

Code Example: OpenTimer23(T2_ON & T2_GATE_OFF & 

T2_PS_1_8 & T2_32BIT_MODE_ON & 

T2_SYNC_EXT_OFF & 

T2_SOURCE_INT, 0xFFFF); 

ReadTimer1 

ReadTimer2 

ReadTimer3 

ReadTimer4 

ReadTimer5 

Description: This function reads the contents of the 16-bit Timer register. 


Prototype: unsigned int ReadTimer1(void); 

unsigned int ReadTimer2(void); 






Remarks: This function returns the contents of the 16-bit TMR register. 


ReadTimer2.c 

ReadTimer3.c 

ReadTimer4.c 

ReadTimer5.c 

Code Example: unsigned int timer1_value; 

timer1_value = ReadTimer1(); 

OpenTimer23 (Continued) 

Mô tả: Chức năng này ghi giá trị 32-bit vào sổ đăng ký hẹn giờ. 


Prototype: void WriteTimer23 (giờ unsigned long); 

làm mất hiệu lực WriteTimer45 (bộ đếm thời gian dài không dấu); 

Đối số: giờ này là giá trị 32-bit được lưu trữ vào TMR đăng ký. 




WriteTimer45.c 

Mã số Ví dụ: timer23_init unsigned long = 0xABCD; 

WriteTimer23 (timer23_init); 

EnableIntT1 

EnableIntT2 

EnableIntT3 

EnableIntT4 

EnableIntT5 

Mô tả: Phần này cho phép giờ gián đoạn. 



Ghi chú: Phần này bộ hẹn giờ ngắt Enable chút ngắt Chức năng Kiểm soát 

đăng ký. 

Mã số Ví dụ: EnableIntT1; 

DisableIntT1 

DisableIntT2 

DisableIntT3 

DisableIntT4 

DisableIntT5 

Mô tả: vĩ mô này vô hiệu hóa bộ đếm thời gian gián đoạn. 



Bình luận: vĩ mô này sẽ xóa Thơi gian ngắt Enable chút ngắt Chức năng Kiểm 

soát 

đăng ký. 

Mã số Ví dụ: DisableIntT2; 

dsPIC 

® 


OpenTimer45 

dsPIC 




® 

# xác định __dsPIC30F6014__



ReadTimer23 

ReadTimer45 

Description: This function reads the contents of the 32-bit Timer register. 


Prototype: unsigned long ReadTimer23(void); 

unsigned long ReadTimer45(void); 



Remarks: This function returns the contentsof the 32-bit TMR register. 


ReadTimer45.c 

Code Example: unsigned long timer23_value; 

timer23_value = ReadTimer23(); 

WriteTimer1 

WriteTimer2 

WriteTimer3 

WriteTimer4 

WriteTimer5 

Description: This function writes the 16-bit value into the Timer register. 


Prototype: void WriteTimer1(unsigned int timer); 

void WriteTimer2(unsigned int timer); 




Arguments: timer This is the 16-bit value to be stored into TMR register. 


Remarks: None 


WriteTimer2.c 

WriteTimer3.c 

WriteTimer4.c 

WriteTimer5.c 

Code Example: unsigned int timer_init = 0xAB; 

WriteTimer1(timer_init); 



# include 

# include 

int timer_value; 

khoảng trống __attribute __ ((__ interrupt__)) _T1Interrupt (void) 

{ 

PORTDbits.RD1 = 1; / * Tắt đèn LED trên RD1 * / 

(0) WriteTimer1; 

IFS0bits.T1IF = 0; / * Thơi gian gián đoạn rõ ràng cờ * / 

} 


{ 

int match_value; 

TRISDbits.TRISD1 = 0; 


/ * Cho phép ngắt Timer1 và ưu tiên để "1" * / 

ConfigIntTimer1 (T1_INT_PRIOR_1 & T1_INT_ON); 

(0) WriteTimer1; 

match_value = 0xFFF; 

OpenTimer1 (T1_ON & T1_GATE_OFF & T1_IDLE_STOP & 


T1_SOURCE_INT, match_value); 

/ * Chờ cho đến khi bộ đếm thời gian phù hợp với giá trị khoảng thời gian * / 

trong khi (1) 

{ 

timer_value = ReadTimer1 (); 

if (timer_value> = 0x7FF) 

{ 

PORTDbits.RD1 = 0; / * Bật đèn LED trên RD1 * / 

} 

} 

CloseTimer1 (); 

} 

SetPriorityIntT1 





Mô tả: Điều này đặt ra ưu tiên vĩ mô cho giờ gián đoạn. 

Bao gồm: timer.h


WriteTimer23 

WriteTimer45 

Description: This function writes the 32-bit value into the Timer register. 


Prototype: void WriteTimer23(unsigned long timer); 

void WriteTimer45(unsigned long timer); 

Arguments: timer This is the 32-bit value to be stored into TMR register. 


Remarks: None 


WriteTimer45.c 

Code Example: unsigned long timer23_init = 0xABCD; 

WriteTimer23(timer23_init); 

EnableIntT1 

EnableIntT2 

EnableIntT3 

EnableIntT4 

EnableIntT5 

Description: This macro enables the timer interrupt. 



Remarks: This macro sets Timer Interrupt Enable bit of Interrupt Enable 

Control 

register. 

Code Example: EnableIntT1; 

DisableIntT1 

DisableIntT2 

DisableIntT3 

DisableIntT4 

DisableIntT5 

Description: This macro disables the timer interrupt. 



Remarks: This macro clears Timer Interrupt Enable bit of Interrupt Enable 

Control 

register. 

Code Example: DisableIntT2; 

dsPIC 

® 


Ghi chú: Phần này thiết lập hẹn giờ ngắt Prioritybits của ngắt ưu tiên kiểm soát 

đăng ký. 

Mã số Ví dụ: SetPriorityIntT4 (7); 



Chức năng thiết lập lại 3,8 / CONTROL 

Phần này bao gồm một danh sách các chức năng cá nhân để lập lại / 

Control. Chức năng có thể 

thực hiện như các macro. 


isBOR 

Mô tả: chức năng này sẽ kiểm tra nếu đặt lại là do màu nâu ra phát hiện. 

Bao gồm: reset.h 

Prototype: char isBOR (void); 


Trở lại giá trị: Chức năng này trả về RCON tình trạng bit. 

Nếu giá trị trả về là 1, sau đó đặt lại là do màu nâu-out. 

Nếu giá trị trả về là 0, sau đó không có màu nâu-out xảy ra. 


Source File: isBOR.c 

Mã số Ví dụ: char reset_state; 

reset_state = isBOR (); 

isPOR 

Mô tả: chức năng này sẽ kiểm tra nếu đặt lại là do điện vào Reset. 


Prototype: char isPOR (void); 



Nếu giá trị trả về là 1, sau đó đặt lại là do nguồn. 

Nếu giá trị trả về là 0, sau đó không có điện vào thiết lập lại xảy ra. 


Source File: isPOR.c 


reset_state = isPOR (); 

isLVD 

Mô tả: chức năng này sẽ kiểm tra nếu phát hiện điện áp thấp ngắt cờ được thiết 

lập. 


Prototype: char isLVD (void);





#include 

#include 

unsigned int timer_value; 

void __attribute__((__interrupt__)) _T1Interrupt(void) 

{ 

PORTDbits.RD1 = 1; /* turn off LED on RD1 */ 

WriteTimer1(0); 

IFS0bits.T1IF = 0; /* Clear Timer interrupt flag */ 

} 


{ 

unsigned int match_value; 



/* Enable Timer1 Interrupt and Priority to "1" */ 

ConfigIntTimer1(T1_INT_PRIOR_1 & T1_INT_ON); 

WriteTimer1(0); 

match_value = 0xFFF; 

OpenTimer1(T1_ON & T1_GATE_OFF & T1_IDLE_STOP & 


T1_SOURCE_INT, match_value); 

/* Wait till the timer matches with the period value */ 

while(1) 

{ 

timer_value = ReadTimer1(); 

if(timer_value >= 0x7FF) 

{ 

PORTDbits.RD1 = 0; /* turn on LED on RD1 */ 

} 

} 

CloseTimer1(); 

} 





Quay trở lại giá trị: Chức năng này trả về IFS2 tình trạng bit. 

Nếu giá trị trả về là 1, sau đó phát hiện điện áp thấp ngắt xảy ra. 

Nếu giá trị trả về là 0, sau đó phát hiện điện áp thấp ngắt đã không xảy ra. 


Source File: isLVD.c 

Mã số Ví dụ: char LVD; 

LVD = isLVD (); 

dsPIC 

® 



isMCLR 


Mô tả: chức năng kiểm tra nếu điều kiện lập lại này là do MCLRpin sẽ thấp. 


Prototype: char isMCLR (void); 



Nếu giá trị trả về là 1, sau đó thiết lập lại xảy ra do MCLRpin sẽ thấp. 

Nếu giá trị trả về là 0, sau đó đặt lại không phải do MCLRgoing thấp. 


Source File: isMCLR.c 


reset_state = isMCLR (); 

isWDTTO 

Mô tả: chức năng kiểm tra nếu điều kiện lập lại này là do WDT time-out. 


Prototype: char isWDTTO (void); 



Nếu giá trị trả về là 1, sau đó thiết lập lại xảy ra do WDT time-out. 

Nếu giá trị trả về là 0, sau đó đặt lại không phải do WDT time-out. 


Source File: isWDTTO.c 


reset_state = isWDTTO (); 

isWDTWU 

Mô tả: chức năng này sẽ kiểm tra nếu đánh thức từ giấc ngủ là do WDT timeout. 

Bao gồm: reset.h



Description: This macro sets priority for timer interrupt. 



Remarks: This macro sets Timer Interrupt Prioritybits of Interrupt Priority 

Control 

register. 

Code Example: SetPriorityIntT4(7); 



3.8 RESET/CONTROL FUNCTIONS 

This section contains a list of individual functions for Reset/Control. Functions 

may be 

implemented as macros. 


isBOR 

Description: This function checks if Reset is due to brown-out detect. 

Include: reset.h 

Prototype: char isBOR(void); 


Return Value: This function returns the RCON bit status. 

If return value is 1, then reset is due to brown-out. 

If return value is 0, then no brown-out occurred. 

Remarks: None 

Source File: isBOR.c 

Code Example: char reset_state; 

reset_state = isBOR(); 

isPOR 

Description: This function checks if Reset is due to Power on Reset. 


Prototype: char isPOR(void); 



If return value is 1, then reset is due to Power on. 

If return value is 0, then no Power on reset occurred. 

Remarks: None 

Source File: isPOR.c 


reset_state = isPOR(); 

Prototype: char isWDTWU (void); 


Trở lại giá trị: Chức năng này trả về tình trạng của RCON và 

RCONbit 

Nếu giá trị trả về là "1", sau đó Wake-up từ Sleep xảy ra do WDT 

time-out. 

Nếu giá trị trả về là "0", sau đó Wake-up từ Sleep không phải là do WDT 

time-out. 


Source File: isWDTWU.c 


reset_state = isWDTWU (); 




isWU 

Mô tả: chức năng này sẽ kiểm tra nếu đánh thức từ giấc ngủ là do MCLR, POR 

Ban đại diện hay bất kỳ gián đoạn. 


Prototype: char isWU (void); 


Quay trở lại giá trị: chức năng này sẽ kiểm tra nếu đánh thức từ giấc ngủ đã xảy 

ra. 

Nếu có, nó sẽ kiểm tra cho là nguyên nhân cho đánh thức. 

nếu "1", đánh thức là do sự xuất hiện của bị gián đoạn. 

nếu "2", báo thức là do MCLR. 

nếu '3', báo thức là do POR. 

nếu '4', báo thức là do Ban đại diện. 

Nếu đánh thức từ giấc ngủ đã không xảy ra, sau đó giá trị "0" được trả về. 


Source File: isWU.c 


reset_state = isWU (); 

DisableInterrupts 

Mô tả: vĩ mô này vô hiệu hóa tất cả các ngắt ngoại vi cho số quy định của 

chu kỳ hướng dẫn. 


Đối số: chu kỳ 

Ghi chú: Phần này hướng dẫn thực hiện Disi để vô hiệu hóa tất cả các thiết bị 

ngoại vi

isLVD 

Description: This function checks if Low voltage detect interrupt flag is set. 


Prototype: char isLVD(void); 


Return Value: This function returns the IFS2 bit status. 

If return value is 1, then low voltage detect interrupt occurred. 

If return value is 0, then low voltage detect interrupt did not occur. 

Remarks: None 

Source File: isLVD.c 

Code Example: char lvd; 

lvd = isLVD(); 

dsPIC 

® 


DS51456B-page 118 

isMCLR 


Description: This function checks if Reset condition is due to MCLRpin going 

low. 


Prototype: char isMCLR(void); 



If return value is 1, then reset occurred due to MCLRpin going low. 

If return value is 0, then reset is not due to MCLRgoing low. 

Remarks: None 

Source File: isMCLR.c 


reset_state = isMCLR(); 

isWDTTO 

Description: This function checks if Reset condition is due to WDT time-out. 


Prototype: char isWDTTO(void); 



If return value is 1, then reset occurred due to WDT time-out. 

If return value is 0, then reset is not due to WDT time-out. 

Remarks: None 

Source File: isWDTTO.c 

ngắt cho số quy định của chu kỳ hướng dẫn. 

Mã số Ví dụ: DisableInterrupts (15); 

PORStatReset 

Mô tả: Đây vĩ mô bit bộ của POR RCON đăng ký để thiết lập lại nhà nước. 




Mã số Ví dụ: PORStatReset; 

BORStatReset 

Mô tả: Đây bộ vĩ mô BOR chút RCON đăng ký để thiết lập lại nhà nước. 




Mã số Ví dụ: BORStatReset; 

dsPIC 

® 



3,9 I / O PORT chức năng 


Phần này bao gồm một danh sách các individualfunctions cho I / O port. Chức 

năng có thể 

thực hiện như các macro. 


WDTSWEnable 

Mô tả: Đây vĩ mô lần lượt trên bộ đếm thời gian cơ quan giám sát 



Bình luận: vĩ mô này đặt phần mềm WDT Enable (SWDTEN) chút RCON 

đăng ký 

Mã số Ví dụ: WDTSWEnable; 

WDTSWDisable 

Mô tả: vĩ mô này sẽ xóa phần mềm WDT Enable (SWDTEN) chút RCON 

đăng ký 



Ghi chú: Phần này sẽ vô hiệu hóa WDT ifFWDTEN Fuse bit "0". 

Mã số Ví dụ: WDTSWDisable; 

CloseINT0 

CloseINT1 

CloseINT2


reset_state = isWDTTO(); 

isWDTWU 

Description: This function checks if Wake-up from Sleep is due to WDT timeout. 


Prototype: char isWDTWU(void); 


Return Value: This function returns the status of RCON and 

RCONbits 

If return value is ‘1’, then Wake-up from Sleep occurred due to WDT 

time-out. 

If return value is ‘0’, then Wake-up from Sleep is not due to WDT 

time-out. 

Remarks: None 

Source File: isWDTWU.c 


reset_state = isWDTWU(); 




isWU 

Description: This function checks if Wake-up from Sleep is due to MCLR, 

POR, 

BOR or any interrupt. 


Prototype: char isWU(void); 


Return Value: This function checks if Wake-up from Sleep has occurred. 

If yes, it checks for the cause for wake-up. 

if ‘1’, wake-up is due to the occurrence of interrupt. 

if ‘2’, wake-up is due to MCLR. 

if ‘3’, wake-up is due to POR. 

if ‘4’, wake-up is due to BOR. 

If Wake-up from Sleep has not occurred, then a value of ‘0’ is returned. 

Remarks: None 

Source File: isWU.c 


reset_state = isWU(); 

DisableInterrupts 

CloseINT3 

CloseINT4 

Mô tả: Chức năng này vô hiệu hóa ngắt ngoài vào INT pin. 

Bao gồm: ports.h 

Prototype: void CloseINT0 (void); 

làm mất hiệu lực CloseINT1 (void); 






Ghi chú: Chức năng này vô hiệu hóa ngắt INT pin và xóa 

tương ứng với cờ ngắt. 

Source File: CloseInt0.c 

CloseInt1.c 

CloseInt2.c 

CloseInt3.c 

CloseInt4.c 

Mã số Ví dụ: CloseINT0 (); 



ConfigINT0 

ConfigINT1 

ConfigINT2 

ConfigINT3 

ConfigINT4 

Mô tả: Chức năng này cấu hình ngắt INT pin. 


Prototype: void ConfigINT0 (int config); 

làm mất hiệu lực ConfigINT1 (int config); 




Đối số: cấu hình ngắt cạnh, ưu tiên và bật / tắt thông tin 


Lựa chọn cạnh ngắt 

RISING_EDGE_INT 

FALLING_EDGE_INT 

Cho phép ngắt

Description: This macro disables all the peripheral interrupts for specified 

number of 

instruction cycles. 


Arguments: cycles 

Remarks: This macro executes DISI instruction to disable all the peripheral 

interrupts for specified number of instruction cycles. 

Code Example: DisableInterrupts(15); 

PORStatReset 

Description: This macro sets POR bit of RCON register to reset state. 



Remarks: None 

Code Example: PORStatReset; 

BORStatReset 

Description: This macro sets BOR bit of RCON register to reset state. 



Remarks: None 

Code Example: BORStatReset; 

dsPIC 

® 


INT_ENABLE 

INT_DISABLE 

Ưu tiên ngắt 

INT_PRI_0 

INT_PRI_1 

INT_PRI_2 

INT_PRI_3 

INT_PRI_4 

INT_PRI_5 

INT_PRI_6 

INT_PRI_7 


Bình luận: chức năng này sẽ xóa cờ ngắt tương ứng với pin INTx và 

sau đó chọn cạnh phát hiện cực. 

Sau đó, đặt ưu tiên ngắt và cho phép / vô hiệu hóa ngắt. 

Source File: ConfigInt0.c 

ConfigInt1.c 

ConfigInt2.c 

ConfigInt3.c 

ConfigInt4.c 

Mã số Ví dụ: ConfigINT0 (RISING_EDGE_INT & EXT_INT_PRI_5 & 

EXT_INT_ENABLE); 

dsPIC 

DS51456B-page 120 


® 

3.9 I/O PORT FUNCTIONS 

This section contains a list of individualfunctions for I/O ports. Functions may 

be 

implemented as macros. 


WDTSWEnable 

Description: This macro turns on the watchdog timer 



Remarks: This macro sets Software WDT Enable (SWDTEN) bit of RCON 

register 

Code Example: WDTSWEnable; 

WDTSWDisable 

Description: This macro clears Software WDT Enable (SWDTEN) bit of RCON 

register 




ConfigCNPullups 

Mô tả: Chức năng này cấu hình các điện trở kéo lên cho CN chân. 


Prototype: void ConfigCNPullups (long int config); 

Đối số: cấu hình này là giá trị 32-bit để cấu hình pull-up. Thấp hơn 

từ được lưu trữ vào CNPU1 đăng ký và từ trên tiếp theo là 

lưu trữ trong CNPU2 đăng ký. 8 bit trên của CNPU2 

đăng ký là chưa thực hiện. 



Source File: ConfigCNPullups.c 

Mã số Ví dụ: ConfigCNPullups (0xFFF); 

ConfigIntCN


Remarks: This macro disables WDT ifFWDTEN Fuse bit is ‘0’. 

Code Example: WDTSWDisable; 

CloseINT0 

CloseINT1 

CloseINT2 

CloseINT3 

CloseINT4 

Description: This function disables the external interrupt on INT pin. 

Include: ports.h 

Prototype: void CloseINT0(void); 

void CloseINT1(void); 






Remarks: This function disables the interrupt on INT pin and clears the 

corresponding Interrupt flag. 

Source File: CloseInt0.c 

CloseInt1.c 

CloseInt2.c 

CloseInt3.c 

CloseInt4.c 

Code Example: CloseINT0(); 



ConfigINT0 

ConfigINT1 

ConfigINT2 

ConfigINT3 

ConfigINT4 

Description: This function configures the interrupt on INT pin. 


Prototype: void ConfigINT0(unsigned int config); 

void ConfigINT1(unsigned int config); 




Mô tả: Chức năng này cấu hình ngắt CN. 


Prototype: void ConfigIntCN (long int config); 

Đối số: cấu hình này là giá trị 32-bit cho cấu hình CN ngắt. 

Thấp hơn 24 bit bao gồm các cá nhân cho phép / vô hiệu hóa 

thông tin cho CN ngắt. Thiết lập bit x (x = 0, 1, ..., 

23) sẽ cho phép ngắt CNX. 

Nhất byte trên các cấu hình bao gồm các ưu tiên ngắt 

và Enable / Disable bit. 

Từ thấp được lưu trữ vào CNEN1register và tiếp theo 

byte trên được lưu trữ vào sổ đăng ký CNEN2 và trên 

hầu hết các byte được sử dụng để ưu tiên thiết lập và kích hoạt / vô hiệu hóa 

CN ngắt. 


Ghi chú: Chức năng này sẽ xóa sạch các interruptflag CN và cho phép / vô hiệu 

hóa 

ngắt cá nhân trên CN chân. 

Điều này cũng có cấu hình ưu tiên ngắt và cho phép / vô hiệu hóa các CN 

Kích hoạt tính năng ngắt bit. 

Source File: ConfigIntCN.c 

Mã số Ví dụ: // này sẽ cho phép CN0, CN1, CN2 và CN7 chỉ. 

ConfigIntCN (CHANGE_INT_OFF & CHANGE_INT_PRI_4 & 

0xFF000087); 




EnableCN0 

EnableCN1 

EnableCN2 

..................... 

EnableCN23 

Mô tả: vĩ mô Điều này cho phép các cá nhân thông báo thay đổi gián đoạn. 




Mã số Ví dụ: EnableCN6; 

DisableCN0 

DisableCN1 

DisableCN2 

......................

Arguments: config Interrupt edge, priority and enable/disable information as 


Interrupt edge selection 

RISING_EDGE_INT 

FALLING_EDGE_INT 

Interrupt enable 

INT_ENABLE 

INT_DISABLE 

Interrupt priority 

INT_PRI_0 

INT_PRI_1 

INT_PRI_2 

INT_PRI_3 

INT_PRI_4 

INT_PRI_5 

INT_PRI_6 

INT_PRI_7 


Remarks: This function clears the interrupt flag corresponding to the INTx pin 

and 

then selects the edge detect polarity. 

It then sets the interrupt priority and enables/disables the interrupt. 

Source File: ConfigInt0.c 

ConfigInt1.c 

ConfigInt2.c 

ConfigInt3.c 

ConfigInt4.c 

Code Example: ConfigINT0(RISING_EDGE_INT& EXT_INT_PRI_5 & 

EXT_INT_ENABLE); 

dsPIC 

® 


DisableCN23 

Mô tả: vĩ mô này vô hiệu hóa cá nhân thông báo thay đổi gián đoạn. 




Mã số Ví dụ: DisableCN14; 

EnableINT0 

EnableINT1 

EnableINT2 

EnableINT3 

EnableINT4 

Mô tả: vĩ mô này cho phép ngắt ngoài cá nhân. 




Mã số Ví dụ: EnableINT2; 

dsPIC 

® 



DisableINT0 

DisableINT1 

DisableINT2 

DisableINT3 

DisableINT4 

Mô tả: vĩ mô này vô hiệu hóa ngắt ngoài cá nhân. 




Mã số Ví dụ: DisableINT2; 

SetPriorityInt0 


DS51456B-page 122 

ConfigCNPullups 




Description: This function configures the pull-up resistors for CN pins. 


Prototype: void ConfigCNPullups(long int config); 

Arguments: config This is the 32-bit value for configuring pull-ups. The lower 

word is stored into CNPU1 register and next upper word is 


Mô tả: Đây ưu tiên bộ vĩ mô cho ngắt ngoài. 



Ghi chú: Phần này thiết lập ngắt ngoài bit ưu tiên của ưu tiên ngắt

stored into CNPU2 register. The upper 8 bits of CNPU2 

register are unimplemented. 


Remarks: None 

Source File: ConfigCNPullups.c 

Code Example: ConfigCNPullups(0xFFF); 

ConfigIntCN 

Description: This function configures the CN interrupts. 


Prototype: void ConfigIntCN(long int config); 

Arguments: config This is the 32-bit value for configuring the CN interrupts. 

The lower 24 bits contain the individual enable/disable 

information for the CN interrupts. Setting bit x (x = 0, 1, ..., 

23) would enable the CNx interrupt. 

The upper most byte of config contains the Interrupt Priority 

and Enable/Disable bits. 

The lower word is stored into the CNEN1register and next 

upper byte is stored into the CNEN2 register and the upper 

most byte is used for setting priority and enable/disable the 

CN interrupts. 


Remarks: This function clears the CN interruptflag and enables/disables the 

individual interrupts on CN pins. 

This also configures the interrupt priority and enables/disables the CN 

Interrupt Enable bit. 

Source File: ConfigIntCN.c 

Code Example: // This would enable CN0, CN1, CN2 and CN7 only. 

ConfigIntCN(CHANGE_INT_OFF & CHANGE_INT_PRI_4 & 

0xFF000087); 




EnableCN0 

EnableCN1 

EnableCN2 

..................... 

EnableCN23 

Description: This macro enables the individual change notification interrupt. 


Kiểm soát đăng ký. 

Mã số Ví dụ: SetPriorityInt4 (6); 



3.10 VÀO CHỨC NĂNG CAPTURE 

Phần này bao gồm một danh sách các chức năng riêng biệt cho Input Capture 

module và một 

ví dụ về việc sử dụng các chức năng. Chức năng có thể được thực hiện như các 

macro. 


CloseCapture1 

CloseCapture2 

CloseCapture3 

CloseCapture4 

CloseCapture5 

CloseCapture6 

CloseCapture7 

CloseCapture8 

Mô tả: Chức năng này sẽ tắt các mô-đun Input Capture. 

Bao gồm: InCap.h 

Prototype: void CloseCapture1 (void); 

làm mất hiệu lực CloseCapture2 (void); 









Ghi chú: Chức năng này vô hiệu hóa các Input Capture gián đoạn và sau đó tắt 

module.The ngắt Flagbit cũng sẽ bị xóa. 

Source File: CloseCapture1.c 

CloseCapture2.c 






CloseCapture8.c


Remarks: None 

Code Example: EnableCN6; 

DisableCN0 

DisableCN1 

DisableCN2 

...................... 

DisableCN23 

Description: This macro disables individual change notification interrupt. 



Remarks: None 

Code Example: DisableCN14; 

EnableINT0 

EnableINT1 

EnableINT2 

EnableINT3 

EnableINT4 

Description: This macro enables the individual external interrupt. 



Remarks: None 

Code Example: EnableINT2; 

dsPIC 

® 



DisableINT0 

DisableINT1 

DisableINT2 

DisableINT3 

DisableINT4 

Description: This macro disables the individual external interrupt. 



Remarks: None 

Code Example: DisableINT2; 



Mã số Ví dụ: CloseCapture1 (); 

dsPIC 

® 



ConfigIntCapture1 








Mô tả: Chức năng này cấu hình Input Capture gián đoạn. 


Prototype: void ConfigIntCapture1 (int config); 

làm mất hiệu lực ConfigIntCapture2 (int config); 







Lập luận: config Input Capture gián đoạn ưu tiên và cho phép / vô hiệu hóa 

thông tin theo quy định dưới đây: 

Ngắt bật / tắt 

IC_INT_ON 

IC_INT_OFF 


IC_INT_PRIOR_0 









Bình luận: Chức năng này sẽ xóa sạch các ngắt Flagbit và sau đó đặt ngắt




Description: This macro sets priority for external interrupts. 



Remarks: This macro sets External Interrupt Priority bits of Interrupt Priority 

Control register. 

Code Example: SetPriorityInt4(6); 



3.10 INPUT CAPTURE FUNCTIONS 

This section contains a list of individual functions for Input Capture module and 

an 

example of use of the functions. Functions may be implemented as macros. 


CloseCapture1 

CloseCapture2 

CloseCapture3 

CloseCapture4 

CloseCapture5 

CloseCapture6 

CloseCapture7 

CloseCapture8 

Description: This function turns off the Input Capture module. 

Include: InCap.h 

Prototype: void CloseCapture1(void); 

void CloseCapture2(void); 









Remarks: This function disables the Input Capture interrupt and then turns off 

the 

module.The Interrupt Flagbit is also cleared. 

Source File: CloseCapture1.c 

ưu tiên và cho phép / vô hiệu hóa ngắt. 

Source File: ConfigIntCapture1.c 

ConfigIntCapture2.c 







Mã số Ví dụ: ConfigIntCapture1 (IC_INT_ON & IC_INT_PRIOR_1); 



OpenCapture1 

OpenCapture2 

OpenCapture3 

OpenCapture4 

OpenCapture5 

OpenCapture6 

OpenCapture7 

OpenCapture8 

Mô tả: Chức năng này cấu hình mô-đun Input Capture. 


Prototype: void OpenCapture1 (int config); 

làm mất hiệu lực OpenCapture2 (int config); 







Đối số: cấu hình này bao gồm các thông số phải được cấu hình trong 

ICxCON đăng ký theo quy định dưới đây: 


IC_IDLE_CON 

IC_IDLE_STOP 

Đồng hồ chọn 

IC_TIMER2_SRC 

IC_TIMER3_SRC 

Chụp mỗi ngắt








Code Example: CloseCapture1(); 

dsPIC 

® 











Description: This function configures the Input Capture interrupt. 


Prototype: void ConfigIntCapture1(unsigned int config); 

void ConfigIntCapture2(unsigned int config); 







Arguments: config Input Capture interrupt priority and enable/disable 

information as defined below: 

Interrupt enable/disable 

IC_INT_ON 

IC_INT_OFF 

Interrupt Priority 




IC_INT_4CAPTURE 




IC_INTERRUPT 

Chế độ IC chọn 

IC_EVERY_EDGE 

IC_EVERY_16_RISE_EDGE 


IC_EVERY_RISE_EDGE 

IC_EVERY_FALL_EDGE 

IC_INPUTCAP_OFF 


Ghi chú: Chức năng này cấu hình Input Capture Mô-đun kiểm soát đăng ký 

(ICxCON) với các thông số sau: Đồng hồ lựa chọn, chụp mỗi 

gián đoạn, chế độ chụp hoạt động. 

Source File: OpenCapture1.c 

OpenCapture2.c 







Mã số Ví dụ: OpenCapture1 (IC_IDLE_CON & IC_TIMER2_SRC & 

IC_INT_1CAPTURE & IC_EVERY_RISE_EDGE); 

dsPIC 

® 



ReadCapture1 

ReadCapture2 

ReadCapture3 

ReadCapture4 

ReadCapture5 

ReadCapture6 

ReadCapture7 

ReadCapture8 

Mô tả: Chức năng này đọc tất cả các cấp phát bộ đệm Input Capture.







Remarks: This function clears the Interrupt Flagbit and then sets the interrupt 

priority and enables/disables the interrupt. 

Source File: ConfigIntCapture1.c 








Code Example: ConfigIntCapture1(IC_INT_ON & IC_INT_PRIOR_1); 



OpenCapture1 

OpenCapture2 

OpenCapture3 

OpenCapture4 

OpenCapture5 

OpenCapture6 

OpenCapture7 

OpenCapture8 

Description: This function configures the Input Capture module. 


Prototype: void OpenCapture1(unsigned int config); 

void OpenCapture2(unsigned int config); 







Arguments: config This contains the parameters to be configured in the 

ICxCON register as defined below: 


Prototype: void ReadCapture1 (int * đệm); 

làm mất hiệu lực ReadCapture2 (int * đệm); 







Đối số: đệm Đây là con trỏ đến vị trí nơi mà các dữ liệu đọc từ 

Input Capture bộ đệm phải được lưu trữ. 


Bình luận: Chức năng này đọc tất cả các cấp phát Input Capture bộ đệm cho đến 

khi bộ đệm 

được sản phẩm nào được chỉ định bởi ICxCON bit bị xóa. 

Source File: ReadCapture1.c 

ReadCapture2.c 







Mã số Ví dụ: int * đệm = 0x1900; 

ReadCapture1 (đệm); 




EnableIntIC1 

EnableIntIC2 

EnableIntIC3 

EnableIntIC4 

EnableIntIC5 

EnableIntIC6 

EnableIntIC7 

EnableIntIC8 

Mô tả: vĩ mô này cho phép ngắt trên màn hình sự kiện. 



Bình luận: Đây vĩ mô bộ Input Capture Interrupt Enable bit Interrupt Enable


IC_IDLE_CON 

IC_IDLE_STOP 

Clock select 

IC_TIMER2_SRC 

IC_TIMER3_SRC 

Captures per interrupt 





IC_INTERRUPT 

IC mode select 

IC_EVERY_EDGE 



IC_EVERY_RISE_EDGE 

IC_EVERY_FALL_EDGE 

IC_INPUTCAP_OFF 


Remarks: This function configures the Input Capture Module Control register 

(ICxCON) with the following parameters: Clock select, Captures per 

interrupt, Capture mode of operation. 

Source File: OpenCapture1.c 








Code Example: OpenCapture1(IC_IDLE_CON & IC_TIMER2_SRC & 

IC_INT_1CAPTURE & IC_EVERY_RISE_EDGE); 

dsPIC 

® 



ReadCapture1 

ReadCapture2 


Mã số Ví dụ: EnableIntIC7; 

DisableIntIC1 

DisableIntIC2 

DisableIntIC3 

DisableIntIC4 

DisableIntIC5 

DisableIntIC6 

DisableIntIC7 

DisableIntIC8 

Mô tả: vĩ mô này vô hiệu hóa ngắt trên màn hình sự kiện. 



Bình luận: vĩ mô này xóa Input Capture Interrupt Enable bit Interrupt Enable 


Mã số Ví dụ: DisableIntIC7; 

SetPriorityIntIC1 








Mô tả: Điều này đặt ra ưu tiên vĩ mô cho thu nhập bị gián đoạn. 



Bình luận: vĩ mô bộ Input Capture này bit ưu tiên của ngắt ưu tiên ngắt 


Mã số Ví dụ: SetPriorityIntIC4 (1); 

dsPIC 

® 



3.10.3 Ví dụ sử dụng 


# include 

# include 

int Interrupt_Count = 0, Int_flag, đếm;

ReadCapture3 

ReadCapture4 

ReadCapture5 

ReadCapture6 

ReadCapture7 

ReadCapture8 

Description: This function reads all the pending Input Capture buffers. 


Prototype: void ReadCapture1(unsigned int *buffer); 

void ReadCapture2(unsigned int *buffer); 







Arguments: buffer This is the pointer to the locations where the data read from 

the Input Capture buffers have to be stored. 


Remarks: This function reads all the pending Input Capture buffers till the 

buffers 

are empty indicated by the ICxCON bit getting cleared. 

Source File: ReadCapture1.c 








Code Example: unsigned int *buffer = 0x1900; 

ReadCapture1(buffer); 




EnableIntIC1 

EnableIntIC2 

EnableIntIC3 

EnableIntIC4 

int timer_first_edge, timer_second_edge; 

khoảng trống __attribute __ ((__ interrupt__)) _IC1Interrupt (void) 

{ 

Interrupt_Count ++; 

if (Interrupt_Count == 1) 

ReadCapture1 (& timer_first_edge); 

else if (Interrupt_Count == 2) 

ReadCapture1 (& timer_second_edge); 

Int_flag = 1; 

IFS0bits.IC1IF = 0; 

} 


{ 

giai đoạn int unsigned; 

Int_flag = 0; 

TRISDbits.TRISD0 = 0; / * Đầu ra cảnh báo về RD0 * / 

PORTDbits.RD0 = 1; 

/ * Cho phép ngắt Timer1 và ưu tiên để "1" * / 

ConfigIntCapture1 (IC_INT_PRIOR_1 & IC_INT_ON); 

T3CON = 0x8000; / * Timer 3 On * / 

/ * Cấu hình các InputCapture trong dừng ở chế độ nhàn rỗi, Timer 

3 như là nguồn, làm gián đoạn trên màn hình 1, I / C vào mỗi mùa thu 

cạnh * / 

OpenCapture1 (IC_IDLE_STOP & IC_TIMER3_SRC & 

IC_INT_1CAPTURE & IC_EVERY_FALL_EDGE); 

trong khi (1) 

{ 

trong khi (Int_flag); / * Chờ đợi ở đây cho đến khi sự kiện bắt đầu * / 

Int_flag = 0; 

trong khi (Int_flag); / * Chờ đợi ở đây cho đến khi sự kiện bắt giữ tiếp theo * / 

/ * Tính đếm thời gian giữa hai sự kiện chụp * / 

thời gian = timer_second_edge - timer_first_edge; 

/ * Nếu tính thời gian giữa hai sự kiện chụp nhiều hơn 

0x200 tính, thiết lập báo động trên RD0 * / 

if (giai đoạn> = 0x200) 

{ 

/ * Thiết lập báo động và chờ đợi đôi khi rõ ràng và báo động * / 


trong khi (count

EnableIntIC5 

EnableIntIC6 

EnableIntIC7 

EnableIntIC8 

Description: This macro enables the interrupt on capture event. 



Remarks: This macro sets Input Capture Interrupt Enable bit of Interrupt Enable 


Code Example: EnableIntIC7; 

DisableIntIC1 

DisableIntIC2 

DisableIntIC3 

DisableIntIC4 

DisableIntIC5 

DisableIntIC6 

DisableIntIC7 

DisableIntIC8 

Description: This macro disables the interrupt on capture event. 



Remarks: This macro clears Input Capture Interrupt Enable bit of Interrupt 

Enable 


Code Example: DisableIntIC7; 









Description: This macro sets priority for input capture interrupt. 



Remarks: This macro sets Input Capture Interrupt Priority bits of Interrupt 

Priority 


Code Example: SetPriorityIntIC4(1); 

{ 

tính ++; 

} 


} 

Interrupt_Count = 0; 

count = 0; 

} 

CloseCapture1 (); 

} 



3.11 OUTPUT SO SÁNH CHỨC NĂNG 

Phần này bao gồm một danh sách các chức năng riêng cho đầu ra so sánh các 

mô-đun và một 

ví dụ về việc sử dụng các chức năng. Chức năng có thể được thực hiện như các 

macro. 


CloseOC1 

CloseOC2 

CloseOC3 

CloseOC4 

CloseOC5 

CloseOC6 

CloseOC7 

CloseOC8 

Mô tả: Chức năng này sẽ tắt đầu ra so sánh các mô-đun. 

Bao gồm: outcompare.h 

Prototype: void CloseOC1 (void); 

làm mất hiệu lực CloseOC2 (void); 









Ghi chú: Chức năng này vô hiệu hóa các đầu ra so sánh gián đoạn và sau đó tắt 

bit module.The Cờ ngắt cũng sẽ bị xóa.

dsPIC 

® 





#include 

#include 

int Interrupt_Count = 0 , Int_flag, count; 

unsigned int timer_first_edge, timer_second_edge; 

void __attribute__((__interrupt__)) _IC1Interrupt(void) 

{ 

Interrupt_Count++; 

if(Interrupt_Count == 1) 

ReadCapture1(&timer_first_edge); 

else if(Interrupt_Count == 2) 

ReadCapture1(&timer_second_edge); 

Int_flag = 1; 

IFS0bits.IC1IF = 0; 

} 


{ 

unsigned int period; 

Int_flag = 0; 

TRISDbits.TRISD0 = 0; /*Alarm output on RD0 */ 


/* Enable Timer1 Interrupt and Priority to '1' */ 

ConfigIntCapture1(IC_INT_PRIOR_1 & IC_INT_ON); 

T3CON = 0x8000; /* Timer 3 On */ 

/* Configure the InputCapture in stop in idle mode , Timer 

3 as source , interrupt on capture 1, I/C on every fall 

edge */ 

OpenCapture1(IC_IDLE_STOP & IC_TIMER3_SRC & 

IC_INT_1CAPTURE & IC_EVERY_FALL_EDGE); 

while(1) 

{ 

while(!Int_flag); /* wait here till first capture event */ 

Int_flag = 0; 

while(!Int_flag); /* wait here till next capture event */ 

Source File: CloseOC1.c 

CloseOC2.c 

CloseOC3.c 

CloseOC4.c 

CloseOC5.c 

CloseOC6.c 

CloseOC7.c 

CloseOC8.c 

Mã số Ví dụ: CloseOC1 (); 

dsPIC 

® 



ConfigIntOC1 

ConfigIntOC2 

ConfigIntOC3 

ConfigIntOC4 

ConfigIntOC5 

ConfigIntOC6 

ConfigIntOC7 

ConfigIntOC8 

Mô tả: Chức năng này cấu hình ra so sánh gián đoạn. 


Prototype: void ConfigIntOC1 (int config); 

làm mất hiệu lực ConfigIntOC2 (int config); 







Lập luận: config ra so sánh ngắt ưu tiên và cho phép / vô hiệu hóa 

thông tin theo quy định dưới đây: 


OC_INT_ON 

OC_INT_OFF 


OC_INT_PRIOR_0 

OC_INT_PRIOR_1

* calculate time count between two capture events */ 

period = timer_second_edge - timer_first_edge; 

/* if the time count between two capture events is more than 

0x200 counts, set alarm on RD0 */ 

if(period >= 0x200) 

{ 

/* set alarm and wait for sometime and clear alarm */ 


while(count

void CloseOC4(void); 







Remarks: This function disables the Output Compare interrupt and then turns 

off 

the module.The Interrupt Flag bit is also cleared. 

Source File: CloseOC1.c 

CloseOC2.c 

CloseOC3.c 

CloseOC4.c 

CloseOC5.c 

CloseOC6.c 

CloseOC7.c 

CloseOC8.c 

Code Example: CloseOC1(); 

dsPIC 

® 


int value1, value2 int); 

khoảng trống OpenOC6 (int config, 







OCxCON đăng ký theo quy định dưới đây: 


OC_IDLE_STOP 

OC_IDLE_CON 

Đồng hồ chọn 

OC_TIMER2_SRC 

OC_TIMER3_SRC 

Đầu ra so sánh phương thức hoạt động 

OC_PWM_FAULT_PIN_ENABLE 

OC_PWM_FAULT_PIN_DISABLE 

OC_CONTINUE_PULSE 

OC_SINGLE_PULSE 

OC_TOGGLE_PULSE 

OC_HIGH_LOW 

DS51456B-page 132 

ConfigIntOC1 

ConfigIntOC2 

ConfigIntOC3 

ConfigIntOC4 

ConfigIntOC5 

ConfigIntOC6 

ConfigIntOC7 

ConfigIntOC8 


OC_LOW_HIGH 

OC_OFF 

value1 này chứa các giá trị được lưu trữ trong OCxRS thứ 

Đăng ký. 

value2 này chứa các giá trị được lưu trữ trong OCxR chính 

Đăng ký. 


dsPIC 

® 

Description: This function configures the Output Compare interrupt. 


Include: outcompare.h 



Prototype: void ConfigIntOC1(unsigned int config); 

void ConfigIntOC2(unsigned int config); 





Bình luận: Chức năng này cấu hình đăng ký OutputCompare Mô-đun điều khiể 

(OCxCON) với các thông số sau: 

Đồng hồ lựa chọn, phương thức hoạt động, hoạt động ở chế độ Idle. 

Nó cũng có cấu hình OCxRS và OCxR đăng ký. 

Source File: OpenOC1.c 

OpenOC2.c



Arguments: config Output Compare interrupt priority and enable/disable 

information as defined below: 

Interrupt enable/disable 

OC_INT_ON 

OC_INT_OFF 

Interrupt Priority 










Remarks: This function clears the Interrupt Flagbit and then sets the interrupt 

priority and enables/disables the interrupt. 

Source File: ConfigIntOC1.c 

ConfigIntOC2.c 







Code Example: ConfigIntOC1(OC_INT_ON & OC_INT_PRIOR_2); 



OpenOC1 

OpenOC2 

OpenOC3 

OpenOC4 

OpenOC5 

OpenOC6 

OpenOC7 

OpenOC8 

Description: This function configures the Output Compare module. 

OpenOC3.c 

OpenOC4.c 

OpenOC5.c 

OpenOC6.c 

OpenOC7.c 

OpenOC8.c 

Mã số Ví dụ: OpenOC1 (OC_IDLE_CON & OC_TIMER2_SRC & 

OC_PWM_FAULT_PIN_ENABLE, 0x80, 0x60); 

OpenOC1 (Tiếp theo) 

OpenOC2 

OpenOC3 

OpenOC4 

OpenOC5 

OpenOC6 

OpenOC7 

OpenOC8 



ReadDCOC1PWM 

ReadDCOC2PWM 

ReadDCOC3PWM 

ReadDCOC4PWM 

ReadDCOC5PWM 

ReadDCOC6PWM 

ReadDCOC7PWM 

ReadDCOC8PWM 

Mô tả: Chức năng này đọc các chu kỳ nhiệm vụ từ đầu ra so sánh thứ 

đăng ký. 


Nguyên mẫu: int ReadDCOC1PWM (void); 

int ReadDCOC2PWM (void); 








Trở lại giá trị: Chức năng này trả về nội dung của OCxRS đăng ký khi đầu ra


Prototype: void OpenOC1(unsigned int config, 

unsigned int value1, unsigned int value2); 

void OpenOC2(unsigned int config, 















OCxCON register as defined below: 


OC_IDLE_STOP 

OC_IDLE_CON 

Clock select 

OC_TIMER2_SRC 

OC_TIMER3_SRC 

Output Compare modes of operation 

OC_PWM_FAULT_PIN_ENABLE 

OC_PWM_FAULT_PIN_DISABLE 

OC_CONTINUE_PULSE 

OC_SINGLE_PULSE 

OC_TOGGLE_PULSE 

OC_HIGH_LOW 

OC_LOW_HIGH 

OC_OFF 

value1 This contains the value to be stored into OCxRS Secondary 

Register. 

value2 This contains the value to be stored into OCxR Main 

Register. 


Hãy so sánh các mô-đun ở chế độ PWM. Else '-1' được trả lại 

Bình luận: Chức năng này đọc các chu kỳ nhiệm vụ từ đầu ra so sánh thứ 

Đăng ký (OCxRS) khi so sánh các mô-đun đầu ra ở chế độ PWM. 

Nếu không có trong chế độ PWM, chức năng trả về giá trị của '-1'. 

Source File: ReadDCOC1PWM.c 

ReadDCOC2PWM.c 







Mã số Ví dụ: int compare_reg; 

compare_reg = ReadDCOC1PWM (); 

dsPIC 

® 



ReadRegOC1 

ReadRegOC2 

ReadRegOC3 

ReadRegOC4 

ReadRegOC5 

ReadRegOC6 

ReadRegOC7 

ReadRegOC8 

Mô tả: Chức năng này đọc cycleregisters nhiệm vụ khi ra so sánh 

mô-đun không có trong chế độ PWM. 


Nguyên mẫu: int ReadRegOC1 (char reg); 

int ReadRegOC2 (char reg); 







Đối số: 

reg Điều này cho thấy nếu đọc nên xảy ra từ chính hoặc

dsPIC 

® 


DS51456B-page 134 


Remarks: This function configures the OutputCompare Module Control register 

(OCxCON)with the following parameters: 

Clock select, mode of operation, operation in Idle mode. 

It also configures the OCxRS and OCxR registers. 

Source File: OpenOC1.c 

OpenOC2.c 

OpenOC3.c 

OpenOC4.c 

OpenOC5.c 

OpenOC6.c 

OpenOC7.c 

OpenOC8.c 

Code Example: OpenOC1(OC_IDLE_CON & OC_TIMER2_SRC & 

OC_PWM_FAULT_PIN_ENABLE, 0x80, 0x60); 

OpenOC1 (Continued) 

OpenOC2 

OpenOC3 

OpenOC4 

OpenOC5 

OpenOC6 

OpenOC7 

OpenOC8 



ReadDCOC1PWM 

ReadDCOC2PWM 

ReadDCOC3PWM 

ReadDCOC4PWM 

ReadDCOC5PWM 

ReadDCOC6PWM 

ReadDCOC7PWM 

ReadDCOC8PWM 

Description: This function reads the duty cycle from the Output Compare 

Secondary 

register. 

ghi chu kỳ nhiệm vụ thứ hai của đầu ra so sánh các mô-đun. 

Nếu Regis "1", sau đó các nội dung của chính Chu kỳ đăng ký 

(OCxR) được đọc. 

Nếu Regis "0", sau đó các nội dung của Duty Cycle thứ cấp đăng ký 

(OCxRS) được đọc. 

Quay trở lại giá trị: Nếu Regis "1", sau đó các nội dung của chính Chu kỳ đăng 

ký (OCxR) là 

đọc. 

Nếu Regis "0", sau đó các nội dung của Duty Cycle thứ cấp đăng ký 

(OCxRS) được đọc. 

Nếu so sánh các mô-đun đầu ra ở chế độ PWM, '-1' được trả về. 

Chú ý: đọc của Chu kỳ chỉ registerhappens khi đầu ra so sánh 

mô-đun không có trong chế độ PWM. Khác, một giá trị của '-1' được trả về. 

Source File: ReadRegOC1.c 

ReadRegOC2.c 

ReadRegOC3.c 

ReadRegOC4.c 

ReadRegOC5.c 

ReadRegOC6.c 

ReadRegOC7.c 

ReadRegOC8.c 

Mã số Ví dụ: int dutycycle_reg; 

dutycycle_reg = ReadRegOC1 (1); 



SetDCOC1PWM 

SetDCOC2PWM 

SetDCOC3PWM 

SetDCOC4PWM 

SetDCOC5PWM 

SetDCOC6PWM 

SetDCOC7PWM 

SetDCOC8PWM 

Mô tả: Chức năng này cấu hình ra so sánh Chu kỳ thứ 

Đăng ký (OCxRS) khi module đang ở chế độ PWM. 


Prototype: void SetDCOC1PWM (int dutycycle); 

khoảng trống SetDCOC2PWM (int dutycycle); 


khoảng trống SetDCOC4PWM (int dutycycle);


Prototype: unsigned int ReadDCOC1PWM(void); 

unsigned int ReadDCOC2PWM(void); 








Return Value: This function returns the content of OCxRS register when Output 

Compare module is in PWM mode. Else ‘-1’ is returned 

Remarks: This function reads the duty cycle from the Output Compare 

Secondary 

register (OCxRS) when Output Compare module is in PWM mode. 

If not in PWM mode, the functions returns a value of ‘-1’. 

Source File: ReadDCOC1PWM.c 









Đối số: dutycycle Đây là giá trị chu kỳ nhiệm vụ được lưu trữ vào đầu ra 

So sánh thứ Chu kỳ đăng ký (OCxRS.) 


Chú ý: Đầu ra so sánh thứ DutyCycle đăng ký (OCxRS) sẽ 

cấu hình với giá trị mới nếu các mô-đun ở chế độ PWM. 

Source File: SetDCOC1PWM.c 

SetDCOC2PWM.c 

SetDCOC3PWM.c 

SetDCOC4PWM.c 

SetDCOC5PWM.c 

SetDCOC6PWM.c 

SetDCOC7PWM.c 

SetDCOC8PWM.c 

Mã số Ví dụ: SetDCOC1PWM (dutycycle); 

dsPIC 

® 





Code Example: unsigned int compare_reg; 

compare_reg = ReadDCOC1PWM(); 

dsPIC 

® 



SetPulseOC1 

SetPulseOC2 

SetPulseOC3 

SetPulseOC4 

SetPulseOC5 

SetPulseOC6 

SetPulseOC7 


DS51456B-page 136 

ReadRegOC1 

ReadRegOC2 

ReadRegOC3 

ReadRegOC4 

ReadRegOC5 

ReadRegOC6 

ReadRegOC7 

ReadRegOC8 


SetPulseOC8 

Mô tả: Chức năng này cấu hình ra so sánh chính và phụ 

đăng ký (OCxR và OCxRS) whenthe mô-đun không có trong chế độ PWM. 


Prototype: void SetPulseOC1 (int pulse_start, 

int pulse_stop); 

khoảng trống SetPulseOC2 (int pulse_start, 



Description: This function reads the duty cycleregisters when Output Compare 

u nsigned int pulse_stop);

module is not in PWM mode. 


Prototype: unsigned int ReadRegOC1(char reg); 

unsigned int ReadRegOC2(char reg); 







Arguments: 

reg This indicates if the read should happen from the main or 

secondary duty cycle registers of Output Compare module. 

If regis ‘1’, then the contents of Main Duty Cycle register 

(OCxR) is read. 

If regis ‘0’, then the contents of Secondary Duty Cycle register 

(OCxRS) is read. 

Return Value: If regis ‘1’, then the contents of Main Duty Cycle register 

(OCxR) is 

read. 

If regis ‘0’, then the contents of Secondary Duty Cycle register 

(OCxRS) is read. 

If Output Compare module is in PWM mode, ‘-1’ is returned. 

Remarks: The read of Duty Cycle registerhappens only when Output Compare 

module is not in PWM mode. Else, a value of ‘-1’ is returned. 

Source File: ReadRegOC1.c 

ReadRegOC2.c 

ReadRegOC3.c 

ReadRegOC4.c 

ReadRegOC5.c 

ReadRegOC6.c 

ReadRegOC7.c 

ReadRegOC8.c 

Code Example: unsigned int dutycycle_reg; 

dutycycle_reg = ReadRegOC1(1); 



SetDCOC1PWM 

SetDCOC2PWM 











Đối số: pulse_start này là giá trị được lưu trữ vào đầu ra so sánh 

Đăng ký chính (OCxR). 

pulse_stop Đây là giá trị được lưu trữ vào đầu ra so sánh 

Đăng ký thứ cấp (OCxRS). 


Chú ý: Đầu ra so sánh đăng ký nhiệm vụ chu kỳ (OCxR và OCxRS) sẽ 

cấu hình với giá trị mới mô-đun chỉ ifthe không ở chế độ PWM. 

Source File: SetPulseOC1.c 

SetPulseOC2.c 

SetPulseOC3.c 

SetPulseOC4.c 

SetPulseOC5.c 

SetPulseOC6.c 

SetPulseOC7.c 

SetPulseOC8.c 

Mã số Ví dụ: pulse_start = 0x40; 

pulse_stop = 0x60; 

SetPulseOC1 (pulse_start, pulse_stop); 




EnableIntOC1 

EnableIntOC2 

EnableIntOC3 

EnableIntOC4 

EnableIntOC5 

EnableIntOC6 

EnableIntOC7 

EnableIntOC8

SetDCOC3PWM 

SetDCOC4PWM 

SetDCOC5PWM 

SetDCOC6PWM 

SetDCOC7PWM 

SetDCOC8PWM 

Description: This function configures the Output Compare Secondary Duty 

Cycle 

register (OCxRS )when the module is in PWM mode. 


Prototype: void SetDCOC1PWM(unsigned int dutycycle); 

void SetDCOC2PWM(unsigned int dutycycle); 







Arguments: dutycycle This is the duty cycle value to be stored into Output 

Compare Secondary Duty Cycle register (OCxRS.) 


Remarks: The Output Compare Secondary DutyCycle register (OCxRS) will be 

configured with new value only if the module is in PWM mode. 

Source File: SetDCOC1PWM.c 

SetDCOC2PWM.c 

SetDCOC3PWM.c 

SetDCOC4PWM.c 

SetDCOC5PWM.c 

SetDCOC6PWM.c 

SetDCOC7PWM.c 

SetDCOC8PWM.c 

Code Example: SetDCOC1PWM(dutycycle); 

dsPIC 

® 


Mô tả: vĩ mô này cho phép ngắt trên đầu ra so sánh trận đấu. 



Bình luận: Đây bộ vĩ mô ra so sánh (OC) Interrupt Enable bit Interrupt 

Cho phép đăng ký kiểm soát. 

Mã số Ví dụ: EnableIntOC8; 

DisableIntOC1 

DisableIntOC2 

DisableIntOC3 

DisableIntOC4 

DisableIntOC5 

DisableIntOC6 

DisableIntOC7 

DisableIntOC8 

Mô tả: vĩ mô này vô hiệu hóa ngắt vào trận đấu so sánh. 



Bình luận: vĩ mô này sẽ xóa OC Interrupt Enable bit Interrupt Enable kiểm soát 

đăng ký. 

Mã số Ví dụ: DisableIntOC7; 









Mô tả: Điều này đặt ra ưu tiên vĩ mô cho đầu ra so sánh gián đoạn. 



Bình luận: Đây bộ vĩ mô OC ngắt bit ưu tiên của ngắt ưu tiên kiểm soát 

đăng ký. 

Mã số Ví dụ: SetPriorityIntOC4 (0); 

dsPIC 

DS51456B-page 138 

SetPulseOC1 


® 


SetPulseOC2 

SetPulseOC3 




SetPulseOC4 

SetPulseOC5 

SetPulseOC6 

SetPulseOC7 

SetPulseOC8 

Description: This function configures the Output Compare main and secondary 

registers (OCxR and OCxRS ) whenthe module is not in PWM mode. 


Prototype: void SetPulseOC1(unsigned int pulse_start, 

unsigned int pulse_stop); 

void SetPulseOC2(unsigned int pulse_start, 



u nsigned int pulse_stop); 











Arguments: pulse_start This is the value to be stored into Output Compare 

Main register (OCxR). 

pulse_stop This is the value to be stored into Output Compare 

Secondary register (OCxRS). 


Remarks: The Output Compare duty cycle registers (OCxR and OCxRS) will be 

configured with new values only ifthe module is not in PWM mode. 

Source File: SetPulseOC1.c 

SetPulseOC2.c 

SetPulseOC3.c 

SetPulseOC4.c 

SetPulseOC5.c 

SetPulseOC6.c 

SetPulseOC7.c 

SetPulseOC8.c 


# include 

# include 

/ * Đây là ISR tương ứng với OC1 ngắt * / 

khoảng trống __attribute __ ((__ interrupt__)) _OC1Interrupt (void) 

{ 

IFS0bits.OC1IF = 0; 

} 


{ 

/ * Giữ giá trị mà tại đó OCX Pin được điều khiển * cao / 

int pulse_start; 

/ * Giữ giá trị mà tại đó OCX Pin được điều khiển * thấp / 

int pulse_stop; 

/ * Tắt OC1 mô-đun * / 

CloseOC1 (); 

/ * Cấu hình đầu ra compare1 ngắt * / 

ConfigIntOC1 (OC_INT_OFF & OC_INT_PRIOR_5); 

/ * Cấu hình OC1 mô-đun cho yêu cầu độ rộng xung * / 

pulse_start = 0x40; 


PR3 = 0x80; 

PR1 = 0xffff; 

TMR1 = 0x0000; 

T3CON = 0x8000; 

T1CON = 0x8000; 

/ * Cấu hình đầu ra so sánh các mô-đun để 'khởi OCX pin 

thấp và tạo ra liên tục pulse'mode * / 

OpenOC1 (OC_IDLE_CON & OC_TIMER3_SRC & 

OC_CONTINUE_PULSE, 

pulse_stop, pulse_start); 

/ * Tạo xung liên tục cho đến khi đạt TMR1 0xff00 * / 

trong khi (TMR1

Code Example: pulse_start = 0x40 ; 

pulse_stop = 0x60 ; 

SetPulseOC1(pulse_start, pulse_stop); 




EnableIntOC1 

EnableIntOC2 

EnableIntOC3 

EnableIntOC4 

EnableIntOC5 

EnableIntOC6 

EnableIntOC7 

EnableIntOC8 

Description: This macro enables the interrupt on output compare match. 



Remarks: This macro sets Output Compare (OC) Interrupt Enable bit of 

Interrupt 

Enable Control register. 

Code Example: EnableIntOC8; 

DisableIntOC1 

DisableIntOC2 

DisableIntOC3 

DisableIntOC4 

DisableIntOC5 

DisableIntOC6 

DisableIntOC7 

DisableIntOC8 

Description: This macro disables the interrupt on compare match. 



Remarks: This macro clears OC Interrupt Enable bit of Interrupt Enable Control 

register. 

Code Example: DisableIntOC7; 





3.12 chức năng UART 

Phần này bao gồm một danh sách các chức năng riêng cho module UART và 




BusyUART1 

BusyUART2 

Mô tả: Chức năng này trả về tình trạng truyền UART. 

Bao gồm: uart.h 

Prototype: char BusyUART1 (void); 

char BusyUART2 (void); 


Quay trở lại giá trị: Nếu "1" được trả lại, nó chỉ ra rằng UART là bận rộn trong 

truyền tải và 

UxSTA bit "0". 

Nếu "0" được trả lại, nó chỉ ra rằng UART là không bận rộn và UxSTA 

bit '1'. 

Bình luận: Chức năng này trả về tình trạng của UART. Điều này cho thấy nếu 

UART 

là bận rộn trong truyền như được chỉ ra bởi các UxSTA bit. 

Source File: BusyUART1.c 

BusyUART2.c 

Mã số Ví dụ: trong khi (BusyUART1 ()); 

CloseUART1 

CloseUART2 

Mô tả: Chức năng này sẽ tắt các mô-đun UART 


Prototype: void CloseUART1 (void); 

làm mất hiệu lực CloseUART2 (void); 



Bình luận: Chức năng này đầu tiên sẽ tắt các module UART và sau đó vô hiệu 

hóa 

UART truyền và nhận interrupts.The Cờ ngắt bit cũng có 

xóa. 

Source File: CloseUART1.c 

CloseUART2.c 

Mã số Ví dụ: CloseUART1 (); 

dsPIC 

® 






Description: This macro sets priority for output compare interrupt. 



Remarks: This macro sets OC Interrupt Priority bits of Interrupt Priority Control 

register. 

Code Example: SetPriorityIntOC4(0); 

dsPIC 

® 





#include 

#include 

/* This is ISR corresponding to OC1 interrupt */ 

void __attribute__((__interrupt__)) _OC1Interrupt(void) 

{ 

IFS0bits.OC1IF = 0; 

} 


{ 

/* Holds the value at which OCx Pin to be driven high */ 

unsigned int pulse_start ; 

/* Holds the value at which OCx Pin to be driven low */ 

unsigned int pulse_stop; 

/* Turn off OC1 module */ 

CloseOC1(); 

/* Configure output compare1 interrupt */ 

ConfigIntOC1(OC_INT_OFF & OC_INT_PRIOR_5); 

/* Configure OC1 module for required pulse width */ 

pulse_start = 0x40; 


PR3 = 0x80 ; 

PR1 = 0xffff; 

TMR1 = 0x0000; 


ConfigIntUART1 



Mô tả: Chức năng này cấu hình UART ngắt. 


Prototype: void ConfigIntUART1 (int config); 

làm mất hiệu lực ConfigIntUART2 (int config); 

Lập luận: config cá nhân gián đoạn bật / tắt thông tin theo quy định 


Nhận ngắt cho phép 

UART_RX_INT_EN 

UART_RX_INT_DIS 

Nhận ưu tiên ngắt 

UART_RX_INT_PR0 








Truyền gián đoạn cho phép 

UART_TX_INT_EN 

UART_TX_INT_DIS 

Truyền ưu tiên ngắt 

UART_TX_INT_PR0 









Ghi chú: Chức năng này cho phép / vô hiệu hóa các UART truyền và nhận 

ngắt và thiết lập các ưu tiên ngắt. 

Source File: ConfigIntUART1.c 

ConfigIntUART2.c 

Mã số Ví dụ: ConfigIntUART1 (UART_RX_INT_EN & UART_RX_INT_PR5 

&

T3CON = 0x8000; 

T1CON = 0X8000; 

/* Configure Output Compare module to 'initialise OCx pin 

low and generate continuous pulse'mode */ 

OpenOC1(OC_IDLE_CON & OC_TIMER3_SRC & 

OC_CONTINUE_PULSE, 

pulse_stop, pulse_start); 

/* Generate continuous pulse till TMR1 reaches 0xff00 */ 

while(TMR1

Description: This function turns off the UART module 

Include: uart.h 

Prototype: void CloseUART1(void); 

void CloseUART2(void); 



Remarks: This function first turns off the UART module and then disables the 

UART transmit and receive interrupts.The Interrupt Flag bits are also 

cleared. 

Source File: CloseUART1.c 

CloseUART2.c 

Code Example: CloseUART1(); 

dsPIC 

® 





Description: This function configures the UART Interrupts. 


Prototype: void ConfigIntUART1(unsigned int config); 

void ConfigIntUART2(unsigned int config); 

Arguments: config Individual interrupt enable/disable information as defined 

below: 

Receive Interrupt enable 

UART_RX_INT_EN 

UART_RX_INT_DIS 

Receive Interrupt Priority 









Transmit Interrupt enable 

UART_TX_INT_EN 

UART_TX_INT_DIS 

Giao tiếp UART với chân ALT chỉ có sẵn cho 

thiết bị nhất định và các bảng dữ liệu phù hợp nên 

gọi. 

UART Dịch vụ báo thức vào Start 

UART_EN_WAKE 

UART_DIS_WAKE 

Chế độ UART lặp bật / tắt 

UART_EN_LOOPBACK 

UART_DIS_LOOPBACK 

Đầu vào để Capture mô-đun 

UART_EN_ABAUD 

UART_DIS_ABAUD 

dsPIC 

® 



Chẵn lẻ và bit dữ liệu chọn 

UART_NO_PAR_9BIT 

UART_ODD_PAR_8BIT 

UART_EVEN_PAR_8BIT 


Số Dừng bit 

UART_2STOPBITS 

UART_1STOPBIT 


UxSTA đăng ký theo quy định dưới đây: 

Chế độ UART truyền gián đoạn chọn 

UART_INT_TX_BUF_EMPTY 

UART_INT_TX 

UART Transmit lao bit 

UART_TX_PIN_NORMAL 

UART_TX_PIN_LOW 

UART truyền cho phép / vô hiệu hóa 

UART_TX_ENABLE 

UART_TX_DISABLE 

UART nhận chế độ ngắt chọn 

UART_INT_RX_BUF_FUL 

UART_INT_RX_3_4_FUL 

UART_INT_RX_CHAR

Transmit Interrupt Priority 










Remarks: This function enables/disables the UART transmit and receive 

interrupts and sets the interrupt priorities. 

Source File: ConfigIntUART1.c 

ConfigIntUART2.c 

Code Example: ConfigIntUART1(UART_RX_INT_EN & 

UART_RX_INT_PR5 & 

UART_TX_INT_EN & UART_TX_INT_PR3); 



DataRdyUART1 

DataRdyUART2 

Description: This function returns the UART receive buffer status. 


Prototype: char DataRdyUART1(void); 

char DataRdyUART2(void); 


Return Value: If ‘1’ is returned, it indicates that the receive buffer has a data to 

be 

read. 

If ‘0’ is returned, it indicates that receive buffer does not have any new 

data to be read. 

Remarks: This function returns the status of the UART receive buffer. 

This indicates if the UART receive buffer contains any new data that is 

yet to be read as indicated by the UxSTA bit. 

Source File: DataRdyUART1.c 

DataRdyUART2.c 

Code Example: while(DataRdyUART1()); 

OpenUART1 

OpenUART2 

Description: This function configures the UART module 

Địa chỉ UART phát hiện cho phép / vô hiệu hóa 

UART_ADR_DETECT_EN 

UART_ADR_DETECT_DIS 

UART tràn ngập bit rõ ràng 

UART_RX_OVERRUN_CLEAR 

ubrg Đây là giá trị được ghi vào UxBRG đăng ký để thiết lập 

tốc độ truyền. 


Bình luận: chức năng này cấu hình UART truyền và nhận phần và 

thiết lập tốc độ truyền thông tin liên lạc. 

Source File: OpenUART1.c 

OpenUART2.c 

Mã số Ví dụ: baud = 5; 

UMODEvalue = UART_EN & UART_IDLE_CON & 

UART_DIS_WAKE & UART_EN_LOOPBACK & 

UART_EN_ABAUD & UART_NO_PAR_8BIT & 

UART_1STOPBIT; 

U1STAvalue = UART_INT_TX_BUF_EMPTY & 

UART_TX_PIN_NORMAL & 

UART_TX_ENABLE & 

UART_INT_RX_3_4_FUL & 

UART_ADR_DETECT_DIS & 

UART_RX_OVERRUN_CLEAR; 

OpenUART1 (U1MODEvalue, U1STAvalue, độ truyền); 

OpenUART1 (Tiếp theo) 

OpenUART2 



ReadUART1 

ReadUART2 

Mô tả: Chức năng này trả về nội dung của UART nhận được bộ đệm 

(UxRXREG) 

đăng ký. 


Nguyên mẫu: int ReadUART1 (void); 

int ReadUART2 (void); 


Quay trở lại giá trị: Chức năng này trả về nội dung của Bộ đệm nhận 

(UxRXREG) 

đăng ký.


Prototype: void OpenUART1(unsigned int config1, 

unsigned int config2, unsigned int ubrg); 

void OpenUART2(unsigned int config1, 

unsigned int config2, unsigned int ubrg); 


UxMODE register as defined below: 

UART enable/disable 

UART_EN 

UART_DIS 

UART Idle mode operation 

UART_IDLE_CON 

UART_IDLE_STOP 

UART communication with ALT pins 

UART_ALTRX_ALTTX 

UART_RX_TX 

UART communication with ALT pins is available only for 

certain devices and the suitable data sheet should be 

referred to. 

UART Wake-up on Start 

UART_EN_WAKE 

UART_DIS_WAKE 

UART Loopback mode enable/disable 

UART_EN_LOOPBACK 

UART_DIS_LOOPBACK 

Input to Capture module 

UART_EN_ABAUD 

UART_DIS_ABAUD 

dsPIC 

® 



Parity and data bits select 


UART_ODD_PAR_8BIT 

UART_EVEN_PAR_8BIT 


Number of Stop bits 

UART_2STOPBITS 

Bình luận: Chức năng này trả về các nội dung của bộ đệm nhận đăng ký. 

Nếu bit tiếp nhận 9 được kích hoạt, toàn bộ nội dung đăng ký được trả về. 

Nếu bit tiếp nhận 8 được kích hoạt, sau đó register được đọc và bit 9 là 

đeo mặt nạ. 

Source File: ReadUART1.c 

ReadUART2.c 

Mã số Ví dụ: int rx_data; 

Rx_data = ReadUART1 (); 

WriteUART1 

WriteUART2 

Mô tả: Chức năng này ghi dữ liệu được truyền vào bộ đệm truyền 

(UxTXREG) đăng ký. 


Prototype: void WriteUART1 (dữ liệu int unsigned); 

làm mất hiệu lực WriteUART2 (dữ liệu int unsigned); 

Đối số: dữ liệu này là các dữ liệu được truyền đi. 


Bình luận: Chức năng này ghi các dữ liệu được truyền vào bộ đệm truyền. 

Nếu truyền 9-bit được kích hoạt, giá trị 9-bit được viết vào 

truyền đệm. 

Nếu truyền 8-bit được kích hoạt, sau đó byte trên được đeo mặt nạ và sau đó 

ghi vào bộ đệm truyền. 

Source File: WriteUART1.c 

WriteUART2.c 

Mã số Ví dụ: WriteUART1 (0xFF); 

dsPIC 

® 



getsUART1 

getsUART2 


Mô tả: Chức năng này lần đọc một chuỗi các dữ liệu chiều dài quy định và lưu 

trữ nó vào 

vị trí đệm quy định. 


Nguyên mẫu: int getsUART1 (unsigned int dài, 

int * buffer, int 

uart_data_wait); 

int getsUART2 (chiều dài int unsigned, 

int * buffer, int

UART_1STOPBIT 


UxSTA register as defined below: 

UART Transmission mode interrupt select 

UART_INT_TX_BUF_EMPTY 

UART_INT_TX 

UART Transmit Break bit 

UART_TX_PIN_NORMAL 

UART_TX_PIN_LOW 

UART transmit enable/disable 

UART_TX_ENABLE 

UART_TX_DISABLE 

UART Receive Interrupt mode select 

UART_INT_RX_BUF_FUL 

UART_INT_RX_3_4_FUL 

UART_INT_RX_CHAR 

UART address detect enable/disable 

UART_ADR_DETECT_EN 

UART_ADR_DETECT_DIS 

UART OVERRUN bit clear 

UART_RX_OVERRUN_CLEAR 

ubrg This is the value to be written into UxBRG register to set the 

baud rate. 


Remarks: This functions configures the UART transmit and receive sections 

and 

sets the communication baud rate. 

Source File: OpenUART1.c 

OpenUART2.c 

Code Example: baud = 5; 

UMODEvalue = UART_EN& UART_IDLE_CON & 






UART_TX_ENABLE & 

UART_INT_RX_3_4_FUL & 



Đối số: chiều dài Đây là chiều dài của chuỗi được nhận. 

đệm Đây là con trỏ đến vị trí mà các dữ liệu nhận được 

phải được lưu trữ. 

uart_data_wait Đây là số thời gian chờ cho các mô-đun 

đã phải chờ đợi trước khi trở về. 

Nếu tính thời gian chờ là 'N', thời gian chờ thực tế 

sẽ vào khoảng (19 * N - 1) chu kỳ hướng dẫn. 

Trở lại giá trị: Chức năng này trả về số byte chưa được nhận. 

Nếu giá trị trả về là "0", nó chỉ ra rằng chuỗi hoàn chỉnh đã được 

nhận được. 

Nếu giá trị trả về là khác không, nó chỉ ra rằng chuỗi hoàn chỉnh có 

không được nhận. 


Source File: getsUART1.c 

getsUART2.c 

Mã số Ví dụ: Datarem = getsUART1 (6, Rxdata_loc, 40); 

putsUART1 

putsUART2 

Mô tả: Chức năng này ghi một chuỗi các dữ liệu được truyền vào UART 



Prototype: void putsUART1 (int * đệm); 

làm mất hiệu lực putsUART2 (int * đệm); 

Đối số: đệm Đây là con trỏ đến chuỗi dữ liệu được truyền đi. 


Bình luận: Chức năng này ghi các dữ liệu được truyền vào bộ đệm truyền 

cho đến khi nhân vật NULL là gặp phải. 

Một khi bộ đệm truyền là đầy đủ, itwaits đến dữ liệu được truyền và 

sau đó ghi dữ liệu tiếp theo vào sổ đăng ký Transmit. 

Source File: putsUART1.c 

putsUART2.c 

Mã số Ví dụ: putsUART1 (Txdata_loc); 




getcUART1 

getcUART2 

Mô tả: Chức năng này giống hệt nhau toReadUART1 và ReadUART2.

UART_RX_OVERRUN_CLEAR ; 

OpenUART1(U1MODEvalue, U1STAvalue, baud); 

OpenUART1 (Continued) 

OpenUART2 



ReadUART1 

ReadUART2 

Description: This function returns the content of UART receive buffer 

(UxRXREG) 

register. 


Prototype: unsigned int ReadUART1(void); 

unsigned int ReadUART2(void); 


Return Value: This function returns the contents of Receive buffer (UxRXREG) 

register. 

Remarks: This function returns the contents of the Receive Buffer register. 

If 9 bit reception is enabled, the entire register content is returned. 

If 8 bit reception is enabled, then register is read and the 9th bit is 

masked. 

Source File: ReadUART1.c 

ReadUART2.c 

Code Example: unsigned int RX_data; 

RX_data = ReadUART1(); 

WriteUART1 

WriteUART2 

Description: This function writes data to be transmitted into the transmit buffer 

(UxTXREG) register. 


Prototype: void WriteUART1(unsigned int data); 

void WriteUART2(unsigned int data); 

Source File: # define để ReadUART1 và ReadUART2 trong uart.h 

putcUART1 

putcUART2 

Mô tả: Chức năng này giống hệt với WriteUART1 và WriteUART2. 

Source File: # define để WriteUART1 và WriteUART2 trong uart.h 

EnableIntU1RX 

EnableIntU2RX 

Mô tả: vĩ mô Điều này cho phép các UART nhận được gián đoạn. 



Bình luận: vĩ mô bộ UART này Nhận Interrupt Enable bit Interrupt Enable 


Mã số Ví dụ: EnableIntU2RX; 

EnableIntU1TX 

EnableIntU2TX 

Mô tả: vĩ mô Điều này cho phép các UART truyền gián đoạn. 



Bình luận: vĩ mô này đặt UART Transmit Interrupt Enable bit Interrupt Enable 


Mã số Ví dụ: EnableIntU2TX; 

DisableIntU1RX 


Mô tả: vĩ mô này vô hiệu hóa các UART nhận được gián đoạn. 



Bình luận: vĩ mô này xóa UART Nhận Interrupt Enable bit Interrupt 


Mã số Ví dụ: DisableIntU1RX; 

dsPIC 

® 


Arguments: data This is the data to be transmitted. 


Remarks: This function writes the data to be transmitted into the transmit buffer. 


DisableIntU1TX 



If 9-bit transmission is enabled, the 9-bit value is written into the 

transmit buffer. 

If 8-bit transmission is enabled, then upper byte is masked and then 

written into the transmit buffer. 

Mô tả: vĩ mô này vô hiệu hóa các UART truyền gián đoạn. 



Bình luận: vĩ mô này xóa UART Transmit Interrupt Enable bit Interrupt

Source File: WriteUART1.c 

WriteUART2.c 

Code Example: WriteUART1(0xFF); 

dsPIC 

® 


DS51456B-page 146 

getsUART1 

getsUART2 


Description: This function reads a string of data of specified length and stores it 

into 

the buffer location specified. 


Prototype: unsigned int getsUART1(unsigned int length, 

unsigned int *buffer, unsigned int 


unsigned int getsUART2(unsigned int length, 

unsigned int *buffer, unsigned int 


Arguments: length This is the length of the string to be received. 

buffer This is the pointer to the location where the data received 

have to be stored. 

uart_data_wait This is the timeout count for which the module 

has to wait before return. 

If the timeout count is ‘N’, the actual timeout 

would be about (19*N - 1) instruction cycles. 

Return Value: This function returns the number of bytes yet to be received. 

If the return value is ‘0’, it indicates that the complete string has been 

received. 

If the return value is nonzero, it indicates that the complete string has 

not been received. 

Remarks: None 

Source File: getsUART1.c 

getsUART2.c 

Code Example: Datarem = getsUART1(6, Rxdata_loc, 40); 

putsUART1 

putsUART2 

Description: This function writes a string of data to be transmitted into the 

UART 



Mã số Ví dụ: DisableIntU1TX; 

SetPriorityIntU1RX 


Mô tả: Điều này đặt ra ưu tiên vĩ mô cho UART nhận được gián đoạn. 



Bình luận: Đây bộ vĩ mô UART Nhận ngắt bit ưu tiên của ưu tiên ngắt 


Mã số Ví dụ: SetPriorityIntU1RX (6); 

SetPriorityIntU1TX 


Mô tả: Điều này đặt ra ưu tiên vĩ mô cho UART truyền gián đoạn. 



Bình luận: Đây bộ vĩ mô UART Transmit Interrupt bit ưu tiên của ngắt 

Kiểm soát ưu tiên đăng ký. 

Mã số Ví dụ: SetPriorityIntU1TX (5); 





# include 

# include 

/ * Dữ liệu nhận được lưu trữ trong mảng Buf * / 

Buf char [80]; 

char * Receivedddata = Buf; 

/ * Đây là UART1 truyền ISR * / 

khoảng trống __attribute __ ((__ interrupt__)) _U1TXInterrupt (void) 

{ 

IFS0bits.U1TXIF = 0; 

} 

/ * Đây là UART1 nhận ISR * / 

khoảng trống __attribute __ ((__ interrupt__)) _U1RXInterrupt (void) 

{ 

IFS0bits.U1RXIF = 0; 

/ * Đọc bộ đệm nhận cho đến ít nhất một hoặc nhiều nhân vật có thể 

đọc * / 

trong khi (DataRdyUART1 ())


Prototype: void putsUART1(unsigned int *buffer); 

void putsUART2(unsigned int *buffer); 

Arguments: buffer This is the pointer to the string of data to be transmitted. 


Remarks: This function writes the data to be transmitted into the transmit buffer 

until NULL character is encountered. 

Once the transmit buffer is full, itwaits till data gets transmitted and 

then writes the next data into the Transmit register. 

Source File: putsUART1.c 

putsUART2.c 

Code Example: putsUART1(Txdata_loc); 




getcUART1 

getcUART2 

Description: This function is identical toReadUART1 and ReadUART2. 

Source File: #define to ReadUART1 and ReadUART2 in uart.h 

putcUART1 

putcUART2 

Description: This function is identical to WriteUART1 and WriteUART2. 

Source File: #define to WriteUART1 and WriteUART2 in uart.h 

EnableIntU1RX 

EnableIntU2RX 

Description: This macro enables the UART receive interrupt. 



Remarks: This macro sets UART Receive Interrupt Enable bit of Interrupt 

Enable 


Code Example: EnableIntU2RX; 

EnableIntU1TX 

EnableIntU2TX 

Description: This macro enables the UART transmit interrupt. 



Remarks: This macro sets UART Transmit Interrupt Enable bit of Interrupt 

Enable 


{ 

(* (Receiveddata) ++) = ReadUART1 (); 

} 

} 


{ 

/ * Dữ liệu được truyền đi bằng cách sử dụng mô-đun giao tiếp UART * / 

Txdata char [] = {'M', 'i', 'c', 'r', 'o', 'c', 'h', 'i', 'p', ' 

',' Tôi ',' C ',' D ',' 2 ',' \ 0 '}; 

/ * Giữ giá trị đăng ký độ truyền * / 

int baudvalue; 

/ * Giữ giá trị của UART cấu hình reg * / 

int U1MODEvalue; 

/ * Giữ các thông tin liên quan đến UART 

TX & RX ngắt chế độ * / 

int U1STAvalue; 

/ * Tắt UART1module * / 

CloseUART1 (); 

/ * Cấu hình uart1 nhận và truyền gián đoạn * / 

ConfigIntUART1 (UART_RX_INT_EN & UART_RX_INT_PR6 & 

UART_TX_INT_DIS & UART_TX_INT_PR2); 

/ * Cấu hình UART1 mô-đun để truyền 8 bit dữ liệu với một stopbit. 

Ngoài ra Kích hoạt chế độ loopback * / 

baudvalue = 5; 

U1MODEvalue = UART_EN & UART_IDLE_CON & 






UART_TX_ENABLE & UART_INT_RX_3_4_FUL & 



OpenUART1 (U1MODEvalue, U1STAvalue, baudvalue); 

dsPIC 

® 



/ * Load truyền đệm và truyền đến vô cùng nhân vật là

Code Example: EnableIntU2TX; 



Description: This macro disables the UART receive interrupt. 



Remarks: This macro clears UART Receive Interrupt Enable bit of Interrupt 


Code Example: DisableIntU1RX; 

dsPIC 

® 


DS51456B-page 148 




Description: This macro disables the UART transmit interrupt. 



Remarks: This macro clears UART Transmit Interrupt Enable bit of Interrupt 


Code Example: DisableIntU1TX; 



Description: This macro sets priority for uart receive interrupt. 



Remarks: This macro sets UART Receive Interrupt Priority bits of Interrupt 

Priority 


Code Example: SetPriorityIntU1RX(6); 



Description: This macro sets priority for uart transmit interrupt. 



Remarks: This macro sets UART Transmit Interrupt Priority bits of Interrupt 

Priority Control register. 

Code Example: SetPriorityIntU1TX(5); 


gặp phải * / 

putsUART1 ((int *) Txdata); 

/ * Chờ cho truyền dẫn để hoàn thành * / 

trong khi (BusyUART1 ()); 

/ * Đọc tất cả các dữ liệu còn lại trong bộ đệm nhận là chưa đọc * / 

trong khi (DataRdyUART1 ()) 

{ 

(* (Receiveddata) ++) = ReadUART1 (); 

} 

/ * Tắt UART1 mô-đun * / 

CloseUART1 (); 

trở về 0; 

} 

3.13 DCI chức năng 

Phần này bao gồm một danh sách các individualfunctions cho DCI mô-đun và 




CloseDCI 

Mô tả: Chức năng này sẽ tắt các mô-đun DCI 

Bao gồm: dci.h 

Prototype: void CloseDCI (void); 



Bình luận: Chức năng này đầu tiên sẽ tắt DCImodule và sau đó vô hiệu hóa các 

DCI 

interrupt.The Cờ ngắt bit cũng sẽ bị xóa. 

Source File: CloseDCI.c 

Mã số Ví dụ: CloseDCI (); 

BufferEmptyDCI 

Mô tả: Chức năng này trả về tình trạng DCI Transmit Buffer Full. 


Prototype: char BufferEmptyDCI (void); 


Quay trở lại giá trị: Nếu giá trị của TMPTY là "1", sau đó "1" được trả lại, chỉ 

ra rằng 

truyền đệm trống. 

Nếu giá trị của TMPTY là "0", sau đó "0" được trả lại, chỉ ra rằng 

truyền đệm là không có sản phẩm nào. 

Bình luận: Chức năng này trả về tình trạng của DCISTATbit. Bit này 

chỉ ra cho dù bộ đệm truyền rỗng.




#include 

#include 

/* Received data is stored in array Buf */ 

char Buf[80]; 

char * Receivedddata = Buf; 

/* This is UART1 transmit ISR */ 

void __attribute__((__interrupt__)) _U1TXInterrupt(void) 

{ 

IFS0bits.U1TXIF = 0; 

} 

/* This is UART1 receive ISR */ 

void __attribute__((__interrupt__)) _U1RXInterrupt(void) 

{ 

IFS0bits.U1RXIF = 0; 

/* Read the receive buffer till atleast one or more character can be 

read */ 

while( DataRdyUART1()) 

{ 

( *( Receiveddata)++) = ReadUART1(); 

} 

} 


{ 

/* Data to be transmitted using UART communication module */ 

char Txdata[] = {'M','i','c','r','o','c','h','i','p',' 

','I','C','D','2','\0'}; 

/* Holds the value of baud register */ 

unsigned int baudvalue; 

/* Holds the value of uart config reg */ 

unsigned int U1MODEvalue; 

/* Holds the information regarding uart 

TX & RX interrupt modes */ 

unsigned int U1STAvalue; 

/* Turn off UART1module */ 

CloseUART1(); 

/* Configure uart1 receive and transmit interrupt */ 

Source File: BufferEmptyDCI.c 

Mã số Ví dụ: trong khi (BufferEmptyDCI ()); 



ConfigIntDCI 

Mô tả: Chức năng này cấu hình ngắt DCI. 


Prototype: void ConfigIntDCI (int config); 

Lập luận: config DCI gián đoạn ưu tiên và bật / tắt thông tin 


DCI ngắt bật / tắt 

DCI_INT_ON 

DCI_INT_OFF 

Ưu tiên DCI ngắt 

DCI_INT_PRI_0 

DCI_INT_PRI_1 

DCI_INT_PRI_2 

DCI_INT_PRI_3 

DCI_INT_PRI_4 

DCI_INT_PRI_5 

DCI_INT_PRI_6 

DCI_INT_PRI_7 


Bình luận: Chức năng này sẽ xóa sạch các (DCIIF) bit Cờ ngắt và sau đó đặt 


Source File: ConfigIntDCI.c 

Mã số Ví dụ: ConfigIntDCI (DCI_INT_PRI_6 & DCI_INT_ENABLE); 

DataRdyDCI 

Mô tả: Chức năng này trả về tình trạng của DCI nhận được bộ đệm. 


Prototype: char DataRdyDCI (void); 


Quay trở lại giá trị: Nếu giá trị của RFUL là "1", sau đó "1" được trả lại, chỉ ra 

rằng dữ liệu 

sẵn sàng để được đọc từ bộ đệm nhận. 

Nếu giá trị của RFUL là "0", sau đó "0" được trả lại, chỉ ra rằng 

nhận được bộ đệm là trống rỗng. 

Bình luận: Chức năng này trả về tình trạng của DCISTATbit. Bit này 

chỉ ra cho dù các dữ liệu có sẵn trong bộ đệm nhận. 

Source File: DataRdyDCI.c

ConfigIntUART1(UART_RX_INT_EN & UART_RX_INT_PR6 & 

UART_TX_INT_DIS & UART_TX_INT_PR2); 

/* Configure UART1 module to transmit 8 bit data with one stopbit. 

Also Enable loopback mode */ 

baudvalue = 5; 

U1MODEvalue = UART_EN & UART_IDLE_CON & 






UART_TX_ENABLE & UART_INT_RX_3_4_FUL & 



OpenUART1(U1MODEvalue, U1STAvalue, baudvalue); 

dsPIC 

® 


DS51456B-page 150 


/* Load transmit buffer and transmit the same till null character is 

encountered */ 

putsUART1 ((unsigned int *)Txdata); 

/* Wait for transmission to complete */ 

while(BusyUART1()); 

/* Read all the data remaining in receive buffer which are unread */ 

while(DataRdyUART1()) 

{ 

(*( Receiveddata)++) = ReadUART1() ; 

} 

/* Turn off UART1 module */ 

CloseUART1(); 

return 0; 

} 

3.13 DCI FUNCTIONS 

This section contains a list of individualfunctions for DCI module and an 

example of 



CloseDCI 

Mã số Ví dụ: trong khi (DataRdyDCI ()); 

OpenDCI 

Mô tả: Chức năng này cấu hình DCI. 


Prototype: void OpenDCI (int config1, 

int config2, 

int config3, 

int trans_mask, 

recv_mask unsigned int) 

Đối số: config1 này chứa các thông số được cấu hình trong 

các DCION1 đăng ký theo quy định dưới đây: 

dsPIC 

® 



Mô-đun On / Off 

DCI_EN 

DCI_DIS 


DCI_IDLE_CON 

DCI_IDLE_STOP 

Chế độ DCI lặp phép 

DCI_DIGI_LPBACK_EN 

DCI_DIGI_LPBACK_DIS 

CSCK pin hướng chọn 

DCI_SCKD_INP 

DCI_SCKD_OUP 

Lựa chọn cạnh lấy mẫu DCI 

DCI_SAMP_CLK_RIS 

DCI_SAMP_CLK_FAL 

FS pin hướng chọn 

DCI_FSD_INP 

DCI_FSD_OUP 

dữ liệu được truyền trong Van cân bằng 

DCI_TX_LASTVAL_UNF 

DCI_TX_ZERO_UNF 

SDO tình trạng pin trong quá trình phát vô hiệu hóa 

DCI_SDO_TRISTAT 

DCI_SDO_ZERO

Description: This function turns off the DCI module 

Include: dci.h 

Prototype: void CloseDCI(void); 



Remarks: This function first turns off the DCImodule and then disables the DCI 

interrupt.The Interrupt Flag bit is also cleared. 

Source File: CloseDCI.c 

Code Example: CloseDCI(); 

BufferEmptyDCI 

Description: This function returns the DCI Transmit Buffer Full status. 


Prototype: char BufferEmptyDCI(void); 


Return Value: If the value of TMPTY is ‘1’, then ‘1’ is returned, indicating that 

the 

transmit buffer is empty. 

If the value of TMPTY is ‘0’, then ‘0’ is returned, indicating that the 

transmit buffer is not empty. 

Remarks: This function returns the status of the DCISTAT bit. This 

bit 

indicates whether the transmit buffer is empty. 

Source File: BufferEmptyDCI.c 

Code Example: while(!BufferEmptyDCI()); 



ConfigIntDCI 

Description: This function configures the DCI interrupt. 


Prototype: void ConfigIntDCI(unsigned int config); 

Arguments: config DCI interrupt priority and enable/disable information as 


DCI Interrupt enable/disable 

DCI_INT_ON 

DCI_INT_OFF 

DCI Interrupt priority 

DCI_INT_PRI_0 

DCI_INT_PRI_1 

DCI_INT_PRI_2 

DCI_INT_PRI_3 

Kiểm soát biện minh dữ liệu 

DCI_DJST_ON 

DCI_DJST_OFF 

Khung chế độ Sync chọn 

DCI_FSM_ACLINK_20BIT 


DCI_FSM_I2S 

DCI_FSM_MULTI 

config2 này chứa các thông số được cấu hình trong 

các DCICON2 đăng ký theo quy định dưới đây: 

Đệm dài 

DCI_BUFF_LEN_4 




DCI Khung điều khiển máy phát đồng bộ 

DCI_FRAME_LEN_16 



..... 


DCI kích thước từ dữ liệu 

DCI_DATA_WORD_16 



..... 



OpenDCI (Tiếp theo) 



config3 này chứa các bit giá trị máy phát điện đồng hồ để được 

cấu hình trong đăng ký DCICON3. 

trans_mask / này chứa các truyền / nhận khe 

recv_mask Enable bit được cấu hình vào TSCON / 

RSCON đăng ký theo quy định dưới đây: 

DCI_DIS_SLOT_15 


.....

DCI_INT_PRI_4 

DCI_INT_PRI_5 

DCI_INT_PRI_6 

DCI_INT_PRI_7 


Remarks: This function clears the Interrupt Flag (DCIIF) bit and then sets the 


Source File: ConfigIntDCI.c 

Code Example: ConfigIntDCI(DCI_INT_PRI_6& DCI_INT_ENABLE); 

DataRdyDCI 

Description: This function returns the status of DCI receive buffers. 


Prototype: char DataRdyDCI(void); 


Return Value: If the value of RFUL is ‘1’, then ‘1’ is returned, indicating that 

the data is 

ready to be read from the receive buffers. 

If the value of RFUL is ‘0’, then ‘0’ is returned, indicating that the 

receive buffers are empty. 

Remarks: This function returns the status of the DCISTAT bit. This bit 

indicates whether the data is available in the receive buffers. 

Source File: DataRdyDCI.c 

Code Example: while(!DataRdyDCI()); 

OpenDCI 

Description: This function configures the DCI. 


Prototype: void OpenDCI(unsigned int config1, 



unsigned int trans_mask, 

unsigned int recv_mask) 

Arguments: config1 This contains the parameters to be configured in 

the DCION1 register as defined below: 

dsPIC 

® 




DCI_EN_SLOT_ALL 

DCI_DIS_SLOT_ALL 


Bình luận: thói quen này cấu hình các thông số sau: 

1. DCICON1 đăng ký: 

Bit cho phép, 

Khung chế độ Sync, 

Giải thích dữ liệu, 

Hướng mẫu đồng hồ, 

Đồng hồ mẫu, 

Cạnh kiểm soát, 

Dẫn đầu ra Đồng bộ khung kiểm soát, 

Truyền liên tục / Nhận chế độ, 

Chế độ Van cân bằng. 

2. DCICON2 đăng ký: 

Khung Sync phát điện điều khiển, 

Kích thước bit dữ liệu Word, 

Đệm bit lượng kiểm soát. 

3. DCICON3 đăng ký: Clock Generator kiểm soát bit 

4. TSCON đăng ký: Truyền khe thời gian Enable bit kiểm soát. 

5. RSCON đăng ký: Nhận Giờ Khe cắm Enable bit kiểm soát. 

Source File: OpenDCI.c 

Mã số Ví dụ: DCICON1value = DCI_EN & 

DCI_IDLE_CON & 

DCI_DIGI_LPBACK_EN & 

DCI_SCKD_OUP & 

DCI_SAMP_CLK_FAL & 

DCI_FSD_OUP & 

DCI_TX_LASTVAL_UNF & 

DCI_SDO_TRISTAT & 

DCI_DJST_OFF & 

DCI_FSM_ACLINK_16BIT; 

DCICON2value = DCI_BUFF_LEN_4 & 

DCI_FRAME_LEN_2 & 

DS51456B-page 152 

Module On/Off 

DCI_EN 


DCI_DATA_WORD_16; 

DCICON3value = 0x02; 

RSCONvalue = DCI_EN_SLOT_ALL &

DCI_DIS 


DCI_IDLE_CON 

DCI_IDLE_STOP 

DCI Loopback mode enable 

DCI_DIGI_LPBACK_EN 

DCI_DIGI_LPBACK_DIS 

CSCK pin direction select 

DCI_SCKD_INP 

DCI_SCKD_OUP 

DCI sampling edge selection 

DCI_SAMP_CLK_RIS 

DCI_SAMP_CLK_FAL 

FS pin direction select 

DCI_FSD_INP 

DCI_FSD_OUP 

data to be transmitted during underflow 

DCI_TX_LASTVAL_UNF 

DCI_TX_ZERO_UNF 

SDO pin status during transmit disable 

DCI_SDO_TRISTAT 

DCI_SDO_ZERO 

Data justification control 

DCI_DJST_ON 

DCI_DJST_OFF 

Frame Sync mode select 



DCI_FSM_I2S 

DCI_FSM_MULTI 

config2 This contains the parameters to be configured in 

the DCICON2 register as defined below: 

Buffer length 





DCI Frame sync generator control 


DCI_DIS_SLOT_15 & 


DCI_DIS_SLOT_2; 

TSCONvalue = DCI_EN_SLOT_ALL & 




OpenDCI (DCICON1value, DCICON2value, DCICON3value, 

TSCONvalue, RSCONvalue); 

OpenDCI (Tiếp theo) 

dsPIC 

® 



ReadDCI 

Mô tả: Chức năng này đọc nội dung của DCI bộ đệm nhận. 


Nguyên mẫu: int ReadDCI (unsigned char buffer); 

Đối số: bufferThis là số đệm DCI để được đọc. 


Ghi chú: Chức năng này trả về nội dung ofDCI nhận được đệm chỉ bởi 

đệm. 

Source File: ReadDCI.c 

Mã số Ví dụ: int DCI_buf0; 

DCI_buf0 = ReadDCI (0); 

WriteDCI 

Mô tả: Chức năng này ghi các dữ liệu được truyền tới truyền DCI 

đệm. 


Prototype: void WriteDCI (int data_out, 

unsigned char buffer); 

Đối số: data_out Đây là các dữ liệu được truyền đi. 

đệm Đây là số lượng bộ đệm DCI được ghi. 


Bình luận: Chức năng này tải bộ đệm truyền theo quy định của bufferwith 

data_out. 

Source File: WriteDCI.c 

Mã số Ví dụ: int DCI_tx0 = 0x60; 

WriteDCI (DCI_tx0, 0);



..... 


DCI data word size 




..... 



OpenDCI (Continued) 



config3 This contains the bit clock generator value to be 

configured in the DCICON3 register. 

trans_mask/ This contains the transmit/receive slot 

recv_mask Enable bits to be configured into the TSCON/ 

RSCON register as defined below: 



..... 



DCI_EN_SLOT_ALL 

DCI_DIS_SLOT_ALL 


Remarks: This routine configures the following parameters: 

1. DCICON1 register: 

Enable bit, 

Frame Sync mode, 

Data Justification, 

Sample Clock Direction, 

Sample Clock, 

Edge Control, 

Output Frame Synchronization Directions Control, 

Continuous Transmit/Receive mode, 

Underflow mode. 

2. DCICON2 register: 




EnableIntDCI 

Mô tả: vĩ mô này cho phép ngắt DCI. 



Bình luận: Đây bộ vĩ mô DCI ngắt Enablebit của ngắt Chức năng Kiểm soát 

đăng ký. 

Mã số Ví dụ: EnableIntDCI; 

DisableIntDCI 

Mô tả: vĩ mô này vô hiệu hóa ngắt DCI. 



Bình luận: vĩ mô này sẽ xóa DCI Interrupt Enable bit Interrupt Enable kiểm soá 

đăng ký. 

Mã số Ví dụ: DisableIntDCI; 

SetPriorityIntDCI 

Mô tả: Đây ưu tiên bộ vĩ mô cho DCI bị gián đoạn. 



Bình luận: Đây bộ vĩ mô DCI ngắt bit ưu tiên của ngắt ưu tiên kiểm soát 

đăng ký. 

Mã số Ví dụ: SetPriorityIntDCI (4); 

dsPIC 

® 





# include 

# include 

/ * Dữ liệu nhận được lưu trữ từ 0x1820 trở đi. * / 

int * Receiveddata = (int *) 0x1820; 

khoảng trống __attribute __ ((__ interrupt__)) _DCIInterrupt (void) 

{ 

IFS2bits.DCIIF = 0; 

} 

int main (void)

Frame Sync Generator Control, 

Data Word Size bits, 

Buffer Length Control bits. 

3. DCICON3 register: Clock Generator Control bits 

4. TSCON register: Transmit TimeSlot Enable Control bits. 

5. RSCON register: Receive Time Slot Enable Control bits. 

Source File: OpenDCI.c 

Code Example: DCICON1value = DCI_EN & 

DCI_IDLE_CON & 




DCI_FSD_OUP & 

DCI_TX_LASTVAL_UNF & 



DCI_FSM_ACLINK_16BIT ; 

DCICON2value = DCI_BUFF_LEN_4 & 

DCI_FRAME_LEN_2& 

DCI_DATA_WORD_16 ; 

DCICON3value = 0x02 ; 

RSCONvalue = DCI_EN_SLOT_ALL & 




TSCONvalue = DCI_EN_SLOT_ALL & 




OpenDCI(DCICON1value, DCICON2value, DCICON3value, 


OpenDCI (Continued) 

dsPIC 

® 



ReadDCI 

Description: This function reads the contents of DCI receive buffer. 


{ 

/ * Dữ liệu được truyền đi bằng cách sử dụng mô-đun DCI * / 

data16 unsigned int [] = {0xABCD, 0x1234, 0x1578, 

0xfff0, 0xf679}; 

/ * Giữ thông tin cấu hình * / 

int DCICON1value; 

/ * Giữ giá trị của framelength, wordsize và chiều dài đệm * / 


/ * Giữ thông tin reagarding đồng hồ bit 

máy phát điện * / 


/ * Giữ các thông tin dữ liệu reagarding hy vọng sẽ nhận được 

hoặc bỏ qua trong thời gian này khe cắm * / 

int RSCONvalue; 

/ * Giữ thông tin reagarding truyền đệm 

nội dung được gửi Nam trong giai đoạn khe thời gian * / 

int TSCONvalue; 

int i; 

CloseDCI (); 

/ * Cấu hình DCI nhận / truyền gián đoạn * / 

ConfigIntDCI (DCI_INT_ON & DCI_INT_PRI_6); 

/ * Cấu hình DCI mô-đun để truyền dữ liệu 16 bit với chế độ đa kênh 

* / 

DCICON1value = DCI_EN & DCI_IDLE_CON & 




DCI_FSD_OUP & 

DCI_TX_ZERO_UNF & 



DCI_FSM_MULTI; 

DCICON2value = DCI_BUFF_LEN_4 & DCI_FRAME_LEN_4 & 

DCI_DATA_WORD_16; 


RSCONvalue = DCI_EN_SLOT_ALL & DCI_DIS_SLOT_11 & 

DCI_DIS_SLOT_4 & DCI_DIS_SLOT_5; 

TSCONvalue = DCI_EN_SLOT_ALL & DCI_DIS_SLOT_11 & 

DCI_DIS_SLOT_4 & DCI_DIS_SLOT_5;

Prototype: unsigned int ReadDCI(unsigned char buffer); 

Arguments: bufferThis is the DCI buffer number to be read. 


Remarks: This function returns the contents ofDCI receive buffer pointed by the 

buffer. 

Source File: ReadDCI.c 

Code Example: unsigned int DCI_buf0; 

DCI_buf0 = ReadDCI(0); 

WriteDCI 

Description: This function writes the data to be transmitted to the DCI transmit 

buffer. 


Prototype: void WriteDCI(unsigned int data_out, 

unsigned char buffer); 

Arguments: data_out This is the data to be transmitted. 

buffer This is the DCI buffer number to be written. 


Remarks: This function loads the transmit buffer specified by the bufferwith 

data_out. 

Source File: WriteDCI.c 

Code Example: unsigned int DCI_tx0 = 0x60; 

WriteDCI(DCI_tx0, 0); 




EnableIntDCI 

Description: This macro enables the DCI interrupt. 



Remarks: This macro sets DCI Interrupt Enablebit of Interrupt Enable Control 

register. 

Code Example: EnableIntDCI; 

DisableIntDCI 

Description: This macro disables the DCI interrupt. 



Remarks: This macro clears DCI Interrupt Enable bit of Interrupt Enable 

Control 

register. 

OpenDCI (DCICON1value, DCICON2value, DCICON3value, 




/ * Load truyền đệm và truyền cùng * / 

i = 0; 

trong khi (i

Code Example: DisableIntDCI; 

SetPriorityIntDCI 

Description: This macro sets priority for DCI interrupt. 



Remarks: This macro sets DCI Interrupt Priority bits of Interrupt Priority 

Control 

register. 

Code Example: SetPriorityIntDCI(4); 

dsPIC 

® 


Mô tả: Chức năng này cấu hình SPI ngắt. 

Bao gồm: spi.h 

Prototype: void ConfigIntSPI1 (int config); 

làm mất hiệu lực ConfigIntSPI2 (int config); 

Đối số: cấu hình SPI ngắt ưu tiên và bật / tắt thông tin 



SPI_INT_EN 

SPI_INT_DIS 


SPI_INT_PRI_0 

SPI_INT_PRI_1 

DS51456B-page 156 



SPI_INT_PRI_2 

SPI_INT_PRI_3 


#include 

#include 

/* Received data is stored from 0x1820 onwards. */ 

unsigned int * Receiveddata = ( unsigned int *)0x1820; 

void __attribute__((__interrupt__)) _DCIInterrupt(void) 

{ 

IFS2bits.DCIIF = 0; 

} 


{ 

/* Data to be transmitted using DCI module */ 

unsigned int data16[] = {0xabcd, 0x1234, 0x1578, 

0xfff0, 0xf679}; 

/* Holds configuration information */ 

unsigned int DCICON1value; 

/* Holds the value of framelength, wordsize and buffer length */ 

unsigned int DCICON2value; 

/* Holds the information reagarding bit clock 

generator */ 

unsigned int DCICON3value ; 

/* Holds the information reagarding data tobe received 

or ignored during this time slot */ 

unsigned int RSCONvalue ; 

/* Holds the information reagarding transmit buffer 

SPI_INT_PRI_4 

SPI_INT_PRI_5 

SPI_INT_PRI_6 

SPI_INT_PRI_7 


Ghi chú: Chức năng này sẽ xóa sạch các bit Cờ ngắt, đặt ưu tiên ngắt và 

cho phép / vô hiệu hóa ngắt. 

Source File: ConfigIntSPI1.c 

ConfigIntSPI2.c 

Mã số Ví dụ: ConfigIntSPI1 (SPI_INT_PRI_3 & SPI_INT_EN); 

CloseSPI1 

CloseSPI2 

Mô tả: Chức năng này sẽ tắt các mô-đun SPI 


Prototype: void CloseSPI1 (void); 

làm mất hiệu lực CloseSPI2 (void); 



Ghi chú: Chức năng này vô hiệu hóa ngắt SPI và sau đó tắt các mô-đun. 

Các bit Cờ ngắt cũng sẽ bị xóa. 

Source File: CloseSPI1.c 

CloseSPI2.c 

Mã số Ví dụ: CloseSPI1 (); 



contents are sent duringthe timeslot */ 

unsigned int TSCONvalue ; 

int i ; 

CloseDCI(); 

/* Configure DCI receive/ transmit interrupt */ 

ConfigIntDCI( DCI_INT_ON & DCI_INT_PRI_6); 

/* Configure DCI module to transmit 16bit data with multichannel mode 

*/ 

DCICON1value = DCI_EN & DCI_IDLE_CON & 




DCI_FSD_OUP & 

DCI_TX_ZERO_UNF & 



DCI_FSM_MULTI; 

DCICON2value = DCI_BUFF_LEN_4 & DCI_FRAME_LEN_4 & 

DCI_DATA_WORD_16 ; 


RSCONvalue = DCI_EN_SLOT_ALL & DCI_DIS_SLOT_11 & 

DCI_DIS_SLOT_4 & DCI_DIS_SLOT_5; 

TSCONvalue = DCI_EN_SLOT_ALL & DCI_DIS_SLOT_11 & 

DCI_DIS_SLOT_4 &DCI_DIS_SLOT_5; 

OpenDCI(DCICON1value, DCICON2value, DCICON3value, 




/* Load transmit buffer and transmit the same */ 

i = 0; 

while( i

* Wait till new data isavailable in RX buffer */ 

while(!DataRdyDCI()); 

/* Read all the data remaining in receive buffer which 

are unread into user defined data buffer*/ 

i = 0; 

while( i

SPI_INT_PRI_4 

SPI_INT_PRI_5 

SPI_INT_PRI_6 

SPI_INT_PRI_7 


Remarks: This function clears the Interrupt Flag bit, sets the interrupt priority 

and 

enables/disables the interrupt. 

Source File: ConfigIntSPI1.c 

ConfigIntSPI2.c 

Code Example: ConfigIntSPI1(SPI_INT_PRI_3 & SPI_INT_EN); 

CloseSPI1 

CloseSPI2 

Description: This function turns off the SPI module 

Include: spi.h 

Prototype: void CloseSPI1(void); 

void CloseSPI2(void); 



Remarks: This function disables the SPI interrupt and then turns off the module. 

The Interrupt Flag bit is also cleared. 

Source File: CloseSPI1.c 

CloseSPI2.c 

Code Example: CloseSPI1(); 



DataRdySPI1 

DataRdySPI2 

Description: This function determines if the SPI buffer contains any data to be 

read. 


Prototype: char DataRdySPI1(void); 

char DataRdySPI2(void); 


Return Value: If ‘1’ is returned, it indicates that the data has been received in 

the 

receive buffer and is to be read. 

If ‘0’ is returned, it indicates that the receive is not complete and the 

receive buffer is empty. 

Remarks: This function returns the status of SPI receive buffer. This indicates if 

Khung Sync xung điều khiển hướng 

FRAME_SYNC_INPUT 

FRAME_SYNC_OUTPUT 

SDO Pin điều khiển bit 

DISABLE_SDO_PIN 

ENABLE_SDO_PIN 

Word / Chế độ liên lạc Byte 

SPI_MODE16_ON 

SPI_MODE16_OFF 

SPI dữ liệu đầu vào giai đoạn mẫu 

SPI_SMP_ON 

SPI_SMP_OFF 

SPI Clock cạnh Chọn 

SPI_CKE_ON 

SPI_CKE_OFF 

SPI nô lệ chọn cho phép 

SLAVE_SELECT_ENABLE_ON 

SLAVE_SELECT_ENABLE_OFF 



SPI Clock cực chọn 

CLK_POL_ACTIVE_LOW 

CLK_POL_ACTIVE_HIGH 

Chọn chế độ SPI bit 

MASTER_ENABLE_ON 

MASTER_ENABLE_OFF 

Prescale thứ cấp chọn 

SEC_PRESCAL_1_1 








Tiểu prescale chọn 

PRI_PRESCAL_1_1 


PRI_PRESCAL_16_1

the SPI receive buffer contains any new data that is yet to be read as 

indicated by the SPIxSTAT bit. This bit is cleared by 

hardware when the data is read from the buffer. 

Source File: DataRdySPI1.c 

DataRdySPI2.c 

Code Example: while(DataRdySPI1()); 

ReadSPI1 

ReadSPI2 

Description: This function reads the content of the SPI Receive Buffer 

(SPIxBUF) 

register. 


Prototype: unsigned int ReadSPI1(void); 

unsigned int ReadSPI2(void); 


Return Value: This function returns the content of Receive Buffer (SPIxBUF) 

register. 

If a value of ‘-1’ is returned, it indicates that there is no data to be read 

from the SPI buffer. 

Remarks: This function returns the content of the Receive Buffer register. 

If 16-bit communication is enabled, the data in the SPIxRBF register is 

returned. 

If 8-bit communication is enabled, then the lower byte of SPIxBUF is 

returned. 

The SPIxBUF is read only if it contains any data as indicated by the 

SPISTATbit. Otherwise, a value of ‘-1’ is returned. 

Source File: ReadSPI1.c 

ReadSPI2.c 

Code Example: unsigned int RX_data; 

RX_data = ReadSPI1(); 

dsPIC 

® 


DS51456B-page 160 

WriteSPI1 

WriteSPI2 


Description: This function writes the data to be transmitted into the Transmit 

Buffer 

(SPIxBUF) register. 




SPIxSTAT đăng ký theo quy định dưới đây: 

SPI Enable / Disable 

SPI_ENABLE 

SPI_DISABLE 

SPI hoạt động chế độ Idle 

SPI_IDLE_CON 

SPI_IDLE_STOP 

Nhận rõ ràng tràn cờ bit 

SPI_RX_OVFLOW_CLR 


Bình luận: chức năng này khởi tạo các mô-đun SPI và thiết lập chế độ nhàn rỗi 

hoạt động. 

Source File: OpenSPI1.c 

OpenSPI2.c 

Mã số Ví dụ: config1 = FRAME_ENABLE_OFF & 

FRAME_SYNC_OUTPUT & 

ENABLE_SDO_PIN & 

SPI_MODE16_ON & 

SPI_SMP_ON & 

SPI_CKE_OFF & 

SLAVE_SELECT_ENABLE_OFF & 

CLK_POL_ACTIVE_HIGH & 

MASTER_ENABLE_ON & 

SEC_PRESCAL_7_1 & 

PRI_PRESCAL_64_1; 

config2 = SPI_ENABLE & 

SPI_IDLE_CON & 

SPI_RX_OVFLOW_CLR OpenSPI1 (config1, 

config2); 

OpenSPI1 (Tiếp theo) 

OpenSPI2 

dsPIC 

® 



putsSPI1 

putsSPI2

Prototype: void WriteSPI1(unsigned int data); 

void WriteSPI2(unsigned int data); 

Arguments: data This is the data to be transmitted which will be stored in SPI 

buffer. 

Remarks: This function writes the data (byte/word) to be transmitted into the 


If 16-bit communication is enabled,the 16-bit value is written to the 


If 8-bit communication is enabled, then upper byte is masked and then 

written to the transmit buffer. 


Source File: WriteSPI1.c 

WriteSPI2.c 

Code Example: WriteSPI1(0x3FFF); 

OpenSPI1 

OpenSPI2 

Description: This function configures the SPI module 


Prototype: void OpenSPI1(unsigned int config1, 


void OpenSPI2(unsigned int config1, 



SPIxCON register as defined below: 

Framed SPI support Enable/Disable 

FRAME_ENABLE_ON 

FRAME_ENABLE_OFF 

Frame Sync Pulse direction control 

FRAME_SYNC_INPUT 

FRAME_SYNC_OUTPUT 

SDO Pin Control bit 

DISABLE_SDO_PIN 

ENABLE_SDO_PIN 

Word/Byte Communication mode 

SPI_MODE16_ON 

SPI_MODE16_OFF 

SPI Data Input Sample phase 

SPI_SMP_ON 

SPI_SMP_OFF 

Mô tả: Chức năng này ghi một chuỗi các dữ liệu được truyền vào SPI 



Nguyên mẫu: 

làm mất hiệu lực putsSPI1 (unsigned int dài, 

int * wrptr); 

làm mất hiệu lực putsSPI2 (unsigned int dài, 

int * wrptr); 

Đối số: chiều dài Đây là số từ dữ liệu / byte được truyền đi. 

wrptr Đây là con trỏ đến chuỗi dữ liệu được truyền đi. 


Ghi chú: Chức năng này ghi chiều dài xác định các từ dữ liệu / byte được 

truyền vào bộ đệm truyền. 

Một khi bộ đệm truyền đầy, nó chờ đợi cho đến khi dữ liệu được truyền và 

sau đó ghi dữ liệu tiếp theo vào sổ đăng ký Transmit. 

Việc kiểm soát vẫn còn trong functionif SPI mô-đun isdisabled trong khi điều 

này 

SPITBF bit được thiết lập. 

Source File: putsSPI1.c 

putsSPI2.c 

Mã số Ví dụ: putsSPI1 (10, Txdata_loc); 

getsSPI1 

getsSPI2 

Mô tả: Chức năng này lần đọc một chuỗi các dữ liệu chiều dài quy định và lưu 

trữ nó vào 

vị trí quy định. 


Nguyên mẫu: int getsSPI1 ( 

chiều dài int unsigned, 

int * rdptr, 

int spi_data_wait); 

int getsSPI2 ( 

chiều dài int unsigned, 

int * rdptr, 

int spi_data_wait); 

Đối số: chiều dài Đây là chiều dài của chuỗi được nhận. 

rdptr Đây là con trỏ đến vị trí dữ liệu 

nhận phải được lưu trữ. 

spi_data_wait Đây là số thời gian chờ cho các mô-đun 

đã phải chờ đợi trước khi trở về.

SPI Clock Edge Select 

SPI_CKE_ON 

SPI_CKE_OFF 

SPI slave select enable 

SLAVE_SELECT_ENABLE_ON 

SLAVE_SELECT_ENABLE_OFF 



SPI Clock polarity select 

CLK_POL_ACTIVE_LOW 

CLK_POL_ACTIVE_HIGH 

SPI Mode Select bit 

MASTER_ENABLE_ON 

MASTER_ENABLE_OFF 

Secondary Prescale select 









Primary Prescale select 






SPIxSTAT register as defined below: 

SPI Enable/Disable 

SPI_ENABLE 

SPI_DISABLE 

SPI Idle mode operation 

SPI_IDLE_CON 

SPI_IDLE_STOP 

Clear Receive Overflow Flag bit 

SPI_RX_OVFLOW_CLR 


Nếu tính thời gian chờ là 'N', thời gian chờ thực tế 

sẽ vào khoảng (19 * N - 1) chu kỳ hướng dẫn. 

Trở lại giá trị: Chức năng này trả về số byte chưa được nhận. 

Nếu giá trị trả về là "0", nó chỉ ra rằng chuỗi hoàn chỉnh đã được 

nhận được. 

Nếu giá trị trả về là một giá trị khác không, nó cho thấy thatthe chuỗi hoàn 

chỉnh có 

không được nhận. 


Source File: getsSPI1.c 

getsSPI2.c 

Mã số Ví dụ: Datarem = getsSPI1 (6, Rxdata_loc, 40); 




getcSPI1 

getcSPI2 

Mô tả: Chức năng này giống hệt với ReadSPI1 và ReadSPI2. 

Source File: # define để ReadSPI1 và ReadSPI2 trong spi.h 

putcSPI1 

putcSPI2 

Mô tả: Chức năng này giống hệt với WriteSPI1 và WriteSPI2. 

Source File: # define để WriteSPI1 và WriteSPI2 trong spi.h 

EnableIntSPI1 

EnableIntSPI2 

Mô tả: vĩ mô này cho phép ngắt SPI. 



Bình luận: Đây bộ vĩ mô SPI Enablebit ngắt của ngắt Kích hoạt tính năng kiểm 

soát 

đăng ký. 

Mã số Ví dụ: EnableIntSPI1; 

DisableIntSPI1 


Mô tả: vĩ mô này vô hiệu hóa ngắt SPI. 



Bình luận: vĩ mô này xóa SPI Enablebit ngắt của ngắt Kích hoạt tính năng kiểm 

soát 

đăng ký. 

Mã số Ví dụ: DisableIntSPI2;

Remarks: This functions initializes the SPI module and sets the Idle mode 

operation. 

Source File: OpenSPI1.c 

OpenSPI2.c 

Code Example: config1 = FRAME_ENABLE_OFF & 

FRAME_SYNC_OUTPUT & 

ENABLE_SDO_PIN & 

SPI_MODE16_ON & 

SPI_SMP_ON & 

SPI_CKE_OFF & 






config2 = SPI_ENABLE & 

SPI_IDLE_CON & 

SPI_RX_OVFLOW_CLR OpenSPI1(config1, 

config2); 

OpenSPI1 (Continued) 

OpenSPI2 

dsPIC 

® 



putsSPI1 

putsSPI2 

Description: This function writes a string of data to be transmitted into the SPI 



Prototype: 

void putsSPI1(unsigned int length, 

unsigned int *wrptr); 

void putsSPI2(unsigned int length, 

unsigned int *wrptr); 

Arguments: length This is the number of data words/bytes to be transmitted. 

wrptr This is the pointer to the string of data to be transmitted. 


Remarks: This function writes the specified length of data words/bytes to be 

SetPriorityIntSPI1 


Mô tả: Đây ưu tiên bộ vĩ mô cho SPI bị gián đoạn. 



Bình luận: vĩ mô này đặt SPI Interrupt bit ưu tiên của ngắt ưu tiên kiểm soát 

đăng ký. 

Mã số Ví dụ: SetPriorityIntSPI2 (2); 

dsPIC 

® 





# include 

# include 

/ * Dữ liệu nhận được SPI2 * / 

int datard; 

khoảng trống __attribute __ ((__ interrupt__)) _SPI1Interrupt (void) 

{ 

IFS0bits.SPI1IF = 0; 

} 

khoảng trống __attribute __ ((__ interrupt__)) _SPI2Interrupt (void) 

{ 


SPI1STATbits.SPIROV = 0; / * Rõ ràng spi1 nhận được tràn 

cờ nếu đặt * / 

} 


{ 

/ * Giữ các thông tin về SPI configuartion * / 

int SPICONValue; 

/ * Giữ các thông tin về SPI Enable / Disable * / 

int SPISTATValue; 

/ * Timeout giá trị trong thời gian đó timer1 là ON * / 

int thời gian chờ; 

/ * Tắt module SPI * / 

CloseSPI1 (); 

CloseSPI2 ();

transmitted into the transmit buffer. 

Once the transmit buffer is full, it waits till the data gets transmitted and 

then writes the next data into the Transmit register. 

The control remains in this functionif SPI module isdisabled while 

SPITBF bit is set. 

Source File: putsSPI1.c 

putsSPI2.c 

Code Example: putsSPI1(10,Txdata_loc); 

getsSPI1 

getsSPI2 

Description: This function reads a string of data of specified length and stores it 

into 

the location specified. 


Prototype: unsigned int getsSPI1( 

unsigned int length, 

unsigned int *rdptr, 

unsigned int spi_data_wait); 

unsigned int getsSPI2( 

unsigned int length, 

unsigned int *rdptr, 

unsigned int spi_data_wait); 

Arguments: length This is the length of the string to be received. 

rdptr This is the pointer to the location where the data 

received have to be stored. 

spi_data_wait This is the timeout count for which the module 

has to wait before return. 

If the timeout count is ‘N’, the actual timeout 

would be about (19*N - 1) instruction cycles. 

Return Value: This function returns the number of bytes yet to be received. 

If the return value is a ‘0’, it indicates that the complete string has been 

received. 

If the return value is a nonzero, it indicates thatthe complete string has 

not been received. 

Remarks: None 

Source File: getsSPI1.c 

getsSPI2.c 

Code Example: Datarem = getsSPI1(6, Rxdata_loc, 40); 


TMR1 = 0; 

thời gian chờ = 0; 


/ * Cấu hình SPI2 ngắt * / 

ConfigIntSPI2 (SPI_INT_EN & SPI_INT_PRI_6); 

/ * Cấu hình spi1 mô-đun totransmit giá trị timer1 16 bit 

trong chế độ thạc sĩ * / 

SPICONValue = FRAME_ENABLE_OFF & FRAME_SYNC_OUTPUT & 

ENABLE_SDO_PIN & SPI_MODE16_ON & 

SPI_SMP_ON & SPI_CKE_OFF & 






SPISTATValue = SPI_ENABLE & SPI_IDLE_CON & 

SPI_RX_OVFLOW_CLR; 

OpenSPI1 (SPICONValue, SPISTATValue); 



/ * Cấu hình SPI2 mô-đun để nhận được giá trị bộ đếm thời gian 16 bit 

chế độ nô lệ * / 



SPI_SMP_OFF & SPI_CKE_OFF & 



MASTER_ENABLE_OFF & 




PI_RX_OVFLOW_CLR; 

OpenSPI2 (SPICONValue, SPISTATValue); 

T1CON = 0x8000; 

trong khi (thời gian chờ



getcSPI1 

getcSPI2 

Description: This function is identical to ReadSPI1 and ReadSPI2. 

Source File: #define to ReadSPI1 and ReadSPI2 in spi.h 

putcSPI1 

putcSPI2 

Description: This function is identical to WriteSPI1 and WriteSPI2. 

Source File: #define to WriteSPI1 and WriteSPI2 in spi.h 

EnableIntSPI1 

EnableIntSPI2 

Description: This macro enables the SPI interrupt. 



Remarks: This macro sets SPI Interrupt Enablebit of Interrupt Enable Control 

register. 

Code Example: EnableIntSPI1; 



Description: This macro disables the SPI interrupt. 



Remarks: This macro clears SPI Interrupt Enablebit of Interrupt Enable Control 

register. 

Code Example: DisableIntSPI2; 



Description: This macro sets priority for SPI interrupt. 



Remarks: This macro sets SPI Interrupt Priority bits of Interrupt Priority Control 

register. 

Code Example: SetPriorityIntSPI2(2); 

dsPIC 

® 


WriteSPI1 (TMR1); 

trong khi (SPI1STATbits.SPITBF); 

trong khi (DataRdySPI2 ()); 

datard = ReadSPI2 (); 

if (datard


#include 

#include 

/* Data received at SPI2 */ 

unsigned int datard ; 

void __attribute__((__interrupt__)) _SPI1Interrupt(void) 

{ 


} 

void __attribute__((__interrupt__)) _SPI2Interrupt(void) 

{ 


SPI1STATbits.SPIROV = 0; /* Clear SPI1 receive overflow 

flag if set */ 

} 


{ 

/* Holds the information about SPI configuartion */ 

unsigned int SPICONValue; 

/* Holds the information about SPI Enable/Disable */ 

unsigned int SPISTATValue; 

/*Timeout value during which timer1 is ON */ 

int timeout; 

/* Turn off SPI modules */ 

CloseSPI1(); 

CloseSPI2(); 

TMR1 = 0 ; 

timeout = 0; 


/* Configure SPI2 interrupt */ 

ConfigIntSPI2(SPI_INT_EN & SPI_INT_PRI_6); 

/* Configure SPI1 module totransmit 16 bit timer1 value 

in master mode */ 


ENABLE_SDO_PIN& SPI_MODE16_ON & 

SPI_SMP_ON & SPI_CKE_OFF & 




QEI_INT_DISABLE 

Ưu tiên QEI ngắt 

QEI_INT_PRI_0 

QEI_INT_PRI_1 

QEI_INT_PRI_2 

QEI_INT_PRI_3 

QEI_INT_PRI_4 

QEI_INT_PRI_5 

QEI_INT_PRI_6 

QEI_INT_PRI_7 

Trở lại giá trị Không 



Source File: ConfigIntQEI.c 

Mã số Ví dụ: ConfigIntQEI (QEI_INT_ENABLE & QEI_INT_PRI_1); 



OpenQEI 

Mô tả: Chức năng này cấu hình QEI. 

Bao gồm: qei.h 

Prototype: void OpenQEI (int config1, int 

config2); 


QEIxCON đăng ký theo quy định dưới đây: 

Chức vụ truy cập điều khiển hướng lựa chọn 

QEI_DIR_SEL_QEB 

QEI_DIR_SEL_CNTRL 

Hẹn giờ đồng hồ Nguồn Chọn bit 

QEI_EXT_CLK 

QEI_INT_CLK 

Chức vụ truy cập Thiết lập lại phép 

QEI_INDEX_RESET_ENABLE 

QEI_INDEX_RESET_DISABLE 

Đồng hồ đếm thời gian đầu vào prescale Chọn bit 

QEI_CLK_PRESCALE_1 




Thơi gian chung cổng Thời gian tích lũy Kích hoạt




SPI_RX_OVFLOW_CLR; 

OpenSPI1(SPICONValue,SPISTATValue ); 



/* Configure SPI2 module to receive 16 bit timer value in 

slave mode */ 



SPI_SMP_OFF & SPI_CKE_OFF & 



MASTER_ENABLE_OFF & 




PI_RX_OVFLOW_CLR; 

OpenSPI2(SPICONValue,SPISTATValue ); 

T1CON = 0X8000; 

while(timeout< 100 ) 

{ 

timeout = timeout+2 ; 

} 

T1CON = 0; 

WriteSPI1(TMR1); 

while(SPI1STATbits.SPITBF); 

while(!DataRdySPI2()); 

datard = ReadSPI2(); 

if(datard

dsPIC 

® 


DS51456B-page 166 

3.15 QEI FUNCTIONS 


This section contains a list of individualfunctions for QEI module and an 

example of 



CloseQEI 

Description: This function turns off the QEI module 

Include: qei.h 

Prototype: void closeQEI(void); 


Return Value None 

Remarks: This function disables the QEI module and clears the QEI Interrupt 

Enable and Flag bits. 

Source File: CloseQEI.c 

Code Example: CloseQEI(); 

ConfigIntQEI 

Description: This function Configure the QEI Interrupt. 


Prototype: void ConfigIntQEI(unsigned int config); 

Arguments: config QEI interrupt priority and enable/disable information as 


QEI Interrupt enable/disable 

QEI_INT_ENABLE 

QEI_INT_DISABLE 

QEI Interrupt priority 

QEI_INT_PRI_0 

QEI_INT_PRI_1 

QEI_INT_PRI_2 

QEI_INT_PRI_3 

QEI_INT_PRI_4 

QEI_INT_PRI_5 

QEI_INT_PRI_6 

QEI_INT_PRI_7 



and 

MATCH_INDEX_INPUT_PHASEB 

Giai đoạn trạng thái tín hiệu đầu vào cho phù hợp với chỉ số xung 

MATCH_INDEX_INPUT_HIGH 

MATCH_INDEX_INPUT_LOW 

Bật / Tắt gián đoạn do vị trí số sự kiện 

POS_CNT_ERR_INT_ENABLE 

POS_CNT_ERR_INT_DISABLE 

QEA / QEB lọc kỹ thuật số Đồng hồ Chia Chọn bit 

QEI_QE_CLK_DIVIDE_1_1 








QEA / QEB lọc kỹ thuật số đầu ra Kích hoạt 

QEI_QE_OUT_ENABLE 

QEI_QE_OUT_DISABLE 


Ghi chú: Chức năng này cấu hình QEICON và DFLTCON đăng ký của QEI 

mô-đun. 

Chức năng này cũng xóa QEICON bit. 

Source File: OpenQEI.c 

Mã số Ví dụ: OpenQEI (QEI_DIR_SEL_QEB & QEI_INT_CLK & 

QEI_INDEX_RESET_ENABLE & 

QEI_CLK_PRESCALE_1 & QEI_NORMAL_IO & 

QEI_MODE_TIMER & QEI_UP_COUNT, 0); 

ReadQEI 

Mô tả: Chức năng này đọc các giá trị số vị trí trong sổ đăng ký POSCNT. 


Nguyên mẫu: int ReadQEI (void); 



Trở lại giá trị chức năng này trả về các nội dung của đăng ký POSCNT. 

Source File: ReadQEI.c 

Mã số Ví dụ: int pos_count; 

pos_count = ReadQEI (); 

OpenQEI (Tiếp theo)


Source File: ConfigIntQEI.c 

Code Example: ConfigIntQEI(QEI_INT_ENABLE & QEI_INT_PRI_1); 



OpenQEI 

Description: This function configure the QEI. 


Prototype: void OpenQEI(unsigned int config1, unsigned int 

config2); 


QEIxCON register as defined below: 

Position Counter Direction Selection Control 

QEI_DIR_SEL_QEB 

QEI_DIR_SEL_CNTRL 

Timer Clock Source Select bit 

QEI_EXT_CLK 

QEI_INT_CLK 

Position Counter Reset Enable 

QEI_INDEX_RESET_ENABLE 

QEI_INDEX_RESET_DISABLE 

Timer Input Clock Prescale Select bits 





Timer Gated Time Accumulation Enable 

QEI_GATED_ACC_ENABLE 

QEI_GATED_ACC_DISABLE 

Position Counter Direction State Output Enable 

QEI_LOGIC_CONTROL_IO 

QEI_NORMAL_IO 

Phase A and Phase B Input Swap Select bit 

QEI_INPUTS_SWAP 

QEI_INPUTS_NOSWAP 

QEI Mode of operation select 

QEI_MODE_x4_MATCH 

QEI_MODE_x4_PULSE 




WriteQEI 

Mô tả: Chức năng này đặt giá trị số tối đa cho QEI. 


Prototype: void WriteQEI (vị trí int unsigned); 

Đối số: 

Vị trí này là giá trị được storedinto đăng ký MAXCNT. 



Source File: WriteQEI.c 

Mã số Ví dụ: vị trí int unsigned = 0x3FFF; 

WriteQEI (vị trí); 

EnableIntQEI 

Mô tả: vĩ mô này cho phép ngắt QEI. 



Ghi chú: Phần này bộ QEI Interrupt Enable bit Interrupt Enable kiểm soát 

đăng ký. 

Mã số Ví dụ: EnableIntQEI; 

DisableIntQEI 

Mô tả: vĩ mô này vô hiệu hóa ngắt QEI. 



Bình luận: vĩ mô này xóa QEI Enablebit ngắt của ngắt Kích hoạt tính năng kiểm 

soát 

đăng ký. 

Mã số Ví dụ: DisableIntQEI; 

SetPriorityIntQEI 

Mô tả: Đây ưu tiên bộ vĩ mô cho QEI bị gián đoạn. 



Bình luận: vĩ mô này đặt QEI ngắt bit ưu tiên của ngắt ưu tiên kiểm soát 

đăng ký. 

Mã số Ví dụ: SetPriorityIntQEI (7); 

dsPIC 

® 


QEI_MODE_x2_MATCH 



QEI_MODE_x2_PULSE 

QEI_MODE_TIMER 

QEI_MODE_OFF 

Position Counter Direction Status 

QEI_UP_COUNT 

QEI_DOWN_COUNT 

Idle Mode Operation 

QEI_IDLE_STOP 

QEI_IDLE_CON 


DFLTxCON register. 

In 4x Quadrature Count Mode: 

Required State of Phase A input signal 

for match on index pulse 

MATCH_INDEX_PHASEA_HIGH 

MATCH_INDEX_PHASEA_LOW 

Required State of Phase B input signal 

for match on index pulse 

MATCH_INDEX_PHASEB_HIGH 

MATCH_INDEX_PHASEB_LOW 

dsPIC 

® 



In 2x Quadrature Count Mode: 

Phase input signal for index state match 

MATCH_INDEX_INPUT_PHASEA 

MATCH_INDEX_INPUT_PHASEB 

Phase input signal state for match on index pulse 

MATCH_INDEX_INPUT_HIGH 

MATCH_INDEX_INPUT_LOW 

Enable/Disable interrupt due to position count event 

POS_CNT_ERR_INT_ENABLE 

POS_CNT_ERR_INT_DISABLE 

QEA/QEB Digital Filter Clock Divide Select bits 







# include 

# include 

int pos_value; 

khoảng trống __attribute __ ((__ interrupt__)) _QEIInterrupt (void) 

{ 


POSCNT = 0; 

IFS2bits.QEIIF = 0; / * Rõ ràng QEI gián đoạn cờ * / 

} 


{ 

int MAX_VALUE; 



/ * Kích hoạt QEI ngắt và ưu tiên để "1" * / 

ConfigIntQEI (QEI_INT_PRI_1 & QEI_INT_ENABLE); 

POSCNT = 0; 

MAXCNT = 0xFFFF; 

OpenQEI (QEI_INT_CLK & QEI_INDEX_RESET_ENABLE & 

QEI_CLK_PRESCALE_256 & 

QEI_GATED_ACC_DISABLE & QEI_INPUTS_NOSWAP & 

QEI_MODE_TIMER & QEI_DIR_SEL_CNTRL & 

QEI_IDLE_CON, 0); 

QEICONbits.UPDN = 1; 

trong khi (1) 

{ 

pos_value = ReadQEI (); 

if (pos_value> = 0x7FFF) 

{ 

PORTDbits.RD1 = 0; / * Bật đèn LED trên RD1 * / 

} 

} 

CloseQEI (); 

} 



3.16 chức năng PWM 

Phần này bao gồm một danh sách các chức năng riêng biệt cho mô-đun PWM





QEA/QEB Digital Filter Output Enable 

QEI_QE_OUT_ENABLE 

QEI_QE_OUT_DISABLE 


Remarks: This function configures the QEICON and DFLTCON registers of 

QEI 

module. 

This function also clears the QEICON bit. 

Source File: OpenQEI.c 

Code Example: OpenQEI(QEI_DIR_SEL_QEB & QEI_INT_CLK & 

QEI_INDEX_RESET_ENABLE & 

QEI_CLK_PRESCALE_1 & QEI_NORMAL_IO & 

QEI_MODE_TIMER & QEI_UP_COUNT,0); 

ReadQEI 

Description: This function read the position count value from the POSCNT 

register. 


Prototype: unsigned int ReadQEI(void); 


Remarks: None 

Return Value This functions returns the contents of the POSCNT register. 

Source File: ReadQEI.c 

Code Example: unsigned int pos_count; 

pos_count = ReadQEI(); 

OpenQEI (Continued) 




WriteQEI 

Description: This function sets the maximum count value for QEI. 


Prototype: void WriteQEI(unsigned int position); 

Arguments: 

position This is the value to be storedinto the MAXCNT register. 


Remarks: None 

và một ví dụ về 



CloseMCPWM 

Mô tả: Chức năng này sẽ tắt các mô-đun điều khiển động cơ PWM. 

Bao gồm: pwm.h 

Prototype: void closeMCPWM (void); 



Bình luận: Chức năng này vô hiệu hóa các động cơ mô-đun điều khiển PWM v 

xóa 

PWM, lỗi A và B lỗi ngắt Enable và bit cờ. 

Chức năng này cũng xóa PTCON, PWMCON1 và PWMCON2 

đăng ký. 

Source File: CloseMCPWM.c 

Mã số Ví dụ: CloseMCPWM (); 

ConfigIntMCPWM 

Mô tả: Chức năng này cấu hình PWM ngắt. 


Prototype: void ConfigIntMCPWM (int config); 

Lập luận: config PWM ngắt ưu tiên và bật / tắt thông tin 


PWM ngắt bật / tắt 

PWM_INT_EN 

PWM_INT_DIS 

Ưu tiên ngắt PWM 

PWM_INT_PR0 

PWM_INT_PR1 

PWM_INT_PR2 

PWM_INT_PR3 

PWM_INT_PR4 

PWM_INT_PR5 

PWM_INT_PR6 

PWM_INT_PR7 

Một lỗi ngắt bật / tắt 

PWM_FLTA_EN_INT 

PWM_FLTA_DIS_INT 

Lỗi Một ưu tiên ngắt 

PWM_FLTA_INT_PR0 

PWM_FLTA_INT_PR1

Source File: WriteQEI.c 

Code Example: unsigned int position = 0x3FFF; 

WriteQEI(position); 

EnableIntQEI 

Description: This macro enables the QEI interrupt. 



Remarks: This macro sets QEI Interrupt Enable bit of Interrupt Enable Control 

register. 

Code Example: EnableIntQEI; 

DisableIntQEI 

Description: This macro disables the QEI interrupt. 



Remarks: This macro clears QEI Interrupt Enablebit of Interrupt Enable Control 

register. 

Code Example: DisableIntQEI; 

SetPriorityIntQEI 

Description: This macro sets priority for QEI interrupt. 



Remarks: This macro sets QEI Interrupt Priority bits of Interrupt Priority 

Control 

register. 

Code Example: SetPriorityIntQEI(7); 

dsPIC 

® 








Lỗi B ngắt cho phép / vô hiệu hóa 

PWM_FLTB_EN_INT 

PWM_FLTB_DIS_INT 

dsPIC 

® 



Lỗi ưu tiên B ngắt 

PWM_FLTB_INT_PR0 











Source File: ConfigIntMCPWM.c 

Mã số Ví dụ: ConfigIntMCPWM (PWM_INT_EN & PWM_INT_PR5 & 

PWM_FLTA_EN_INT & 

DS51456B-page 170 



PWM_FLTA_INT_PR6 & 

PWM_FLTB_EN_INT & 


#include 

#include 

unsigned int pos_value; 

void __attribute__((__interrupt__)) _QEIInterrupt(void) 

{ 


POSCNT = 0; 

IFS2bits.QEIIF = 0; /* Clear QEI interrupt flag */ 

PWM_FLTB_INT_PR7); 

OpenMCPWM 

Mô tả: Chức năng này cấu hình các mô-đun PWM điều khiển động cơ. 


Prototype: void OpenMCPWM (giai đoạn int unsigned, 

int sptime, 

int config1, 

int config2, 

int config3); 

Lập luận: Giai đoạn này bao gồm các giá trị thời gian PWM timebase được lưu

} 


{ 

unsigned int max_value; 



/* Enable QEI Interrupt and Priority to "1" */ 

ConfigIntQEI(QEI_INT_PRI_1 & QEI_INT_ENABLE); 

POSCNT = 0; 

MAXCNT = 0xFFFF; 

OpenQEI(QEI_INT_CLK & QEI_INDEX_RESET_ENABLE & 

QEI_CLK_PRESCALE_256 & 

QEI_GATED_ACC_DISABLE & QEI_INPUTS_NOSWAP & 

QEI_MODE_TIMER & QEI_DIR_SEL_CNTRL & 

QEI_IDLE_CON, 0); 

QEICONbits.UPDN = 1; 

while(1) 

{ 

pos_value = ReadQEI(); 

if(pos_value >= 0x7FFF) 

{ 

PORTDbits.RD1 = 0; /* turn on LED on RD1 */ 

} 

} 

CloseQEI(); 

} 



3.16 PWM FUNCTIONS 

This section contains a list of individual functions for PWM module and an 

example of 



CloseMCPWM 

Description: This function turns off the Motor Control PWM module. 

Include: pwm.h 

Prototype: void closeMCPWM(void); 



trữ 

trong PTPER đăng ký. 

sptime này bao gồm các sự kiện đặc biệt so sánh giá trị là 

lưu trữ trong SEVTCMP đăng ký. 

config1 này chứa các parametersto được cấu hình trong 

PTCON đăng ký theo quy định dưới đây: 

Mô-đun PWM cho phép / vô hiệu hóa 

PWM_EN 

PWM_DIS 

Nhàn rỗi chế độ bật / tắt 

PWM_IDLE_STOP 

PWM_IDLE_CON 

Sản lượng bài rỉ chọn 

PWM_OP_SCALE1 

PWM_OP_SCALE2 

..... 

PWM_OP_SCALE15 


Đầu vào prescaler chọn 

PWM_IPCLK_SCALE1 




ConfigIntMCPWM (Tiếp theo) 



Chế độ PWM hoạt động 

PWM_MOD_FREE 

PWM_MOD_SING 

PWM_MOD_UPDN 

PWM_MOD_DBL 


PWMCON1 đăng ký theo quy định dưới đây: 

PWM I / O pin cặp 

PWM_MOD4_COMP 

PWM_MOD3_COMP 

PWM_MOD2_COMP 

PWM_MOD1_COMP 

PWM_MOD4_IND

Remarks: This function disables the Motor control PWM module and clears the 

PWM, Fault A and Fault B Interrupt Enable and Flag bits. 

This function also clears the PTCON, PWMCON1 and PWMCON2 

registers. 

Source File: CloseMCPWM.c 

Code Example: CloseMCPWM(); 

ConfigIntMCPWM 

Description: This function configures the PWM Interrupts. 


Prototype: void ConfigIntMCPWM(unsigned int config); 

Arguments: config PWM interrupt priority and enable/disable information as 


PWM Interrupt enable/disable 

PWM_INT_EN 

PWM_INT_DIS 

PWM Interrupt priority 

PWM_INT_PR0 

PWM_INT_PR1 

PWM_INT_PR2 

PWM_INT_PR3 

PWM_INT_PR4 

PWM_INT_PR5 

PWM_INT_PR6 

PWM_INT_PR7 

Fault A Interrupt enable/disable 

PWM_FLTA_EN_INT 

PWM_FLTA_DIS_INT 

Fault A Interrupt priority 









Fault B Interrupt enable/disable 

PWM_FLTB_EN_INT 

PWM_FLTB_DIS_INT 

PWM_MOD3_IND 

PWM_MOD2_IND 

PWM_MOD1_IND 

PWM H / LI / O cho phép / vô hiệu hóa chọn 

PWM_PEN4H 

PWM_PDIS4H 

PWM_PEN3H 

PWM_PDIS3H 

PWM_PEN2H 

PWM_PDIS2H 

PWM_PEN1H 

PWM_PDIS1H 

PWM_PEN4L 

PWM_PDIS4L 

PWM_PEN3L 

PWM_PDIS3L 

PWM_PEN2L 

PWM_PDIS2L 

PWM_PEN1L 

PWM_PDIS1L 

Bit xác định liên quan đến PWM4 chỉ có sẵn cho một số 

thiết bị và các bảng dữ liệu phù hợp nên được chuyển đến. 


PWMCON2 đăng ký theo quy định dưới đây: 

Sự kiện đặc biệt bài rỉ 

PWM_SEVOPS1 

PWM_SEVOPS2 

..... 

PWM_SEVOPS15 

PWM_SEVOPS16 

Đầu ra đồng bộ hóa Override chọn 

PWM_OSYNC_PWM 

PWM_OSYNC_Tcy 

Cập nhật PWM cho phép / vô hiệu hóa 

PWM_UDIS 

PWM_UEN 


Ghi chú: Chức năng này cấu hình PTPER, SEVTCMP, PTCON, PWMCON1 

và PWMCON2 đăng ký.

dsPIC 

® 


DS51456B-page 172 

Fault B Interrupt priority 












and 


Source File: ConfigIntMCPWM.c 

Code Example: ConfigIntMCPWM(PWM_INT_EN & PWM_INT_PR5 & 

PWM_FLTA_EN_INT & 

PWM_FLTA_INT_PR6 & 

PWM_FLTB_EN_INT & 

PWM_FLTB_INT_PR7); 

OpenMCPWM 

Description: This function configure the motor control PWM module. 


Prototype: void OpenMCPWM(unsigned int period, 

unsigned int sptime, 




Arguments: period This contains the PWM timebase period value to be stored 

in PTPER register. 

sptime This contains the special event compare value to be 

stored in SEVTCMP register. 

config1 This contains the parametersto be configured in the 

PTCON register as defined below: 

PWM module enable/disable 

PWM_EN 

OpenMCPWM (Tiếp theo) 

dsPIC 

® 



Source File: OpenMCPWM.c 

Mã số Ví dụ: giai đoạn = 0x7fff; 

sptime = 0x0; 

config1 = PWM_EN & PWM_PTSIDL_DIS & 

PWM_OP_SCALE16 & 

PWM_IPCLK_SCALE16 & 

PWM_MOD_UPDN; 

config2 = PWM_MOD1_COMP & PWM_PDIS4H & 

PWM_PDIS3H & PWM_PDIS2H & 

PWM_PEN1H & PWM_PDIS4L & 

PWM_PDIS3L & PWM_PDIS2L & 

PWM_PEN1L; 

config3 = PWM_SEVOPS1 & PWM_OSYNC_PWM & 

PWM_UEN; 

OpenMCPWM (thời gian, sptime, config1, 

config2, config3); 

OverrideMCPWM 

Mô tả: Chức năng này cấu hình đăng ký OVDCON. 


Prototype: void OverrideMCPWM (int config); 

Đối số: cấu hình này chứa các parametersto được cấu hình trong 

OVDCON đăng ký theo quy định dưới đây: 

Đầu ra điều khiển bởi máy phát điện PWM 

PWM_GEN_4H 

PWM_GEN_3H 

PWM_GEN_2H 

PWM_GEN_1H 

PWM_GEN_4L 

PWM_GEN_3L 

PWM_GEN_2L 

PWM_GEN_1L 



Đầu ra điều khiển bởi bit Pout

PWM_DIS 

Idle mode enable/disable 

PWM_IDLE_STOP 

PWM_IDLE_CON 

Output post scaler select 

PWM_OP_SCALE1 

PWM_OP_SCALE2 

..... 



Input prescaler select 





ConfigIntMCPWM (Continued) 



PWM mode of operation 

PWM_MOD_FREE 

PWM_MOD_SING 

PWM_MOD_UPDN 

PWM_MOD_DBL 


PWMCON1 register as defined below: 

PWM I/O pin pair 

PWM_MOD4_COMP 

PWM_MOD3_COMP 

PWM_MOD2_COMP 

PWM_MOD1_COMP 

PWM_MOD4_IND 

PWM_MOD3_IND 

PWM_MOD2_IND 

PWM_MOD1_IND 

PWM H/L I/O enable/disable select 

PWM_PEN4H 

PWM_PDIS4H 

PWM_PEN3H 

PWM_PDIS3H 

PWM_POUT_4H 

PWM_POUT_4L 

PWM_POUT_3H 

PWM_POUT_3L 

PWM_POUT_2H 

PWM_POUT_2L 

PWM_POUT_1H 

PWM_POUT_1L 



OpenMCPWM (Tiếp theo) 



PWM bit tay ra 

PWM_POUT4H_ACT 

PWM_POUT4H_INACT 

PWM_POUT4L_ACT 

PWM_POUT4L_INACT 
















Bình luận: chức năng này cấu hình Override PWM đầu ra và hướng dẫn sử dụn 

Bit kiểm soát đăng ký OVDCON. 

Source File: OverrideMCPWM.c 

Mã số Ví dụ: config = PWM_GEN_1L & 

PWM_GEN_1H & 

PWM_POUT1L_INACT &

PWM_PEN2H 

PWM_PDIS2H 

PWM_PEN1H 

PWM_PDIS1H 

PWM_PEN4L 

PWM_PDIS4L 

PWM_PEN3L 

PWM_PDIS3L 

PWM_PEN2L 

PWM_PDIS2L 

PWM_PEN1L 

PWM_PDIS1L 

Bit defines related to PWM4 is available only for certain 

devices and the suitable data sheet should be referred to. 


PWMCON2 register as defined below: 

Special event post scaler 

PWM_SEVOPS1 

PWM_SEVOPS2 

..... 

PWM_SEVOPS15 

PWM_SEVOPS16 

Output Override synchronization select 

PWM_OSYNC_PWM 

PWM_OSYNC_Tcy 

PWM update enable/disable 

PWM_UDIS 

PWM_UEN 


Remarks: This function configures the PTPER, SEVTCMP, PTCON, 

PWMCON1 

and PWMCON2 registers. 

OpenMCPWM (Continued) 

dsPIC 

® 


PWM_POUT3L_INACT; 

OverrideMCPWM (config); 

SetDCMCPWM 

Mô tả: Chức năng này cấu hình đăng ký Chu kỳ và cập nhật của PWM 

Cập nhật Disable 'bit inthe PWMCON2 đăng ký. 


Prototype: void SetDCMCPWM ( 

int dutycyclereg, 

int dutycycle, 

char updatedisable); 

Đối số: dutycycleregThis là con trỏ đến đăng ký Chu kỳ. 

dutycycle Đây là giá trị được lưu trữ trong sổ đăng ký Chu kỳ. 

updatedisable Đây là giá trị được nạp vào 'Cập nhật 

Vô hiệu hoá 'bit của thanh ghi PWMCON2. 



Source File: SetDCMCPWM.c 

Mã số Ví dụ: dutycyclereg = 1; 

dutycycle = 0xFFF; 

updatedisable = 0; 

SetDCMCPWM (dutycyclereg, dutycycle, updatedisable); 

OverrideMCPWM (Tiếp theo) 

dsPIC 

® 



SetMCPWMDeadTimeAssignment 

Mô tả: Chức năng này cấu hình giao các đơn vị thời gian chết để PWM 

cặp đầu ra. 


Prototype: void SetMCPWMDeadTimeAssignment (int 

config); 


DTCON2 đăng ký theo quy định dưới đây: 

Dead Thời gian Chọn bit cho tín hiệu PWM4 

PWM_DTS4A_UA 

DS51456B-page 174 


PWM_DTS4A_UB 

Source File: OpenMCPWM.c 

Code Example: period = 0x7fff; 

PWM_DTS4I_UA 

PWM_DTS4I_UB

sptime = 0x0; 

config1 = PWM_EN & PWM_PTSIDL_DIS & 

PWM_OP_SCALE16 & 

PWM_IPCLK_SCALE16 & 

PWM_MOD_UPDN; 

config2 = PWM_MOD1_COMP & PWM_PDIS4H & 

PWM_PDIS3H & PWM_PDIS2H & 

PWM_PEN1H & PWM_PDIS4L & 

PWM_PDIS3L & PWM_PDIS2L & 

PWM_PEN1L; 

config3 = PWM_SEVOPS1 & PWM_OSYNC_PWM & 

PWM_UEN; 

OpenMCPWM(period, sptime, config1, 

config2, config3); 

OverrideMCPWM 

Description: This function configures the OVDCON register. 


Prototype: void OverrideMCPWM(unsigned int config); 

Arguments: config This contains the parametersto be configured in the 

OVDCON register as defined below: 

Output controlled by PWM generator 

PWM_GEN_4H 

PWM_GEN_3H 

PWM_GEN_2H 

PWM_GEN_1H 

PWM_GEN_4L 

PWM_GEN_3L 

PWM_GEN_2L 

PWM_GEN_1L 



Output controlled by POUT bits 

PWM_POUT_4H 

PWM_POUT_4L 

PWM_POUT_3H 

PWM_POUT_3L 

PWM_POUT_2H 

PWM_POUT_2L 

PWM_POUT_1H 




PWM_DTS3A_UA 

PWM_DTS3A_UB 

PWM_DTS3I_UA 

PWM_DTS3I_UB 


PWM_DTS2A_UA 

PWM_DTS2A_UB 

PWM_DTS2I_UA 

PWM_DTS2I_UB 

Dead Thời gian Chọn bit cho tín hiệu pwm1 

PWM_DTS1A_UA 

PWM_DTS1A_UB 

PWM_DTS1I_UA 

PWM_DTS1I_UB 



Source File: SetMCPWMDeadTimeAssignment.c 

Mã số Ví dụ: SetMCPWMDeadTimeAssignment (PWM_DTS3A_UA & 

PWM_DTS2I_UA & PWM_DTS1I_UA); 



SetMCPWMDeadTimeGeneration 

Mô tả: Chức năng này cấu hình các giá trị thời gian chết và prescalers đồng hồ. 


Prototype: void SetMCPWMDeadTimeGeneration ( 

int config); 

Đối số: cấu hình này bao gồm các thông số phải được cấu hình trong DTCON1 


Dead Thời gian Đơn vị B prescale Chọn bit 

PWM_DTBPS8 

PWM_DTBPS4 

PWM_DTBPS2 

PWM_DTBPS1 

Dead Thời gian Đơn vị A prescale Chọn hằng số 

PWM_DTA0 

PWM_DTA1

PWM_POUT_1L 



OpenMCPWM (Continued) 



PWM Manual Output bits 




















Remarks: This functions configures the PWM Output Override and Manual 

Control bits of the OVDCON register. 

Source File: OverrideMCPWM.c 

Code Example: config = PWM_GEN_1L & 

PWM_GEN_1H & 

PWM_POUT1L_INACT & 

PWM_POUT3L_INACT; 

OverrideMCPWM(config); 

SetDCMCPWM 

Description: This function configures the Duty Cycle register and updates the 

‘PWM 

Update Disable’ bit inthe PWMCON2 register. 


PWM_DTA2 

.......... 

PWM_DTA62 

PWM_DTA63 

Dead Thời gian Đơn vị B prescale Chọn hằng số 

PWM_DTB0 

PWM_DTB1 

PWM_DTB2 

.......... 

PWM_DTB62 

PWM_DTB63 

Dead Thời gian Đơn vị A prescale Chọn bit 

PWM_DTAPS8 

PWM_DTAPS4 

PWM_DTAPS2 

PWM_DTAPS1 



Source File: SetMCPWMDeadTimeGeneration.c 

Mã số Ví dụ: SetMCPWMDeadTimeGeneration (PWM_DTBPS16 & 

PWM_DT54 & PWM_DTAPS8); 

dsPIC 

® 



SetMCPWMFaultA 

Mô tả: Chức năng này cấu hình Lỗi Một bit Override, Lỗi Một chút Mode và 

Một lỗi đầu vào Enable bit PWM. 


Prototype: void SetMCPWMFaultA (int config); 


FLTACON đăng ký theo quy định dưới đây: 

Lỗi đầu vào PWM bit Override Giá trị 

PWM_OVA4H_ACTIVE 




PWM_OVA4L_ACTIVE 

PWM_OVA3L_ACTIVE

Prototype: void SetDCMCPWM( 

unsigned int dutycyclereg, 

unsigned int dutycycle, 

char updatedisable); 

Arguments: dutycycleregThis is the pointer to the Duty Cycle register. 

dutycycle This is the value to be stored in the Duty Cycle register. 

updatedisable This is the value to be loaded into the ‘Update 

Disable’ bit of the PWMCON2 register. 


Remarks: None 

Source File: SetDCMCPWM.c 

Code Example: dutycyclereg = 1; 

dutycycle = 0xFFF; 


SetDCMCPWM(dutycyclereg, dutycycle,updatedisable); 

OverrideMCPWM (Continued) 

dsPIC 

® 


DS51456B-page 176 

SetMCPWMDeadTimeAssignment 


Description: This function configures the assignment of dead time units to 

PWM 

output pairs. 


Prototype: void SetMCPWMDeadTimeAssignment (unsigned int 

config); 


DTCON2 register as defined below: 

Dead Time Select bits for PWM4 signal 

PWM_DTS4A_UA 

PWM_DTS4A_UB 

PWM_DTS4I_UA 

PWM_DTS4I_UB 




PWM_DTS3A_UA 

PWM_DTS3A_UB 



PWM_OVA4H_INACTIVE 




PWM_OVA4L_INACTIVE 






Lỗi Một chút chế độ 

PWM_FLTA_MODE_CYCLE 

PWM_FLTA_MODE_LATCH 

Một lỗi đầu vào Enable bit. 

PWM_FLTA4_EN 

PWM_FLTA4_DIS 

PWM_FLTA3_EN 

PWM_FLTA3_DIS 

PWM_FLTA2_EN 

PWM_FLTA2_DIS 

PWM_FLTA1_EN 

PWM_FLTA1_DIS 





Source File: SetMCPWMFaultA.c 

Mã số Ví dụ: SetMCPWMFaultA (PWM_OVA3L_INACTIVE & 

PWM_FLTA_MODE_LATCH & 

PWM_FLTA1_DIS); 



SetMCPWMFaultB 

Mô tả: Chức năng này cấu hình bit Override lỗi B, chế độ lỗi bit và B 

Lỗi InputB Enable bit PWM. 


Prototype: void SetMCPWMFaultB (int config);

PWM_DTS3I_UA 

PWM_DTS3I_UB 


PWM_DTS2A_UA 

PWM_DTS2A_UB 

PWM_DTS2I_UA 

PWM_DTS2I_UB 


PWM_DTS1A_UA 

PWM_DTS1A_UB 

PWM_DTS1I_UA 

PWM_DTS1I_UB 


Remarks: None 

Source File: SetMCPWMDeadTimeAssignment.c 

Code Example: SetMCPWMDeadTimeAssignment(PWM_DTS3A_UA & 

PWM_DTS2I_UA & PWM_DTS1I_UA); 



SetMCPWMDeadTimeGeneration 

Description: This function configures dead time values and clock prescalers. 


Prototype: void SetMCPWMDeadTimeGeneration( 



DTCON1 


Dead Time Unit B Prescale Select bits 

PWM_DTBPS8 

PWM_DTBPS4 

PWM_DTBPS2 

PWM_DTBPS1 

Dead Time Unit A Prescale Select constants 

PWM_DTA0 

PWM_DTA1 

PWM_DTA2 

.......... 

PWM_DTA62 

PWM_DTA63 


FLTBCON đăng ký theo quy định dưới đây: 

FLTBCON đăng ký chỉ có sẵn cho các thiết bị nhất định và 

các bảng dữ liệu phù hợp nên được chuyển đến. 

Lỗi B PWM Override bit Giá trị đầu vào 

PWM_OVB4H_ACTIVE 




PWM_OVB4L_ACTIVE 




PWM_OVB4H_INACTIVE 




PWM_OVB4L_INACTIVE 




Lỗi B Chế độ bit 

PWM_FLTB_MODE_CYCLE 

PWM_FLTB_MODE_LATCH 

Lỗi đầu vào B Enable bit. 

PWM_FLTB4_EN 

PWM_FLTB4_DIS 

PWM_FLTB3_EN 

PWM_FLTB3_DIS 

PWM_FLTB2_EN 

PWM_FLTB2_DIS 

PWM_FLTB1_EN 

PWM_FLTB1_DIS 



Source File: SetMCPWMFaultB.c 

Mã số Ví dụ: SetMCPWMFaultB (PWM_OVB3L_INACTIVE & 

PWM_FLTB_MODE_LATCH & 

PWM_FLTB2_DIS);

Dead Time Unit B Prescale Select constants 

PWM_DTB0 

PWM_DTB1 

PWM_DTB2 

.......... 

PWM_DTB62 

PWM_DTB63 

Dead Time Unit A Prescale Select bits 

PWM_DTAPS8 

PWM_DTAPS4 

PWM_DTAPS2 

PWM_DTAPS1 


Remarks: None 

Source File: SetMCPWMDeadTimeGeneration.c 

Code Example: SetMCPWMDeadTimeGeneration(PWM_DTBPS16 & 

PWM_DT54 & PWM_DTAPS8); 

dsPIC 

® 


DS51456B-page 178 

SetMCPWMFaultA 


Description: This function configures Fault A Override bits, Fault A Mode bit 

and 

Fault Input A Enable bits of PWM. 


Prototype: void SetMCPWMFaultA(unsigned int config); 


FLTACON register as defined below: 

Fault Input A PWM Override Value bits 










dsPIC 

® 




EnableIntMCPWM 


Mô tả: Phần này cho phép các PWM gián đoạn. 



Bình luận: Đây bộ vĩ mô PWM Enablebit ngắt của ngắt Kích hoạt tính năng 

kiểm soát 

đăng ký. 

Mã số Ví dụ: EnableIntMCPWM; 

DisableIntMCPWM 

Mô tả: vĩ mô này vô hiệu hóa các PWM gián đoạn. 



Bình luận: vĩ mô này sẽ xóa PWM Interrupt Enable bit Interrupt Enable kiểm 

soát 

đăng ký. 

Mã số Ví dụ: DisableIntMCPWM; 

SetPriorityIntMCPWM 

Mô tả: Điều này đặt ra ưu tiên vĩ mô cho PWM gián đoạn. 



Bình luận: vĩ mô này đặt PWM ngắt bit ưu tiên của ngắt ưu tiên kiểm soát 

đăng ký. 

Mã số Ví dụ: SetPriorityIntMCPWM (7); 

EnableIntFLTA 

Mô tả: vĩ mô này cho phép ngắt FLTA. 



Bình luận: Đây bộ vĩ mô FLTA Interrupt Enable bit Interrupt Enable kiểm soát 

đăng ký. 

Mã số Ví dụ: EnableIntFLTA; 

DisableIntFLTA 

Mô tả: vĩ mô này vô hiệu hóa ngắt FLTA. 



Bình luận: vĩ mô này sẽ xóa FLTA Interrupt Enable bit Interrupt Enable kiểm 

soát










Fault A Mode bit 

PWM_FLTA_MODE_CYCLE 

PWM_FLTA_MODE_LATCH 

Fault Input A Enable bits. 

PWM_FLTA4_EN 

PWM_FLTA4_DIS 

PWM_FLTA3_EN 

PWM_FLTA3_DIS 

PWM_FLTA2_EN 

PWM_FLTA2_DIS 

PWM_FLTA1_EN 

PWM_FLTA1_DIS 




Remarks: None 

Source File: SetMCPWMFaultA.c 

Code Example: SetMCPWMFaultA(PWM_OVA3L_INACTIVE & 

PWM_FLTA_MODE_LATCH & 

PWM_FLTA1_DIS); 



SetMCPWMFaultB 

Description: This function configures Fault B Override bits, Fault B Mode bit 

and 

Fault InputB Enable bits of PWM. 


đăng ký. 

Mã số Ví dụ: DisableIntFLTA; 



SetPriorityIntFLTA 

Mô tả: Đây ưu tiên bộ vĩ mô cho FLTA bị gián đoạn. 



Bình luận: Đây bộ vĩ mô FLTA Prioritybits ngắt của ngắt ưu tiên kiểm soát 

đăng ký. 

Mã số Ví dụ: SetPriorityIntFLTA (7); 

EnableIntFLTB 

Mô tả: vĩ mô này cho phép ngắt FLTB. 



Bình luận: Đây bộ vĩ mô FLTB Enablebit ngắt của ngắt Kích hoạt tính năng 

kiểm soát 

đăng ký. 

Mã số Ví dụ: EnableIntFLTB; 

DisableIntFLTB 

Mô tả: vĩ mô này vô hiệu hóa ngắt FLTB. 



Bình luận: vĩ mô này sẽ xóa FLTB Interrupt Enable bit Interrupt Enable kiểm 

soát 

đăng ký. 

Mã số Ví dụ: DisableIntFLTB; 

SetPriorityIntFLTB 

Mô tả: Đây ưu tiên bộ vĩ mô cho FLTB bị gián đoạn. 



Bình luận: Đây bộ vĩ mô FLTB Prioritybits ngắt của ngắt ưu tiên kiểm soát 

đăng ký. 

Mã số Ví dụ: SetPriorityIntFLTB (1); 

dsPIC 

® 


Prototype: void SetMCPWMFaultB(unsigned int config); 





FLTBCON register as defined below: 

# xác định __dsPIC30F6010__

FLTBCON register is available only for certain devices and 

the suitable data sheet should be referred to. 

Fault Input B PWM Override Value bits 

















Fault B Mode bit 

PWM_FLTB_MODE_CYCLE 

PWM_FLTB_MODE_LATCH 

Fault Input B Enable bits. 

PWM_FLTB4_EN 

PWM_FLTB4_DIS 

PWM_FLTB3_EN 

PWM_FLTB3_DIS 

PWM_FLTB2_EN 

PWM_FLTB2_DIS 

PWM_FLTB1_EN 

PWM_FLTB1_DIS 


Remarks: None 

Source File: SetMCPWMFaultB.c 

Code Example: SetMCPWMFaultB(PWM_OVB3L_INACTIVE & 

PWM_FLTB_MODE_LATCH & 

PWM_FLTB2_DIS); 

dsPIC 

® 

# include 

# include 

khoảng trống __attribute __ ((__ interrupt__)) _PWMInterrupt (void) 

{ 

IFS2bits.PWMIF = 0; 

} 

int main () 

{ 

/ * Giữ PWM giá trị cấu hình ngắt * / 

int cấu hình; 

/ * Giữ giá trị beloaded vào dutycycle đăng ký * / 

giai đoạn int unsigned; 

/ * Giữ giá trị được nạp vào sự kiện đặc biệt so sánh đăng ký * / 

int sptime; 

/ * Giữ giá trị cấu hình PWM * / 

int config1; 

/ * Giữ giá trị được nạp vào PWMCON1 đăng ký * / 

int config2; 

/ * Giữ giá trị cấu hình kích hoạt specialevent 

postscale và dutycycle * / 

int config3; 

/ * Giá trị của 'dutycyclereg' xác định chu kỳ nhiệm vụ 

register (PDCx) được viết * / 

int dutycyclereg; 

int dutycycle; 

unsigned char updatedisable; 

/ * Cấu hình PWM gián đoạn cho phép / vô hiệu hóa và thiết lập ngắt 

priorties * / 

config = (PWM_INT_EN & PWM_FLTA_DIS_INT & PWM_INT_PR1 

& PWM_FLTA_INT_PR0 

& PWM_FLTB_DIS_INT & PWM_FLTB_INT_PR0); 

ConfigIntMCPWM (config); 

/ * Cấu hình PWM để tạo ra sóng vuông of50% chu kỳ * / 

dutycyclereg = 1; 

dutycycle = 0x3FFF; 


SetDCMCPWM (dutycyclereg, dutycycle, updatedisable); 

thời gian = 0x7fff; 

sptime = 0x0;


DS51456B-page 180 


EnableIntMCPWM 


Description: This macro enables the PWM interrupt. 



Remarks: This macro sets PWM Interrupt Enablebit of Interrupt Enable Control 

register. 

Code Example: EnableIntMCPWM; 

DisableIntMCPWM 

Description: This macro disables the PWM interrupt. 



Remarks: This macro clears PWM Interrupt Enable bit of Interrupt Enable 

Control 

register. 

Code Example: DisableIntMCPWM; 

SetPriorityIntMCPWM 

Description: This macro sets priority for PWM interrupt. 



Remarks: This macro sets PWM Interrupt Priority bits of Interrupt Priority 

Control 

register. 

Code Example: SetPriorityIntMCPWM(7); 

EnableIntFLTA 

Description: This macro enables the FLTA interrupt. 



Remarks: This macro sets FLTA Interrupt Enable bit of Interrupt Enable 

Control 

register. 

Code Example: EnableIntFLTA; 

DisableIntFLTA 

Description: This macro disables the FLTA interrupt. 



Remarks: This macro clears FLTA Interrupt Enable bit of Interrupt Enable 

Control 

register. 

config1 = (PWM_EN & PWM_PTSIDL_DIS & PWM_OP_SCALE16 

& PWM_IPCLK_SCALE16 & 

PWM_MOD_UPDN); 

config2 = (PWM_MOD1_COMP & PWM_PDIS4H & PWM_PDIS3H & 

PWM_PDIS2H & PWM_PEN1H & PWM_PDIS4L & 

PWM_PDIS3L & PWM_PDIS2L & PWM_PEN1L); 

config3 = (PWM_SEVOPS1 & PWM_OSYNC_PWM & PWM_UEN); 

OpenMCPWM (thời gian, sptime, config1, config2, config3); 

trong khi (1); 

} 



3.17 Tôi 

2 

C chức năng 

Phần này bao gồm một danh sách các chức năng cá nhân cho tôi 

2 

C module và một ví dụ về sử dụng 

các chức năng. Chức năng có thể được thực hiện như các macro. 


CloseI2C 

Mô tả: Chức năng này sẽ tắt thei 

2 

Cmodule 

Bao gồm: i2c.h 

Prototype: void CloseI2C (void); 



Bình luận: Chức năng này vô hiệu hóa tôi 

2 

Cmodule và xóa Master và Slave 

Ngắt Enable và bit cờ. 

Source File: CloseI2C.c 

Mã số Ví dụ: CloseI2C (); 

ConfigIntI2C 

Mô tả: Chức năng này Cấu hình tôi 

2 

CInterrupt. 

Bao gồm: i2c.h

Code Example: DisableIntFLTA; 



SetPriorityIntFLTA 

Description: This macro sets priority for FLTA interrupt. 



Remarks: This macro sets FLTA Interrupt Prioritybits of Interrupt Priority 

Control 

register. 

Code Example: SetPriorityIntFLTA(7); 

EnableIntFLTB 

Description: This macro enables the FLTB interrupt. 



Remarks: This macro sets FLTB Interrupt Enablebit of Interrupt Enable Control 

register. 

Code Example: EnableIntFLTB; 

DisableIntFLTB 

Description: This macro disables the FLTB interrupt. 



Remarks: This macro clears FLTB Interrupt Enable bit of Interrupt Enable 

Control 

register. 

Code Example: DisableIntFLTB; 

SetPriorityIntFLTB 

Description: This macro sets priority for FLTB interrupt. 



Remarks: This macro sets FLTB Interrupt Prioritybits of Interrupt Priority 

Control 

register. 

Code Example: SetPriorityIntFLTB(1); 

dsPIC 

® 


DS51456B-page 182 




Prototype: void ConfigIntI2C (int config); 

Lập luận: config tôi 

2 

Ưu tiên Cinterrupt và bật / tắt thông tin 


Tôi 

2 

Cmaster ngắt bật / tắt 

MI2C_INT_ON 

MI2C_INT_OFF 

I2C nô lệ ngắt bật / tắt 

SI2C_INT_ON 

SI2C_INT_OFF 

Tôi 

2 

Ưu tiên Cmaster ngắt 

MI2C_INT_PRI_7 








Tôi 

2 

Ưu tiên Cslave ngắt 

SI2C_INT_PRI_7 









dsPIC 

® 


#include 

#include 

void __attribute__((__interrupt__)) _PWMInterrupt(void) 

{ 

IFS2bits.PWMIF = 0; 

} 

int main() 

{ 

/* Holds the PWM interrupt configuration value*/ 

unsigned int config; 

/* Holds the value to beloaded into dutycycle register */ 

unsigned int period; 

/* Holds the value to be loaded into special event compare register */ 

unsigned int sptime; 

/* Holds PWM configuration value */ 

unsigned int config1; 

/* Holds the value be loaded into PWMCON1 register */ 


/* Holds the value to configure the specialevent trigger 

postscale and dutycycle */ 


/* The value of ‘dutycyclereg’ determines the duty cycle 

register(PDCx)to be written */ 

unsigned int dutycyclereg; 

unsigned int dutycycle; 

unsigned char updatedisable; 

/* Configure pwm interrupt enable/disable and set interrupt 

priorties */ 

config = (PWM_INT_EN & PWM_FLTA_DIS_INT & PWM_INT_PR1 

& PWM_FLTA_INT_PR0 

& PWM_FLTB_DIS_INT & PWM_FLTB_INT_PR0); 

ConfigIntMCPWM( config ); 

/* Configure PWM to generate square wave of50% duty cycle */ 

dutycyclereg = 1; 

dutycycle = 0x3FFF; 


SetDCMCPWM(dutycyclereg,dutycycle,updatedisable); 

period = 0x7fff; 

sptime = 0x0; 



Bình luận: chức năng này sẽ xóa các bit Cờ ngắt, thiết lập các ưu tiên của ngắt 

chủ và nô lệ và cho phép / vô hiệu hóa ngắt. 

Source File: ConfigIntI2C.c 

Mã số Ví dụ: ConfigIntI2C (MI2C_INT_ON & MI2C_INT_PRI_3 

& SI2C_INT_ON & SI2C_INT_PRI_5); 

AckI2C 

Mô tả: Tạo ra tôi 

2 

Cbus Thừa nhận điều kiện. 


Prototype: void AckI2C (void); 



Bình luận: Chức năng này tạo ra một tôi 

2 

Cbus Thừa nhận điều kiện. 

Source File: AckI2C.c 

Mã số Ví dụ: AckI2C (); 

DataRdyI2C 

Mô tả: Chức năng này cung cấp cho tình trạng trở lại cho người dùng nếu 

I2CRCV register chứa 

dữ liệu. 


Prototype: unsigned char DataRdyI2C (void); 


Giá trị trả lại chức năng này trả về "1" nếu có dữ liệu trong I2CRCV đăng 

ký; khác trở về 

"0" mà chỉ có dữ liệu trong I2CRCV đăng ký. 

Bình luận: Chức năng này xác định xem liệu có bất kỳ byte để đọc từ I2CRCV 

đăng ký. 

Source File: DataRdyI2C.c 

Mã số Ví dụ: if (DataRdyI2C ()); 

IdleI2C 

Mô tả: Đây tình trạng chức năng generatesWait cho đến khi tôi 

2 

Cbus là nhàn rỗi 


Prototype: void IdleI2C (void); 

Lập luận: Không

config1 = (PWM_EN & PWM_PTSIDL_DIS & PWM_OP_SCALE16 

& PWM_IPCLK_SCALE16 & 

PWM_MOD_UPDN); 

config2 = (PWM_MOD1_COMP & PWM_PDIS4H & PWM_PDIS3H & 

PWM_PDIS2H & PWM_PEN1H& PWM_PDIS4L & 

PWM_PDIS3L & PWM_PDIS2L & PWM_PEN1L); 

config3 = (PWM_SEVOPS1& PWM_OSYNC_PWM & PWM_UEN); 

OpenMCPWM(period,sptime,config1,config2,config3); 

while(1); 

} 



3.17 I 

2 

C FUNCTIONS 

This section contains a list of individual functions for I 

2 

C module and an example of use 

of the functions. Functions may be implemented as macros. 


CloseI2C 

Description: This function turns off theI 

2 

Cmodule 

Include: i2c.h 

Prototype: void CloseI2C(void); 



Remarks: This function disables the I 

2 

Cmodule and clears the Master and Slave 

Interrupt Enable and Flag bits. 

Source File: CloseI2C.c 

Code Example: CloseI2C(); 

ConfigIntI2C 

Description: This function Configure the I 

2 

CInterrupt. 



Ghi chú: Chức năng này sẽ ở trong trạng thái chờ đợi cho đến khi bắt đầu Điều 

kiện Kích hoạt bit, Stop 

Điều kiện Enable bit, Nhận Kích hoạt bit, Thừa nhận trình tự 

Bit cho phép của tôi 

2 

CControl đăng ký và Truyền Tình trạng bit tôi 

2 

CStatus 

đăng ký rõ ràng. Chức năng IdleI2C được yêu cầu kể từ khi phần cứng 

Tôi 

2 

Cperipheral không cho phép spooling của dãy xe buýt. I 

2 

C 

thiết bị ngoại vi phải ở trạng thái nhàn rỗi trước khi tôi 

2 

Coperation có thể được bắt đầu 

hoặc viết va chạm sẽ được tạo ra. 

Source File: IdleI2C.c 

Mã số Ví dụ: IdleI2C (); 

ConfigIntI2C (Tiếp theo) 



MastergetsI2C 

Mô tả: Chức năng này lần đọc dữ liệu định trước chuỗi dài từ tôi 

2 

Cbus. 


Prototype: unsigned int MastergetsI2C (unsigned int dài, 

unsigned char * rdptr, int i2c_data_wait); 

Đối số: chiều dài Số byte để đọc từ tôi 

2 

Cdevice. 

rdptr loại nhân vật con trỏ tới dsPIC ram cho lưu trữ dữ liệu 

đọc từ tôi 

2 

Cdevice 

i2c_data_wait Đây là số thời gian chờ cho các mô-đun có 

chờ đợi trước khi trở về.

Prototype: void ConfigIntI2C(unsigned int config); 

Arguments: config I 

2 

Cinterrupt priority and enable/disable information as 


I 

2 

Cmaster Interrupt enable/disable 

MI2C_INT_ON 

MI2C_INT_OFF 

I2C slave Interrupt enable/disable 

SI2C_INT_ON 

SI2C_INT_OFF 

I 

2 

Cmaster Interrupt priority 









I 

2 

Cslave Interrupt priority 










dsPIC 

® 


Nếu tính thời gian chờ là 'N', thời gian chờ thực tế sẽ 

khoảng (20 * N - 1) chu kỳ hướng dẫn. 

Giá trị trả lại chức năng này trả về "0" nếu tất cả các byte đã được gửi hoặc số 

byte 

đọc từ tôi 

2 

Cbus nếu nó không thể đọc được dữ liệu có trong các quy định 

i2c_data_waittime ra giá trị 

Bình luận: thói quen này đọc một chuỗi dữ liệu được xác định trước từ I 

2 

Cbus. 

Source File: MastergetsI2C.c 

Mã số Ví dụ: unsigned char string [10]; 

unsigned char * rdptr; 

chiều dài int unsigned, i2c_data_wait; 

chiều dài = 9; 

rdptr = chuỗi; 

i2c_data_wait = 152; 

MastergetsI2C (chiều dài, rdptr, i2c_data_wait); 

MasterputsI2C 

Mô tả: Chức năng này được sử dụng để viết ra một chuỗi dữ liệu cho tôi 

2 

Cbus. 


Nguyên mẫu: int MasterputsI2C (unsigned char * wrptr); 

Đối số: wrptr loại nhân vật con trỏ đến các đối tượng dữ liệu trong dsPIC 

Ram. Các 

đối tượng dữ liệu được ghi vào tôi 

2 

Cdevice. 

Trở lại giá trị chức năng này trả về -3 nếu viết va chạm occurred.This trở về 

chức năng 

"0" nếu các ký tự null đã đạt được trong chuỗi dữ liệu. 

Bình luận: Chức năng này ghi một chuỗi các tôi 

2 

Cbus cho đến khi một nhân vật null 

đạt được. Mỗi byte được viết thông qua một cuộc gọi đến MasterputcI2C 

chức năng. Cơ thể calledfunction thực tế được gọi là MasterWriteI2C. 

MasterWriteI2Cand MasterputcI2Crefer để cùng chức năng thông qua 

một #definestatement trong i2c.h 

Source File: MasterputsI2C.c

DS51456B-page 184 


Remarks: This function clears the Interrupt Flag bits, sets the interrupt priorities 

of 

master and slave and enables/disables the interrupt. 

Source File: ConfigIntI2C.c 

Code Example: ConfigIntI2C(MI2C_INT_ON& MI2C_INT_PRI_3 

& SI2C_INT_ON & SI2C_INT_PRI_5); 

Mã số Ví dụ: unsigned char string [] = "vi mạch"; 

unsigned char * wrptr; 

wrptr = chuỗi; 

MasterputsI2C (wrptr); 

dsPIC 

® 


AckI2C 

Description: Generates I 


MasterReadI2C 


2 

Cbus Acknowledge condition. 


Prototype: void AckI2C(void); 



Remarks: This function generates an I 

2 

Cbus Acknowledge condition. 

Source File: AckI2C.c 

Code Example: AckI2C(); 

DataRdyI2C 

Description: This function provides status back to user if I2CRCV register 

contain 

data. 


Prototype: unsigned char DataRdyI2C(void); 


Return Value This function returns ‘1’ if there is data in I2CRCV register; else 

return 

‘0’ which indicates no data in I2CRCV register. 

Remarks: This function Determines if there is any byte to read from I2CRCV 

register. 

Source File: DataRdyI2C.c 

Code Example: if(DataRdyI2C()); 

IdleI2C 

Description: This function generatesWait condition until I 

2 

Cbus is Idle 


Prototype: void IdleI2C(void); 

Mô tả: Chức năng này được sử dụng để đọc một byte duy nhất từ tôi 

2 

Cbus 


Prototype: unsigned char MasterReadI2C (void); 


Quay trở lại Giá trị Giá trị trả về là các byte dữ liệu đọc từ tôi 

2 

Cbus. 

Bình luận: Chức năng này lần đọc trong một byte duy nhất từ tôi 

2 

Cbus. 

Chức năng này thực hiện chức năng tương tự như MastergetcI2C. 

Source File: MasterReadI2C.c 

Mã số Ví dụ: giá trị unsigned char; 

giá trị = MasterReadI2C (); 

MasterWriteI2C 

Mô tả: Chức năng này được sử dụng để viết ra một byte dữ liệu duy nhất cho tô 

2 

Cdevice. 


Prototype: unsigned char MasterWriteI2C (unsigned char 

data_out); 

Đối số: data_out Một byte dữ liệu duy nhất để được ghi vào tôi 

2 

Thiết bị Cbus. 

Giá trị trả lại chức năng này trả về -1 nếu có một vụ va chạm khác viết nó trả về 

0. 

Ghi chú: Chức năng này viết ra một byte dữ liệu duy nhất cho tôi 

2 

Thiết bị Cbus. Điều này



Remarks: This function will be in a wait state until Start Condition Enable bit, 

Stop 

Condition Enable bit, Receive Enable bit, Acknowledge Sequence 

Enable bit of I 

2 

CControl register and Transmit Status bit I 

2 

CStatus 

register are clear. The IdleI2C function is required since the hardware 

I 

2 

Cperipheral does not allow for spooling of bus sequence. The I 

2 

C 

peripheral must be in Idle state before an I 

2 

Coperation can be initiated 

or write collision will be generated. 

Source File: IdleI2C.c 

Code Example: IdleI2C(); 

ConfigIntI2C (Continued) 



MastergetsI2C 

Description: This function reads predetermined data string length from the I 

2 

Cbus. 


Prototype: unsigned int MastergetsI2C(unsigned int length, 

unsigned char *rdptr, unsigned int i2c_data_wait); 

Arguments: length Number of bytes to read from I 

2 

Cdevice. 

rdptr Character type pointer to dsPIC ram for storage of data 

read from I 

2 

Cdevice 

chức năng thực hiện các chức năng tương tự như MasterputcI2C. 

Source File: MasterWriteI2C.c 

Mã số Ví dụ: MasterWriteI2C ('a'); 

NotAckI2C 


2 

Cbus Không Thừa nhận điều kiện. 


Prototype: void NotAckI2C (void); 




2 

Cbus Không Thừa nhận điều kiện. 

Source File: NotAckI2C.c 

Mã số Ví dụ: NotAckI2C (); 



OpenI2C 

Mô tả: Cấu hình tôi 

2 

Cmodule. 


Prototype: void OpenI2C (int config1, int 

config2); 

Đối số: config1 này chứa các tham số cấu hình I2CCON 

đăng ký 

Tôi 

2 

Bit CEnable 

I2C_ON 

I2C_OFF 

Tôi 

2 

CStop trong chế độ nhàn rỗi bit 

I2C_IDLE_STOP 

I2C_IDLE_CON 

SCL phát hành kiểm soát bit 

I2C_CLK_REL

i2c_data_wait This is the timeout count for which the module has 

to wait before return. 

If the timeout count is ‘N’, the actual timeout would 

be about (20*N - 1) instruction cycles. 

Return Value This function returns ‘0’ if all bytes have been sent or number of 

bytes 

read from I 

2 

Cbus if its not able to read the data with in the specified 

i2c_data_waittime out value 

Remarks: This routine reads a predefined data string from the I 

2 

Cbus. 

Source File: MastergetsI2C.c 

Code Example: unsigned char string[10]; 

unsigned char *rdptr; 

unsigned int length,i2c_data_wait; 

length = 9; 

rdptr = string; 

i2c_data_wait = 152; 

MastergetsI2C(length, rdptr, i2c_data_wait); 

MasterputsI2C 

Description: This function is used to write out a data string to the I 

2 

Cbus. 


Prototype: unsigned int MasterputsI2C(unsigned char *wrptr); 

Arguments: wrptr Character type pointer to data objects in dsPIC Ram. The 

data objects are written to the I 

2 

Cdevice. 

Return Value This function returns -3 if a write collision occurred.This function 

returns 

‘0’ if the null character was reached in data string. 

Remarks: This function writes a string to the I 

2 

Cbus until a null character is 

reached. Each byte is written via a call to the MasterputcI2C 

function. The actual calledfunction body is termed MasterWriteI2C. 

MasterWriteI2Cand MasterputcI2Crefer to the same function via 

I2C_CLK_HLD 

Giao diện quản lý thông minh ngoại vi Enable bit 

I2C_IPMI_EN 

I2C_IPMI_DIS 

10-bit Slave Địa chỉ bit 

I2C_10BIT_ADD 

I2C_7BIT_ADD 

Vô hiệu hóa xoay Tỷ lệ kiểm soát bit 

I2C_SLW_DIS 

I2C_SLW_EN 

SMBus bit Cấp độ đầu vào 

I2C_SM_EN 

I2C_SM_DIS 

Gọi chung Enable bit 

I2C_GCALL_EN 

I2C_GCALL_DIS 

SCL đồng hồ căng Enable bit 

I2C_STR_EN 

I2C_STR_DIS 

Thừa nhận bit dữ liệu 

I2C_ACK 

I2C_NACK 

Thừa nhận trình tự Enable bit 

I2C_ACK_EN 

I2C_ACK_DIS 

Nhận Kích hoạt bit 

I2C_RCV_EN 

I2C_RCV_DIS 

Dừng Điều kiện Enable bit 

I2C_STOP_EN 

I2C_STOP_DIS 

Bắt đầu lặp đi lặp lại Điều kiện Enable bit 

I2C_RESTART_EN 

I2C_RESTART_DIS 

Điều kiện bắt đầu Enable bit 

I2C_START_EN 

I2C_START_DIS 

config2 trị giá tính toán cho máy phát điện tốc độ truyền 

dsPIC

a #definestatement in the i2c.h 

Source File: MasterputsI2C.c 

Code Example: unsigned char string[] = “ MICROCHIP ”; 

unsigned char *wrptr; 

wrptr = string; 

MasterputsI2C( wrptr); 

dsPIC 

® 


DS51456B-page 186 

MasterReadI2C 


Description: This function is used to read a single byte from I 

2 

Cbus 


Prototype: unsigned char MasterReadI2C(void); 


Return Value The return value is the data byte read from the I 

2 

Cbus. 

Remarks: This function reads in a single byte from the I 

2 

Cbus. 

This function performs the same function as MastergetcI2C. 

Source File: MasterReadI2C.c 

Code Example: unsigned char value; 

value = MasterReadI2C(); 

MasterWriteI2C 

Description: This function is used to write out a single data byte to the I 

2 

Cdevice. 


Prototype: unsigned char MasterWriteI2C(unsigned char 

data_out); 

Arguments: data_out A single data byte to be written to the I 

2 

Cbus device. 

Return Value This function returns -1 if there was a write collision else it 

returns a 0. 

® 




Bình luận: Chức năng này cấu hình tôi 

2 

CControl đăng ký và tôi 

2 

CBaud Rate 

Máy phát điện đăng ký. 

Source File: OpenI2C.c 

Mã số Ví dụ: OpenI2C (); 

RestartI2C 


2 

CBUs Khởi động lại điều kiện. 


Prototype: void RestartI2C (void); 




2 

CBUs Khởi động lại điều kiện. 

Source File: RestartI2C.c 

Mã số Ví dụ: RestartI2C (); 

SlavegetsI2C 

Mô tả: Chức năng này lần đọc chuỗi dài trước determineddata từ I 

2 

Cbus. 


Nguyên mẫu: int SlavegetsI2C (unsigned char * rdptr, 

int i2c_data_wait); 

Đối số: rdptr loại nhân vật con trỏ tới dsPIC ram cho lưu trữ dữ liệu đọc 

từ I 

2 

Cdevice 

i2c_data_wait Đây là số thời gian chờ cho các mô-đun có 

chờ đợi trước khi trở về. 

Nếu tính thời gian chờ là 'N', thời gian chờ thực tế sẽ

Remarks: This function writes out a single data byte to the I 

2 

Cbus device. This 

function performs the same function as MasterputcI2C. 

Source File: MasterWriteI2C.c 

Code Example: MasterWriteI2C(‘a’); 

NotAckI2C 


2 

Cbus Not Acknowledge condition. 


Prototype: void NotAckI2C(void); 




2 

Cbus Not Acknowledge condition. 

Source File: NotAckI2C.c 

Code Example: NotAckI2C(); 



OpenI2C 

Description: Configures the I 

2 

Cmodule. 


Prototype: void OpenI2C(unsigned int config1, unsigned int 

config2); 

Arguments: config1 This contains the parameter to configure the I2CCON 

register 

I 

2 

CEnable bit 

I2C_ON 

I2C_OFF 

I 

2 

CStop in Idle Mode bit 

I2C_IDLE_STOP 

khoảng (20 * N - 1) chu kỳ hướng dẫn. 

Trở lại giá trị Trả về số byte nhận được từ tôi 

2 

Cbus. 

Bình luận: thói quen này đọc một chuỗi dữ liệu được xác định trước từ I 

2 

Cbus. 

Source File: SlavegetsI2C.c 

Mã số Ví dụ: unsigned char string [12]; 



i2c_data_out = 0x11; 

SlavegetsI2C (rdptr, i2c_data_wait); 

OpenI2C (Tiếp theo) 



SlaveputsI2C 

Mô tả: Chức năng này được sử dụng để viết ra một chuỗi dữ liệu cho tôi 

2 

Cbus. 


Nguyên mẫu: int SlaveputsI2C (unsigned char * wrptr); 

Đối số: wrptr loại nhân vật con trỏ đến các đối tượng dữ liệu trong dsPIC 

ram. Các 

đối tượng dữ liệu được ghi vào tôi 

2 

Cdevice. 

Giá trị trả lại chức năng này trả về "0" nếu nullcharacter đã đạt được trong các 

dữ liệu 

chuỗi. 

Bình luận: thói quen này ghi một chuỗi dữ liệu ra cho tôi 

2 

Cbus cho đến khi một ký tự null 

đạt được. 

Source File: SlaveputsI2C.c 

Mã số Ví dụ: unsigned char string [] = "vi mạch"; 



SlaveputsI2C (rdptr); 

SlaveReadI2C

I2C_IDLE_CON 

SCL Release Control bit 

I2C_CLK_REL 

I2C_CLK_HLD 

Intelligent Peripheral Management Interface Enable bit 

I2C_IPMI_EN 

I2C_IPMI_DIS 

10-bit Slave Address bit 

I2C_10BIT_ADD 

I2C_7BIT_ADD 

Disable Slew Rate Control bit 

I2C_SLW_DIS 

I2C_SLW_EN 

SMBus Input Level bits 

I2C_SM_EN 

I2C_SM_DIS 

General Call Enable bit 

I2C_GCALL_EN 

I2C_GCALL_DIS 

SCL Clock Stretch Enable bit 

I2C_STR_EN 

I2C_STR_DIS 

Acknowledge Data bit 

I2C_ACK 

I2C_NACK 

Acknowledge Sequence Enable bit 

I2C_ACK_EN 

I2C_ACK_DIS 

Receive Enable bit 

I2C_RCV_EN 

I2C_RCV_DIS 

Stop Condition Enable bit 

I2C_STOP_EN 

I2C_STOP_DIS 

Repeated Start Condition Enable bit 

I2C_RESTART_EN 

I2C_RESTART_DIS 

Start Condition Enable bit 

I2C_START_EN 

Mô tả: Chức năng này được sử dụng để đọc một byte duy nhất từ tôi 

2 

Cbus. 


Prototype: unsigned char SlaveReadI2C (void); 


Quay trở lại Giá trị Giá trị trả về là các byte dữ liệu đọc từ tôi 

2 

Cbus. 

Bình luận: Chức năng này lần đọc trong một byte duy nhất từ tôi 

2 

Cbus. Chức năng này 

thực hiện chức năng tương tự như SlavegetcI2C. 

Source File: SlaveReadI2C.c 

Mã số Ví dụ: giá trị unsigned char; 

giá trị = SlaveReadI2C (); 

SlaveWriteI2C 

Mô tả: Chức năng này được sử dụng để viết ra một byte duy nhất để tôi 

2 

Cbus. 


Prototype: void SlaveWriteI2C (unsigned char data_out); 

Đối số: data_out Một byte dữ liệu duy nhất để được ghi vào tôi 

2 

Thiết bị Cbus. 


Ghi chú: Chức năng này viết ra một byte dữ liệu duy nhất cho tôi 

2 

Thiết bị Cbus. Điều này 

chức năng thực hiện các chức năng tương tự như SlaveputcI2C. 

Source File: SlaveWriteI2C.c 

Mã số Ví dụ: SlaveWriteI2C ('a'); 

dsPIC 

® 




StartI2C 

Mô tả: Tạo ra tôi

I2C_START_DIS 

config2 computed value for the baud rate generator 

dsPIC 

® 




Remarks: This function configures the I 

2 

CControl register and I 

2 

CBaud Rate 

Generator register. 

Source File: OpenI2C.c 

Code Example: OpenI2C(); 

RestartI2C 


2 

CBus Restart condition. 


Prototype: void RestartI2C(void); 




2 

CBus Restart condition. 

Source File: RestartI2C.c 

Code Example: RestartI2C(); 

SlavegetsI2C 

Description: This function reads pre-determineddata string length from the I 

2 

Cbus. 


Prototype: unsigned int SlavegetsI2C(unsigned char *rdptr, 

unsigned int i2c_data_wait); 

Arguments: rdptr Character type pointer to dsPIC ram for storage of data read 

from I 

2 

Cdevice 

2 

CBUs Bắt đầu điều kiện. 


Prototype: void StartI2C (void); 




2 

CBUs Bắt đầu điều kiện. 

Source File: StartI2C.c 

Mã số Ví dụ: StartI2C (); 

StopI2C 


2 

CBUs Dừng điều kiện. 


Prototype: void StopI2C (void); 




2 

CBUs Dừng điều kiện. 

Source File: StopI2C.c 

Mã số Ví dụ: StopI2C (); 

EnableIntMI2C 

Mô tả: vĩ mô này cho phép chủ tôi 

2 

Cinterrupt. 



Bình luận: vĩ mô này đặt Thầy tôi 

2 

Bit CEnable của Interrupt Enable kiểm soát 

đăng ký. 

Mã số Ví dụ: EnableIntMI2C; 

DisableIntMI2C 

Mô tả: vĩ mô này vô hiệu hóa các chủ tôi 

2 

Cinterrupt.

i2c_data_wait This is the timeout count for which the module has 

to wait before return. 

If the timeout count is ‘N’, the actual timeout would 

be about (20*N - 1) instruction cycles. 

Return Value Returns the number of bytes received from the I 

2 

Cbus. 

Remarks: This routine reads a predefined data string from the I 

2 

Cbus. 

Source File: SlavegetsI2C.c 

Code Example: unsigned char string[12]; 


rdptr = string; 

i2c_data_out = 0x11; 

SlavegetsI2C(rdptr, i2c_data_wait); 

OpenI2C (Continued) 



SlaveputsI2C 

Description: This function is used to write out a data string to the I 

2 

Cbus. 


Prototype: unsigned int SlaveputsI2C(unsigned char *wrptr); 

Arguments: wrptr Character type pointer to data objects in dsPIC ram. The 

data objects are written to the I 

2 

Cdevice. 

Return Value This function returns ‘0’ if the nullcharacter was reached in the 

data 

string. 

Remarks: This routine writes a data string out to the I 

2 

Cbus until a null character 

is reached. 

Source File: SlaveputsI2C.c 

Code Example: unsigned char string[] =”MICROCHIP”; 




Bình luận: vĩ mô này xóa Thầy tôi 

2 

CInterrupt Enable chút ngắt Kích hoạt 


Mã số Ví dụ: DisableIntMI2C; 



SetPriorityIntMI2C 

Mô tả: Điều này đặt ra ưu tiên vĩ mô cho chủ tôi 

2 

Cinterrupt. 




2 

CInterrupt bit ưu tiên của ưu tiên ngắt 


Mã số Ví dụ: SetPriorityIntMI2C (1); 

EnableIntSI2C 

Mô tả: vĩ mô Điều này cho phép các nô lệ tôi 

2 

Cinterrupt. 



Bình luận: vĩ mô này đặt Slave tôi 

2 

Bit CEnable của Interrupt Enable kiểm soát 

đăng ký. 

Mã số Ví dụ: EnableIntSI2C; 

DisableIntSI2C 

Mô tả: vĩ mô này vô hiệu hóa các nô lệ tôi 

2 

Cinterrupt. 



Bình luận: vĩ mô này xóa Slave tôi 

2

dptr = string; 

SlaveputsI2C(rdptr); 

SlaveReadI2C 

Description: This function is used to read a single byte from the I 

2 

Cbus. 


Prototype: unsigned char SlaveReadI2C(void); 


Return Value The return value is the data byte read from the I 

2 

Cbus. 

Remarks: This function reads in a single byte from the I 

2 

Cbus. This function 

performs the same function as SlavegetcI2C. 

Source File: SlaveReadI2C.c 

Code Example: unsigned char value; 

value = SlaveReadI2C(); 

SlaveWriteI2C 

Description: This function is used to write out a single byte to the I 

2 

Cbus. 


Prototype: void SlaveWriteI2C(unsigned char data_out); 

Arguments: data_out A single data byte to be written to the I 

2 

Cbus device. 


Remarks: This function writes out a single data byte to the I 

2 

Cbus device. This 

function performs the same function as SlaveputcI2C. 

Source File: SlaveWriteI2C.c 

Code Example: SlaveWriteI2C(‘a’); 

dsPIC 

® 



CInterrupt Enable chút ngắt Kích hoạt 


Mã số Ví dụ: DisableIntSI2C; 

SetPriorityIntSI2C 

Mô tả: Điều này đặt ra ưu tiên vĩ mô cho chủ tôi 

2 

Cinterrupt. 




2 

CInterrupt bit ưu tiên của ưu tiên ngắt 


Mã số Ví dụ: SetPriorityIntSI2C (4); 

dsPIC 

® 





# include 

# include 


{ 

int config2, config1; 

unsigned char * wrptr; 

unsigned char tx_data [] = 

{'M', 'tôi', 'C', 'R', 'O', 'C', 'H', 'tôi', 'P', '\ 0'}; 

wrptr = tx_data; 

/ * Tốc độ truyền được thiết lập cho 100 Khz * / 

config2 = 0x11; 

/ * Cấu hình I2C cho chế độ địa chỉ 7 bit * / 

config1 = (I2C_ON & I2C_IDLE_CON & I2C_CLK_HLD 

& I2C_IPMI_DIS & I2C_7BIT_ADD 

& I2C_SLW_DIS & I2C_SM_DIS & 

I2C_GCALL_DIS & I2C_STR_DIS & 

I2C_NACK & I2C_ACK_DIS & I2C_RCV_DIS & 

I2C_STOP_DIS & I2C_RESTART_DIS 

& I2C_START_DIS);


StartI2C 


2 

CBus Start condition. 


Prototype: void StartI2C(void); 



Remarks: This function generates a I 

2 

CBus Start condition. 

Source File: StartI2C.c 

Code Example: StartI2C(); 

StopI2C 


2 

CBus Stop condition. 


Prototype: void StopI2C(void); 



Remarks: This function generates a I 

2 

CBus Stop condition. 

Source File: StopI2C.c 

Code Example: StopI2C(); 

EnableIntMI2C 

Description: This macro enables the master I 

2 

Cinterrupt. 



Remarks: This macro sets Master I 

2 

CEnable bit of Interrupt Enable Control 

register. 

Code Example: EnableIntMI2C; 

DisableIntMI2C 

OpenI2C (config1, config2); 

IdleI2C (); 

StartI2C (); 

/ * Chờ cho đến khi bắt đầu trình tự hoàn thành * / 

trong khi (I2CCONbits.SEN); 

/ * Viết Slave địa chỉ và thiết lập tổng thể cho truyền * / 

MasterWriteI2C (0xE); 

/ * Chờ cho đến khi địa chỉ được truyền * / 

trong khi (I2CSTATbits.TBF); 

trong khi (I2CSTATbits.ACKSTAT); 

/ * Chuỗi Truyền dữ liệu * / 

MasterputsI2C (wrptr); 

StopI2C (); 

/ * Chờ cho đến khi dừng lại trình tự hoàn thành * / 

trong khi (I2CCONbits.PEN); 

CloseI2C (); 

} 

dsPIC 


THƯ VIỆN 


Chương 4 Thư viện chuẩn C với các hàm toán 


Chức năng thư viện chuẩn ANSI C được chứa trong các thư viện libc-omf.aand 

libm-omf.a (chức năng toán học), trong đó có omfwill coffor elfdepending trên 

lựa chọn đối tượng định dạng mô-đun. 

Ngoài ra, một số tiêu chuẩn dsPIC chức năng trợ giúp thư viện C, và các chức 

năng tiêu chuẩn 

đó phải được sửa đổi để sử dụng với các thiết bị dsPIC, đang ở trong thư viện 

libpic30-omf.a. 


Một phiên bản miễn phí của các hàm toán học thư viện và phần đầu tập tin có 

sẵn từ các trang web của Microchip. Không có mã nguồn có sẵn với phiên bản 

miễn phí này. 




• Tiêu chuẩn lib- tập tin thư viện C 

• src \ libm- mã nguồn cho các chức năng thư viện toán học, tập tin thực thi để 

xây dựng lại thư viện 

• tập tin tiêu đề hỗ trợ \ h- cho các thư viện 

4.1.3 Tổ chức Chương

Description: This macro disables the master I 

2 

Cinterrupt. 



Remarks: This macro clears Master I 

2 

CInterrupt Enable bit of Interrupt Enable 


Code Example: DisableIntMI2C; 



SetPriorityIntMI2C 

Description: This macro sets priority for master I 

2 

Cinterrupt. 




2 

CInterrupt Priority bits of Interrupt Priority 


Code Example: SetPriorityIntMI2C(1); 

EnableIntSI2C 

Description: This macro enables the slave I 

2 

Cinterrupt. 



Remarks: This macro sets Slave I 

2 

CEnable bit of Interrupt Enable Control 

register. 

Code Example: EnableIntSI2C; 

DisableIntSI2C 

Description: This macro disables the slave I 

2 

Cinterrupt. 



• Sử dụng thư viện chuẩn C 

libc-omf.a 

• chẩn đoán 

• xử lý nhân vật 

• lỗi 

• đặc điểm nổi 

• giới hạn thực hiện xác định 

• nội địa hóa 

• nhảy không địa phương 

• xử lý tín hiệu 

• danh sách đối số biến 

• định nghĩa chung 

• đầu vào và đầu ra 

• chức năng tiện ích 

• chức năng chuỗi 

• ngày và thời gian chức năng 

libm-omf.a 

• chức năng toán học 

libpic30-omf.a 

• pic30-libs 

dsPIC 

® 




4.2 SỬ DỤNG THƯ VIỆN TIÊU CHUẨN C 

Xây dựng một ứng dụng mà sử dụng các tiêu chuẩn thư viện C yêu cầu hai loại 

tập tin: 

tập tin tiêu đề và các tập tin thư viện. 

4.2.1 Tiêu đề tin 

Tất cả các tổ chức tiêu chuẩn thư viện C được khai báo hoặc quy định tại một 

hoặc nhiều tiêu đề tiêu chuẩn 

(Xem danh sách tại mục 4.1.3 "Chương Tổ chức".) Để sử dụng một thực thể 

trong thư viện 

một chương trình, viết một chỉ thị bao gồm có tên tiêu đề tiêu chuẩn có liên 

quan. 

Nội dung của một tiêu đề tiêu chuẩn được bao gồm bằng cách đặt tên nó trong 

một chỉ thị bao gồm, như trong: 

# include / * Bao gồm I / O cơ sở * / 

Các tiêu đề tiêu chuẩn có thể được bao gồm trong bất kỳ thứ tự. Không bao gồm 

tiêu đề chuẩn 

trong một tuyên bố. Không định nghĩa macro có cùng tên với từ khóa


Remarks: This macro clears Slave I 

2 

CInterrupt Enable bit of Interrupt Enable 


Code Example: DisableIntSI2C; 

SetPriorityIntSI2C 

Description: This macro sets priority for master I 

2 

Cinterrupt. 




2 

CInterrupt Priority bits of Interrupt Priority 


Code Example: SetPriorityIntSI2C(4); 

dsPIC 

® 


trước khi bao gồm một tiêu đề chuẩn. 

Một tiêu đề tiêu chuẩn không bao giờ bao gồm một tiêu đề chuẩn. 

4.2.2 Thư viện tập tin 

Các tập tin thư viện lưu trữ chứa tất cả các đối tượng tập tin cá nhân cho mỗi 


Khi kết nối một ứng dụng, tập tin thư viện phải được cung cấp như một đầu vào 

để mối liên kết 

(Bằng cách sử dụng tùy chọn -llinker --libraryor) như vậy mà các chức năng 



Một ứng dụng điển hình C sẽ yêu cầu ba tập tin thư viện: libc-omf.a, libmomf.a, 

và 

libpic30-omf.a. (Xem phần 1.2 "OMF-cụ thể thư viện / khởi động mô-đun" 

để biết thêm về thư viện OMF cụ thể.) Các thư viện này sẽ được bao gồm tự 

động nếu 

liên kết được thực hiện bằng cách sử dụng trình biên dịch MPLAB C30. 

Lưu ý: Một số chức năng thư viện chuẩn đòi hỏi một đống. Chúng bao gồm các 

tiêu chuẩn 

I / O chức năng mở các tập tin và các chức năng cấp phát bộ nhớ. Xem 

MPLAB ASM30, MPLAB LINK30 và Guideand MPLAB tiện ích của người sử 

dụng 

C30 C Compiler của người sử dụng Guidefor thêm thông tin về đống. 

Thư viện chuẩn C với hàm toán học 


DS51456B-page 192 


4.3 DIAGNOSTICS 



#include 

#include 

void main(void ) 

{ 

unsigned int config2, config1; 

unsigned char *wrptr; 

unsigned char tx_data[] = 

{'M','I','C','R','O',’C’,'H','I','P','\0'}; 

wrptr = tx_data; 

/* Baud rate is set for 100 Khz */ 

config2 = 0x11; 

/* Configure I2C for 7 bit address mode */ 

config1 = (I2C_ON & I2C_IDLE_CON & I2C_CLK_HLD 

& I2C_IPMI_DIS & I2C_7BIT_ADD 

& I2C_SLW_DIS & I2C_SM_DIS & 

I2C_GCALL_DIS & I2C_STR_DIS & 

Các assert.hconsists tập tin tiêu đề của một vĩ mô duy nhất đó là hữu ích để gỡ 

lỗi lôgic 

sai sót trong chương trình. Bằng cách sử dụng các tuyên bố khẳng định tại các 

địa điểm quan trọng, nơi nhất định 

điều kiện phải được sự thật, logic của chương trình có thể được kiểm tra. 

Kiểm tra khẳng định có thể được tắt mà không loại bỏ các mã bằng cách định 

nghĩa NDEBUG 

trước khi bao gồm . Nếu NDEBUGis vĩ mô được xác định, khẳng định () bị bỏ 

qua 

và không có mã số được tạo ra. 

khẳng định 

Mô tả: Nếu biểu thức là sai, một thông báo khẳng định được in vào thiết bị lỗi 

chuẩn và 

chương trình được hủy bỏ. 

Bao gồm: 

Prototype: void khẳng định (int biểu thức); 

Đối số: biểu Các biểu hiện để kiểm tra. 

Ghi chú: Các biểu thức ước lượng không ornon-không. Nếu không, sự khẳng 

định 

không thành công, và một tin nhắn được in tostderr. Thông điệp bao gồm các 

tên tập tin nguồn (__FILE__), số dòng mã nguồn (__LINE__), các

I2C_NACK & I2C_ACK_DIS& I2C_RCV_DIS & 

I2C_STOP_DIS & I2C_RESTART_DIS 

& I2C_START_DIS); 

OpenI2C(config1,config2); 

IdleI2C(); 

StartI2C(); 

/* Wait till Start sequence is completed */ 

while(I2CCONbits.SEN ); 

/* Write Slave address and set master for transmission */ 

MasterWriteI2C(0xE); 

/* Wait till address is transmitted */ 

while(I2CSTATbits.TBF); 

while(I2CSTATbits.ACKSTAT); 

/* Transmit string of data */ 

MasterputsI2C(wrptr); 

StopI2C(); 

/* Wait till stop sequence is completed */ 

while(I2CCONbits.PEN); 

CloseI2C(); 

} 

dsPIC 


biểu hiện được đánh giá và tin nhắn. Vĩ mô sau đó gọi 

chức năng hủy bỏ (). Nếu _VERBOSE_DEBUGGINGis vĩ mô được xác định, 

một 

thông báo sẽ được in để thiết bị lỗi chuẩn mỗi lần khẳng định () được gọi. 

Ví dụ: # include / * Để khẳng định * / 


{ 

int a; 

a = 2 * 2; 

khẳng định (a == 4); / * Nếu bản in thật không có gì * / 

khẳng định (a == 6); / * Nếu tin nhắn giả in * / 

/ * Và hủy bỏ * / 

} 

Đầu ra: 

sampassert.c: 9 a == 6 --assertion thất bại 

ABRT 

với _VERBOSE_DEBUGGINGdefined: 

sampassert.c: 8 a == 4 - OK 

sampassert.c: 9 a == 6 --assertion thất bại 

ABRT 

dsPIC 

® 


LIBRARIES 



4.4 NHÂN XỬ LÝ 


Chapter 4. Standard C Libraries with Math Functions 


Standard ANSI C library functions are contained in the libraries libc-omf.aand 

libm-omf.a(math functions), where omfwill be coffor elfdepending upon the 

selected object module format. 

Additionally, some dsPIC standard C library helper functions, and standard 

functions 

that must be modified for use with dsPIC devices, are in the library libpic30- 

omf.a. 


A free version of the math functions library and header file is available from the 

Microchip web site. No source code is available with this free version. 




• lib– standard C library files 

Các ctype.hconsists tập tin tiêu đề của các chức năng hữu ích cho việc phân loạ 

và 

lập bản đồ ký tự. Nhân vật được giải thích theo quy định của địa phương chuẩn 

C. 

isalnum 

Mô tả: Kiểm tra cho một nhân vật tự chữ và số. 

Bao gồm: 

Nguyên mẫu: int isalnum (int c); 

Đối số: c Các nhân vật để kiểm tra. 

Quay trở lại giá trị: Trả về một số nguyên nhân vật khác không có giá trị ifthe là 

chữ số; 

nếu không, trả về một số không. 

Ghi chú: chữ và số ký tự được bao gồm trong phạm vi AZ, az hoặc 0-9. 

Ví dụ: # include / * Cho isalnum * / 

# include / * Cho printf * / 

int main (void)

• src\libm– source code for math library functions, batch file to rebuild the 

library 

• support\h– header files for libraries 



• Using the Standard C Libraries 

libc-omf.a 

• diagnostics 

• character handling 

• errors 

• floating-point characteristics 

• implementation-defined limits 

• localization 

• non-local jumps 

• signal handling 

• variable argument lists 

• common definitions 

• input and output 

• utility functions 

• string functions 

• date and time functions 

libm-omf.a 

• mathematical functions 

libpic30-omf.a 

• pic30-libs 

dsPIC 

® 


DS51456B-page 194 


4.2 USING THE STANDARD C LIBRARIES 

Building an application which utilizes the standard C libraries requires two 

types of files: 

header files and library files. 

4.2.1 Header Files 

All standard C library entities are declared or defined in one or more standard 

headers 

(See list in Section 4.1.3 “Chapter Organization”.) To make use of a library 

entity in 

a program, write an include directive that names the relevant standard header. 

The contents of a standard header is included by naming it in an include 

directive, as in: 

{ 

int ch; 

ch = '3'; 

if (isalnum (ch)) 

printf ("3 là một chữ \ n"); 

khác 

printf ("3 là chữ số NOTan \ n"); 

ch = '#'; 

if (isalnum (ch)) 

printf ("# là một chữ \ n"); 

khác 

printf ("# là chữ số NOTan \ n"); 

} 

Đầu ra: 

3 là một chữ số 

# Là không một chữ số 

isalpha 

Mô tả: Kiểm tra cho một ký tự chữ cái. 

Bao gồm: 

Nguyên mẫu: int isalpha (int c); 

Đối số: c Các nhân vật để kiểm tra. 


chữ cái; 

nếu không, trả về số không. 

Ghi chú: ký tự chữ cái được bao gồm trong phạm vi AZ hoặc az. 



Ví dụ: # include / * Cho isalpha * / 



{ 

int ch; 

ch = 'B'; 

if (isalpha (ch)) 

printf ("B là chữ cái \ n"); 

khác 

printf ("B isnot chữ cái \ n"); 

ch = '#'; 

if (isalpha (ch)) 

printf ("# là chữ cái \ n");

#include /* include I/O facilities */ 

The standard headers can be included in any order. Do not include a standard 

header 

within a declaration. Do not define macros that have the same names as 

keywords 

before including a standard header. 

A standard header never includes another standard header. 

4.2.2 Library Files 

The archived library files contain all the individual object files for each library 

function. 

When linking an application, the library file must be provided as an input to the 

linker 

(using the --libraryor -llinker option) such that the functions used by the 


A typical C application will require three library files: libc-omf.a, libm-omf.a, 

and 

libpic30-omf.a. (See Section 1.2 “OMF-Specific Libraries/StarTup Modules” 

for more on OMF-specific libraries.) These libraries will be included 

automatically if 

linking is performed using the MPLAB C30 compiler. 

Note: Some standard library functions require a heap. These include the 

standard 

I/O functions that open files and the memory allocation functions. See the 

MPLAB ASM30, MPLAB LINK30 and Utilities User’s Guideand MPLAB 

C30 C Compiler User’s Guidefor more information on the heap. 

Standard C Libraries with Math Functions 


4.3 DIAGNOSTICS 

The header file assert.hconsists of a single macro that is useful for debugging 

logic 

errors in programs. By using the assert statement in critical locations where 

certain 

conditions should be true, the logic of the program may be tested. 

Assertion testing may be turned off without removing the code by defining 

NDEBUG 

before including . If the macro NDEBUGis defined, assert()is ignored 

and no code is generated. 

assert 

Description: If the expression is false, an assertion message is printed to stderr 

and 

the program is aborted. 

Include: 

Prototype: void assert(int expression); 

Argument: expression The expression to test. 

khác 

printf ("# isnot chữ cái \ n"); 

} 

Đầu ra: 

B là chữ cái 

# Là không chữ cái 

iscntrl 

Mô tả: Kiểm tra cho một nhân vật điều khiển. 

Bao gồm: 

Nguyên mẫu: int iscntrl (int c); 

Đối số: nhân vật c để kiểm tra. 

Quay trở lại giá trị: Trả về một giá trị khác không số nguyên nếu nhân vật là 

một nhân vật kiểm soát; 


Bình luận: Một nhân vật được coi là một nhân vật kiểm soát nếu giá trị ASCII 

của nó là 

trong phạm vi 0x00 đến 0x1f bao gồm, hoặc 0x7F. 

Ví dụ: # include / * Cho iscntrl * / 



{ 

char ch; 

ch = 'B'; 

if (iscntrl (ch)) 

printf ("B là một điều khiển nhân vật \ n"); 

khác 

printf ("B là Nota kiểm soát ký tự \ n"); 

ch = '\ t'; 

if (iscntrl (ch)) 

printf ("Một tab isa ký tự điều khiển \ n"); 

khác 

printf ("Một thẻ là không một nhân vật điều khiển \ n"); 

} 

Đầu ra: 

B là không một nhân vật điều khiển 

Một thẻ là một nhân vật kiểm soát 

isalpha (Tiếp theo) 

dsPIC 

® 


Remarks: The expression evaluates to zero ornon-zero. If zero, the assertion 

fails, and a message is printed tostderr. The message includes the 

source file name (__FILE__), the source line number (__LINE__), the 

expression being evaluated and the message. The macro then calls the 

function abort(). If the macro _VERBOSE_DEBUGGINGis defined, a 

message will be printed to stderr each time assert()is called. 

Example: #include /* for assert */ 


{ 

int a; 

a = 2 * 2; 

assert(a == 4); /* if true-nothing prints */ 

assert(a == 6); /*if false-print message */ 

/* and abort */ 

} 

Output: 

sampassert.c:9 a == 6 --assertion failed 

ABRT 

with _VERBOSE_DEBUGGINGdefined: 

sampassert.c:8 a == 4 -- OK 

sampassert.c:9 a == 6 --assertion failed 

ABRT 

dsPIC 

® 


DS51456B-page 196 


4.4 CHARACTER HANDLING 

The header file ctype.hconsists of functions that are useful for classifying and 

mapping characters. Characters are interpreted according to the Standard C 

locale. 

isalnum 

Description: Test for an alphanumeric character. 

Include: 

Prototype: int isalnum(int c); 

Argument: c The character to test. 

Return Value: Returns a non-zero integer value ifthe character is alphanumeric; 

otherwise, returns a zero. 

Remarks: Alphanumeric characters are included within the ranges A-Z, a-z or 0- 

9. 

Example: #include /*for isalnum */ 


isdigit 


Mô tả: Kiểm tra trong một chữ số thập phân. 

Bao gồm: 

Nguyên mẫu: int isdigit (int c); 

Đối số: nhân vật c để kiểm tra. 

Quay trở lại giá trị: Trả về một giá trị khác không số nguyên nếu nhân vật này l 

một chữ số; nếu không, 

lợi nhuận bằng không. 

Bình luận: Một nhân vật được coi là một nhân vật nếu nó là chữ số trong phạm 

vi 

"0" - "9". 

Ví dụ: # include / * Cho isdigit * / 



{ 

int ch; 

ch = '3'; 

if (isdigit (ch)) 

printf ("3 là một chữ số \ n"); 

khác 

printf ("3 là không một chữ số \ n"); 

ch = '#'; 

if (isdigit (ch)) 

printf ("# là một chữ số \ n"); 

khác 

printf ("# là không một chữ số \ n"); 

} 

Đầu ra: 

3 là một chữ số 

# Là không một chữ số 

isgraph 

Mô tả: Kiểm tra cho một nhân vật đồ họa. 

Bao gồm: 

Nguyên mẫu: int isgraph (int c); 

Đối số: nhân vật c để kiểm tra 


một đồ họa 

nhân vật; nếu không, trả về số không. 

Bình luận: Một nhân vật được coi là một nhân vật đồ họa nếu nó là bất kỳ 

nhân vật có thể in được, ngoại trừ một không gian.

#include /* for printf */ 


{ 

int ch; 

ch = '3'; 

if (isalnum(ch)) 

printf("3 is an alphanumeric\n"); 

else 

printf("3 is NOTan alphanumeric\n"); 

ch = '#'; 

if (isalnum(ch)) 

printf("# is an alphanumeric\n"); 

else 

printf("# is NOTan alphanumeric\n"); 

} 

Output: 

3 is an alphanumeric 

# is NOT an alphanumeric 

isalpha 

Description: Test for an alphabetic character. 

Include: 

Prototype: int isalpha(int c); 

Argument: c The character to test. 

Return Value: Returns a non-zero integer value ifthe character is alphabetic; 

otherwise, returns zero. 

Remarks: Alphabetic characters are included within the ranges A-Z or a-z. 



Example: #include /*for isalpha */ 



{ 

int ch; 

ch = 'B'; 

if (isalpha(ch)) 

printf("B is alphabetic\n"); 

else 

printf("B isNOT alphabetic\n"); 

ch = '#'; 

Ví dụ: # include / * Cho isgraph * / 



{ 

int ch; 



ch = '3'; 

if (isgraph (ch)) 

printf ("3 là một nhân vật đồ họa \ n"); 

khác 

printf ("3 là Nota đồ họa nhân vật \ n"); 

ch = '#'; 


printf ("# là một nhân vật đồ họa \ n"); 

khác 

printf ("# là Nota nhân vật đồ họa \ n"); 

ch = ''; 


printf ("một không gian là một nhân vật đồ họa \ n"); 

khác 

printf ("một không gian là không một nhân vật đồ họa \ n"); 

} 

Đầu ra: 

3 là một nhân vật đồ họa 

# Là một nhân vật đồ họa 

một không gian là không một nhân vật đồ họa 

islower 

Mô tả: Kiểm tra trong một trường hợp thấp hơn ký tự chữ cái. 

Bao gồm: 

Nguyên mẫu: int islower (int c); 



một trường hợp thấp hơn 

ký tự chữ cái; nếu không, trả về số không. 

Bình luận: Một nhân vật được coi là một trường hợp ký tự chữ cái thấp hơn nếu 

nó là 

trong phạm vi của 'a' - 'z'. 

Ví dụ: # include / * Cho islower * / 

# include / * Cho printf * /

if (isalpha(ch)) 

printf("# is alphabetic\n"); 

else 

printf("# isNOT alphabetic\n"); 

} 

Output: 

B is alphabetic 

# is NOT alphabetic 

iscntrl 

Description: Test for a control character. 

Include: 

Prototype: int iscntrl(int c); 

Argument: c character to test. 

Return Value: Returns a non-zero integer value if the character is a control 

character; 


Remarks: A character is considered to be a control character if its ASCII value 

is 

in the range 0x00 to 0x1F inclusive, or 0x7F. 

Example: #include /*for iscntrl */ 



{ 

char ch; 

ch = 'B'; 

if (iscntrl(ch)) 

printf("B is a control character\n"); 

else 

printf("B is NOTa control character\n"); 

ch = '\t'; 

if (iscntrl(ch)) 

printf("A tab isa control character\n"); 

else 

printf("A tab is NOT a control character\n"); 

} 

Output: 

B is NOT a control character 

A tab is a control character 

isalpha (Continued) 

dsPIC 


{ 

int ch; 

ch = 'B'; 

if (islower (ch)) 

printf ("B là trường hợp thấp hơn \ n"); 

khác 

printf ("B isnot thấp hơn trường hợp \ n"); 

ch = 'b'; 

if (islower (ch)) 

printf ("b là trường hợp thấp hơn \ n"); 

khác 

printf ("b isnot thấp hơn trường hợp \ n"); 

} 

Đầu ra: 

B là không thấp hơn trường hợp 

b là trường hợp thấp hơn 

isgraph (Tiếp theo) 

dsPIC 

® 



isprint 


Mô tả: Kiểm tra cho một ký tự in (bao gồm một không gian). 

Bao gồm: 

Nguyên mẫu: int isprint (int c); 



in; 


Bình luận: Một nhân vật được coi là một nhân vật có thể in nếu nó đang trong 

phạm vi 

0x20 để 0x7e toàn diện. 

Ví dụ: # include / * Cho isprint * / 



{ 

int ch; 

ch = "&"; 

if (isprint (ch))

® 


DS51456B-page 198 

isdigit 

Description: Test for a decimal digit. 

Include: 

Prototype: int isdigit(int c); 

Argument: c character to test. 


Return Value: Returns a non-zero integer value if the character is a digit; 

otherwise, 

returns zero. 

Remarks: A character is considered to be a digit character if it is in the range of 

'0'-'9'. 

Example: #include /*for isdigit */ 



{ 

int ch; 

ch = '3'; 

if (isdigit(ch)) 

printf("3 is a digit\n"); 

else 

printf("3 is NOT a digit\n"); 

ch = '#'; 

if (isdigit(ch)) 

printf("# is a digit\n"); 

else 

printf("# is NOT a digit\n"); 

} 

Output: 

3 is a digit 

# is NOT a digit 

isgraph 

Description: Test for a graphical character. 

Include: 

Prototype: int isgraph (int c); 

Argument: c character to test 

Return Value: Returns a non-zero integer value ifthe character is a graphical 

character; otherwise, returns zero. 

printf ("& là một nhân vật có thể in \ n"); 

khác 

printf ("& KHÔNG phải là một nhân vật có thể in \ n"); 

ch = '\ t'; 

if (isprint (ch)) 

printf ("một tab là một nhân vật có thể in \ n"); 

khác 

printf ("một tab là không một nhân vật có thể in \ n"); 

} 

Đầu ra: 

Và là một nhân vật có thể in 

một tab là không một nhân vật có thể in 

ispunct 

Mô tả: Kiểm tra trong một ký tự chấm câu. 

Bao gồm: 

Nguyên mẫu: int ispunct (int c); 



một dấu chấm câu 


Bình luận: Một nhân vật được coi là một nhân vật dấu chấm câu nếu nó là một 

nhân vật có thể in mà không phải là một không gian cũng không phải là chữ số 

nhân vật. Ký tự chấm câu bao gồm những điều sau đây: 

! "# $% & '(); @ [\] * +, - /:. ^ _ {|} ~ 



Ví dụ: # include / * Cho ispunct * / 



{ 

int ch; 

ch = "&"; 

if (ispunct (ch)) 

printf ("& là một nhân vật dấu chấm câu \ n"); 

khác 

printf ("& là ký tự chấm câu Nota \ n"); 

ch = '\ t'; 

if (ispunct (ch)) 

printf ("một tab isa dấu chấm câu ký tự \ n"); 

khác

Remarks: A character is considered to be a graphical character if it is any 

printable character except a space. 

Example: #include /*for isgraph */ 



{ 

int ch; 



ch = '3'; 

if (isgraph(ch)) 

printf("3 is a graphical character\n"); 

else 

printf("3 is NOTa graphical character\n"); 

ch = '#'; 


printf("# is a graphical character\n"); 

else 

printf("# is NOTa graphical character\n"); 

ch = ' '; 


printf("a space is a graphical character\n"); 

else 

printf("a space is NOT a graphical character\n"); 

} 

Output: 

3 is a graphical character 

# is a graphical character 

a space is NOT a graphical character 

islower 

Description: Test for a lower case alphabetic character. 

Include: 

Prototype: int islower (int c); 


Return Value: Returns a non-zero integer value if the character is a lower case 

alphabetic character; otherwise, returns zero. 

Remarks: A character is considered to be a lower case alphabetic character if it 

is 

in the range of 'a'-'z'. 

printf ("một tab là không một ký tự chấm câu \ n"); 

} 

Đầu ra: 

Và là một nhân vật dấu chấm câu 

một tab là không một ký tự chấm câu 

isspace 

Mô tả: Kiểm tra cho một nhân vật không gian trắng. 

Bao gồm: 

Nguyên mẫu: int isspace (int c); 



một không gian màu trắng 


Bình luận: Một nhân vật được coi là một nhân vật không gian trắng nếu nó là 

một trong những 

như sau: không gian (''), thức ăn dạng ('\ f'), xuống dòng ('\ n'), vận chuyển trở 

lại 

('\ R'), tab ngang ('\ t'), hoặc tab theo chiều dọc ('\ v'). 

Ví dụ: # include / * Cho isspace * / 



{ 

int ch; 

ch = "&"; 

if (isspace (ch)) 

printf ("& là một không gian trắng ký tự \ n"); 

khác 

printf ("& là Nota trắng không gian ký tự \ n"); 

ch = '\ t'; 

if (isspace (ch)) 

printf ("một tab isa trắng không gian ký tự \ n"); 

khác 

printf ("một tab là không một không gian trắng ký tự \ n"); 

} 

Đầu ra: 

Và là không một nhân vật không gian trắng 

một tab là một nhân vật không gian trắng 

ispunct (Tiếp theo) 

dsPIC 

® 


Example: #include /*for islower */ 



{ 

int ch; 

ch = 'B'; 

if (islower(ch)) 

printf("B is lower case\n"); 

else 

printf("B isNOT lower case\n"); 

ch = 'b'; 

if (islower(ch)) 

printf("b is lower case\n"); 

else 

printf("b isNOT lower case\n"); 

} 

Output: 

B is NOT lower case 

b is lower case 

isgraph (Continued) 

dsPIC 

® 



isupper 


Mô tả: Kiểm tra cho một thư trường hợp trên. 

Bao gồm: 

Nguyên mẫu: int isupper (int c); 


Quay trở lại giá trị: Trả về một số nguyên giá trị ifthe nhân vật khác không Isan 

trường hợp trên 

ký tự chữ cái; nếu không, trả về số không. 

Bình luận: Một nhân vật được coi là một trường hợp trên ký tự chữ cái nếu nó 

là trong phạm vi của 'A' - 'Z'. 

Ví dụ: # include / * Cho isupper * / 



{ 

int ch; 

ch = 'B'; 

if (isupper (ch)) 

printf ("B là chữ hoa \ n"); 

khác 

printf ("B là không chữ hoa \ n"); 

ch = 'b'; 

if (isupper (ch)) 

printf ("b là chữ hoa \ n"); 

DS51456B-page 200 

isprint 


khác 

printf ("b là không chữ hoa \ n"); 

Description: Test for a printable character (includes a space). 

Include: 

Prototype: int isprint (int c); 


Return Value: Returns a non-zero integer value ifthe character is printable; 


Remarks: A character is considered to be a printable character if it is in the 

range 

0x20 to 0x7e inclusive. 

Example: #include /*for isprint */ 



{ 

int ch; 

} 

Đầu ra: 

B là trường hợp trên 

b là không trường hợp trên 

isxdigit 

Mô tả: Kiểm tra trong một chữ số thập lục phân. 

Bao gồm: 

Nguyên mẫu: int isxdigit (int c); 



một chữ số thập lục phân; 


Bình luận: Một nhân vật được coi là một nhân vật chữ số thập lục phân nếu nó 

đang trong 

phạm vi của "0" - "9 ',' A '-' F 'or' a '-' f'.Note: Danh sách này không bao gồm

ch = '&'; 

if (isprint(ch)) 

printf("& is a printable character\n"); 

else 

printf("& is NOT a printable character\n"); 

ch = '\t'; 

if (isprint(ch)) 

printf("a tab is a printable character\n"); 

else 

printf("a tab is NOT a printable character\n"); 

} 

Output: 

& is a printable character 

a tab is NOT a printable character 

ispunct 

Description: Test for a punctuation character. 

Include: 

Prototype: int ispunct (int c); 


Return Value: Returns a non-zero integer value ifthe character is a punctuation 


Remarks: A character is considered to be a punctuation character if it is a 

printable character which is neither a space nor an alphanumeric 

character. Punctuation characters consist of the following: 

! " # $ % & ' ( ) ; < = > ? @ [ \ ] * + , - . / : ^ _ { | } ~ 



Example: #include /*for ispunct */ 



{ 

int ch; 

ch = '&'; 

if (ispunct(ch)) 

printf("& is a punctuation character\n"); 

else 

printf("& is NOTa punctuation character\n"); 

ch = '\t'; 

if (ispunct(ch)) 

các 

0x hàng đầu vì 0x là tiền tố cho một số thập lục phân, nhưng không phải là 

một chữ số thập lục phân thực tế. 



Ví dụ: # include / * Cho isxdigit * / 



{ 

int ch; 

ch = 'B'; 

if (isxdigit (ch)) 

printf ("B là một chữ số thập lục phân \ n"); 

khác 

printf ("B là chữ số thập lục phân Nota \ n"); 

ch = 't'; 

if (isxdigit (ch)) 

printf ("t là một chữ số thập lục phân \ n"); 

khác 

printf ("t là chữ số thập lục phân Nota \ n"); 

} 

Đầu ra: 

B là một chữ số thập lục phân 

t là không một chữ số thập lục phân 

ToLower 

Mô tả: Chuyển đổi một nhân vật đến một trường hợp thấp hơn chữ cái. 

Bao gồm: 

Nguyên mẫu: int ToLower (int c); 

Đối số: c Nhân vật chuyển đổi sang chữ thường. 

Quay trở lại giá trị: Trả về trường hợp thấp hơn tương ứng với chữ cái nếu 

lập luận là trường hợp ban đầu trên; nếu không, trả về ban đầu 

nhân vật. 

Ghi chú: Chỉ có trường hợp trên ký tự chữ cái có thể được chuyển đổi để giảm 

trường hợp. 

Ví dụ: # include / * Cho ToLower * / 



{ 

int ch;

printf("a tab isa punctuation character\n"); 

else 

printf("a tab is NOT a punctuation character\n"); 

} 

Output: 

& is a punctuation character 

a tab is NOT a punctuation character 

isspace 

Description: Test for a white-space character. 

Include: 

Prototype: int isspace (int c); 


Return Value: Returns a non-zero integer value if the character is a white-space 


Remarks: A character is considered to be a white-space character if it is one of 

the following: space (' '), form feed ('\f'), newline ('\n'), carriage return 

('\r'), horizontal tab ('\t'), or vertical tab ('\v'). 

Example: #include /*for isspace */ 



{ 

int ch; 

ch = '&'; 

if (isspace(ch)) 

printf("& is a white-space character\n"); 

else 

printf("& is NOTa white-space character\n"); 

ch = '\t'; 

if (isspace(ch)) 

printf("a tab isa white-space character\n"); 

else 

printf("a tab is NOT a white-space character\n"); 

} 

Output: 

& is NOT a white-space character 

a tab is a white-space character 

ispunct (Continued) 

dsPIC 

® 

ch = 'B'; 

printf ("thay đổi B trường hợp thấp hơn% c \ n", 

ToLower (ch)); 

ch = 'b'; 

printf ("b vẫn còn trường hợp thấp hơn% c \ n", 

ToLower (ch)); 

ch = '@'; 

printf ("@ không có trường hợp thấp hơn,"); 

printf ("% c để được trả lại \ n", ToLower (ch)); 

} 

Đầu ra: 

B để thay đổi trường hợp thấp hơn b 

b vẫn còn trường hợp thấp hơn b 

@ Không có trường hợp thấp hơn, vì vậy @ được trả lại 

isxdigit (Tiếp theo) 

dsPIC 

® 



toupper 


Mô tả: Chuyển đổi một nhân vật với một chữ hoa chữ cái. 

Bao gồm: 

Nguyên mẫu: int toupper (int c); 

Đối số: c Nhân vật chuyển đổi sang trường hợp trên. 

Quay trở lại giá trị: Trả về trường hợp trên tương ứng với chữ cái nếu 

lập luận là trường hợp ban đầu thấp hơn; nếu không, trả về ban đầu 

nhân vật. 

Ghi chú: Chỉ có trường hợp thấp hơn các ký tự chữ cái có thể được chuyển đổi 

sang trên 

trường hợp. 

Ví dụ: # include / * Cho toupper * / 



{ 

int ch; 

ch = 'b'; 

printf ("b thay đổi chữ hoa% c \ n", 

toupper (ch)); 

ch = 'B'; 

printf ("B vẫn còn trường hợp trên% c \ n",


DS51456B-page 202 

isupper 


Description: Test for an upper case letter. 

Include: 

Prototype: int isupper (int c); 


Return Value: Returns a non-zero integer value ifthe character isan upper case 

alphabetic character; otherwise, returns zero. 

Remarks: A character is considered to be an upper case alphabetic character if it 

is in the range of 'A'-'Z'. 

Example: #include /*for isupper */ 



{ 

int ch; 

ch = 'B'; 

if (isupper(ch)) 

printf("B is upper case\n"); 

else 

printf("B is NOT upper case\n"); 

ch = 'b'; 

if (isupper(ch)) 

printf("b is upper case\n"); 

else 

printf("b is NOT upper case\n"); 

} 

Output: 

B is upper case 

b is NOT upper case 

isxdigit 

Description: Test for a hexadecimal digit. 

Include: 

Prototype: int isxdigit (int c); 


Return Value: Returns a non-zero integer value if the character is a hexadecimal 

digit; 


Remarks: A character is considered to be a hexadecimal digit character if it is in 

toupper (ch)); 

ch = '@'; 

printf ("@ có trường hợp noupper,"); 

printf ("% c để được trả lại \ n", toupper (ch)); 

} 

Đầu ra: 

b thay đổi đối với trường hợp trên B 

B vẫn còn trường hợp trên B 

@ Không có trường hợp trên, vì vậy @ được trả lại 



4.5 LỖI 

Các errno.hconsists tập tin tiêu đề của các macro cung cấp mã lỗi được báo cáo 

bởi chức năng thư viện nhất định (xem chức năng riêng biệt.) Sự trở lại 

errnomay biến 

bất kỳ giá trị lớn hơn không. Để kiểm tra xem một chức năng thư viện gặp một 

lỗi, chương trình sẽ lưu trữ các giá trị số không trong errnoimmediately trước 

khi gọi hàm thư viện. Giá trị cần được kiểm tra trước khi một cuộc gọi chức 

năng có thể thay đổi giá trị. 

Khi khởi động chương trình, errnois không. Chức năng thư viện sẽ không bao 

giờ đặt errnoto không. 

EDOM 

Mô tả: Đại diện cho một lỗi tên miền. 

Bao gồm: 

Bình luận: EDOMrepresents một lỗi miền, xảy ra khi một đối số đầu vào 

là bên ngoài lĩnh vực chức năng whichthe được xác định. 

ERANGE 

Mô tả: Đại diện một tràn hoặc lỗi Van cân bằng. 

Bao gồm: 

Bình luận: ERANGErepresents một tràn hoặc lỗi Van cân bằng, xảy ra khi 

Kết quả là quá lớn hoặc quá nhỏ để có thể lưu trữ. 

errno 

Mô tả: Chứa các giá trị của một lỗi whenan lỗi xảy ra trong một hàm. 

Bao gồm: 

Chú ý: errnois biến thiết lập một khác không giá trị số nguyên của một thư viện 

hoạt động khi xảy ra lỗi. Khi khởi động chương trình, errnois thiết lập để 

không. Errnoshould được thiết lập lại bằng không trước khi gọi một chức năng 

mà bộ 

nó. 

dsPIC 

® 


the range of '0'-'9', 'A'-'F' or 'a'-'f'.Note: The list does not include the 

leading 0x because 0x is the prefix for a hexadecimal number but is not 

an actual hexadecimal digit. 



Example: #include /*for isxdigit */ 



{ 

int ch; 

ch = 'B'; 

if (isxdigit(ch)) 

printf("B is a hexadecimal digit\n"); 

else 

printf("B is NOTa hexadecimal digit\n"); 

ch = 't'; 

if (isxdigit(ch)) 

printf("t is a hexadecimal digit\n"); 

else 

printf("t is NOTa hexadecimal digit\n"); 

} 

Output: 

B is a hexadecimal digit 

t is NOT a hexadecimal digit 

tolower 

Description: Convert a character to a lower case alphabetical character. 

Include: 

Prototype: int tolower (int c); 

Argument: c The character to convert to lower case. 

Return Value: Returns the corresponding lower case alphabetical character if 

the 

argument was originally upper case; otherwise, returns the original 

character. 

Remarks: Only upper case alphabetical characters may be converted to lower 

case. 

Example: #include /*for tolower */ 



{ 


4.6 ĐẶC ĐIỂM NỔI 


Các float.hconsists tập tin tiêu đề của các macro mà chỉ định thuộc tính khác 

nhau nổi 

loại điểm. Các tính chất này bao gồm số con số đáng kể, giới hạn kích thước, và 

những gì 

chế độ làm tròn được sử dụng. 

DBL_DIG 

Mô tả: Số chữ số thập phân có độ chính xác trong một độ chính xác kép nổi 

giá trị điểm 

Bao gồm: 

Giá trị: 6 theo mặc định, 15 công tắc -fno-ngắn doubleis sử dụng 

Ghi chú: Theo mặc định, một loại tăng gấp đôi là samesize như một kiểu float 

(32-bit 

đại diện). Các -fno-ngắn doubleswitch cho phép IEEE 

Đại diện 64-bit được sử dụng cho một điểm chính xác đôi nổi 

giá trị. 

DBL_EPSILON 

Mô tả: Sự khác biệt giữa 1.0 và biểu diễn tiếp theo lớn hơn gấp đôi 

chính xác giá trị dấu chấm động 

Bao gồm: 

Giá trị: 1.192093e-07 theo mặc định, 2.220446e-16 nếu chuyển đổi 

-fno-ngắn doubleis sử dụng 


(32-bit 



giá trị. 

DBL_MANT_DIG 

Mô tả: Số cơ sở-FLT_RADIXdigits trong một độ chính xác gấp đôi điểm nổi 

significand 

Bao gồm: 

Giá trị: 24 theo mặc định, 53 công tắc -fno-ngắn doubleis sử dụng 


(32-bit 

đại diện). The-fno-ngắn doubleswitch cho phép IEEE 


giá trị. 

DBL_MAX 

Mô tả: hữu hạn gấp đôi giá trị điểm tối đa độ chính xác nổi 

Bao gồm: 

Giá trị: 3.402823e + 38 theo mặc định, 1.797693e + 308 nếu chuyển đổi

int ch; 

ch = 'B'; 

printf("B changes to lower case %c\n", 

tolower(ch)); 

ch = 'b'; 

printf("b remains lower case %c\n", 

tolower(ch)); 

ch = '@'; 

printf("@ has no lower case, "); 

printf("so %c is returned\n", tolower(ch)); 

} 

Output: 

B changes to lower case b 

b remains lower case b 

@ has no lower case,so @ is returned 

isxdigit (Continued) 

dsPIC 

® 


DS51456B-page 204 

toupper 


Description: Convert a character to an upper case alphabetical character. 

Include: 

Prototype: int toupper (int c); 

Argument: c The character to convert to upper case. 

Return Value: Returns the corresponding upper case alphabetical character if 

the 

argument was originally lower case; otherwise, returns the original 

character. 

Remarks: Only lower case alphabetical characters may be converted to upper 

case. 

Example: #include /*for toupper */ 



{ 

int ch; 

ch = 'b'; 

printf("b changes to upper case %c\n", 

toupper(ch)); 



(32-bit 



giá trị. 



DBL_MAX_10_EXP 

Mô tả: giá trị số nguyên tối đa cho một số mũ điểm chính xác gấp đôi nổi trong 

10 cơ sở 

Bao gồm: 

Giá trị: 38 theo mặc định, 308 nếu chuyển đổi -fno-ngắn doubleis sử dụng 


(32-bit 



giá trị. 

DBL_MAX_EXP 

Mô tả: giá trị số nguyên tối đa cho một số mũ điểm chính xác gấp đôi nổi trong 

cơ sở FLT_RADIX 

Bao gồm: 

Giá trị: 128 theo mặc định, 1024 nếu chuyển đổi -fno-ngắn doubleis sử dụng 


(32-bit 



giá trị. 

DBL_MIN 

Mô tả: tối thiểu giá trị chính xác điểm nổi đôi 

Bao gồm: 

Giá trị: 1.175494e-38 theo mặc định, 2.225074e-308 nếu chuyển đổi 



(32-bit 



giá trị. 

DBL_MIN_10_EXP 

Mô tả: Giá trị số nguyên âm tối thiểu cho một điểm chính xác đôi nổi 

số mũ cơ số 10

ch = 'B'; 

printf("B remains upper case %c\n", 

toupper(ch)); 

ch = '@'; 

printf("@ has noupper case, "); 

printf("so %c is returned\n", toupper(ch)); 

} 

Output: 

b changes to upper case B 

Bao gồm: 

Giá trị: -37 theo mặc định, nếu chuyển đổi -307 -fno-ngắn doubleis sử dụng 


(32-bit 



giá trị. 

dsPIC 

® 


B remains upper case B 

@ has no upper case, so @ is returned 


DBL_MIN_EXP 




4.5 ERRORS 

The header file errno.hconsists of macros that provide error codes that are 

reported 

by certain library functions (see individual functions.) The variable errnomay 

return 

any value greater than zero. To test if a library function encounters an error, the 

program should store the value zero in errnoimmediately before calling the 

library function. The value should be checked before another function call could 

change the value. 

At program startup, errnois zero. Library functions will never set errnoto zero. 

EDOM 

Description: Represents a domain error. 

Include: 

Remarks: EDOMrepresents a domain error, which occurs when an input 

argument 

is outside the domain in whichthe function is defined. 

ERANGE 

Description: Represents an overflow or underflow error. 

Include: 

Remarks: ERANGErepresents an overflow or underflow error, which occurs 

when 

a result is too large or too small to be stored. 

errno 

Description: Contains the value of an error whenan error occurs in a function. 

Include: 

Remarks: The variable errnois set to a non-zero integer value by a library 

function when an error occurs. At program startup, errnois set to 

zero. Errnoshould be reset to zero prior to calling a function that sets 

it. 

Mô tả: Giá trị số nguyên âm tối thiểu cho một điểm chính xác đôi nổi 

mũ trong FLT_RADIX cơ sở 

Bao gồm: 

Giá trị: -125 theo mặc định, nếu chuyển đổi -1021 -fno-ngắn doubleis sử dụng 


(32-bit 



giá trị. 

FLT_DIG 

Mô tả: Số chữ số thập phân chính xác tại một điểm duy nhất chính xác nổi 

giá trị 

Bao gồm: 

Giá trị: 6 

FLT_EPSILON 

Mô tả: Sự khác biệt giữa 1.0 và duy nhất biểu diễn lớn hơn tiếp theo 

chính xác giá trị dấu chấm động 

Bao gồm: 

Giá trị: 1.192093e-07 

FLT_MANT_DIG 

Mô tả: Số cơ sở-FLT_RADIXdigits trong một đơn chính xác dấu chấm động 

significand 

Bao gồm: 

Giá trị: 24 

FLT_MAX 

Mô tả: hữu hạn đơn giá trị điểm tối đa độ chính xác nổi 

Bao gồm: 

Giá trị: 3.402823e + 38

dsPIC 

® 


DS51456B-page 206 


4.6 FLOATING-POINT CHARACTERISTICS 

The header file float.hconsists of macros that specify various properties of 

floating 

point types. These properties include number of significant figures, size limits, 

and what 

rounding mode is used. 

DBL_DIG 

Description: Number of decimal digits of precision in a double precision 

floating 

point value 

Include: 

Value: 6 by default, 15 if the switch -fno-short-doubleis used 

Remarks: By default, a double type is the samesize as a float type (32-bit 

representation). The -fno-short-doubleswitch allows the IEEE 

64-bit representation to be used for a double precision floating point 

value. 

DBL_EPSILON 

Description: The difference between 1.0 and the next larger representable 

double 

precision floating point value 

Include: 

Value: 1.192093e-07 by default, 2.220446e-16 if the switch 

-fno-short-doubleis used 




value. 

DBL_MANT_DIG 

Description: Number of base-FLT_RADIXdigits in a double precision floatingpoint 

significand 

Include: 



representation). The-fno-short-doubleswitch allows the IEEE 


value. 

FLT_MAX_10_EXP 

Mô tả: giá trị số nguyên tối đa cho một số mũ điểm chính xác đơn trôi nổi trong 

10 cơ sở 

Bao gồm: 




FLT_MAX_EXP 

Mô tả: giá trị số nguyên tối đa cho một số mũ điểm chính xác đơn trôi nổi trong 

cơ sở FLT_RADIX 

Bao gồm: 


FLT_MIN 

Mô tả: đơn giá trị điểm nổi chính xác tối thiểu 

Bao gồm: 

Giá trị: 1.175494e-38 

FLT_MIN_10_EXP 

Mô tả: Giá trị số nguyên âm tối thiểu cho một điểm duy nhất chính xác nổi 

số mũ cơ số 10 

Bao gồm: 

Giá trị: -37 

FLT_MIN_EXP 

Mô tả: Giá trị số nguyên âm tối thiểu cho một điểm duy nhất chính xác nổi 


Bao gồm: 


FLT_RADIX 

Mô tả: Radix đại diện mũ 

Bao gồm: 

Giá trị: 2 

Ghi chú: Các đại diện cơ sở của số mũ là cơ sở-2 hoặc nhị phân. 

FLT_ROUNDS 

Mô tả: Đại diện cho chế độ làm tròn cho các hoạt động nổi điểm 

Bao gồm: 

Giá trị: 1 

Bình luận: Rounds với giá trị biểu diễn gần 

LDBL_DIG 

Mô tả: Số chữ số thập phân có độ chính xác trong một độ chính xác kép dài 

điểm nổi giá trị

DBL_MAX 

Description: Maximum finite double precision floating point value 

Include: 

Value: 3.402823e+38 by default, 1.797693e+308 if the switch 





value. 



DBL_MAX_10_EXP 

Description: Maximum integer value for a double precision floating point 

exponent in 

base 10 

Include: 





value. 

DBL_MAX_EXP 

Description: Maximum integer value for a double precision floating point 

exponent in 

base FLT_RADIX 

Include: 





value. 

DBL_MIN 

Description: Minimum double precision floating point value 

Include: 

Value: 1.175494e-38 by default, 2.225074e-308 if the switch 





value. 

Bao gồm: 


dsPIC 

® 



LDBL_EPSILON 

Mô tả: Sự khác biệt giữa 1.0 và dài biểu diễn lớn hơn tiếp theo 

độ chính xác gấp đôi giá trị dấu chấm động 

Bao gồm: 

Giá trị: 2.220446e-16 

LDBL_MANT_DIG 

Mô tả: Số chữ số cơ sở-FLT_RADIX trong một độ chính xác kép dài 

điểm nổi significand 

Bao gồm: 


LDBL_MAX 

Mô tả: hữu hạn dài gấp đôi độ chính xác giá trị nổi điểm tối đa 

Bao gồm: 

Giá trị: 1.797693e + 308 

LDBL_MAX_10_EXP 

Mô tả: giá trị số nguyên tối đa cho một độ chính xác kép dài dấu chấm động 

số mũ cơ số 10 

Bao gồm: 


LDBL_MAX_EXP 

Mô tả: giá trị số nguyên tối đa cho một độ chính xác kép dài dấu chấm động 


Bao gồm: 


LDBL_MIN 

Mô tả: độ chính xác kép dài giá trị nổi-điểm tối thiểu 

Bao gồm: 

Giá trị: 2.225074e-308 

LDBL_MIN_10_EXP 

Mô tả: Giá trị số nguyên âm tối thiểu cho một độ chính xác kép dài 

điểm nổi số mũ cơ số 10 

Bao gồm: 

Giá trị: -307

DBL_MIN_10_EXP 

Description: Minimum negative integer value for a double precision floating 

point 

exponent in base 10 

Include: 

Value: -37 by default, -307 if the switch -fno-short-doubleis used 




value. 

dsPIC 

® 


DS51456B-page 208 

DBL_MIN_EXP 


Description: Minimum negative integer value for a double precision floating 

point 

exponent in base FLT_RADIX 

Include: 

Value: -125 by default, -1021 if the switch -fno-short-doubleis used 




value. 

FLT_DIG 

Description: Number of decimal digits of precision in a single precision floating 

point 

value 

Include: 

Value: 6 

FLT_EPSILON 

Description: The difference between 1.0 and the next larger representable single 

precision floating point value 

Include: 

Value: 1.192093e-07 

FLT_MANT_DIG 

Description: Number of base-FLT_RADIXdigits in a single precision floatingpoint 

significand 

Include: 

Value: 24 



4.7 GIỚI HẠN THỰC HIỆN-ĐỊNH NGHĨA 

Các limits.hconsists tập tin tiêu đề của các macro để xác định tối thiểu và tối đa 

giá trị của các loại nguyên. Mỗi một macro có thể được sử dụng trong 

#ifpreprocessing 

chỉ thị. 

LDBL_MIN_EXP 

Mô tả: Giá trị số nguyên âm tối thiểu cho một độ chính xác kép dài 

điểm nổi mũ trong FLT_RADIX cơ sở 

Bao gồm: 


CHAR_BIT 

Mô tả: Số bit để đại diện cho kiểu char 

Bao gồm: 

Giá trị: 8 

CHAR_MAX 

Mô tả: Giá trị tối đa của một char 

Bao gồm: 


CHAR_MIN 

Mô tả: Giá trị tối thiểu của một char 

Bao gồm: 


INT_MAX 

Mô tả: Giá trị tối đa của một int 

Bao gồm: 


INT_MIN 

Mô tả: Giá trị tối thiểu của một int 

Bao gồm: 

Giá trị: -32768 

LLONG_MAX 

Mô tả: Giá trị tối đa của một int dài dài 

Bao gồm: 

Giá trị: 9223372036854775807 

dsPIC 

® 




FLT_MAX 

Description: Maximum finite single precision floating point value 

Include: 

Value: 3.402823e+38 

FLT_MAX_10_EXP 

Description: Maximum integer value for a single precision floating point 

exponent in 

base 10 

Include: 

Value: 38 



FLT_MAX_EXP 

Description: Maximum integer value for a single precision floating point 

exponent in 

base FLT_RADIX 

Include: 

Value: 128 

FLT_MIN 

Description: Minimum single precision floating point value 

Include: 

Value: 1.175494e-38 

FLT_MIN_10_EXP 

Description: Minimum negative integer value for a single precision floating 

point 


Include: 

Value: -37 

FLT_MIN_EXP 

Description: Minimum negative integer value for a single precision floating 

point 


Include: 

Value: -125 

FLT_RADIX 

Description: Radix of exponent representation 

Include: 

Value: 2 

Remarks: The base representation of the exponent is base-2 or binary. 

FLT_ROUNDS 

Description: Represents the rounding mode for floating-point operations 

LLONG_MIN 

Mô tả: Giá trị tối thiểu của một int dài dài 

Bao gồm: 

Giá trị: -9223372036854775808 

LONG_MAX 

Mô tả: Giá trị tối đa của một int dài 

Bao gồm: 

Giá trị: 2147483647 

LONG_MIN 

Mô tả: Giá trị tối thiểu của một int dài 

Bao gồm: 

Giá trị: -2147483648 

MB_LEN_MAX 

Mô tả: Tối đa số byte trong một nhân vật nhiều byte 

Bao gồm: 

Giá trị: 1 

SCHAR_MAX 

Mô tả: Giá trị tối đa của một char ký 

Bao gồm: 


SCHAR_MIN 

Mô tả: Giá trị tối thiểu của một char ký 

Bao gồm: 


SHRT_MAX 

Mô tả: Giá trị tối đa của một int ngắn 

Bao gồm: 


SHRT_MIN 

Mô tả: Giá trị tối thiểu của một int ngắn 

Bao gồm: 

Giá trị: -32768 



4.8 Nội địa hoá 

Trình biên dịch này mặc định là miền địa phương C và không hỗ trợ bất kỳ 

ngôn ngữ khác; Do đó, 

nó không hỗ trợ các tập tin tiêu đề locale.h. Sau đây thường được tìm thấy 

trong tập tin này: 

• cấu trúc lconv

Include: 

Value: 1 

Remarks: Rounds to the nearest representable value 

LDBL_DIG 

Description: Number of decimal digits of precision in a long double precision 

floating-point value 

Include: 

Value: 15 

dsPIC 

® 



LDBL_EPSILON 

Description: The difference between 1.0 and the next larger representable long 

double precision floating-point value 

Include: 

Value: 2.220446e-16 

LDBL_MANT_DIG 

Description: Number of base-FLT_RADIX digits in a long double precision 

floating-point significand 

Include: 

Value: 53 

LDBL_MAX 

Description: Maximum finite long double precision floating-point value 

Include: 

Value: 1.797693e+308 

LDBL_MAX_10_EXP 

Description: Maximum integer value for a long double precision floating-point 


Include: 

Value: 308 

LDBL_MAX_EXP 

Description: Maximum integer value for a long double precision floating-point 


Include: 

Value: 1024 

LDBL_MIN 

Description: Minimum long double precision floating-point value 

Include: 

• NULL 

• LC_ALL 

• LC_COLLATE 

• LC_CTYPE 

• LC_MONETARY 

• LC_NUMERIC 

• LC_TIME 

• localeconv 

• setlocale 

UCHAR_MAX 

Mô tả: Giá trị tối đa của một unsigned char 

Bao gồm: 


UINT_MAX 

Mô tả: Giá trị tối đa của một int unsigned 

Bao gồm: 


ULLONG_MAX 

Mô tả: Giá trị tối đa của một lâu dài int 

Bao gồm: 

Giá trị: 18446744073709551615 

ULONG_MAX 

Mô tả: Giá trị tối đa của một int dài 

Bao gồm: 

Giá trị: 4294967295 

USHRT_MAX 

Mô tả: Giá trị tối đa của một ngắn unsigned int 

Bao gồm: 


dsPIC 

® 



4.9 Nhảy KHÔNG ĐỊA PHƯƠNG 


Các setjmp.hconsists tập tin tiêu đề của một loại, một chức năng Anda vĩ mô 

cho phép kiểm soát 

chuyển giao xảy ra bỏ qua các cuộc gọi chức năng bình thường và quá trình trở 

lại. 

jmp_buf 

Mô tả: Một loại đó là một mảng được sử dụng bởi setjmpand longjmpto lưu và

Value: 2.225074e-308 

LDBL_MIN_10_EXP 

Description: Minimum negative integer value for a long double precision 

floating-point exponent in base 10 

Include: 

Value: -307 



4.7 IMPLEMENTATION-DEFINED LIMITS 

The header file limits.hconsists of macros that define the minimum and 

maximum 

values of integer types. Each of these macros can be used in #ifpreprocessing 

directives. 

LDBL_MIN_EXP 

Description: Minimum negative integer value for a long double precision 

floating-point exponent in base FLT_RADIX 

Include: 

Value: -1021 

CHAR_BIT 

Description: Number of bits to represent type char 

Include: 

Value: 8 

CHAR_MAX 

Description: Maximum value of a char 

Include: 

Value: 127 

CHAR_MIN 

Description: Minimum value of a char 

Include: 

Value: -128 

INT_MAX 

Description: Maximum value of an int 

Include: 

Value: 32767 

INT_MIN 

Description: Minimum value of an int 

Include: 

Value: -32768 

LLONG_MAX 

phục hồi môi trường chương trình. 

Bao gồm: 

Prototype: typedef int jmp_buf [_NSETJMP]; 

Bình luận: _NSETJMPis định nghĩa là 16 + 2 đại diện cho 16 đăng ký và 

Địa chỉ trả lại 32-bit. 

setjmp 

Mô tả: Một vĩ mô mà lưu trạng thái hiện tại của chương trình để sử dụng sau 

này bằng cách 

longjmp. 

Bao gồm: 

Prototype: setjmp # define (jmp_buf env) 

Đối số: env biến nơi môi trường được lưu trữ 

Quay trở lại giá trị: Nếu sự trở lại là từ một cuộc gọi trực tiếp, setjmpreturns 

không. Nếu sự trở lại là 

từ một cuộc gọi đến longjmp, setjmpreturns một giá trị khác không. 

Lưu ý: Nếu valfrom luận longjmpis 0, setjmpreturns 1. 

Ví dụ: Xem longjmp. 

longjmp 

Mô tả: Chức năng này sẽ phục hồi môi trường lưu bởi setjmp. 

Bao gồm: 

Prototype: void longjmp (jmp_buf env, int val); 

Đối số: biến môi nơi môi trường được lưu trữ 

val giá trị được trả lại cho setjmp gọi. 

Ghi chú: Các giá trị tham số valshould có khác không. Nếu longjmpis gọi 

từ xử lý tín hiệu lồng nhau (có nghĩa là, gọi là kết quả của một tín hiệu 

đưa ra trong việc xử lý các tín hiệu khác), hành vi này là không xác định. 



4.10 XỬ LÝ TÍN HIỆU 

Các signal.hconsists tập tin tiêu đề của một loại, một số macro và hai chức năng 

định rõ các chương trình xử lý tín hiệu trong khi nó được thực hiện. Một tín 

hiệu là một điều kiện 

có thể được báo cáo trong quá trình thực hiện chương trình. Tín hiệu đồng bộ, 

xảy ra dưới sự kiểm soát phần mềm thông qua các raisefunction. 

Một tín hiệu có thể được xử lý bởi: 

• xử lý (SIG_DFL) Mặc định; tín hiệu được coi là một lỗi nghiêm trọng và thực 

hiện 

điểm dừng 

• Bỏ qua các tín hiệu (SIG_IGN); tín hiệu được bỏ qua và kiểm soát được trả lạ 

cho 

các ứng dụng người dùng 

• Xử lý tín hiệu với một chức năng được thông qua tín hiệu. 

Theo mặc định, tất cả các tín hiệu được xử lý bởi bộ xử lý mặc định, được xác

Description: Maximum value of a long long int 

Include: 

Value: 9223372036854775807 

dsPIC 

® 



LLONG_MIN 

Description: Minimum value of a long long int 

Include: 

Value: -9223372036854775808 

LONG_MAX 

Description: Maximum value of a long int 

Include: 

Value: 2147483647 

LONG_MIN 

Description: Minimum value of a long int 

Include: 

Value: -2147483648 

MB_LEN_MAX 

Description: Maximum number of bytes in a multibyte character 

Include: 

Value: 1 

SCHAR_MAX 

Description: Maximum value of a signed char 

định bởi 

SIG_DFL. 

Các loại sig_atomic_tis một loại nguyên do việc tiếp cận chương trình nguyên 

tử. Khi 

loại này được sử dụng với các từ khóa dễ bay hơi, xử lý tín hiệu có thể chia sẻ 

dữ liệu 

các đối tượng với phần còn lại của chương trình. 

sig_atomic_t 

Mô tả: Một loại được sử dụng bởi một bộ xử lý tín hiệu 

Bao gồm: 

Prototype: typedef int sig_atomic_t; 

SIG_DFL 

Mô tả: Sử dụng như đối số thứ hai và / hoặc giá trị trả về cho signalto 

xác định rằng việc xử lý mặc định sẽ được sử dụng cho một tín hiệu cụ thể. 

Bao gồm: 

SIG_ERR 

Mô tả: Được sử dụng như giá trị trả về cho signalwhen nó không thể hoàn thành 

một 

yêu cầu do một lỗi. 

Bao gồm: 

SIG_IGN 

Mô tả: Sử dụng như đối số thứ hai và / hoặc giá trị trả về cho signalto 

xác định rằng các signalshould bị bỏ qua. 

Bao gồm: 

dsPIC 

® 


Include: 

Value: 127 


SIGABRT 


SCHAR_MIN 

Description: Minimum value of a signed char 

Include: 

Value: -128 

SHRT_MAX 

Description: Maximum value of a short int 

Include: 

Value: 32767 

SHRT_MIN 

Description: Minimum value of a short int 

Include: 

Value: -32768 

Mô tả: Đặt tên cho các tín hiệu chấm dứt bất thường. 

Bao gồm: 

Prototype: # define SIGABRT 

Bình luận: SIGABRTrepresents một tín hiệu chấm dứt bất thường và được sử 

dụng trong 

kết hợp với tín hiệu raiseor. Các raisebehavior mặc định 

(Hành động xác định bởi SIG_DFL) là đầu ra cho dòng sai số chuẩn: 

hủy bỏ - chấm dứt 

Xem ví dụ đi kèm signalto thấy sử dụng chung của 

tên tín hiệu và xử lý tín hiệu. 

Ví dụ: # include / * Cho tăng lương, SIGABRT * / 




4.8 LOCALIZATION 

This compiler defaults to the C locale and does not support any other locales; 

therefore 

it does not support the header file locale.h. The following would normally be 

found 

in this file: 

• struct lconv 

• NULL 

•LC_ALL 

• LC_COLLATE 

• LC_CTYPE 

• LC_MONETARY 

• LC_NUMERIC 

• LC_TIME 

• localeconv 

• setlocale 

UCHAR_MAX 

Description: Maximum value of an unsigned char 

Include: 

Value: 255 

UINT_MAX 

Description: Maximum value of an unsigned int 

Include: 

Value: 65535 

ULLONG_MAX 

Description: Maximum value of a long long unsigned int 

Include: 

Value: 18446744073709551615 

ULONG_MAX 

Description: Maximum value of a long unsigned int 

Include: 

Value: 4294967295 

USHRT_MAX 

Description: Maximum value of an unsigned short int 

Include: 

Value: 65535 

dsPIC 

® 


{ 

nâng cao (SIGABRT); 

printf ("Chương trình không bao giờ đạt ở đây."); 

} 

Đầu ra: 

ABRT 

Giải thích: 

ABRT viết tắt của "hủy bỏ". 

SIGFPE 

Mô tả: Tín hiệu báo lỗi dấu chấm động như phân chia cho số không hoặc kết 

quả của 

phạm vi. 

Bao gồm: 

Prototype: # define SIGFPE 

Bình luận: SIGFPEis sử dụng như một tham số cho raiseand / hoặc tín hiệu. Kh 

được sử dụng, hành vi mặc định là in một thông báo lỗi số học và 

chấm dứt chương trình gọi điện thoại. Điều này có thể được ghi đè bởi một 

người dùng 

chức năng xác định các hành động xử lý tín hiệu. Xem signalfor một 

ví dụ về một người dùng xác định chức năng. 

Ví dụ: # include / * Cho tăng lương, SIGFPE * / 



{ 

nâng cao (SIGFPE); 

printf ("Chương trình không bao giờ đạt ở đây"); 

} 

Đầu ra: 

FPE 


FPE là viết tắt của "dấu chấm động lỗi". 



SIGILL 

Mô tả: Tín hiệu lệnh bất hợp pháp. 

Bao gồm: 

Prototype: # define SIGILL 

Bình luận: SIGILLis sử dụng như một tham số cho raiseand / hoặc tín hiệu. Khi 

được sử dụng, hành vi mặc định là in một mã thực thi không hợp lệ 

thông báo và chấm dứt chương trình gọi điện thoại. Điều này có thể được ghi đ


DS51456B-page 214 


4.9 NON-LOCAL JUMPS 

The header file setjmp.hconsists of a type, a macro anda function that allow 

control 

transfers to occur that bypass the normal function call and return process. 

jmp_buf 

Description: A type that is an array used by setjmpand longjmpto save and 

restore the program environment. 

Include: 

Prototype: typedef int jmp_buf[_NSETJMP]; 

Remarks: _NSETJMPis defined as 16 + 2 that represents 16 registers and a 

32-bit return address. 

setjmp 

Description: A macro that saves the current state of the program for later use by 

longjmp. 

Include: 

Prototype: #define setjmp(jmp_buf env) 

Argument: env variable where environment is stored 

Return Value: If the return is from a direct call, setjmpreturns zero. If the return 

is 

from a call to longjmp, setjmpreturns a non-zero value. 

Note:If the argument valfrom longjmpis 0, setjmpreturns 1. 

Example: See longjmp. 

longjmp 

Description: A function that restores the environment saved by setjmp. 

Include: 

Prototype: void longjmp(jmp_buf env, int val); 

Arguments: env variable where environment is stored 

val value to be returned to setjmp call. 

Remarks: The value parameter valshould be non-zero. If longjmpis invoked 

from a nested signal handler (that is, invoked as a result of a signal 

raised during the handling of another signal), the behavior is undefined. 



4.10 SIGNAL HANDLING 

The header file signal.hconsists of a type, several macros and two functions that 

specify how the program handles signals while it is executing. A signal is a 

condition 

that may be reported during the program execution. Signals are synchronous, 

occurring under software control via the raisefunction. 

bởi 

một chức năng người dùng định nghĩa các hành động xử lý tín hiệu. Xem 

signalfor 

một ví dụ về một người dùng xác định chức năng. 

Ví dụ: # include / * Forraise, SIGILL * / 



{ 

nâng cao (SIGILL); 


} 

Đầu ra: 

ILL 


ILL là viết tắt của "hướng dẫn bất hợp pháp". 

SIGINT 

Mô tả: tín hiệu ngắt. 

Bao gồm: 

Prototype: # define SIGINT 

Bình luận: SIGINTis sử dụng như một tham số cho raiseand / hoặc tín hiệu. Kh 

được sử dụng, hành vi mặc định là in một thông bị gián đoạn và 

chấm dứt chương trình gọi điện thoại. Thismay được ghi đè bởi một người dùng 



Ví dụ: # include / * Forraise, SIGINT * / 



{ 

nâng cao (SIGINT); 


} 

Đầu ra: 

INT 


INT là viết tắt của "gián đoạn". 

dsPIC 

® 



SIGSEGV 


A signal may be handled by: 

• Default handling (SIG_DFL); the signal is treated as a fatal error and 

execution 

stops 

• Ignoring the signal (SIG_IGN); the signal is ignored and control is returned to 

the user application 

• Handling the signal with a function designated via signal. 

By default all signals are handled by the default handler, which is identified by 

SIG_DFL. 

The type sig_atomic_tis an integer type that the program access atomically. 

When 

this type is used with the keyword volatile, the signal handler can share the data 

objects with the rest of the program. 

sig_atomic_t 

Description: A type used by a signal handler 

Include: 

Prototype: typedef int sig_atomic_t; 

SIG_DFL 

Description: Used as the second argument and/or the return value for signalto 

specify that the default handler should be used for a specific signal. 

Include: 

SIG_ERR 

Description: Used as the return value for signalwhen it cannot complete a 

request due to an error. 

Include: 

SIG_IGN 

Description: Used as the second argument and/or the return value for signalto 

specify that the signalshould be ignored. 

Include: 

dsPIC 

® 


Mô tả: Tín hiệu truy cập không hợp lệ để lưu trữ. 

Bao gồm: 

Prototype: # define SIGSEGV 

Bình luận: SIGSEGVis sử dụng như một tham số cho raiseand / hoặc tín 

hiệu. Khi 

được sử dụng, hành vi mặc định là in một yêu cầu lưu trữ không hợp lệ 

thông báo và chấm dứt chương trình gọi điện thoại. Điều này có thể được ghi đ 

bởi 

một chức năng người dùng định nghĩa các hành động xử lý tín hiệu. Xem 

signalfor 

một ví dụ về một người dùng xác định chức năng. 

Ví dụ: # include / * Cho tăng lương, SIGSEGV * / 



{ 

nâng cao (SIGSEGV); 


} 

Đầu ra: 

SEGV 


SEGV viết tắt của "truy cập lưu trữ không hợp lệ". 

SIGTERM 

Mô tả: Tín hiệu yêu cầu chấm dứt 

Bao gồm: 

Prototype: # define SIGTERM 

Bình luận: SIGTERMis sử dụng như một tham số cho raiseand / hoặc tín 

hiệu. Khi 

được sử dụng, hành vi mặc định là in một thông báo yêu cầu chấm dứt 

và chấm dứt chương trình gọi điện thoại. Điều này có thể được ghi đè bởi một 

người dùng 



Ví dụ: # include / * Cho tăng lương, SIGTERM * / 

DS51456B-page 216 

SIGABRT 




Description: Name for the abnormal termination signal. 

Include: 

Prototype: #define SIGABRT 

Remarks: SIGABRTrepresents an abnormal termination signal and is used in 

conjunction with raiseor signal. The default raisebehavior 

(action identified by SIG_DFL) is to output to the standard error stream: 

{ 

nâng cao (SIGTERM); 


} 

Đầu ra: 

HẠN

abort - terminating 

See the example accompanying signalto see general usage of 

signal names and signal handling. 

Example: #include /* for raise, SIGABRT */ 



{ 

raise(SIGABRT); 

printf("Program never reaches here."); 

} 

Output: 

ABRT 

Explanation: 

ABRT stands for “abort”. 

SIGFPE 

Description: Signals floating-point error such as for division by zero or result 

out of 

range. 

Include: 

Prototype: #define SIGFPE 

Remarks: SIGFPEis used as an argument for raiseand/or signal. When 

used, the default behavior is to print an arithmetic error message and 

terminate the calling program. This may be overridden by a user 

function that defines the signal handler actions. See signalfor an 

example of a user defined function. 

Example: #include /* for raise, SIGFPE */ 



{ 

raise(SIGFPE); 

printf("Program never reaches here"); 

} 

Output: 

FPE 

Explanation: 

FPE stands for “floating-point error”. 



SIGILL 


HẠN viết tắt của "yêu cầu chấm dứt". 



nâng cao 

Mô tả: Báo cáo một tín hiệu đồng bộ. 

Bao gồm: 

Nguyên mẫu: int tăng (int sig); 

Đối số: sig tên tín hiệu 

Quay trở lại giá trị: Trả về 0 nếu thành công; nếu không, trả về giá trị khác 

không. 

Bình luận: raisesends tín hiệu xác định bysig cho chương trình thực hiện. 

Ví dụ: # include / * Cho tăng, tín hiệu, * / 

/ * SIGILL, SIG_DFL * / 

# include / * Cho div, div_t * / 


# include / * Cho INTCON1bits * / 

khoảng trống __attribute __ ((__ interrupt__)) 

_MathError (Void) 

{ 


INTCON1bits.MATHERR = 0; 

} 

khoảng trống illegalinsn (int idsig) 

{ 

printf ("bất hợp pháp hướng dẫn thực hiện \ n"); 

exit (1); 

} 


{ 

int x, y; 

z div_t; 

tín hiệu (SIGILL, illegalinsn); 

x = 7; 

y = 0; 

z = div (x, y); 


} 

Đầu ra: 

Hướng dẫn thực hiện bất hợp pháp

Description: Signals illegal instruction. 

Include: 

Prototype: #define SIGILL 

Remarks: SIGILLis used as an argument for raiseand/or signal. When 

used, the default behavior is to print an invalid executable code 

message and terminate the calling program. This may be overridden by 

a user function that defines the signal handler actions. See signalfor 

an example of a user defined function. 

Example: #include /* forraise, SIGILL */ 



{ 

raise(SIGILL); 


} 

Output: 

ILL 

Explanation: 

ILL stands for “illegal instruction”. 

SIGINT 

Description: Interrupt signal. 

Include: 

Prototype: #define SIGINT 

Remarks: SIGINTis used as an argument for raiseand/or signal. When 

used, the default behavior is to print an interruption message and 

terminate the calling program. Thismay be overridden by a user 



Example: #include /* forraise, SIGINT */ 



{ 

raise(SIGINT); 


} 

Output: 

INT 

Explanation: 

INT stands for “interruption”. 


Ví dụ này đòi hỏi các mối liên kết p30f6014.gld kịch bản. Có ba 

các bộ phận để ví dụ này. 

Đầu tiên, một xử lý ngắt được viết cho các vector ngắt 

_MathErrorto Xử lý một lỗi toán học bằng cách gửi một lệnh bất hợp pháp 

tín hiệu (SIGILL) để chương trình thực hiện. Tuyên bố cuối cùng trong 

gián đoạn xử lý xóa cờ ngoại lệ. 

Thứ hai, các chức năng illegalinsnwill in một thông báo lỗi và 

thoát cuộc gọi. 

Thứ ba, chính, tín hiệu (SIGILL, illegalinsn) bộ xử lý 

cho SIGILLto chức năng illegalinsn. 

Khi một lỗi toán học xảy ra, do một chia cho số không, các _MathError 

vector ngắt được gọi, mà lần lượt sẽ nâng cao một tín hiệu rằng sẽ gọi 

chức năng xử lý cho SIGILL, đó là chức năng illegalinsn. 

Vì vậy, các thông báo lỗi được in và chương trình được chấm dứt. 

dsPIC 

® 



tín hiệu 

Mô tả: Điều khiển gián đoạn xử lý tín hiệu. 

Bao gồm: 

Nguyên mẫu: void (* tín hiệu (int sig, void (* func) (int))) (int); 

Đối số: sig tên tín hiệu 

chức năng Func được thực hiện 

Quay trở lại giá trị: Trả về giá trị trước đó của Func. 

Ví dụ: # include / * Cho tín hiệu, nâng cao, * / 

/ * SIGINT, SIGILL, * / 

/ * SIG_IGN, và SIGFPE * / 


/ * Chức năng xử lý tín hiệu * / 

khoảng trống mysigint (int id) 

{ 

printf ("SIGINT nhận \ n"); 

} 


{ 

/ * Ghi đè mặc định với người dùng xác định chức năng * / 

tín hiệu (SIGINT, mysigint);

dsPIC 

® 



SIGSEGV 

Description: Signals invalid access to storage. 

Include: 

Prototype: #define SIGSEGV 

Remarks: SIGSEGVis used as an argument for raiseand/or signal. When 

used, the default behavior is to print an invalid storage request 

message and terminate the calling program. This may be overridden by 

a user function that defines the signal handler actions. See signalfor 

an example of a user defined function. 

Example: #include /* for raise, SIGSEGV */ 



{ 

raise(SIGSEGV); 


} 

Output: 

SEGV 

Explanation: 

SEGV stands for “invalid storage access”. 

SIGTERM 

Description: Signals a termination request 

Include: 

Prototype: #define SIGTERM 

Remarks: SIGTERMis used as an argument for raiseand/or signal. When 

used, the default behavior is to print a termination request message 

and terminate the calling program. This may be overridden by a user 



Example: #include /* for raise, SIGTERM */ 



{ 

raise(SIGTERM); 


nâng cao (SIGINT); 

/ * Bỏ qua xử lý tín hiệu * / 

tín hiệu (SIGILL, SIG_IGN); 


printf ("SIGILL đã bị bỏ qua \ n"); 

/ * Sử dụng tín hiệu mặc định xử lý * / 

nâng cao (SIGFPE); 


} 

Đầu ra: 

SIGINT nhận 

SIGILL đã bị bỏ qua 

FPE 


Các chức năng xử lý tín hiệu mysigintis người dùng định nghĩa cho SIGINT. 

Bên trong chương trình chính, chức năng signalis gọi thành lập 

xử lý tín hiệu (mysigint) cho SIGINTthat tín hiệu sẽ ghi đè lên 

hành động mặc định. Chức năng raiseis gọi đến báo tín hiệu 

SIGINT. Điều này làm cho xử lý tín hiệu cho SIGINTto sử dụng 

người dùng định nghĩa chức năng (mysigint) như là xử lý tín hiệu để nó in 

"SIGINT nhận được" tin nhắn. 

Tiếp theo, chức năng signalis kêu gọi thiết lập xử lý tín hiệu 

SIG_IGNfor các SIGILL tín hiệu. Các SIG_IGNis liên tục được sử dụng để 

chỉ ra shouldbe tín hiệu bỏ qua. Chức năng raiseis kêu gọi 

báo cáo SIGILLthat tín hiệu được bỏ qua. 

Chức năng raiseis gọi một lần nữa để báo cáo SIGFPE tín hiệu. Kể từ 

không có người sử dụng được xác định chức năng cho SIGFPE, xử lý tín hiệu 

mặc định 

được sử dụng để thông báo "FPE" được in (viết tắt của 

"Lỗi số học - chấm dứt") Sau đó, chương trình gọi là. 

chấm dứt. Các printfstatement không bao giờ đạt được. 



4.11 DANH MỤC LUẬN BIẾN 

Các tập tin tiêu đề stdarg.hsupports chức năng với danh sách đối số biến. Điều 

này cho phép 

chức năng để có những lập luận mà không cần khai báo tham số tương ứng. Có 

phải có ít nhất một đối số được đặt tên. Các đối số biến được biểu diễn bằng 

bầu dục (...). Một đối tượng của loại va_listmust được khai báo trong các chức 

năng để giữ 

các đối số. va_startwill khởi tạo biến một danh sách đối số, va_argwill

} 

Output: 

TERM 

Explanation: 

TERM stands for “termination request”. 



raise 

Description: Reports a synchronous signal. 

Include: 

Prototype: int raise(int sig); 

Argument: sig signal name 

Return Value: Returns a 0 if successful; otherwise, returns a nonzero value. 

Remarks: raisesends the signal identified bysig to the executing program. 

Example: #include /*for raise, signal, */ 

/* SIGILL, SIG_DFL */ 

#include /* for div, div_t */ 


#include /*for INTCON1bits */ 

void __attribute__((__interrupt__)) 

_MathError(void) 

{ 


INTCON1bits.MATHERR = 0; 

} 

void illegalinsn(int idsig) 

{ 

printf("Illegal instruction executed\n"); 

truy cập vào danh sách đối số, và va_endwill chấm dứt việc sử dụng của các đố 

số. 

va_list 

Mô tả: Các loại va_listdeclares một biến mà sẽ đề cập đến từng đối số 

trong một danh sách đối số chiều dài thay đổi. 

Bao gồm: 

Ví dụ: Xem va_arg. 

va_arg 

Mô tả: Được tranh luận hiện nay 

Bao gồm: 

Prototype: va_arg # define (va_list ap, Ty) 

Đối số: ap con trỏ đến danh sách các đối số 

Ty loại đối số được lấy ra 

Quay trở lại giá trị: Trả về đối số hiện nay 

Bình luận: va_startmust được gọi trước khi va_arg. 

Ví dụ: # include / * Cho printf * / 

# include / * Cho va_arg, va_start, 

va_list, va_end * / 

khoảng trống tprint (const char * fmt, ...) 

{ 

va_list ap; 

va_start (ap, fmt); 

trong khi (* fmt) 

{ 

chuyển đổi (* fmt) 

{ 

dsPIC 

® 


exit(1); 

} 


{ 

int x, y; 

div_t z; 


trường hợp '%': 

fmt ++; 

if (* fmt == 'd') 

{ 

int d = va_arg (ap, int); 


signal(SIGILL, illegalinsn); 

x = 7; 

y = 0; 

z = div(x, y); 


printf (" là một số nguyên \ n", d); 

} 

else if (* == fmt 's') 

{ 

char * s = va_arg (ap, char *);

} 

Output: 

Illegal instruction executed 

Explanation: 

This example requires the linker script p30f6014.gld. There are three 

parts to this example. 

First, an interrupt handler is written for the interrupt vector 

_MathErrorto handle a math error by sending an illegal instruction 

signal (SIGILL)to the executing program. The last statement in 

the interrupt handler clears the exception flag. 

Second, the function illegalinsnwill print an error message and 

call exit. 

Third, in main, signal (SIGILL, illegalinsn)sets the handler 

for SIGILLto the function illegalinsn. 

When a math error occurs, due to a divide by zero, the _MathError 

interrupt vector is called, which in turn will raise a signal that will call the 

handler function for SIGILL, which is the function illegalinsn. 

Thus error messages are printed and the program is terminated. 

dsPIC 

® 



signal 

Description: Controls interrupt signal handling. 

Include: 

Prototype: void (*signal(int sig, void(*func)(int)))(int); 

Arguments: sig signal name 

func function to be executed 

Return Value: Returns the previous value of func. 

Example: #include /* for signal, raise, */ 

/* SIGINT, SIGILL, */ 

/* SIG_IGN, and SIGFPE */ 


/* Signal handler function */ 

void mysigint(int id) 

{ 

printf("SIGINT received\n"); 

} 


printf (" là một chuỗi \ n", s); 

} 

khác 

{ 

printf ("%%% c là một định dạng không rõ \ n", 

* Fmt); 

} 

fmt ++; 

phá vỡ; 

mặc định: 

printf ("% c là không rõ \ n", * fmt); 

fmt ++; 

phá vỡ; 

} 

} 

va_end (ap); 

} 


{ 

tprint (".% d% s% c", 83, "Đây là văn bản.", 'a'); 

} 

Đầu ra: 

là một số nguyên 

là một chuỗi 

. không biết 

% C là một định dạng chưa biết 

va_arg (Tiếp theo) 



4.12 ĐỊNH NGHĨA CHUNG 

Các stddef.hconsists tập tin tiêu đề của một số loại và macro có công dụng 

chung 

trong các chương trình. 

va_end 

Mô tả: Kết thúc việc sử dụng ap. 

Bao gồm: 

Prototype: va_end # define (va_list ap) 


Ghi chú: Sau khi một cuộc gọi đến va_end, các apis con trỏ danh sách đối số 

được coi là 

không hợp lệ. Cuộc gọi hơn nữa để va_argshould không được thực hiện cho đến

{ 

/* Override default with user defined function */ 

signal(SIGINT, mysigint); 

raise(SIGINT); 

/* Ignore signal handler */ 

signal(SIGILL, SIG_IGN); 


printf("SIGILL was ignored\n"); 

/* Use default signal handler */ 

raise(SIGFPE); 


} 

Output: 

SIGINT received 

SIGILL was ignored 

FPE 

Explanation: 

The function mysigintis the user-defined signal handler for SIGINT. 

Inside the main program, the function signalis called to set up the 

signal handler (mysigint) for the signal SIGINTthat will override the 

default actions. The function raiseis called to report the signal 

SIGINT. This causes the signal handler for SIGINTto use the 

user-defined function (mysigint) as the signal handler so it prints the 

"SIGINT received" message. 

Next, the function signalis called to set up the signal handler 

SIG_IGNfor the signal SIGILL. The constant SIG_IGNis used to 

indicate the signal shouldbe ignored. The function raiseis called to 

report the signal SIGILLthat is ignored. 

The function raiseis called again to report the signal SIGFPE. Since 

there is no user defined function for SIGFPE, the default signal handler 

is used so the message "FPE" is printed (which stands for 

"arithmetic error - terminating”.) Then the calling program is 

terminated. The printfstatement is never reached. 



4.11 VARIABLE ARGUMENT LISTS 

The header file stdarg.hsupports functions with variable argument lists. This 

allows 

functions to have arguments without corresponding parameter declarations. 

There 

khi tới 

va_start. Trong MPLAB C30, va_enddoes gì, vì vậy cuộc gọi này không phải là 

cần thiết, nhưng nên được sử dụng để có thể đọc và tính di động. 


va_start 

Mô tả: Thiết lập con trỏ luận APTO đối số tùy chọn đầu tiên trong 

danh sách đối số chiều dài thay đổi 

Bao gồm: 

Prototype: va_start # define (va_list ap, last_arg) 


last_arg tên đối số cuối cùng trước khi các đối số tùy chọn 


ptrdiff_t 

Mô tả: Các loại kết quả ofsubtracting hai con trỏ. 

Bao gồm: 

size_t 

Mô tả: Các loại kết quả của sizeofoperator. 

Bao gồm: 

wchar_t 

Mô tả: Một loại chứa một giá trị nhân vật rộng. 

Bao gồm: 

NULL 

Mô tả: Giá trị của một con trỏ hằng null. 

Bao gồm: 

dsPIC 

® 



offsetof 


Mô tả: Cung cấp cho bù đắp của một thành viên cơ cấu từ đầu 

cấu trúc. 

Bao gồm: 

Prototype: # define offsetof (T, MBR) 

Đối số: tname cấu trúc 

MBR tên của thành viên trong cấu trúc T 

Quay trở lại giá trị: Trả về bù đắp bằng byte của các thành viên được chỉ định 

(MBR) từ 

bắt đầu của cấu trúc. 

Chú ý: offsetofis vĩ mô không xác định cho bitfields. Một thông báo lỗi sẽ 

xảy ra nếu bitfields được sử dụng.

must be at least one named argument. The variable arguments are represented 

by 

ellipses (...). An object of type va_listmust be declared inside the function to 

hold 

the arguments. va_startwill initialize the variable to an argument list, va_argwill 

access the argument list, and va_endwill end the use of the argument. 

va_list 

Description: The type va_listdeclares a variable that will refer to each argument 

in a variable-length argument list. 

Include: 

Example: See va_arg. 

va_arg 

Description: Gets the current argument 

Include: 

Prototype: #define va_arg(va_list ap, Ty) 

Argument: ap pointer to list of arguments 

Ty type of argument to be retrieved 

Return Value: Returns the current argument 

Remarks: va_startmust be called before va_arg. 

Example: #include /* for printf */ 

#include /*for va_arg, va_start, 

va_list, va_end */ 

void tprint(const char *fmt, ...) 

{ 

va_list ap; 

va_start(ap, fmt); 

while (*fmt) 

{ 

switch (*fmt) 

{ 

dsPIC 

® 


Ví dụ: # include / * Cho offsetof * / 


thông tin cấu trúc { 

char item1 [5]; 

int Item2; 

char Item3; 

nổi item4; 

}; 


{ 

printf ("Offset của item1 =% d \ n", 

offsetof (thông tin cấu trúc, item1)); 

printf ("Offset của Item2 =% d \ n", 

offsetof (thông tin cấu trúc, Item2)); 

printf ("Offset của Item3 =% d \ n", 

offsetof (thông tin cấu trúc, Item3)); 

printf ("Offset của item4 =% d \ n", 

offsetof (thông tin cấu trúc, item4)); 

} 

Đầu ra: 

Offset của item1 = 0 

Offset của Item2 = 6 

Offset của Item3 = 8 

Offset của item4 = 10 


Chương trình này cho thấy sự bù đắp bằng byte của mỗi thành viên trong cấu 

trúc từ 

bắt đầu của cấu trúc. Mặc dù item1is chỉ 5 byte (char 

item1 [5]), đệm được thêm vào để địa chỉ của item2falls trên 

thậm chí ranh giới. Điều tương tự cũng xảy ra với Item3; nó là 1 byte (char 

Item3) với 1 byte padding. 



DS51456B-page 222 

case '%': 

fmt++; 

if (*fmt == 'd') 


4.13 Vào và đầu ra 

Các stdio.hconsists tập tin tiêu đề của các loại, macro và các chức năng cung 

cấp hỗ trợ 

để thực hiện các hoạt động đầu vào và đầu ra trên các tập tin và suối. Khi một 

tập tin được mở ra nó là 

{ 

int d = va_arg(ap, int); 

printf(" is an integer\n",d); 

kết hợp với một dòng suối. Một dòng là một đường ống dẫn cho các luồng dữ 

liệu vào và ra khỏi các tập tin. 

Bởi vì hệ thống khác nhau sử dụng các thuộc tính khác nhau, dòng cung cấp 

đồng đều hơn

} 

else if (*fmt == 's') 

{ 

char *s = va_arg(ap, char*); 

printf(" is a string\n", s); 

} 

else 

{ 

printf("%%%c is an unknown format\n", 

*fmt); 

} 

fmt++; 

break; 

default: 

printf("%c is unknown\n", *fmt); 

fmt++; 

break; 

} 

} 

va_end(ap); 

} 


{ 

tprint("%d%s.%c", 83, "This is text.", 'a'); 

} 

Output: 

is an integer 

is a string 

. is unknown 

%c is an unknown format 

va_arg (Continued) 



4.12 COMMON DEFINITIONS 

The header file stddef.hconsists of several types and macros that are of general 

use 

in programs. 

va_end 

Description: Ends the use of ap. 

bất động sản để cho phép đọc và viết các tập tin. 

Streams có thể dòng văn bản hoặc dòng nhị phân. Dòng văn bản bao gồm một 

chuỗi các 

nhân vật chia thành dòng. Mỗi dòng được kết thúc bằng một dòng mới ('\ n') 

nhân vật. 

Các nhân vật có thể được thay đổi trong internalrepresentation của họ, đặc biệt 

là liên quan đến 

kết thúc dòng. Dòng nhị phân bao gồm chuỗi các byte thông tin. Các byte 

chuyển đến các dòng nhị phân không altered.There có khái niệm về dòng, tập 

tin là 

chỉ là một loạt các byte. 

Khi khởi động ba dòng sẽ được tự động mở ra: stdin, stdout, và stderr. 

stdinprovides một dòng cho đầu vào tiêu chuẩn, stdoutis đầu ra tiêu chuẩn và 

thiết bị lỗi chuẩn 

là sai số chuẩn. Dòng bổ sung có thể được tạo ra với fopenfunction. Xem 

fopenfor các loại khác nhau của tập tin truy cập được phép. Những loại truy cập 

được 

được sử dụng bởi fopenand freopen. 

Các FILEis loại được sử dụng để lưu trữ thông tin về mỗi dòng mở tập tin. Nó 

bao gồm 

những thứ như chỉ số lỗi, cuối cùng các chỉ số tập tin, thị vị trí của tập tin, và 

các 

tình trạng thông tin nội bộ cần thiết để kiểm soát một dòng suối. Nhiều chức 

năng trong stdio 

sử dụng FILEas một cuộc tranh cãi. 

Có ba loại đệm: bộ đệm, dòng đệm và đệm đầy đủ. Unbuffered có nghĩa là một 

nhân vật hay byte được chuyển giao tại một thời điểm. Dòng đệm và thu thập 

những 

chuyển toàn bộ một dòng một lúc (ví dụ, các ký tự xuống dòng cho biết kết thú 

của một dòng.) 

Đệm đầy đủ cho phép các khối kích thước tùy ý được truyền đi. Các chức năng 

setbufand tập setvbufcontrol đệm. 

Các stdio.hfile cũng chứa các chức năng sử dụng các định dạng đầu vào và đầu 

ra. Các đầu vào 

định dạng, hoặc các định dạng quét, được sử dụng để đọc dữ liệu. Mô tả của họ 

có thể được tìm thấy 

dưới scanf, nhưng họ cũng được sử dụng bởi sscanf fscanfand. Các định dạng 

đầu ra, hoặc 

định dạng in ấn, được sử dụng để ghi dữ liệu. Mô tả của họ có thể được tìm thấy 

dưới printf. 

Các định dạng in ấn cũng được sử dụng bởi fprintf, sprintf, vfprintf, vprintfand 

vsprintf. 

Một số tùy chọn trình biên dịch có thể ảnh hưởng đến cách tiêu chuẩn I / O thực 

hiện. Trong một nỗ lực để cung cấp 

một phiên bản phù hợp hơn của thói quen định dạng I / O, dây chuyền công cụ 

có thể chuyển đổi một cuộc gọi 

đến một chức năng scanfstyle printfor một cuộc gọi khác nhau. Các tùy chọn 

được tóm tắt 

dưới đây:

Include: 

Prototype: #define va_end(va_list ap) 


Remarks: After a call to va_end, the argument list pointer apis considered to be 

invalid. Further calls to va_argshould not be made until the next 

va_start. In MPLAB C30, va_enddoes nothing, so this call is not 

necessary but should be used for readability and portability. 


va_start 

Description: Sets the argument pointer apto first optional argument in the 

variable-length argument list 

Include: 

Prototype: #define va_start(va_list ap, last_arg) 


last_arg last named argument before the optional arguments 


ptrdiff_t 

Description: The type of the result ofsubtracting two pointers. 

Include: 

size_t 

Description: The type of the result of the sizeofoperator. 

Include: 

wchar_t 

Description: A type that holds a wide character value. 

Include: 

NULL 

Description: The value of a null pointer constant. 

Include: 

dsPIC 

® 



offsetof 

Description: Gives the offset of a structure member from the beginning of the 

structure. 

Include: 

Prototype: #define offsetof(T, mbr) 

Arguments: Tname of structure 

mbr name of member in structure T 

• Các -msmart-iooption, khi được kích hoạt, sẽ cố gắng để chuyển đổi printf, 

scanfand chức năng khác sử dụng các định dạng đầu ra đầu vào cho một số 

nguyên chỉ 

biến thể. Các chức năng tương tự như các hình thức tiêu chuẩn C, trừ đi 

hỗ trợ cho đầu ra nổi điểm. -msmart-io = 0disables tính năng này và không có 

chuyển đổi sẽ diễn ra. -msmart-io = 1or -msmart-io (mặc định) sẽ 

chuyển đổi một cuộc gọi chức năng nếu có thể chứng minh rằng một chức năng 

I / O sẽ không bao giờ được trình bày với một chuyển đổi dấu chấm động. - 

msmart-io = 2is lạc quan hơn 

mặc định và sẽ cho rằng chuỗi định dạng không đổi hoặc 

chuỗi định dạng không biết sẽ không có một định dạng dấu chấm động. Trong 

trường hợp 

-msmart-io = 2is sử dụng với một định dạng dấu chấm động, bức thư định dạng 

sẽ xuất hiện 

như văn bản đen và số tương ứng của nó sẽ không được tiêu thụ. 

• -fno-ngắn doublewill gây ra trình biên dịch để tạo ra các cuộc gọi đến định 

dạng I / O 

thói quen hỗ trợ doubleas thể nó là một doubletype dài. 

Module trộn biên dịch với các tùy chọn này có thể dẫn đến một kích thước thực 

thi lớn hơn, hoặc 

thực hiện không đúng nếu lớn và nhỏ dữ liệu tăng gấp đôi kích thước được chia 

sẻ trên các mô-đun. 

dsPIC 

® 



FILE 


Mô tả: Cửa hàng thông tin về một dòng tập tin. 

Bao gồm: 

fpos_t 

Mô tả: Loại một biến được sử dụng để lưu trữ một vị trí tập tin. 

Bao gồm: 

size_t 


Bao gồm: 

_IOFBF 

Mô tả: Cho biết đầy đủ đệm. 

Bao gồm: 

Ghi chú: Được sử dụng bởi các chức năng setvbuf. 

_IOLBF 

Mô tả: Cho dòng đệm. 

Bao gồm: 

Ghi chú: Được sử dụng bởi các chức năng setvbuf.

Return Value: Returns the offset in bytes of the specified member (mbr) from 

the 

beginning of the structure. 

Remarks: The macro offsetofis undefined for bitfields. An error message will 

occur if bitfields are used. 

Example: #include /* for offsetof */ 


struct info { 

char item1[5]; 

int item2; 

char item3; 

float item4; 

}; 


{ 

printf("Offset of item1 = %d\n", 

offsetof(struct info,item1)); 







} 

Output: 

Offset of item1 = 0 




Explanation: 

This program shows the offset in bytes of each structure member from 

the start of the structure. Although item1is only 5 bytes (char 

item1[5]), padding is added so the address of item2falls on an 

even boundary. The same occurs with item3; it is 1 byte (char 

item3) with 1 byte of padding. 



4.13 INPUT AND OUTPUT 

The header file stdio.hconsists of types, macros and functions that provide 

support 

_IONBF 

Mô tả: Cho biết không có đệm. 

Bao gồm: 

Ghi chú: Được sử dụng bởi các chức năng setvbuf. 

BUFSIZ 

Mô tả: Xác định kích thước của bộ đệm được sử dụng bởi các chức năng setbuf 

Bao gồm: 




EOF 

Mô tả: Một số âm cho thấy các tập tin end-of-đã đạt tới hoặc 

báo cáo một điều kiện lỗi. 

Bao gồm: 

Ghi chú: Nếu một tập tin end-of-là gặp phải, chỉ số cuối cùng của tập tin được 

thiết lập. Nếu một 

tình trạng lỗi gặp phải, chỉ số lỗi được thiết lập. Lỗi 

điều kiện bao gồm ghi errorsand đầu vào hoặc đọc lỗi. 

FILENAME_MAX 

Mô tả: Tối đa số ký tự trong một tên tập tin bao gồm cả null 

terminator. 

Bao gồm: 


FOPEN_MAX 

Mô tả: Xác định số lượng tối đa của tập tin có thể được mở cùng một lúc 

Bao gồm: 

Giá trị: 8 

Bình luận: stderr, stdinand stdoutare bao gồm trong FOPEN_MAXcount. 

L_tmpnam 

Mô tả: Xác định số lượng ký tự cho tên tập tin tạm thời dài nhất 

tạo ra bởi các chức năng tmpnam. 

Bao gồm: 


Bình luận: L_tmpnamis sử dụng để xác định kích thước của mảng được sử dụng 

bởi tmpnam. 

NULL 

Mô tả: Giá trị của một con trỏ hằng rỗng 

Bao gồm: 

SEEK_CUR 

Mô tả: Chỉ ra rằng fseekshould tìm kiếm từ vị trí hiện tại của tập tin

to perform input and output operations on files and streams. When a file is 

opened it is 

associated with a stream. A stream is a pipeline for the flow of data into and out 

of files. 

Because different systems use different properties, the stream provides more 

uniform 

properties to allow reading and writing of the files. 

Streams can be text streams or binary streams. Text streams consist of a 

sequence of 

characters divided into lines. Each line is terminated with a newline ('\n') 

character. 

The characters may be altered in their internalrepresentation, particularly in 

regards to 

line endings. Binary streams consist of sequences of bytes of information. The 

bytes 

transmitted to the binary stream are not altered.There is no concept of lines, the 

file is 

just a series of bytes. 

At startup three streams are automatically opened: stdin, stdout, and stderr. 

stdinprovides a stream for standard input, stdoutis standard output and stderr 

is the standard error. Additional streams may be created with the fopenfunction. 

See 

fopenfor the different types of file access that are permitted. These access types 

are 

used by fopenand freopen. 

The type FILEis used to store information about each opened file stream. It 

includes 

such things as error indicators, end of file indicators, file position indicators, and 

other 

internal status information needed to control a stream. Many functions in the 

stdio 

use FILEas an argument. 

There are three types of buffering: unbuffered, line buffered and fully buffered. 

Unbuffered means a character or byte is transferred one at a time. Line buffered 

collects and 

transfers an entire line at a time (i.e., the newline character indicates the end of a 

line.) 

Fully buffered allows blocks of an arbitrary size to be transmitted. The functions 

setbufand setvbufcontrol file buffering. 

The stdio.hfile also contains functions that use input and output formats. The 

input 

formats, or scan formats, are used for reading data. Their descriptions can be 

found 

under scanf, but they are also used by fscanfand sscanf. The output formats, or 

print formats, are used for writing data. Their descriptions can be found under 

printf. 

These print formats are also used by fprintf, sprintf, vfprintf, vprintfand 

con trỏ 

Bao gồm: 

Ví dụ: Xem ví dụ cho fseek. 

dsPIC 

® 



SEEK_END 

Mô tả: Chỉ ra rằng fseekshould tìm kiếm từ khi kết thúc tập tin. 

Bao gồm: 


SEEK_SET 

Mô tả: Chỉ ra rằng fseekshould tìm kiếm từ đầu của tập tin. 

Bao gồm: 


stderr 

Mô tả: File con trỏ đến dòng lỗi chuẩn. 

Bao gồm: 

stdin 

Mô tả: File con trỏ đến dòng đầu vào tiêu chuẩn. 

Bao gồm: 

thiết bị xuất chuẩn 

Mô tả: File con trỏ đến dòng đầu ra tiêu chuẩn. 

Bao gồm: 

TMP_MAX 

Mô tả: Số lượng tối đa của tên tập tin duy nhất chức năng tmpnamcan 

tạo ra. 

Bao gồm: 




clearerr 

Mô tả: Cấu hình lại các indictor lỗi cho các dòng 

Bao gồm: 

Prototype: void clearerr (FILE * stream); 

Đối số: streamstream để thiết lập lại các chỉ số lỗi 

Ghi chú: Các chức năng xóa các chỉ số cuối cùng của tập tin và báo lỗi cho cho 

dòng (ví dụ, feofand ferrorwill return false sau khi chức năng 

clearerris gọi.)

vsprintf. 

Certain compiler options may affect how standard I/O performs. In an effort to 

provide 

a more tailored version of the formatted I/O routines, the tool chain may convert 

a call 

to a printfor scanfstyle function to a different call. The options are summarized 

below: 

•The -msmart-iooption, when enabled, will attempt to convert printf, 

scanfand other functions that use the input output formats to an integer only 

variant. The functionality is the same as that of the C standard forms, minus the 

support for floating point output. -msmart-io=0disables this feature and no 

conversion will take place. -msmart-io=1or -msmart-io(the default) will 

convert a function call if it can be proven that an I/O function will never be 

presented with a floating point conversion. -msmart-io=2is more optimistic than 

the default and will assume that non-constant format strings or otherwise 

unknown format strings will not contain a floating-point format. In the event 

that 

-msmart-io=2is used with a floating-point format, the format letter will appear 

as literal text and its corresponding argument will not be consumed. 

• -fno-short-doublewill cause the compiler to generate calls to formatted I/O 

routines that support doubleas if it were a long doubletype. 

Mixing modules compiled with these options may result in a larger executable 

size, or 

incorrect execution if large and small double-sized data is shared across 

modules. 

dsPIC 

® 


Ví dụ: / * Chương trình này sẽ cố gắng để viết một tập tin đó là * / 

/ * Chỉ đọc. Điều này làm cho chỉ số lỗi để * / 

/ * Được thiết lập. Chức năng ferror được sử dụng để kiểm tra * / 

/ * Chỉ số lỗi. Chức năng clearerr là * / 

/ * Sử dụng để thiết lập lại các errorindicator vì vậy tiếp theo * / 

/ * Thời gian ferror được gọi là nó sẽ không báo cáo * / 

/ * Lỗi. * / 

# include / * Cho ferror, clearerr, * / 

/ * Printf, fprintf, fopen, * / 

/ * Fclose, FILE, NULL * / 


{ 

FILE * myfile; 

if ((myfile = fopen ("sampclearerr.c", "r")) == 

NULL) 

printf ("Không thể mở tập tin \ n"); 

khác 

{ 

fprintf (myfile, "dòng Writethis đến" 

"Tập tin. \ N"); 

if (ferror (myfile)) 

printf ("Lỗi \ n"); 

khác 

printf ("Không có lỗi \ n"); 

clearerr (myfile); 


DS51456B-page 226 

FILE 


printf ("Vẫn có lỗi \ n"); 

khác 

Description: Stores information for a file stream. 

Include: 

fpos_t 

Description: Type of a variable used to store a file position. 

Include: 

size_t 

Description: The result type of the sizeofoperator. 

Include: 

_IOFBF 

Description: Indicates full buffering. 

printf ("Lỗi chỉ thiết lập lại \ n"); 

fclose (myfile); 

} 

} 

Đầu ra: 

Lỗi 

Lỗi chỉ thiết lập lại 

dsPIC 

® 


Include: 

Remarks: Used by the function setvbuf. 



_IOLBF 

Description: Indicates line buffering. 

Include: 


_IONBF 

Description: Indicates no buffering. 

Include: 


BUFSIZ 

Description: Defines the size of the buffer used by the function setbuf. 

Include: 

Value: 512 



EOF 

Description: A negative number indicating the end-of-file has been reached or 

to 

report an error condition. 

Include: 

Remarks: If an end-of-file is encountered, the end-of-file indicator is set. If an 

error condition is encountered, the error indicator is set. Error 

conditions include write errorsand input or read errors. 

FILENAME_MAX 

Description: Maximum number of characters in a filename including the null 

terminator. 

Include: 

Value: 260 

FOPEN_MAX 

Description: Defines the maximum number of files that can be simultaneously 

open 

Include: 

Value: 8 

Remarks: stderr, stdinand stdoutare included in the FOPEN_MAXcount. 

L_tmpnam 

Description: Defines the number of characters for the longest temporary 

filename 

created by the function tmpnam. 

Include: 

Value: 16 

Remarks: L_tmpnamis used to define the size of the array used by tmpnam. 

fclose 

Mô tả: Đóng một dòng suối. 

Bao gồm: 

Nguyên mẫu: int fclose (FILE * stream); 

Đối số: dòng con trỏ đến dòng đóng cửa 

Quay trở lại giá trị: Trả về 0 nếu thành công; nếu không, trả về EOF nếu có sai 

sót là 

phát hiện. 

Bình luận: fclosewrites bất kỳ sản lượng đệm vào tập tin. 

Ví dụ: # include / * Cho fopen, fclose, * / 

/ * Printf, FILE, NULL, kết thúc tập tin * / 


{ 

FILE * myfile1, * myfile2; 

int y; 

if ((myfile1 = fopen ("afile1", "w +")) == NULL) 

printf ("Không thể mở afile1 \ n"); 

khác 

{ 

printf ("afile1 được mở \ n"); 

y = fclose (myfile1); 

if (y == EOF) 

printf ("afile1 đã không đóng cửa \ n"); 

khác 

printf ("afile1 đã được đóng cửa \ n"); 

} 

} 

Đầu ra: 

afile1 đã được mở 

afile1 đã bị đóng cửa 



feof 

Mô tả: Các thử nghiệm về kết thúc của file 

Bao gồm: 

Nguyên mẫu: int feof (FILE * stream); 

Đối số: dòng dòng để kiểm tra kết thúc của file 

Quay trở lại giá trị: Trả về giá trị khác không nếu dòng là ở phần cuối của tập 

tin; nếu không, trả về số không. 

Ví dụ: # include / * Cho feof, fgetc, fputc, * /

NULL 

Description: The value of a null pointer constant 

Include: 

SEEK_CUR 

Description: Indicates that fseekshould seek from the current position of the file 

pointer 

Include: 

Example: See example for fseek. 

dsPIC 

® 


DS51456B-page 228 

SEEK_END 


Description: Indicates that fseekshould seek from the end of the file. 

Include: 


SEEK_SET 

Description: Indicates that fseekshould seek from the beginning of the file. 

Include: 


stderr 

Description: File pointer to the standard error stream. 

Include: 

stdin 

Description: File pointer to the standard input stream. 

Include: 

stdout 

Description: File pointer to the standard output stream. 

Include: 

TMP_MAX 

Description: The maximum number of unique filenames the function 

tmpnamcan 

generate. 

Include: 

Value: 32 



clearerr 

Description: Resets the error indictor for the stream 

/ * Fopen, fclose, FILE, * / 

/ * NULL * / 


{ 


int y = 0; 

if ((myfile = fopen ("afile.txt", "rb")) == NULL) 


khác 

{ 

cho (;;) 

{ 

y = fgetc (myfile); 

if (feof (myfile)) 

phá vỡ; 

fputc (y, thiết bị xuất chuẩn); 

} 


} 

} 

Đầu vào: 

Nội dung afile.txt (được sử dụng như đầu vào): 

Đây là một câu. 

Đầu ra: 

Đây là một câu. 

dsPIC 

® 



ferror 


Mô tả: Kiểm tra xem chỉ số lỗi được thiết lập. 

Bao gồm: 

Nguyên mẫu: int ferror (FILE * stream); 

Đối số: dòng con trỏ đến FILEstructure 

Quay trở lại giá trị: Trả về một giá trị khác không hàm IFERROR chỉ số được 

thiết lập; nếu không, trả về một 

không. 

Ví dụ: / * Chương trình này sẽ cố gắng để viết một tập tin đó là * / 

/ * Chỉ đọc. Điều này làm cho chỉ số lỗi để * / 

/ * Được thiết lập. Các functionferror được sử dụng để kiểm tra * /

Include: 

Prototype: void clearerr(FILE *stream); 

Argument: streamstream to reset error indicators 

Remarks: The function clears the end-of-file and error indicators for the given 

stream (i.e., feofand ferrorwill return false after the function 

clearerris called.) 

Example: /* This program tries to write to a file that is */ 

/* readonly. This causes the error indicator to */ 

/* be set. The function ferror is used to check */ 

/* the error indicator. The function clearerr is */ 

/* used to reset the errorindicator so the next */ 

/* time ferror is called it will not report an */ 

/* error. */ 

#include /* for ferror, clearerr, */ 

/* printf, fprintf, fopen,*/ 

/* fclose, FILE, NULL */ 


{ 

FILE *myfile; 

if ((myfile = fopen("sampclearerr.c", "r")) == 

NULL) 

printf("Cannot open file\n"); 

else 

{ 

fprintf(myfile, "Writethis line to the " 

"file.\n"); 

if (ferror(myfile)) 

printf("Error\n"); 

else 

printf("No error\n"); 

clearerr(myfile); 


printf("Still has Error\n"); 

else 

printf("Error indicator reset\n"); 

fclose(myfile); 

} 

} 

Output: 

/ * Chỉ số lỗi và tìm ra lỗi. Các * / 

/ * Chức năng clearerr được sử dụng để thiết lập lại các lỗi * / 

/ * Chỉ nên thời gian ferror tiếp theo được gọi là * / 

/ * Nó sẽ không báo lỗi. * / 

# include / * Cho ferror, clearerr, * / 

/ * Printf, fprintf, * / 

/ * Fopen, fclose, * / 

/ * FILE, NULL * / 


{ 


if ((myfile = fopen ("sampclearerr.c", "r")) == 

NULL) 


khác 

{ 

fprintf (myfile, "Viết dòng này cho" 

"Tập tin. \ N"); 


printf ("Lỗi \ n"); 

khác 

printf ("Không có lỗi \ n"); 

clearerr (myfile); 


printf ("Vẫn có lỗi \ n"); 

khác 

printf ("Lỗi chỉ thiết lập lại \ n"); 


} 

} 

Đầu ra: 

Lỗi 

Lỗi chỉ thiết lập lại 



fflush 

Mô tả: bừng bộ đệm trong dòng quy định. 

Bao gồm: 

Nguyên mẫu: int fflush (FILE * stream);

Error 

Error indicator reset 

dsPIC 

® 


Đối số: dòng con trỏ tới dòng để tuôn ra. 

Quay trở lại giá trị: Trả về EOF nếu gặp lỗi ghi; nếu không, trả về số không cho 

thành công. 

Ghi chú: Nếu dòng là một con trỏ null, tất cả các bộ đệm đầu ra được ghi vào 

tập tin. fflush 

không có tác dụng trên một dòng không có bộ đệm. 

DS51456B-page 230 

fclose 


fgetc 

Mô tả: Có được một nhân vật từ một dòng suối 

Description: Close a stream. 

Include: 

Prototype: int fclose(FILE *stream); 

Argument: stream pointer to the stream to close 

Return Value: Returns 0 if successful; otherwise, returns EOF if any errors were 

detected. 

Remarks: fclosewrites any buffered output to the file. 

Example: #include /* for fopen, fclose, */ 

/* printf,FILE, NULL, EOF */ 


{ 

FILE *myfile1, *myfile2; 

int y; 

if ((myfile1 = fopen("afile1", "w+")) == NULL) 

printf("Cannot open afile1\n"); 

else 

{ 

printf("afile1 was opened\n"); 

y = fclose(myfile1); 

if (y == EOF) 

printf("afile1 was not closed\n"); 

else 

printf("afile1 was closed\n"); 

} 

} 

Output: 

afile1 was opened 

afile1 was closed 



feof 

Description: Tests for end of file 

Bao gồm: 

Nguyên mẫu: int fgetc (FILE * stream); 

Đối số: dòng con trỏ đến dòng mở 

Quay trở lại giá trị: Trả về nhân vật đọc hoặc EOF nếu một lỗi đọc xảy ra hoặc 

kết thúc của tập tin 


Bình luận: Chức năng đọc ký tự tiếp theo từ dòng đầu vào, tiến bộ 

chỉ số tập tin vị trí và trả về ký tự như là một unsigned 

charconverted đến một int. 

Ví dụ: # include / * Cho fgetc, printf, * / 

/ * Fclose, FILE, * / 

/ * NULL, kết thúc tập tin * / 


{ 

FILE * buf; 

char y; 

if ((buf = fopen ("afile.txt", "r")) == NULL) 

printf ("Không thể mở afile.txt \ n"); 

khác 

{ 

y = fgetc (buf); 

trong khi (y! = EOF) 

{ 

printf ("% c |", y); 


} 

fclose (buf); 

} 

} 

Đầu vào: 


Ngắn

Include: 

Prototype: int feof(FILE *stream); 

Argument: stream stream to check for end of file 

Return Value: Returns nonzero if stream is at the end of file; otherwise, returns 

zero. 

Example: #include /* for feof, fgetc, fputc, */ 

/* fopen, fclose, FILE, */ 

/* NULL */ 

Chuỗi dài hơn 

Đầu ra: 

S | h | o | r | t | 

| L | o | n | g | e | r | | s | t | r | i | n | g | 

| 

dsPIC 

® 



{ 


fgetpos 


FILE *myfile; 

int y = 0; 

if( (myfile = fopen( "afile.txt", "rb" )) == NULL ) 

printf( "Cannot open file\n" ); 

else 

{ 

for (;;) 

{ 

y = fgetc(myfile); 

if (feof(myfile)) 

break; 

fputc(y, stdout); 

} 

fclose( myfile ); 

} 

} 

Input: 

Contents of afile.txt(used as input): 

This is a sentence. 

Output: 

This is a sentence. 

dsPIC 

® 


Mô tả: Được vị trí hồ sơ của dòng suối. 

Bao gồm: 

Nguyên mẫu: int fgetpos (FILE * stream, fpos_t * pos); 

Đối số: dòng mục tiêu dòng 

pos lưu trữ vị trí, chỉ số 

Quay trở lại giá trị: Trả về 0 nếu thành công; nếu không, trả về một giá trị khác 

không. 

Ghi chú: Các chức năng lưu trữ các tập tin chỉ số vị trí cho các dòng được đưa 

ra trong 

* Posif thành công, nếu không, fgetpossets errno. 

Ví dụ: / * Chương trình này sẽ mở ra một tập tin và đọc byte tại * / 

/ * Địa điểm khác nhau. Các fgetpos * / 

/ * Chức năng ghi nhận các byte 8. 21 byte * / 

/ * Đọc sau đó 18 byte được đọc. Tiếp theo * / 

/ * Chức năng fsetpos được thiết lập dựa trên * / 

/ * Vị trí fgetpos và theprevious 21 byte * / 

/ * Đang đọc lại. * / 

# include / * Cho fgetpos, fread, * / 

/ * Printf, fopen, fclose, * / 

/ * FILE, NULL, perror, * / 

/ * Fpos_t, sizeof * / 


{ 


pos fpos_t; 

DS51456B-page 232 

ferror 


char buf [25]; 

if ((myfile = fopen ("sampfgetpos.c", "rb")) == 

Description: Tests if error indicator is set. 

Include: 

Prototype: int ferror(FILE *stream); 

NULL) 


khác

Argument: stream pointer to FILEstructure 

Return Value: Returns a nonzero value iferror indicator is set; otherwise, returns 

a 

zero. 

Example: /* This program tries to write to a file that is */ 

/* readonly. This causes the error indicator to */ 

/* be set. The functionferror is used to check */ 

/* the error indicator and find the error. The */ 

/* function clearerr is used to reset the error */ 

/* indicator so the next time ferror is called */ 

/* it will not report an error. */ 

#include /* for ferror, clearerr, */ 

/* printf, fprintf, */ 

/* fopen, fclose, */ 

/* FILE, NULL */ 


{ 

FILE *myfile; 

if ((myfile = fopen("sampclearerr.c", "r")) == 

NULL) 


else 

{ 

fprintf(myfile, "Write this line to the " 

"file.\n"); 


printf("Error\n"); 

else 

printf("No error\n"); 

clearerr(myfile); 


printf("Still has Error\n"); 

else 

printf("Error indicator reset\n"); 


} 

} 

Output: 

Error 

{ 

fread (buf, sizeof (char), 8, myfile); 

if (fgetpos (myfile, và pos) = 0) 

perror ("fgetpos lỗi"); 

khác 

{ 

fread (buf, sizeof (char), 21 tuổi, myfile); 

printf ("Bytes đọc:% .21s \ n", buf); 



} 

if (fsetpos (myfile, và pos) = 0) 

perror ("fsetpos lỗi"); 




} 

} 

Đầu ra: 

Byte đọc: chương trình sẽ mở ra một tập tin 

Byte đọc: và đọc byte tại 




fgets 

Mô tả: Có được một chuỗi từ một dòng suối 

Bao gồm: 

Prototype: char * fgets (char * s, int n, FILE * stream); 

Đối số: s con trỏ đến chuỗi lưu trữ 

n số lượng tối đa của các nhân vật để đọc 

dòng con trỏ đến dòng mở. 

Quay trở lại giá trị: Trả về một con trỏ đến chuỗi SIF thành công; nếu không, tr 

về một null 

con trỏ 

Bình luận: Chức năng đọc ký tự từ dòng đầu vào và lưu trữ chúng 

vào chuỗi trỏ đến bởi suntil nó đã đọc n-1 ký tự, lưu trữ một 

xuống dòng nhân vật hoặc thiết lập cuối cùng của tập tin hoặc các chỉ số 

lỗi. Nếu bất kỳ 

ký tự được lưu trữ, một ký tự null được lưu trữ ngay lập tức sau khi 

cuối cùng đọc ký tự trong phần tử tiếp theo của mảng. Nếu các fgetssets

Error indicator reset 



fflush 

Description: Flushes the buffer in the specified stream. 

Include: 

Prototype: int fflush(FILE *stream); 

Argument: stream pointer to the stream to flush. 

Return Value: Returns EOF if a write error occurs; otherwise, returns zero for 

success. 

Remarks: If stream is a null pointer, all output buffers are written to files. fflush 

has no effect on an unbuffered stream. 

fgetc 

Description: Get a character from a stream 

Include: 

Prototype: int fgetc(FILE *stream); 

Argument: stream pointer to the open stream 

Return Value: Returns the character read or EOF if a read error occurs or end of 

file is 

reached. 

Remarks: The function reads the next character from the input stream, advances 

the file-position indicator and returns the character as an unsigned 

charconverted to an int. 

Example: #include /* for fgetc, printf, */ 

/* fclose, FILE, */ 

/* NULL, EOF */ 


{ 

FILE *buf; 

char y; 

if ((buf = fopen("afile.txt", "r")) == NULL) 

chỉ số lỗi, nội dung mảng là không xác định. 

Ví dụ: # include / * Cho fgets, printf, * / 



# define MAX 50 


{ 

FILE * buf; 

char s [MAX]; 



khác 

{ 

trong khi (fgets (s, MAX, buf) = NULL) 

{ 

printf ("% s |", s); 

} 

fclose (buf); 

} 

} 

Đầu vào: 


Ngắn 


Đầu ra: 

Ngắn 

| Chuỗi dài hơn 

| 

dsPIC 

® 


printf("Cannot open afile.txt\n"); 

else 

{ 

y = fgetc(buf); 


fopen 

Mô tả: Mở một tập tin. 

Bao gồm: 


while (y != EOF) 

{ 

printf("%c|", y); 


Prototype: FILE * fopen (const char * filename, const char * mode); 

Tên tên tập tin của tập tin: đối số 

loại phương thức truy cập được phép 

Quay trở lại giá trị: Trả về một con trỏ đến dòng mở. Nếu chức năng không mộ 

con trỏ null

} 

fclose(buf); 

} 

} 

Input: 


Short 

Longer string 

Output: 

S|h|o|r|t| 

|L|o|n|g|e|r| |s|t|r|i|n|g| 

| 

dsPIC 

® 



fgetpos 

Description: Gets the stream's file position. 

Include: 

Prototype: int fgetpos(FILE *stream, fpos_t *pos); 

Arguments: stream target stream 

pos position-indicator storage 

Return Value: Returns 0 if successful; otherwise, returns a non-zero value. 

Remarks: The function stores the file-position indicator for the given stream in 

*posif successful, otherwise, fgetpossets errno. 

Example: /* This program opens a file and reads bytes at */ 

/* several different locations. The fgetpos */ 

/* function notes the 8th byte. 21 bytes are */ 

/* read then 18 bytes are read. Next the */ 

/* fsetpos function is set based on the */ 

/* fgetpos position and theprevious 21 bytes */ 

/* are reread. */ 

#include /* for fgetpos, fread, */ 

/* printf, fopen, fclose, */ 

/* FILE, NULL, perror, */ 

/* fpos_t, sizeof */ 


{ 

FILE *myfile; 

được trả về. 

Bình luận: Sau đây là các loại hình truy cập file: 

r- mở một tập tin văn bản hiện hành để đọc 

w- mở một tập tin văn bản trống cho văn bản. (Một tập tin hiện có sẽ 

được ghi đè.) 

a-mở một tập tin văn bản để phụ thêm. (Một tập tin được tạo ra nếu nó 

không tồn tại.) 

rb- mở một tập tin nhị phân hiện có để đọc. 

wb- mở một tập tin nhị phân có sản phẩm nào cho văn bản. (Một tập tin hiện có 

sẽ được ghi đè.) 

ab- mở một tập tin nhị phân để phụ thêm. (Một tập tin được tạo ra nếu nó 

không tồn tại.) 

r + - mở một tập tin văn bản hiện hành để đọc và viết. 

w + - mở một tập tin văn bản trống để đọc và viết. (An 

tập tin hiện tại sẽ được ghi đè.) 

a + - mở một tập tin văn bản để đọc và phụ thêm. (Một tập tin là 

tạo ra nếu nó không tồn tại.) 

r + bor rb + - mở một tập tin nhị phân hiện có để đọc và viết. 

w + bor wb + - mở một tập tin nhị phân có sản phẩm nào để đọc và viết. (An 

tập tin hiện tại sẽ được ghi đè.) 

a + ab + bor - mở một tập tin nhị phân để đọc và phụ thêm. (Một tập tin là 

tạo ra nếu nó không tồn tại.) 


/ * Printf, FILE, * / 

/ * NULL, kết thúc tập tin * / 


{ 


int y; 



if ((myfile1 = fopen ("afile1", "r")) == NULL) 


khác 

{ 



if (y == EOF) 

printf ("afile1was không đóng cửa \ n");

fpos_t pos; 

char buf[25]; 

if ((myfile = fopen("sampfgetpos.c", "rb")) == 

NULL) 


else 

{ 

fread(buf, sizeof(char), 8, myfile); 

if (fgetpos(myfile, &pos) != 0) 

perror("fgetpos error"); 

else 

{ 


printf("Bytes read: %.21s\n", buf); 



} 

if (fsetpos(myfile, &pos) != 0) 

perror("fsetpos error"); 




} 

} 

Output: 

Bytes read: program opens a file 

Bytes read: and reads bytes at 




fgets 

Description: Get a string from a stream 

Include: 

Prototype: char *fgets(char *s, int n, FILE *stream); 

Arguments: s pointer to the storage string 

n maximum number of characters to read 

stream pointer to the open stream. 

Return Value: Returns a pointer to the string sif successful; otherwise, returns a 

null 

khác 


} 


printf ("Thứ hai cố gắng, không thể mở afile1 \ n"); 

khác 

{ 

printf ("Thứ hai cố gắng, afile1 được mở \ n"); 


if (y == EOF) 

printf ("afile1was không đóng cửa \ n"); 

khác 


} 



khác 

{ 



if (y == EOF) 

printf ("afile2was không đóng cửa \ n"); 

khác 


} 

} 

Đầu ra: 

Không thể mở afile1 

Thứ hai cố gắng, afile1 đã được mở 





afile1must tồn tại trước khi nó có thể được mở ra để đọc (r) hoặc 

fopenfunction sẽ thất bại. Nếu fopenfunction mở một tập tin để viết 

(W +) nó không phải đã tồn tại. Nếu nó không tồn tại, nó sẽ được tạo ra 

và sau đó mở ra. 

fopen (Tiếp theo) 

dsPIC

pointer 

Remarks: The function reads characters from the input stream and stores them 

into the string pointed to by suntil it has read n-1 characters, stores a 

newline character or sets the end-of-file or error indicators. If any 

characters were stored, a null character is stored immediately after the 

last read character in the next element of the array. If fgetssets the 

error indicator, the array contents are indeterminate. 

Example: #include /* for fgets, printf, */ 



#define MAX 50 


{ 

FILE *buf; 

char s[MAX]; 



else 

{ 

while (fgets(s, MAX, buf) != NULL) 

{ 

printf("%s|", s); 

} 

fclose(buf); 

} 

} 

Input: 


Short 

Longer string 

Output: 

Short 

|Longer string 

| 

dsPIC 

® 



fopen 

® 



fprintf 

Mô tả: In định dạng dữ liệu vào một dòng. 

Bao gồm: 

Nguyên mẫu: int fprintf (FILE * stream, const char * format, ...); 

Đối số: dòng con trỏ vào dòng, trong đó để dữ liệu đầu ra 

định dạng kiểm soát chuỗi định dạng 

Đối số tùy chọn ... 

Quay trở lại giá trị: Trả về số ký tự được tạo ra hoặc một số âm nếu một 

lỗi xảy ra. 

Ghi chú: Đối số định dạng có cú pháp tương tự và sử dụng nó có trong 

in. 


/ * Fprintf, printf, * / 



{ 


int y; 

char s [] = "chuỗi Printthis"; 

int x = 1; 

char '\ n' a =; 

if ((myfile = fopen ("afile", "w")) == NULL) 

printf ("Không thể mở afile \ n"); 

khác 

{ 

y = fprintf (myfile, "% s% d% thời gian c", s, x, a); 

printf ("ofcharacters Số in" 

"Nộp =% d", y); 


} 

} 

Đầu ra: 

Số ký tự được in để nộp = 25 

Nội dung afile: 

In chuỗi này 1 lần 

Thư viện chuẩn C với hàm toán học

Description: Opens a file. 

Include: 

Prototype: FILE *fopen(const char *filename, const char *mode); 

Arguments: filename name of the file 

mode type of access permitted 

Return Value: Returns a pointer to the open stream. If the function fails a null 

pointer 

is returned. 

Remarks: Following are the types of file access: 

r- opens an existing text file for reading 

w- opens an empty text file for writing. (An existing file will 

be overwritten.) 

a- opens a text file for appending. (A file is created if it 

doesn't exist.) 

rb- opens an existing binary file for reading. 

wb- opens an empty binary file for writing. (An existing file 

will be overwritten.) 

ab- opens a binary file for appending. (A file is created if it 

doesn't exist.) 

r+- opens an existing text file for reading and writing. 

w+- opens an empty text file for reading and writing. (An 

existing file will be overwritten.) 

a+- opens a text file for reading and appending. (A file is 

created if it doesn't exist.) 

r+bor rb+- opens an existing binary file for reading and writing. 

w+bor wb+- opens an empty binary file for reading and writing. (An 

existing file will be overwritten.) 

a+bor ab+- opens a binary file for reading and appending. (A file is 

created if it doesn't exist.) 


/* printf, FILE, */ 

/* NULL, EOF */ 


{ 


int y; 



if ((myfile1 = fopen("afile1", "r")) == NULL) 


fputc 

Mô tả: Đặt một ký tự dòng. 

Bao gồm: 

Nguyên mẫu: int fputc (int c, FILE * stream); 

Đối số: ký tự c được viết 

dòng con trỏ đến dòng mở 

Quay trở lại giá trị: Trả về nhân vật được viết orEOF nếu không gặp lỗi ghi. 

Ghi chú: Các chức năng ghi các ký tự dòng đầu ra, tiến bộ 

chỉ số tập tin vị trí và trả về ký tự như một unsigned char 

chuyển đổi sang một int. 

Ví dụ: # include / * Cho fputc, kết thúc tập tin, thiết bị xuất chuẩn * / 


{ 

char * y; 

char buf [] = "Đây là văn bản \ n"; 

int x; 

x = 0; 

cho (y = buf; (x = EOF) && (* y = '\ 0');! y ++!) 

{ 

x = fputc (* y, thiết bị xuất chuẩn); 

fputc ('|', thiết bị xuất chuẩn); 

} 

} 

Đầu ra: 

T | h | i | s | | i | s | | t | e | x | t | 

| 

fputs 

Mô tả: Đặt một chuỗi các dòng. 

Bao gồm: 

Nguyên mẫu: int fputs (const char * s, FILE * stream); 

Đối số: chuỗi s được viết 


Quay trở lại giá trị: Trả về một giá trị không âm nếu thành công; nếu không, trả 

về EOF. 

Chú ý: chức năng viết ký tự tothe sản lượng dòng lên đến nhưng không 

bao gồm các ký tự null. 

Ví dụ: # include / * Cho fputs, thiết bị xuất chuẩn * / 


{


else 

{ 



if (y == EOF) 

printf("afile1was not closed\n"); 

else 


} 


printf("Second try,cannot open afile1\n"); 

else 

{ 

printf("Second try,afile1 was opened\n"); 


if (y == EOF) 


else 


} 



else 

{ 



if (y == EOF) 


else 


} 

} 

Output: 

Cannot open afile1 

Second try, afile1 was opened 





fputs (buf, thiết bị xuất chuẩn); 

fputs ("|", thiết bị xuất chuẩn); 

} 

Đầu ra: 

Đây là văn bản 

| 

dsPIC 

® 



fread 

Mô tả: Đọc dữ liệu từ các dòng suối. 

Bao gồm: 


Prototype: size_t fread (void * ptr, size_t size, nelem size_t, 

FILE * stream); 

Đối số: ptr con trỏ đến bộ đệm lưu trữ 

kích thước kích thước của sản phẩm 

số nelem tối đa các mặt hàng được đọc 

dòng con trỏ đến dòng 

Quay trở lại giá trị: Trả về số yếu tố hoàn toàn đọc lên đến nelemwhose 

kích thước được xác định bởi kích thước. 

Bình luận: Chức năng đọc ký tự FROMA dòng cho vào bộ đệm 

trỏ đến bởi ptruntil các cửa hàng chức năng kích thước * nelemcharacters 

hoặc thiết lập cuối cùng của tập tin hoặc chỉ số lỗi. freadreturns n / size trong đó 

n là 

số ký tự nó đọc. Nếu n không phải là một bội số của kích thước, giá trị 

của phần tử cuối cùng là không xác định. Nếu chức năng đặt ra các lỗi 

chỉ số, chỉ số tập tin vị trí là không xác định. 

Ví dụ: # include / * Cho fread, fwrite, * / 


/ * Sizeof, FILE, NULL * / 


{ 

FILE * buf; 

int x, numwrote, numread; 

nums đôi [10], readnums [10]; 

if ((buf = fopen ("afile.out", "w +")) = NULL) 

{ 

for (x = 0; x

Explanation: 

afile1must exist before it can be opened for reading (r) or the 

fopenfunction will fail. If the fopenfunction opens a file for writing 

(w+) it does not have to already exist. If it doesn't exist, it will be created 

and then opened. 

fopen (Continued) 

dsPIC 

® 


DS51456B-page 238 

fprintf 


Description: Prints formatted data to a stream. 

Include: 

Prototype: int fprintf(FILE *stream, const char *format, ...); 

Arguments: stream pointer to the stream in which to output data 

format format control string 

... optional arguments 

Return Value: Returns number of characters generated or a negative number if 

an 

error occurs. 

Remarks: The format argument has the same syntax and use that it has in 

print. 


/* fprintf, printf, */ 



{ 

FILE *myfile; 

int y; 

char s[]="Printthis string"; 

int x = 1; 

char a = '\n'; 

if ((myfile = fopen("afile", "w")) == NULL) 

printf("Cannot open afile\n"); 

else 

{ 

y = fprintf(myfile, "%s %d time%c", s, x, a); 

printf("Number ofcharacters printed " 

"to file = %d",y); 

{ 

nums [x] = 10,0 / (x + 1); 

printf ("10,0 /% d =% f \ n", x + 1, nums [x]); 

} 

numwrote = fwrite (nums, sizeof (double), 

10, buf); 

printf ("đã viết% dnumbers \ n \ n", numwrote); 

fclose (buf); 

} 

khác 

printf ("Không thể mở afile.out \ n"); 



if ((buf = fopen ("afile.out", "r +")) = NULL) 

{ 

numread = fread (readnums, sizeof (double), 

10, buf); 

printf ("Đọc% số d \ n", numread); 

for (x = 0; x


} 

} 

Output: 

Number of characters printed to file = 25 

Contents of afile: 

Print this string 1 time 



fputc 

Description: Puts a character to the stream. 

Include: 

Prototype: int fputc(int c, FILE *stream); 

Arguments: c character to be written 

stream pointer to the open stream 

Return Value: Returns the character written orEOF if a write error occurs. 

Remarks: The function writes the character to the output stream, advances the 

file-position indicator and returns the character as an unsigned char 

converted to an int. 

Example: #include /* for fputc, EOF, stdout */ 


{ 

char *y; 

char buf[] = "This is text\n"; 

int x; 

x = 0; 

Đã viết 10 số 

Đọc số 10 

1 * 10,000000 = 10,000000 

2 * 5,000000 = 10,000000 

3 * 3,333333 = 10,000000 

4 * 2,500000 = 10,000000 

5 * 2,000000 = 10,000000 

6 * 1,666667 = 10,000000 

7 * 1,428571 = 10,000000 

8 * 1,250000 = 10,000000 

9 * 1,111111 = 10,000000 

10 * 1,000000 = 10,000000 


Chương trình này sử dụng fwriteto tiết kiệm 10 số vào một tập tin dưới dạng nh 

phân. 

Điều này cho phép các con số để được lưu inthe cùng một khuôn mẫu của các 

bit là 

chương trình nào đang sử dụng cung cấp thêm độ chính xác và nhất quán. Sử 

dụng 

fprintfwould lưu các số là chuỗi văn bản mà có thể gây ra 

những con số được rút ngắn. Eachnumber được chia thành 10 

sản xuất một loạt các con số. Lấy các con số với một freadto 

mảng mới và nhân chúng bằng của số ban đầu cho thấy 

số không được cắt ngắn trong quá trình tiết kiệm. 

fread (Tiếp theo) 

dsPIC 

® 


for (y = buf; (x != EOF)&& (*y != '\0'); y++) 

{ 


freopen 


x = fputc(*y, stdout); 

fputc('|', stdout); 

} 

} 

Output: 

T|h|i|s| |i|s| |t|e|x|t| 

| 

fputs 

Description: Puts a string to the stream. 

Include: 

Prototype: int fputs(const char *s, FILE *stream); 

Mô tả: reassigns một dòng hiện có vào một tập tin mới. 

Bao gồm: 

Prototype: FILE * freopen (const char * filename, const char 

* Chế độ, FILE * stream); 

Tên tên tập tin của các tập tin mới: đối số 


dòng con trỏ đến dòng hiện đang mở 

Quay trở lại giá trị: Trả về một con trỏ đến các tập tin mở mới. Nếu chức năng 

không một con trỏ null 

được trả về. 

Bình luận: Chức năng đóng cửa các tập tin liên quan đến dòng như

Arguments: s string to be written 


Return Value: Returns a non-negative value if successful; otherwise, returns 

EOF. 

Remarks: The function writes characters tothe output stream up to but not 

including the null character. 

Example: #include /* for fputs, stdout */ 


{ 


fputs(buf,stdout); 

fputs("|",stdout); 

} 

Output: 

This is text 

| 

dsPIC 

® 


fclosewas gọi. Sau đó, nó sẽ mở ra các tập tin mới như fopenwas 

gọi. freopenwill thất bại nếu dòng quy định không mở cửa. Xem fopen 

cho các loại có thể truy cập tập tin. 

Ví dụ: # include / * Cho fopen, freopen, * / 

/ * Printf, fclose, * / 



{ 


int y; 



khác 

{ 


if ((myfile2 = freopen ("afile2", "w +", 

myfile1)) == NULL) 

{ 


DS51456B-page 240 

fread 


fclose (myfile1); 

} 

Description: Reads data from the stream. 

Include: 

Prototype: size_t fread(void *ptr, size_t size, size_t nelem, 

FILE *stream); 

Arguments: ptr pointer to the storage buffer 

size size of item 

nelem maximum number of items to be read 

stream pointer to the stream 

Return Value: Returns the number of complete elements read up to nelemwhose 

size is specified by size. 

Remarks: The function reads characters froma given stream into the buffer 

pointed to by ptruntil the function stores size* nelemcharacters 

or sets the end-of-file or error indicator. freadreturns n/size where n is 

the number of characters it read. If n is not a multiple of size, the value 

of the last element is indeterminate. If the function sets the error 

indicator, the file-position indicator is indeterminate. 

Example: #include /* for fread, fwrite, */ 


khác 

{ 



} 

} 

} 

Đầu ra: 




Chương trình này sử dụng điểm myfile2to vào dòng khi freopenis 

gọi là như vậy nếu một lỗi xảy ra, vẫn myfile1will trỏ đến dòng và 

có thể được đóng đúng cách. Nếu freopencall thành công, myfile2can 

được sử dụng để đóng dòng đúng cách. 

fscanf 

Mô tả: Quét định dạng văn bản từ một dòng suối. 

Bao gồm:

* sizeof, FILE, NULL */ 


{ 

FILE *buf; 


double nums[10], readnums[10]; 

if ((buf = fopen("afile.out", "w+")) != NULL) 

{ 

for (x = 0; x < 10; x++) 

{ 

nums[x] = 10.0/(x + 1); 

printf("10.0/%d = %f\n", x+1, nums[x]); 

} 

numwrote = fwrite(nums, sizeof(double), 

10, buf); 

printf("Wrote %dnumbers\n\n", numwrote); 

fclose(buf); 

} 

else 

printf("Cannot open afile.out\n"); 



if ((buf = fopen("afile.out", "r+")) != NULL) 

{ 

numread = fread(readnums, sizeof(double), 

10, buf); 

printf("Read %d numbers\n", numread); 

for (x = 0; x < 10; x++) 

{ 

printf("%d * %f= %f\n", x+1, readnums[x], 

(x + 1) * readnums[x]); 

} 

fclose(buf); 

} 

else 


} 

Output: 

10.0/1 = 10.000000 



Nguyên mẫu: int fscanf (FILE * stream, const char * format, ...); 

Đối số: dòng con trỏ đến dòng mở cửa từ để đọc dữ liệu 



Quay trở lại giá trị: Trả về số lượng các mục chuyển đổi thành công và được 

giao. Nếu 

Không có sản phẩm được giao, một 0 được trả về. Kết thúc tập tin được trả về 

nếu kết thúc tập tin 

gặp phải trước khi chuyển đổi đầu tiên hoặc nếu có lỗi xảy ra. 


scanf. 

Ví dụ: # include / * Cho fopen, fscanf, * / 

/ * Fclose, fprintf, * / 

/ * Fseek, printf, FILE, * / 

/ * NULL, SEEK_SET * / 


{ 


char s [30]; 

int x; 

char a; 

if ((myfile = fopen ("afile", "w +")) == NULL) 


khác 

{ 

fprintf (myfile, "% s% d lần% c", 

"In chuỗi này", 100, '\ n'); 

fseek (myfile, 0l, SEEK_SET); 

fscanf (myfile, "% s", s); 

printf ("% s \ n", s); 


printf ("% s \ n", s); 


printf ("% s \ n", s); 

fscanf (myfile, "% d", & x); 

printf ("% d \ n", x); 


printf ("% s \ n", s);

10.0/2 = 5.000000 

10.0/3 = 3.333333 

10.0/4 = 2.500000 

10.0/5 = 2.000000 

10.0/6 = 1.666667 

10.0/7 = 1.428571 

10.0/8 = 1.250000 

10.0/9 = 1.111111 

10.0/10 = 1.000000 

Wrote 10 numbers 

Read 10 numbers 

1 * 10.000000 = 10.000000 

2 * 5.000000 = 10.000000 

3 * 3.333333 = 10.000000 

4 * 2.500000 = 10.000000 

5 * 2.000000 = 10.000000 

6 * 1.666667 = 10.000000 

7 * 1.428571 = 10.000000 

8 * 1.250000 = 10.000000 

9 * 1.111111 = 10.000000 

10 * 1.000000 = 10.000000 

Explanation: 

This program uses fwriteto save 10 numbers to a file in binary form. 

This allows the numbers to be saved inthe same pattern of bits as the 

program is using which provides more accuracy and consistency. Using 

fprintfwould save the numbers as text strings which could cause 

the numbers to be truncated. Eachnumber is divided into 10 to 

produce a variety of numbers. Retrieving the numbers with freadto a 

new array and multiplying them by the original number shows the 

numbers were not truncated in the save process. 

fread (Continued) 

dsPIC 

® 


fscanf (myfile, "% c", a); 

printf ("% c \ n", a); 


} 

} 

Đầu vào: 

Nội dung afile: 

In chuỗi này 100 lần 

Đầu ra: 

In 

này 

chuỗi 

100 

lần 

fscanf (Tiếp theo) 

dsPIC 

® 



fseek 


Mô tả: Di chuyển con trỏ tập tin đến một địa điểm cụ thể. 

Bao gồm: 

Nguyên mẫu: int fseek (FILE * stream, dài bù đắp, int mode); 

Đối số: dòng dòng, trong đó để di chuyển con trỏ tập tin. 

giá trị bù đắp thêm vào vị trí hiện tại 

loại phương thức tìm kiếm để thực hiện 


không và thiết lập 

errno. 

Bình luận: chế độ có thể là một trong các cách sau: 

SEEK_SET- tìm kiếm từ đầu của tập tin 

SEEK_CUR- tìm từ vị trí hiện tại của con trỏ tập tin 

SEEK_END- tìm kiếm từ khi kết thúc tập tin 

Ví dụ: # include / * Cho fseek, fgets, * / 


DS51456B-page 242 

freopen 



/ * SEEK_SET, SEEK_CUR, * / 

Description: Reassigns an existing stream to a new file. 

Include: 

Prototype: FILE *freopen(const char *filename, const char 

/ * SEEK_END * / 


{

*mode, FILE *stream); 

Arguments: filename name of the new file 


stream pointer to the currently open stream 

Return Value: Returns a pointer to the new open file. If the function fails a null 

pointer 

is returned. 

Remarks: The function closes the file associated with the stream as though 

fclosewas called. Then it opens the new file as though fopenwas 

called. freopenwill fail if the specified stream is not open. See fopen 

for the possible types of file access. 

Example: #include /* for fopen, freopen, */ 

/* printf, fclose, */ 



{ 


int y; 



else 

{ 


if ((myfile2 = freopen("afile2", "w+", 

myfile1)) == NULL) 

{ 


fclose(myfile1); 

} 

else 

{ 



} 

} 

} 

Output: 




char s [70]; 

int y; 

myfile = fopen ("afile.out", "w +"); 

if (myfile == NULL) 


khác 

{ 

fprintf (myfile, "Đây là sự khởi đầu" 

"Đây là trung bình và" 

"Đây là kết thúc."); 

y = fseek (myfile, 0l, SEEK_SET); 

if (y) 

perror ("fseek thất bại"); 

khác 

{ 

fgets (s, 22, myfile); 

printf ("\"% s \ "\ n \ n", s); 

} 

y = fseek (myfile, 2L, SEEK_CUR); 

if (y) 


khác 

{ 


printf ("\"% s \ "\ n \ n", s); 

} 



y = fseek (myfile, -16L, SEEK_END); 

if (y) 


khác 

{ 


printf ("\"% s \ "\ n", s); 

} 


}

Explanation: 

This program uses myfile2to point to the stream when freopenis 

called so if an error occurs, myfile1will still point to the stream and 

can be closed properly. If the freopencall is successful, myfile2can 

be used to close the stream properly. 

fscanf 

Description: Scans formatted text from a stream. 

Include: 



Prototype: int fscanf(FILE *stream, const char *format, ...); 

Arguments: stream pointer to the open stream from which to read data 



Return Value: Returns the number of items successfully converted and assigned. 

If 

no items are assigned, a 0 is returned. EOF is returned if end of file is 

encountered before the first conversion or if an error occurs. 


scanf. 

Example: #include /* for fopen, fscanf, */ 

/* fclose, fprintf, */ 

/* fseek, printf, FILE, */ 

/* NULL, SEEK_SET */ 


{ 

FILE *myfile; 

char s[30]; 

int x; 

char a; 

if ((myfile = fopen("afile", "w+")) == NULL) 


else 

{ 

fprintf(myfile, "%s %d times%c", 

"Print this string", 100, '\n'); 

fseek(myfile, 0L, SEEK_SET); 

fscanf(myfile, "%s", s); 

printf("%s\n", s); 

} 

Đầu ra: 

"Đây là sự khởi đầu" 

"Đây là andthis giữa là kết thúc." 

"Đây là kết thúc." 


Các tập tin afile.outis tạo ra với các văn bản, "Đây là sự khởi đầu, điều này 

là giữa và đây là kết thúc ". 

Chức năng fseekuses một bù đắp bằng không và SEEK_SETto thiết lập các tập 

tin 

con trỏ đến đầu của tập tin. fgetsthen đọc 22 ký tự 

mà là "Đây là sự khởi đầu", và cho biết thêm một ký tự null đến 

chuỗi. 

Tiếp theo, fseekuses một bù đắp của hai SEEK_CURRENTto và thiết lập các 

tập tin 

con trỏ đến vị trí hiện tại cộng với hai (bỏ qua các dấu phẩy và 

không gian.) fgetsthen đọc đến 70characters tiếp theo. Đầu tiên 39 

nhân vật "này là giữa và đây là kết thúc." Nó dừng lại khi nó 

đọc kết thúc tập tin và cho biết thêm một ký tự null vào chuỗi. 

Cuối cùng, fseekuses bù đắp âm 16 ký tự và SEEK_END 

thiết lập các tập tin con trỏ đến 16 ký tự từ cuối của tập tin. fgets 

sau đó đọc lên đến 70 ký tự. Nó dừng lại ở kết thúc tập tin sau khi đọc 16 

nhân vật "này là kết thúc." và cho biết thêm một ký tự null vào chuỗi. 

fsetpos 

Mô tả: Thiết lập vị trí tập tin của dòng. 

Bao gồm: 

Prototype: fsetpos int (FILE * stream, fpos_t const * pos); 

Đối số: dòng streamtarget 

pos lưu trữ vị trí, chỉ số như trả về bởi một cuộc gọi trước đó để 

fgetpos 


không. 

Chú ý: chức năng đặt chỉ số tập tin vị trí cho các dòng được đưa ra trong * pos 

nếu thành công; nếu không, fsetpossets errno. 

fseek (Tiếp theo) 

dsPIC 

® 




Ví dụ: / * Chương trình này sẽ mở ra một tập tin và đọc byte tại * / 

/ * Địa điểm khác nhau. Các fgetpos * /





fscanf(myfile, "%d", &x); 

printf("%d\n", x); 



fscanf(myfile, "%c", a); 

printf("%c\n", a); 


} 

} 

Input: 

Contents of afile: 

Print this string 100 times 

Output: 

Print 

this 

string 

100 

times 

fscanf (Continued) 

dsPIC 

® 


DS51456B-page 244 

fseek 


Description: Moves file pointer to a specific location. 

Include: 

Prototype: int fseek(FILE *stream, long offset, int mode); 

Arguments: stream stream in which to move the file pointer. 

offset value to add to the current position 

mode type of seek to perform 

Return Value: Returns 0 if successful; otherwise, returns a non-zero value and 

set 

errno. 

Remarks: mode can be one of the following: 

SEEK_SET– seeks from the beginning of the file 

/ * Chức năng ghi nhận các byte 8. 21 byte * / 

/ * Đọc sau đó 18 byte được đọc. Tiếp theo * / 

/ * Chức năng fsetpos được thiết lập dựa trên * / 

/ * Vị trí fgetpos và theprevious 21 byte * / 

/ * Đang đọc lại. * / 

# include / * Cho fgetpos, fread, * / 



/ * Fpos_t, sizeof * / 


{ 


pos fpos_t; 


if ((myfile = fopen ("sampfgetpos.c", "rb")) == 

NULL) 


khác 

{ 

fread (buf, sizeof (char), 8, myfile); 

if (fgetpos (myfile, và pos) = 0) 

perror ("fgetpos lỗi"); 

khác 

{ 





} 

if (fsetpos (myfile, và pos) = 0) 

perror ("fsetpos lỗi"); 




} 

} 

Đầu ra: 


Byte đọc: và đọc byte tại

SEEK_CUR– seeks from the current position of the file pointer 

SEEK_END– seeks from the end of the file 

Example: #include /* for fseek, fgets, */ 



/* SEEK_SET, SEEK_CUR, */ 

/*SEEK_END */ 


{ 

FILE *myfile; 

char s[70]; 

int y; 

myfile = fopen("afile.out", "w+"); 



else 

{ 

fprintf(myfile, "This is the beginning, " 

"this is the middle and " 

"this is the end."); 

y = fseek(myfile, 0L, SEEK_SET); 

if (y) 

perror("Fseek failed"); 

else 

{ 

fgets(s, 22, myfile); 

printf("\"%s\"\n\n", s); 

} 

y = fseek(myfile, 2L, SEEK_CUR); 

if (y) 


else 

{ 


printf("\"%s\"\n\n", s); 

} 



y = fseek(myfile, -16L, SEEK_END); 


fsetpos (Tiếp theo) 



ftell 

Mô tả: Được vị trí hiện tại của con trỏ tập tin. 

Bao gồm: 

Prototype: dài ftell (FILE * stream); 

Đối số: dòng dòng, trong đó để có được vị trí tập tin hiện hành 

Quay trở lại giá trị: Trả về vị trí của con trỏ tập tin nếu thành công; nếu không, 

trả về 

-1. 

Ví dụ: # include / * Cho ftell, fread, * / 


/ * Fopen, fclose, sizeof, * / 



{ 


char s [75]; 

y dài; 

myfile = fopen ("afile.out", "w +"); 



khác 

{ 

fprintf (myfile, "isa này câu rất dài" 

"Để đưa vào các tập tin có tên" 

"Afile.out để thử nghiệm."); 


if ((myfile = fopen ("afile.out", "rb")) = NULL) 

{ 

printf ("Đọc một số ký tự: \ n"); 

fread (s, sizeof (char), 29 tuổi, myfile); 

printf ("\ t \"% s \ "\ n", s); 

y = ftell (myfile); 

printf ("vị trí hiện tại của" 

"Con trỏ tập tin là% ld \ n", y); 


}

if (y) 


else 

{ 


printf("\"%s\"\n", s); 

} 


} 

} 

Output: 

"This is the beginning" 

"this is the middle andthis is the end." 

"this is the end." 

Explanation: 

The file afile.outis created with the text, "This is the beginning, this 

is the middle and this is the end". 

The function fseekuses an offset of zero and SEEK_SETto set the file 

pointer to the beginning of the file. fgetsthen reads 22 characters 

which are "This is the beginning, " and adds a null character to the 

string. 

Next, fseekuses an offset of two and SEEK_CURRENTto set the file 

pointer to the current position plus two (skipping the comma and 

space.) fgetsthen reads up to the next 70characters. The first 39 

characters are "this is the middle and this is the end." It stops when it 

reads EOF and adds a null character to the string. 

FInally, fseekuses an offset of negative 16 characters and SEEK_END 

to set the file pointer to 16 characters from the end of the file. fgets 

then reads up to 70 characters. It stops at the EOF after reading 16 

characters "this is the end." and adds a null character to the string. 

fsetpos 

Description: Sets the stream's file position. 

Include: 

Prototype: int fsetpos(FILE *stream, const fpos_t *pos); 

Arguments: streamtarget stream 

pos position-indicator storage as returned by an earlier call to 

fgetpos 

Return Value: Returns 0 if successful; otherwise, returns a non-zero value. 

Remarks: The function sets the file-position indicator for the given stream in 

} 

} 

Đầu ra: 

Đọc một số ký tự: 

"Câu isa này rất dài" 

Vị trí hiện tại của con trỏ tập tin là 29 

dsPIC 

® 



fwrite 

Mô tả: Ghi dữ liệu vào dòng. 

Bao gồm: 


Prototype: size_t fwrite (const void * ptr, size_t size, 

nelem size_t, FILE * stream); 

Đối số: ptr con trỏ đến bộ đệm lưu trữ 

kích thước kích thước của sản phẩm 

số nelem tối đa các mặt hàng được đọc 


Quay trở lại giá trị: Trả về số phần tử hoàn chỉnh văn bản thành công, mà 

sẽ ít hơn nelemonly nếu một lỗi ghi là gặp phải. 

Ghi chú: Các chức năng viết chữ vào một dòng nhất định từ một bộ đệm chỉ 

để bằng ptrup để nelemelements có kích thước được xác định bởi kích 

thước. Các 

chỉ báo vị trí tập tin được đưa lên bằng số lượng ký tự 

viết thành công. Nếu functionsets chỉ số lỗi, 

chỉ số tập tin vị trí là không xác định. 

Ví dụ: # include / * Cho fread, fwrite, * / 


/ * Sizeof, FILE, NULL * / 


{ 

FILE * buf; 


nums đôi [10], readnums [10]; 

if ((buf = fopen ("afile.out", "w +")) = NULL) 

{ 

for (x = 0; x

*pos 

if successful; otherwise, fsetpossets errno. 

fseek (Continued) 

dsPIC 

® 


printf ("10,0 /% d =% f \ n", x + 1, nums [x]); 

} 

numwrote = fwrite (nums, sizeof (double), 

10, buf); 

printf ("đã viết% dnumbers \ n \ n", numwrote); 

fclose (buf); 

DS51456B-page 246 


} 

Example: /* This program opens a file and reads bytes at */ 

/* several different locations. The fgetpos */ 

/* function notes the 8th byte. 21 bytes are */ 

/* read then 18 bytes are read. Next the */ 

/* fsetpos function is set based on the */ 

/* fgetpos position and theprevious 21 bytes */ 

/* are reread. */ 

#include /* for fgetpos, fread, */ 



/* fpos_t, sizeof */ 


{ 

FILE *myfile; 

fpos_t pos; 

char buf[25]; 

if ((myfile = fopen("sampfgetpos.c", "rb")) == 

NULL) 


else 

{ 


if (fgetpos(myfile, &pos) != 0) 

perror("fgetpos error"); 

else 

{ 





} 

if (fsetpos(myfile, &pos) != 0) 

khác 




if ((buf = fopen ("afile.out", "r +")) = NULL) 

{ 

numread = fread (readnums, sizeof (double), 

10, buf); 

printf ("Đọc% số d \ n", numread); 

for (x = 0; x

perror("fsetpos error"); 




} 

} 

Output: 


Bytes read: and reads bytes at 


fsetpos (Continued) 



ftell 

Description: Gets the current position of a file pointer. 

Include: 

Prototype: long ftell(FILE *stream); 

Argument: stream stream in which to get the current file position 

Return Value: Returns the position of the file pointer if successful; otherwise, 

returns 

-1. 

Example: #include /* for ftell, fread, */ 


/* fopen, fclose, sizeof, */ 



{ 

FILE *myfile; 

char s[75]; 

long y; 

myfile = fopen("afile.out", "w+"); 



else 

{ 

fprintf(myfile,"This isa very long sentence " 

"for input into the file named " 

"afile.out for testing."); 


1 * 10,000000 = 10,000000 

2 * 5,000000 = 10,000000 

3 * 3,333333 = 10,000000 

4 * 2,500000 = 10,000000 

5 * 2,000000 = 10,000000 

6 * 1,666667 = 10,000000 

7 * 1,428571 = 10,000000 

8 * 1,250000 = 10,000000 

9 * 1,111111 = 10,000000 

10 * 1,000000 = 10,000000 


Chương trình này sử dụng fwriteto tiết kiệm 10 số vào một tập tin dưới dạng nh 

phân. 

Điều này cho phép các con số để được lưu inthe cùng một khuôn mẫu của các 

bit là 

chương trình nào đang sử dụng cung cấp thêm độ chính xác và nhất quán. Sử 

dụng 

fprintfwould lưu các số như textstrings, mà có thể gây ra 

những con số được rút ngắn. Eachnumber được chia thành 10 

sản xuất một loạt các con số. Lấy các con số với một freadto 

mảng mới và nhân chúng bằng của số ban đầu cho thấy 

số không được cắt ngắn trong quá trình tiết kiệm. 

fwrite (Tiếp theo) 

dsPIC 

® 



getc 


Mô tả: Có được một nhân vật từ các dòng. 

Bao gồm: 

Nguyên mẫu: int getc (FILE * stream); 





Bình luận: getcis giống như chức năng fgetc. 

Ví dụ: # include / * Cho getc, printf, * / 


/ * FILE, NULL, kết thúc tập tin * / 


{

if ((myfile = fopen("afile.out", "rb")) != NULL) 

{ 

printf("Read some characters:\n"); 

fread(s, sizeof(char), 29, myfile); 

printf("\t\"%s\"\n", s); 

y = ftell(myfile); 

printf("The current position of the " 

"file pointer is %ld\n", y); 


} 

} 

} 

Output: 

Read some characters: 

"This isa very long sentence " 

The current position of the file pointer is 29 

dsPIC 

® 


DS51456B-page 248 

fwrite 

Description: Writes data to the stream. 

Include: 


Prototype: size_t fwrite(const void *ptr, size_t size, 

size_t nelem, FILE *stream); 

Arguments: ptr pointer to the storage buffer 

size size of item 

nelem maximum number of items to be read 


Return Value: Returns the number of complete elements successfully written, 

which 

will be less than nelemonly if a write error is encountered. 

Remarks: The function writes characters to a given stream from a buffer pointed 

to by ptrup to nelemelements whose size is specified by size. The 

file position indicator is advanced by the number of characters 

successfully written. If the functionsets the error indicator, the 

file-position indicator is indeterminate. 

Example: #include /* for fread, fwrite, */ 


FILE * buf; 

char y; 



khác 

{ 

y = getc (buf); 


{ 

printf ("% c |", y); 

y = getc (buf); 

} 

fclose (buf); 

} 

} 

Đầu vào: 


Ngắn 


Đầu ra: 

S | h | o | r | t | 

| L | o | n | g | e | r | | s | t | r | i | n | g | 

| 



getchar 

Mô tả: Có được một nhân vật từ thiết bị nhập chuẩn. 

Bao gồm: 

Nguyên mẫu: int getchar (void); 




Bình luận: cùng tác dụng như fgetcwith các thiết bị nhập chuẩn đối số. 

Ví dụ: # include / * Cho getchar, printf * / 


{ 

char y; 

y = getchar (); 

printf ("% c |", y); 

y = getchar ();

* sizeof, FILE, NULL */ 


{ 

FILE *buf; 


double nums[10], readnums[10]; 

if ((buf = fopen("afile.out", "w+")) != NULL) 

{ 

for (x = 0; x < 10; x++) 

{ 

nums[x] = 10.0/(x + 1); 

printf("10.0/%d = %f\n", x+1, nums[x]); 

} 

numwrote = fwrite(nums, sizeof(double), 

10, buf); 

printf("Wrote %dnumbers\n\n", numwrote); 

fclose(buf); 

} 

else 




if ((buf = fopen("afile.out", "r+")) != NULL) 

{ 

numread = fread(readnums, sizeof(double), 

10, buf); 

printf("Read %d numbers\n", numread); 

for (x = 0; x < 10; x++) 

{ 

printf("%d * %f= %f\n", x+1, readnums[x], 

(x + 1) * readnums[x]); 

printf ("% c |", y); 


printf ("% c |", y); 


printf ("% c |", y); 


printf ("% c |", y); 

} 

Đầu vào: 

Nội dung UartIn.txt (được sử dụng như là đầu vào thiết bị nhập chuẩn cho mô 

phỏng): 

Ngắn 


Đầu ra: 

S | h | o | r | t | 

được 

Mô tả: Có được một chuỗi từ thiết bị nhập chuẩn. 

Bao gồm: 

Prototype: char * được (char * s); 

Đối số: s con trỏ đến chuỗi lưu trữ 

Quay trở lại giá trị: Trả về một con trỏ đến chuỗi SIF thành công; nếu không, tr 

về một null 

con trỏ 

Chú ý: chức năng đọc ký tự từ các cửa hàng dòng stdinand chúng 

vào chuỗi trỏ đến bởi suntil nó đọc một ký tự xuống dòng (đó là 

không được lưu trữ) hoặc thiết lập cuối cùng của tập tin orerror chỉ số. Nếu bất 

kỳ ký tự 

đã đọc, một ký tự null được lưu trữ ngay lập tức sau khi đọc cuối cùng 

nhân vật trong phần tiếp theo của mảng. Nếu getssets lỗi 

chỉ số, các mảng nội dung là không xác định. 

dsPIC 

® 


} 



fclose(buf); 

} 

else 


} 

Output: 

10.0/1 = 10.000000 

Ví dụ: # include / * Cho được, printf * / 


{ 

char y [50]; 

được (y); 

printf ("Text:% s \ n", y); 

}

10.0/2 = 5.000000 

10.0/3 = 3.333333 

10.0/4 = 2.500000 

10.0/5 = 2.000000 

10.0/6 = 1.666667 

10.0/7 = 1.428571 

10.0/8 = 1.250000 

10.0/9 = 1.111111 

10.0/10 = 1.000000 

Wrote 10 numbers 

Read 10 numbers 

1 * 10.000000 = 10.000000 

2 * 5.000000 = 10.000000 

3 * 3.333333 = 10.000000 

4 * 2.500000 = 10.000000 

5 * 2.000000 = 10.000000 

6 * 1.666667 = 10.000000 

7 * 1.428571 = 10.000000 

8 * 1.250000 = 10.000000 

9 * 1.111111 = 10.000000 

10 * 1.000000 = 10.000000 

Explanation: 

This program uses fwriteto save 10 numbers to a file in binary form. 

This allows the numbers to be saved inthe same pattern of bits as the 

program is using which provides more accuracy and consistency. Using 

fprintfwould save the numbers as textstrings, which could cause 

the numbers to be truncated. Eachnumber is divided into 10 to 

produce a variety of numbers. Retrieving the numbers with freadto a 

new array and multiplying them by the original number shows the 

numbers were not truncated in the save process. 

fwrite (Continued) 

dsPIC 

® 



getc 

Description: Get a character from the stream. 

Include: 

Prototype: int getc(FILE *stream); 

Đầu vào: 


phỏng): 

Ngắn 


Đầu ra: 

Tiêu đề: Ngắn 

perror 

Mô tả: In một thông báo lỗi để thiết bị lỗi chuẩn. 

Bao gồm: 

Prototype: void perror (const char * s); 

Đối số: s chuỗi in 

Quay trở lại giá trị: Không có. 

Ghi chú: Các chuỗi s được in theo sau dấu hai chấm và một không gian. Sau đó 

một lỗi 

tin dựa trên errnois được in theo sau là một dòng mới 

Ví dụ: # include / * Cho perror, fopen, * / 

/ * Fclose, printf, * / 



{ 


if ((myfile = fopen ("samp.fil", "r +")) == NULL) 

perror ("Không thể mở samp.fil"); 

khác 

printf ("Thành công mở samp.fil \ n"); 


} 

Đầu ra: 

Không thể mở samp.fil: tập tin lỗi mở 

được (Tiếp theo) 



printf 

Mô tả: In định dạng văn bản để thiết bị xuất chuẩn. 

Bao gồm: 

Nguyên mẫu: int printf (const char * format, ...); 

Đối số: chuỗi định dạng kiểm soát định dạng 


Quay trở lại giá trị: Trả về số ký tự được tạo ra hoặc một số âm nếu một

Argument: stream pointer to the open stream 


file is 

reached. 

Remarks: getcis the same as the function fgetc. 

Example: #include /* for getc, printf, */ 


/* FILE, NULL, EOF */ 


{ 

FILE *buf; 

char y; 



else 

{ 

y = getc(buf); 


{ 


y = getc(buf); 

} 

fclose(buf); 

} 

} 

Input: 


Short 

Longer string 

Output: 

S|h|o|r|t| 

|L|o|n|g|e|r| |s|t|r|i|n|g| 

| 



getchar 

Description: Get a character from stdin. 

Include: 

Prototype: int getchar(void); 


Bình luận: Phải có chính xác cùng một số đối số là có 

định dạng specifiers. Nếu là đối số ít hơn phù hợp với định dạng 

specifiers, đầu ra là không xác định. Nếu có tranh luận hơn 

phù hợp với các đặc tả định dạng, các đối số còn lại sẽ bị loại bỏ. 

Mỗi đặc tả định dạng bắt đầu với một dấu phần trăm tiếp theo tùy chọn 

lĩnh vực và một loại yêu cầu như ở đây: 

[Chính xác.] [Size]% [cờ] [chiều rộng] loại 

cờ 

- Trái biện minh cho giá trị trong một lĩnh vực nhất định chiều rộng 

0 0 sử dụng cho nhân vật pad thay vì không gian (đó là 

mặc định) 

+ Tạo ra một dấu cộng cho các giá trị ký kết tích cực 

không gian tạo ra một không gian hoặc giá trị ký kết có không phải là một cộng 

cũng không phải là dấu trừ 

# Để tiền tố 0 trên một chuyển đổi bát phân, tiền tố 0x hoặc 0X trên 

chuyển đổi hệ thập lục phân, hoặc để tạo ra một dấu thập phân 

và chữ số thập phân được nếu không bị đàn áp trên 

chuyển đổi dấu chấm động 

chiều rộng 

xác định số ký tự để tạo ra cho việc chuyển đổi. Nếu 

dấu sao (*) được sử dụng thay vì một số thập phân, tiếp theo 

tranh luận (mà cần phải có kiểu int) sẽ được sử dụng cho lĩnh vực này 

chiều rộng. Nếu kết quả là ít hơn so với chiều rộng lĩnh vực, nhân vật pad sẽ 

sử dụng ở bên trái để điền vào lĩnh vực này. Nếu kết quả là lớn hơn lĩnh vực nà 

chiều rộng, lĩnh vực này được mở rộng toaccommodate giá trị mà không 

padding. 

độ chính xác 

Chiều rộng lĩnh vực có thể được theo sau với dấu chấm (.) Và một số nguyên 

thập phân 

đại diện cho sự chính xác mà xác định một trong những điều sau đây: 

- Số lượng tối thiểu của các chữ số để tạo ra trên một chuyển đổi số nguyên 

- Số chữ số phần để tạo ra một địa chỉ e, E, hoặc f chuyển đổi 

- Số lượng tối đa đáng kể chữ số để tạo ra trên ag hoặc G 

chuyển đổi 

- Số lượng tối đa của nhân vật để tạo ra từ một chuỗi C trên 

s chuyển đổi 

Nếu giai đoạn này xuất hiện mà không có số nguyên số nguyên được giả định 

là số không. Nếu các dấu sao (*) được sử dụng thay vì một số thập phân, 

Đối số tiếp theo (trong đó phải có kiểu int) sẽ được sử dụng cho


file is 

reached. 

Remarks: Same effect as fgetcwith the argument stdin. 

chính xác. 

dsPIC 

® 


Example: #include /* for getchar, printf */ 



kích thước 


{ 

char y; 

y = getchar(); 










} 

Input: 

Contents of UartIn.txt(used as stdin input for simulator): 

Short 

Longer string 

Output: 

S|h|o|r|t| 

gets 

Description: Get a string from stdin. 

Include: 

Prototype: char *gets(char *s); 

Argument: s pointer to the storage string 

Return Value: Returns a pointer to the string sif successful; otherwise, returns a 

null 

pointer 

Remarks: The function reads characters from the stream stdinand stores them 

into the string pointed to by suntil it reads a newline character (which is 

not stored) or sets the end-of-file orerror indicators. If any characters 

were read, a null character is stored immediately after the last read 

character in the next element of the array. If getssets the error 

indicator, the array contents are indeterminate. 

dsPIC 

h sửa đổi - sử dụng với các loại d, i, o, u, x, X; chuyển đổi các giá trị cho một 

intor ngắn unsigned short int 

h sửa đổi - sử dụng với n; xác định rằng con trỏ trỏ đến một 

ngắn int 

l sửa đổi - sử dụng với các loại d, i, o, u, x, X; chuyển đổi các giá trị cho một 

intor dài unsigned long int 

l sửa đổi - sử dụng với n; xác định rằng con trỏ trỏ đến một 

long int 

l sửa đổi - sử dụng với c; quy định cụ thể một nhân vật rộng 

l sửa đổi - sử dụng với các loại điện tử, E, F, F, g, G; chuyển đổi các giá trị cho 

một 

đôi 

ll sửa đổi - sử dụng với các loại d, i, o, u, x, X; chuyển đổi các giá trị cho một 

intor lâu dài unsigned long long int 

ll sửa đổi - sử dụng với n; xác định rằng con trỏ trỏ đến một 

lâu dài int 

L sửa đổi - sử dụng với điện tử, E, e, g, G; chuyển đổi các giá trị cho một thời 

gian dài 

đôi 

loại 

d, tôi đã ký int 

o unsigned intin bát phân 

u thập phân intin unsigned 

x unsigned intin hệ thập lục phân chữ thường 

X unsigned intin hệ thập lục phân hoa 

điện tử, E doublein ký hiệu khoa học 

f doubledecimal ký hiệu 

g, G đôi (có dạng điện tử, E hoặc e nếu thích hợp) 

c char- một nhân vật duy nhất 

của chuỗi 

giá trị p của một con trỏ 

n tranh luận liên quan sẽ là một con trỏ số nguyên vào 

được đặt số lượng ký tự được viết cho đến nay. Không có 

ký tự được in.

® 



Example: #include /* for gets, printf */ 


{ 

char y[50]; 

gets(y) ; 

printf("Text: %s\n", y); 

} 

Input: 


Short 

Longer string 

Output: 

Text: Short 

perror 

Description: Prints an error message to stderr. 

Include: 

Prototype: void perror(const char *s); 

Argument: s string to print 

Return Value: None. 

Remarks: The string s is printed followed by a colon and a space. Then an error 

message based on errnois printed followed by an newline 

Example: #include /* for perror, fopen, */ 

/* fclose, printf, */ 



{ 

FILE *myfile; 

if ((myfile = fopen("samp.fil", "r+")) == NULL) 

perror("Cannot open samp.fil"); 

else 

printf("Success opening samp.fil\n"); 


} 

Output: 

Cannot open samp.fil: file open error 

gets (Continued) 

%% Một nhân vật được in 



{ 

/ * In quyền nhân vật lý trong 3 * / 

/ * Không gian nhân vật. * / 

printf ("% 3c \ n", 'a'); 

/ * In một số nguyên, trái lý (như * / 

/ * Xác định bởi các dấu trừ ở định dạng * / 

/ * String) trong một không gian 4 ký tự. In một * / 

/ * Số nguyên thứ hai như vậy là hợp lý trong * / 

/ * Một không gian 4 nhân vật bằng cách sử dụng ống (|) như * / 

/ * Một dấu phân cách giữa các số nguyên. * / 

printf ("% - 4d |% 4d \ n", -4, 4); 

/ * In một số chuyển đổi sang bát phân trong 4 * / 

/ * Chữ số. * / 

printf ("% 4o. \ n", 10); 

printf (Tiếp theo) 



/ * In một số chuyển đổi sang hệ thập lục phân * / 

/ * Định dạng với một tiền tố 0x. * / 

printf ("% # x \ n", 28); 

/ * In một phao trong ký hiệu khoa học * / 

printf ("% E \ n", 1.1e20); 

/ * In nổi với 2 chữ số thập phân * / 

printf (".% 2f \ n", -3,346); 

/ * In một phao dài với E%,% e hoặc% f * / 

/ * Nào là phiên bản ngắn nhất * / 

printf ("% Lg \ n", .02L); 

} 

Đầu ra: 

một 

-4 | 4 

0012 

0x1c 

1.100000E + 20 

-3.35 

0.02



printf 

Description: Prints formatted text to stdout. 

Include: 

Prototype: int printf(const char *format, ...); 

Arguments: format format control string 



an 

error occurs. 

Remarks: There must be exactly the same number of arguments as there are 

format specifiers. If the are less arguments than match the format 

specifiers, the output is undefined. If there are more arguments than 

match the format specifiers, the remaining arguments are discarded. 

Each format specifier begins with a percent sign followed by optional 

fields and a required type as shown here: 

%[flags][width][.precision][size]type 

flags 

- left-justify the value within a given field width 

0 Use 0 for the pad character instead of space (which is the 

default) 

+ generate a plus sign for positive signed values 

space generate a space or signed values that have neither a plus 

nor a minus sign 

# to prefix 0 on an octal conversion, to prefix 0x or 0X on a 

hexadecimal conversion, or to generate a decimal point 

and fraction digits that are otherwise suppressed on a 

floating-point conversion 

width 

specify the number of characters to generate for the conversion. If 

the asterisk (*) is used instead of a decimal number, the next 

argument (which must be of type int) will be used for the field 

width. If the result is less than the field width, pad characters will be 

used on the left to fill the field. If the result is greater than the field 

width, the field is expanded toaccommodate the value without 

padding. 

precision 

The field width can be followed with dot (.) and a decimal integer 

putc 

Mô tả: Đặt một ký tự dòng. 

Bao gồm: 

Nguyên mẫu: int putc (int c, FILE * stream); 


dòng con trỏ đến cấu trúc FILE 

Quay trở lại giá trị: Trả về nhân vật hoặc EOF nếu lỗi xảy ra hoặc kết thúc của 

tập tin 


Bình luận: putcis giống như chức năng fputc. 

Ví dụ: # include / * Cho putc, kết thúc tập tin, thiết bị xuất chuẩn * / 


{ 

char * y; 


int x; 

x = 0; 


{ 

x = putc (* y, thiết bị xuất chuẩn); 

putc ('|', thiết bị xuất chuẩn); 

} 

} 

Đầu ra: 

T | h | i | s | | i | s | | t | e | x | t | 

| 

printf (Tiếp theo) 

dsPIC 

® 



putchar 


Mô tả: Đặt một nhân vật để thiết bị xuất chuẩn. 

Bao gồm: 

Nguyên mẫu: int putchar (int c); 


Quay trở lại giá trị: Trả về nhân vật hoặc EOF nếu lỗi xảy ra hoặc kết thúc của 

tập tin 


Bình luận: cùng tác dụng như fputcwith stdoutas một cuộc tranh cãi.

epresenting the precision that specifies one of the following: 

- minimum number of digits to generate on an integer conversion 

- number of fraction digits to generate on an e, E, or f conversion 

- maximum number of significant digits to generate on a g or G 

conversion 

- maximum number of characters to generate from a C string on an 

s conversion 

If the period appears without the integer the integer is assumed to 

be zero. If the asterisk (*) is used instead of a decimal number, the 

next argument (which must be of type int) will be used for the 

precision. 

dsPIC 

® 



size 

h modifier - used with type d, i, o,u, x, X; converts the value to a 

short intor unsigned short int 

h modifier - used with n; specifies that the pointer points to a 

short int 

l modifier - used with type d, i, o,u, x, X; converts the value to a 

long intor unsigned long int 

l modifier - used with n; specifies that the pointer points to a 

long int 

l modifier - used with c; specifies a wide character 

l modifier - used with type e, E, f, F, g, G; converts the value to a 

double 

ll modifier - used with type d, i, o,u, x, X; converts the value to a 

long long intor unsigned long long int 

ll modifier - used with n; specifies that the pointer points to a 

long long int 

L modifier - used with e, E, f, g, G; converts the value to a long 

double 

type 

d, i signed int 

o unsigned intin octal 

u unsigned intin decimal 

x unsigned intin lowercase hexadecimal 

X unsigned intin uppercase hexadecimal 

Ví dụ: # include / * Cho putchar, printf, * / 

/ * Kết thúc tập tin, thiết bị xuất chuẩn * / 


{ 

char * y; 


int x; 

x = 0; 


x = putchar (* y); 

} 

Đầu ra: 


puts 

Mô tả: Đặt một chuỗi thiết bị xuất chuẩn. 

Bao gồm: 

Nguyên mẫu: int puts (const char * s); 

Đối số: s chuỗi được viết 

Quay trở lại giá trị: Trả về một giá trị không âm nếu thành công; nếu không, trả 

về EOF. 

Ghi chú: Các chức năng ghi ký tự đến thiết bị xuất chuẩn dòng. Một dòng mới 

nhân vật được nối. Các ký tự null chấm dứt được không được ghi vào 

dòng. 

Ví dụ: # include / * Cho puts * / 


{ 


đặt (buf); 

đặt ("|"); 

} 

Đầu ra: 


| 



loại bỏ 

Mô tả: Xóa các tập tin được chỉ định. 

Bao gồm: 

Nguyên mẫu: int remove (const char * filename); 

Đối số: tên tên tập tin của tập tin bị xóa.

e, E doublein scientific notation 

f doubledecimal notation 

g, G double(takes the form of e, E or f as appropriate) 

c char- a single character 

s string 

p value of a pointer 

n the associated argument shall be an integer pointer into 

which is placed the number of characters written so far. No 

characters are printed. 

% A % character is printed 



{ 

/* print a character right justified in a 3 */ 

/* character space. */ 

printf("%3c\n", 'a'); 

/* print an integer, left justified (as */ 

/* specified by the minus sign in the format */ 

/* string) in a 4 character space. Print a */ 

/* second integer that is right justified in */ 

/* a 4 character space using the pipe (|) as */ 

/* a separator between the integers. */ 

printf("%-4d|%4d\n", -4, 4); 

/* print a number converted to octal in 4 */ 

/* digits. */ 

printf("%.4o\n", 10); 

printf (Continued) 



/* print a number converted to hexadecimal */ 

/* format with a 0x prefix. */ 

printf("%#x\n", 28); 

/* print a float in scientific notation */ 

printf("%E\n", 1.1e20); 

/* print a float with 2 fraction digits */ 

printf("%.2f\n", -3.346); 

/* print a long float with %E, %e, or %f */ 

/* whichever is the shortest version */ 

printf("%Lg\n", .02L); 

Quay trở lại giá trị: Trả về 0 nếu thành công, -1 nếu không. 

Ghi chú: Nếu tên tập tin không tồn tại hoặc là mở, removewill thất bại. 

Ví dụ: # include / * Cho loại bỏ, printf * / 


{ 

if (loại bỏ ("myfile.txt") = 0) 

printf ("Không thể loại bỏ tập tin"); 

khác 

printf ("File gỡ bỏ"); 

} 

Đầu ra: 

Tập tin bị loại bỏ 

đổi tên 

Mô tả: Đổi tên các tập tin được chỉ định. 

Bao gồm: 

Nguyên mẫu: int đổi tên (const char * cũ, const char * mới); 

Đối số: con trỏ cũ sang tên cũ 

con trỏ mới sang tên mới. 

Quay trở lại giá trị: Trở về 0 nếu thành công, khác không nếu không. 

Chú ý: tên mới phải không tồn tại trong thư mục làm việc hiện tại, 

tên cũ phải tồn tại trong thư mục làm việc hiện tại. 

Ví dụ: # include / * Để đổi tên, printf * / 


{ 

if (đổi tên ("myfile.txt", "newfile.txt") = 0) 

printf ("Không thể đổi tên tập tin"); 

khác 

printf ("File đổi tên thành"); 

} 

Đầu ra: 

Tập tin đổi tên 

dsPIC 

® 



quay lại 

Mô tả: Cấu hình lại các tập tin con trỏ đến đầu của tập tin. 

Bao gồm: 

Prototype: void rewind (FILE * stream);

} 

Output: 

a 

-4 | 4 

0012 

0x1c 

1.100000E+20 

-3.35 

0.02 

putc 

Description: Puts a character to the stream. 

Include: 

Prototype: int putc(int c, FILE *stream); 

Arguments: c character to be written 

stream pointer to FILE structure 

Return Value: Returns the character or EOF if an error occurs or end of file is 

reached. 

Remarks: putcis the same as the function fputc. 

Example: #include /* for putc, EOF, stdout */ 


{ 

char *y; 


int x; 

x = 0; 

for (y = buf; (x != EOF) && (*y != '\0'); y++) 

{ 

x = putc(*y, stdout); 

putc('|', stdout); 

} 

} 

Output: 

T|h|i|s| |i|s| |t|e|x|t| 

| 

printf (Continued) 

dsPIC 

® 



Đối số: dòng suối để thiết lập lại con trỏ tập tin 

Chú ý: chức năng cuộc gọi fseek (stream, 0L, SEEK_SET) và sau đó Clears 

chỉ số lỗi cho các dòng nhất định. 

Ví dụ: # include / * Để quay lại, fopen, * / 

/ * Fscanf, fclose, * / 




{ 


char s [] = "cookies"; 

int x = 10; 

if ((myfile = fopen ("afile", "w +")) == NULL) 


khác 

{ 

fprintf (myfile, "% d% s", x, s); 

printf ("Tôi có% d% s. \ n", x, s); 

/ * Thiết lập con trỏ tobeginning của tập tin * / 

tua lại (myfile); 

fscanf (myfile, "% d% s", & x, & s); 

printf ("tôi đã ăn% d% s. \ n", x, s); 


} 

} 

Đầu ra: 

Tôi có 10 bánh. 

Tôi đã ăn 10 bánh. 



scanf 

Mô tả: Quét định dạng văn bản từ thiết bị nhập chuẩn. 

Bao gồm: 

Nguyên mẫu: int scanf (const char * format, ...); 

Đối số: định dạng chuỗi kiểm soát định dạng 



giao. Nếu 

Không có sản phẩm được giao, một 0 được trả về. Kết thúc tập tin được trả lại 

nếu một đầu vào

putchar 

Description: Put a character to stdout. 

Include: 

Prototype: int putchar(int c); 

Argument: c character to be written 

Return Value: Returns the character or EOF if an error occurs or end of file is 

reached. 

Remarks: Same effect as fputcwith stdoutas an argument. 

Example: #include /* for putchar, printf, */ 

/* EOF, stdout */ 


{ 

char *y; 


int x; 

x = 0; 

for (y = buf; (x !=EOF) && (*y != '\0'); y++) 

x = putchar(*y); 

} 

Output: 

This is text 

puts 

Description: Put a string to stdout. 

Include: 

Prototype: int puts(const char *s); 

Argument: s string to be written 

Return Value: Returns a non-negative value if successful; otherwise, returns 

EOF. 

Remarks: The function writes characters to the stream stdout. A newline 

character is appended. The terminating null character is not written to 

the stream. 

Example: #include /* for puts */ 

thất bại là gặp phải trước khi là người đầu tiên. 

Ghi chú: Mỗi đặc tả định dạng bắt đầu với một dấu phần trăm tiếp theo tùy chọ 

lĩnh vực và một loại yêu cầu như ở đây: 

% [*] [Chiều rộng] [sửa đổi] loại 

* 

chỉ ra nhiệm vụ đàn áp. Điều này sẽ gây ra các lĩnh vực đầu vào 

bị bỏ qua và không có chuyển nhượng được thực hiện. 

chiều rộng 

xác định số ký tự tối đa đầu vào để phù hợp cho 

chuyển đổi không bao gồm khoảng trắng có thể được bỏ qua. 

sửa đổi 

h sửa đổi - sử dụng với các loại d, i, o, u, x, X; chuyển đổi các giá trị cho một 

intor ngắn unsigned short int. 

h sửa đổi - sử dụng với n; xác định rằng con trỏ trỏ đến một 

ngắn int 

l sửa đổi - sử dụng với các loại d, i, o, u, x, X; chuyển đổi các giá trị cho một 

intor dài unsigned long int 

l sửa đổi - sử dụng với n; xác định rằng con trỏ trỏ đến một 

long int 

l sửa đổi - sử dụng với c; quy định cụ thể một nhân vật rộng 

l sửa đổi - sử dụng với các loại điện tử, E, F, F, g, G; chuyển đổi các giá trị cho 

một 

đôi 

ll sửa đổi - sử dụng với các loại d, i, o, u, x, X; chuyển đổi các giá trị cho một 

intor lâu dài unsigned long long int 

ll sửa đổi - sử dụng với n; xác định rằng con trỏ trỏ đến một 

lâu dài int 

L sửa đổi - sử dụng với điện tử, E, e, g, G; chuyển đổi các giá trị cho một thời 

gian dài 

đôi 

dsPIC 

® 



{ 



loại 

d, tôi đã ký int 


puts(buf); 

puts("|"); 

} 

Output: 

o unsigned intin bát phân 

u thập phân intin unsigned 

x unsigned intin hệ thập lục phân chữ thường 

X unsigned intin hệ thập lục phân hoa

This is text 

| 



remove 

Description: Deletes the specified file. 

Include: 

Prototype: int remove(const char *filename); 

Argument: filename name of file to be deleted. 

Return Value: Returns 0 if successful, -1 if not. 

Remarks: If filename does not exist or is open, removewill fail. 

Example: #include /* for remove, printf */ 


{ 

if (remove("myfile.txt") != 0) 

printf("Cannot remove file"); 

else 

printf("File removed"); 

} 

Output: 

File removed 

rename 

Description: Renames the specified file. 

Include: 

Prototype: int rename(const char *old, const char *new); 

Arguments: old pointer to the old name 

new pointer to the new name. 

Return Value: Return 0 if successful, non-zero if not. 

Remarks: The new name must not already exist in the current working 

directory, 

the old name must exist in the current working directory. 

Example: #include /* for rename, printf */ 


{ 

if (rename("myfile.txt","newfile.txt") != 0) 

printf("Cannot rename file"); 

else 

printf("File renamed"); 

} 

điện tử, E doublein ký hiệu khoa học 

f doubledecimal ký hiệu 

g, G đôi (có dạng điện tử, E hoặc e nếu thích hợp) 

c char- một nhân vật duy nhất 

sstring giá trị p của một con trỏ 

n tranh luận liên quan sẽ là một con trỏ số nguyên vào, 

được đặt số ký tự đọc cho đến nay. Không có 

nhân vật được quét. 

[...] Nhân vật mảng. Cho phép tìm kiếm một tập hợp các ký tự. Một 

dấu mũ (^) ngay sau khi khung bên trái ([) đảo ngược 

scanset và cho phép bất kỳ ký tự ASCII, ngoại trừ những 

quy định giữa các dấu ngoặc đơn. Một nhân vật có dấu gạch ngang (-) có thể 

dùng để xác định một phạm vi đầu với nhân vật trước 

dấu gạch ngang và kết thúc các nhân vật sau dấu gạch ngang. Một rỗng 

nhân vật không thể là một phần của scanset. 

%% Một nhân vật được quét 

Ví dụ: # include / * Cho scanf, printf * / 


{ 

int số lượng, mặt hàng; 

thư char; 

char màu [30], string [30]; 

nổi tiền lương; 

printf ("Nhập số yourfavorite" 

"Thư yêu thích,"); 

printf ("yêu thích màu sắc mong muốn mức lương" 

"Và SSN: \ n"); 

mục = scanf ("% d% c% [A-Za-z]% f% s", & số, 

& Thư, và màu sắc, và tiền lương, và string); 

printf ("Số scan =% d \ n", các mục); 

printf ("số yêu thích =% d", số lượng); 

printf ("thư yêu thích =% c \ n", thư); 

printf ("Màu sắc ưa thích =% s", màu sắc); 

printf ("lương Desired = $% 2f. \ n", tiền lương); 

printf ("Số An Sinh Xã Hội =% s", string); 

} 

Đầu vào: 


phỏng): 

5 T xanh 300000 123-45-6789

Output: 

File renamed 

dsPIC 

® 



rewind 

Description: Resets the file pointer to the beginning of the file. 

Include: 

Prototype: void rewind(FILE *stream); 

Argument: stream stream to reset the file pointer 

Remarks: The function calls fseek(stream, 0L, SEEK_SET)and then clears 

the error indicator for the given stream. 

Example: #include /* for rewind, fopen, */ 

/* fscanf, fclose, */ 




{ 

FILE *myfile; 

char s[] = "cookies"; 

int x = 10; 

if ((myfile = fopen("afile", "w+")) == NULL) 


else 

{ 

fprintf(myfile, "%d %s", x, s); 

printf("I have %d %s.\n", x, s); 

/* set pointer tobeginning of file */ 

rewind(myfile); 

fscanf(myfile, "%d %s", &x, &s); 

printf("I ate %d %s.\n", x, s); 


} 

} 

Output: 

I have 10 cookies. 

I ate 10 cookies. 


Đầu ra: 

Nhập số yêu thích của bạn, thư yêu thích, 

Màu sắc yêu thích, lương mong muốn và SSN: 

Số mục quét = 5 

Số yêu thích = 5, thư yêu thích = T 

Màu sắc ưa thích = Green, lương mong muốn = $ 300.000,00 

Số An Sinh Xã Hội = 123-45-6789 

scanf (Tiếp theo) 



setbuf 

Mô tả: Xác định như thế nào một dòng là đệm. 

Bao gồm: 

Prototype: void setbuf (FILE * stream, char * buf); 


buf sử dụng cấp phát bộ đệm 

Bình luận: setbufmust được gọi sau khi fopenbut trước khi gọi chức năng khác 

hoạt động trên dòng suối. Nếu bufis một con trỏ null, setbufcalls các 

chức năng setvbuf (dòng, 0, _IONBF, BUFSIZ) không có đệm; 

nếu không setbufcalls setvbuf (dòng, buf, _IOFBF, 

BUFSIZ) để đệm đầy đủ với một bộ đệm có kích thước BUFSIZ. Xem setvbuf. 

Ví dụ: # include / * Cho setbuf, printf, * / 


/ * FILE, NULL, BUFSIZ * / 


{ 


char buf [BUFSIZ]; 

if ((myfile1 = fopen ("afile1", "w +")) = NULL) 

{ 

setbuf (myfile1, NULL); 

printf ("myfile1 không có đệm \ n"); 


} 


{ 

setbuf (myfile2, buf); 

printf ("myfile2 có đầy đủ đệm"); 

fclose (myfile2);


scanf 

Description: Scans formatted text from stdin. 

Include: 

Prototype: int scanf(const char *format, ...); 

Argument: format format control string 



If 

no items are assigned, a 0 is returned. EOF is returned if an input 

failure is encountered before the first. 

Remarks: Each format specifier begins with a percent sign followed by optional 

fields and a required type as shown here: 

%[*][width][modifier]type 

* 

indicates assignment suppression. This will cause the input field to 

be skipped and no assignment made. 

width 

specify the maximum number of input characters to match for the 

conversion not including white space that can be skipped. 

modifier 

h modifier - used with type d, i, o,u, x, X; converts the value to a 

short intor unsigned short int. 

h modifier - used with n; specifies that the pointer points to a 

short int 

l modifier - used with type d, i, o,u, x, X; converts the value to a 

long intor unsigned long int 

l modifier - used with n; specifies that the pointer points to a 

long int 

l modifier - used with c; specifies a wide character 

l modifier - used with type e, E, f, F, g, G; converts the value to a 

double 

ll modifier - used with type d, i, o, u, x, X; converts the value to a 

long long intor unsigned long long int 

ll modifier - used with n; specifies that the pointer points to a 

long long int 

L modifier - used with e, E, f, g, G; converts the value to a long 

double 

dsPIC 

} 

} 

Đầu ra: 

myfile1 không có đệm 

myfile2 có đầy đủ đệm 

dsPIC 

® 



setvbuf 


Mô tả: Xác định dòng để được đệm và kích thước bộ đệm. 

Bao gồm: 

Nguyên mẫu: int setvbuf (FILE * stream, char * buf, int mode, 

size_t size); 


buf sử dụng cấp phát bộ đệm 

loại chế độ đệm 

kích thước kích thước của bộ đệm 

Quay trở lại giá trị: Trả về 0 nếu thành công 

Bình luận: setvbufmust được gọi sau khi fopenbut trước khi bất kỳ chức năng 

khác 

các cuộc gọi hoạt động trên dòng suối. Đối với chế độ sử dụng một trong các 

cách sau: 

_IOFBF- Đủ đệm 

_IOLBF- Cho dòng đệm 

_IONBF- Không có đệm 

Ví dụ: # include / * Cho setvbuf, fopen, * / 

/ * Printf, FILE, NULL, * / 

/ * _IONBF, _IOFBF * / 


{ 




{ 

if (setvbuf (myfile1, NULL, _IONBF, 0) == 0) 

printf ("myfile1 không có đệm \ n"); 

khác 

printf ("Không thể xác định dòng đệm" 

"Và / hoặc kích thước \ n");

® 



type 

d,i signed int 

o unsigned intin octal 

u unsigned intin decimal 

x unsigned intin lowercase hexadecimal 

X unsigned intin uppercase hexadecimal 

e,E doublein scientific notation 

f doubledecimal notation 

g,G double(takes the form of e, E or f as appropriate) 

c char- a single character 

sstring p value of a pointer 

n the associated argument shall be an integer pointer into, 

which is placed the number of characters read so far. No 

characters are scanned. 

[...] character array. Allows a search of a set of characters. A 

caret (^) immediately after the left bracket ( [ ) inverts the 

scanset and allows any ASCII character except those 

specified between the brackets. A dash character (-) may be 

used to specify a range beginning with the character before 

the dash and ending the character after the dash. A null 

character can not be part of the scanset. 

% A % character is scanned 

Example: #include /*for scanf, printf */ 


{ 

int number, items; 

char letter; 

char color[30], string[30]; 

float salary; 

printf("Enter yourfavorite number, " 

"favorite letter, "); 

printf("favorite color desired salary " 

"and SSN:\n"); 

items = scanf("%d %c %[A-Za-z] %f %s", &number, 

&letter, &color, &salary, &string); 

printf("Number of items scanned = %d\n", items); 

} 



{ 

if (setvbuf (myfile2, buf, _IOFBF, sizeof (buf)) == 

0) 

printf ("myfile2 có một bộ đệm của% d" 

"Ký tự \ n", sizeof (buf)); 

khác 

printf ("Không thể xác định dòng đệm" 

"Và / hoặc kích thước \ n"); 

} 


} 

Đầu ra: 

myfile1 không có đệm 

myfile2 có bufferof 256 ký tự 



sprintf 

Mô tả: In định dạng văn bản cho một chuỗi 

Bao gồm: 

Nguyên mẫu: int sprintf (char * s, char * format, ...); 

Đối số: s chuỗi lưu trữ cho định dạng đầu ra kiểm soát chuỗi định dạng 


Quay trở lại giá trị: Trả về số ký tự được lưu trữ trong sexcluding việc chấm dứ 

ký tự null. 


printf. 

Ví dụ: # include / * Cho sprintf, printf * / 


{ 

SBUF char [100], s [] = "In chuỗi này"; 

int x = 1, y; 

char '\ n' a =; 

y = sprintf (SBUF, "% s% d% thời gian c", s, x, a); 

printf ("Số ký tự được in để" 

"Chuỗi đệm =% d \ n", y); 

printf ("String =% s \ n", SBUF);

printf("Favorite number = %d, ", number); 

printf("Favorite letter = %c\n", letter); 

printf("Favorite color= %s, ", color); 

printf("Desired salary = $%.2f\n", salary); 

printf("Social Security Number = %s, ", string); 

} 

Input: 


5 T Green 300000 123-45-6789 

Output: 

Enter your favorite number, favorite letter, 

favorite color, desired salary and SSN: 

Number of items scanned = 5 

Favorite number = 5,Favorite letter = T 

Favorite color = Green, Desired salary = $300000.00 

Social Security Number = 123-45-6789 

scanf (Continued) 



setbuf 

Description: Defines how a stream is buffered. 

Include: 

Prototype: void setbuf(FILE *stream, char *buf); 

Arguments: stream pointer to the open stream 

buf user allocated buffer 

Remarks: setbufmust be called after fopenbut before any other function calls 

that operate on the stream. If bufis a null pointer, setbufcalls the 

function setvbuf(stream, 0, _IONBF, BUFSIZ)for no buffering; 

otherwise setbufcalls setvbuf(stream, buf, _IOFBF, 

BUFSIZ)for full buffering with a buffer of size BUFSIZ. See setvbuf. 

Example: #include /* for setbuf, printf, */ 


/* FILE, NULL, BUFSIZ */ 


{ 


char buf[BUFSIZ]; 

if ((myfile1 = fopen("afile1", "w+")) != NULL) 

{ 

} 

Đầu ra: 

Số ký tự được in chuỗi đệm = 25 

String = In trang nay chuỗi 1 lần 

sscanf 

Mô tả: Quét định dạng văn bản từ một chuỗi 

Bao gồm: 

Nguyên mẫu: int sscanf (const char * s, char * format, ...); 

Đối số: s chuỗi lưu trữ cho các định dạng đầu vào chuỗi kiểm soát định dạng 



giao. Nếu 

Không có sản phẩm được giao, một 0 được trả về. Kết thúc tập tin được trả lại 

nếu một lỗi đầu vào 

đang gặp phải trước khi chuyển đổi đầu tiên. 


scanf. 

dsPIC 

® 




Ví dụ: # include / * Cho sscanf, printf * / 


{ 

char s [] = "5 T 3.000.000,00 xanh"; 

int số lượng, mặt hàng; 

thư char; 

char màu [10]; 

nổi tiền lương; 

mục = sscanf (s, "% d% c% s% f", & số, và lá thư, 

Và màu sắc, và tiền lương); 

printf ("Số scan =% d \ n", các mục); 

printf ("yêu thích số =% d \ n", số lượng); 

printf ("thư yêu thích =% c \ n", thư); 

printf ("Màu sắc ưa thích =% s \ n", màu sắc); 

printf ("lương Desired = $% 2f. \ n", tiền lương); 

} 

Đầu ra: 

Số mục quét = 4 

Số yêu thích = 5

setbuf(myfile1, NULL); 

printf("myfile1 has no buffering\n"); 


} 


{ 

setbuf(myfile2, buf); 

printf("myfile2 has full buffering"); 


} 

} 

Output: 

myfile1 has no buffering 

myfile2 has full buffering 

dsPIC 

® 



setvbuf 

Description: Defines the stream to be buffered and the buffer size. 

Include: 

Prototype: int setvbuf(FILE *stream, char *buf, int mode, 

size_t size); 


buf user allocated buffer 

mode type of buffering 

size size of buffer 

Return Value: Returns 0 if successful 

Remarks: setvbufmust be called after fopenbut before any other function 

calls that operate on the stream. For mode use one of the following: 

_IOFBF– for full buffering 

_IOLBF– for line buffering 

_IONBF– for no buffering 

Example: #include /* for setvbuf, fopen, */ 

/* printf, FILE, NULL, */ 

/* _IONBF, _IOFBF */ 


{ 


Thư yêu thích = T 

Màu sắc yêu thích màu xanh lá cây = 

Mức lương mong muốn = $ 3.000.000,00 

tmpfile 

Mô tả: Tạo ra một tập tin tạm thời 

Bao gồm: 

Prototype: FILE * tmpfile (void) 

Quay trở lại giá trị: Trả về một con trỏ dòng nếu thành công; nếu không, trả về 

một NULL 

con trỏ. 

Bình luận: tmpfilecreates một tập tin với một tên tập tin duy nhất. Các tập tin 

tạm thời là 

mở trong w + b (nhị phân đọc / ghi) chế độ. Nó sẽ tự động được 

loại bỏ khi exitis gọi; nếu không thì tập tin sẽ ở lại 

thư mục. 

Ví dụ: # include / * Cho tmpfile, printf, * / 



{ 

FILE * mytempfile; 

if ((mytempfile = tmpfile ()) == NULL) 

printf ("Không thể tạo tập tin tạm thời"); 

khác 

printf ("tập tin tạm thời được tạo ra"); 

} 

Đầu ra: 

Tập tin tạm thời được tạo ra 

sscanf (Tiếp theo) 



tmpnam 

Mô tả: Tạo ra một tên tập tin tạm thời độc đáo 

Bao gồm: 

Prototype: char * tmpnam (char * s); 

Đối số: s con trỏ đến tên tạm thời 

Quay trở lại giá trị: Trả về một con trỏ đến tên tập tin được tạo ra và lưu trữ các 

tên tập tin trong 

s. Nếu nó không thể tạo ra một tên tập tin, con trỏ NULL được trả về. 

Chú ý: tên tập tin được tạo ra sẽ không mâu thuẫn với một tên tập tin hiện 

có. Sử dụng 

L_tmpnamto xác định kích thước của mảng đối số của tmpnampoints

char buf[256]; 


{ 

if (setvbuf(myfile1, NULL, _IONBF, 0) == 0) 

printf("myfile1 has no buffering\n"); 

else 

printf("Unable to define buffer stream " 

"and/or size\n"); 

} 



{ 

if (setvbuf(myfile2, buf, _IOFBF, sizeof(buf)) == 

0) 

printf("myfile2 has a buffer of %d " 

"characters\n", sizeof(buf)); 

else 

printf("Unable to define buffer stream " 

"and/or size\n"); 

} 


} 

Output: 

myfile1 has no buffering 

myfile2 has a bufferof 256 characters 



sprintf 

Description: Prints formatted text to a string 

Include: 

Prototype: int sprintf(char *s, const char *format, ...); 

Arguments: s storage string for output format format control string 


Return Value: Returns the number of characters stored in sexcluding the 

terminating 

null character. 


printf. 

Example: #include /* for sprintf, printf */ 

để. 

Ví dụ: # include / * Cho tmpnam, L_tmpnam, * / 

/ * Printf, NULL * / 


{ 

char * mYfiLEname; 

char mybuf [L_tmpnam]; 

char * myptr = (char *) & mybuf; 

if ((mYfiLEname = tmpnam (myptr)) == NULL) 

printf ("Không thể tạo tên tập tin tạm thời"); 

khác 

printf ("tạm thời tập tin% s đã được tạo ra", 

mYfiLEname); 

} 

Đầu ra: 

Tập tin tạm thời được tạo ra ctm00001.tmp 

ungetc 

Mô tả: Đẩy nhân vật trở lại vào dòng. 

Bao gồm: 

Nguyên mẫu: int ungetc (int c, FILE * stream); 

Đối số: ký tự c được đẩy lùi 


Quay trở lại giá trị: Trả về nhân vật đẩy nếu thành công; nếu không, trả về EOF 

Ghi chú: Các nhân vật bị đẩy trở lại sẽ được trả về bởi sau đó đọc trên 

dòng. Nếu có nhiều hơn một nhân vật được đẩy trở lại, họ sẽ có 

trở lại theo thứ tự ngược lại đẩy họ. Một cuộc gọi thành công vào một tập tin 

chức năng định vị (fseek, fsetposor quay lại) hủy bỏ bất kỳ đẩy 

ký tự trở lại. Chỉ có một nhân vật của pushback được đảm bảo. 

Nhiều cuộc gọi đến ungetcwithout một vị trí can thiệp đọc hoặc tập tin 

hoạt động có thể gây ra một sự thất bại. 

dsPIC 

® 



Ví dụ: # include / * Cho ungetc, fgetc, * / 


/ * FILE, NULL, kết thúc tập tin * / 


{


{ 

char sbuf[100], s[]="Print this string"; 

int x = 1, y; 

char a = '\n'; 

y = sprintf(sbuf, "%s%d time%c", s, x, a); 

printf("Number of characters printed to " 

"string buffer = %d\n", y); 

printf("String= %s\n", sbuf); 

} 

Output: 

Number of characters printed to string buffer = 25 

String = Print this string 1 time 

sscanf 

Description: Scans formatted text from a string 

Include: 

Prototype: int sscanf(const char *s, const char *format, ...); 

Arguments: s storage string for input format format control string 



If 

no items are assigned, a 0 is returned. EOF is returned if an input error 

is encountered before the first conversion. 


scanf. 

dsPIC 

® 


FILE * buf; 

char y, c; 



khác 

{ 



{ 

if (y == 'r') 

{ 

c = ungetc (y, buf); 

if (c! = EOF) 

{ 

printf ("2"); 


} 

} 

printf ("% c", y); 


} 

fclose (buf); 

} 

} 

Đầu vào: 


Ngắn 


DS51456B-page 264 


Đầu ra: 

Example: #include /* for sscanf, printf */ 


{ 

char s[] = "5 T green 3000000.00"; 

int number, items; 

char letter; 

char color[10]; 

float salary; 

items = sscanf(s, "%d %c %s %f", &number, &letter, 

&color, &salary); 

Sho2rt 

Longe2r st2ring 

ungetc (Tiếp theo) 



vfprintf 

Mô tả: In định dạng dữ liệu cho một dòng bằng cách sử dụng một danh sách đố 

số chiều dài biến. 

Bao gồm: 

Nguyên mẫu: int vfprintf (FILE * stream, const char * format, 

va_list ap);

printf("Number of items scanned = %d\n", items); 

printf("Favorite number = %d\n", number); 

printf("Favorite letter = %c\n", letter); 

printf("Favorite color = %s\n", color); 

printf("Desired salary = $%.2f\n", salary); 

} 

Output: 

Number of items scanned = 4 

Favorite number = 5 

Favorite letter = T 

Favorite color = green 

Desired salary = $3000000.00 

tmpfile 

Description: Creates a temporary file 

Include: 

Prototype: FILE *tmpfile(void) 

Return Value: Returns a stream pointer if successful; otherwise, returns a NULL 

pointer. 

Remarks: tmpfilecreates a file with a unique filename. The temporary file is 

opened in w+b(binary read/write) mode. It will automatically be 

removed when exitis called; otherwise the file will remain in the 

directory. 

Example: #include /* for tmpfile, printf, */ 



{ 

FILE *mytempfile; 

if ((mytempfile = tmpfile()) == NULL) 

printf("Cannot create temporary file"); 

else 

printf("Temporary file was created"); 

} 

Output: 

Temporary file was created 

sscanf (Continued) 



tmpnam 

Description: Creates a unique temporary filename 



ap con trỏ đến một danh sách các đối số 

Quay trở lại giá trị: Trả về số ký tự được tạo ra hoặc một số âm nếu một 



printf. 

Để truy cập vào danh sách đối số chiều dài biến, apvariable phải 

khởi tạo bởi các va_startand vĩ mô có thể được khởi tạo lại bởi 

cuộc gọi bổ sung cho va_arg. Điều này phải được thực hiện trước khi vfprintf 

hàm được gọi. Gọi va_endafter trở về chức năng. Để biết thêm 

chi tiết xem stdarg.h. 

Ví dụ: # include / * Forvfprintf, fopen, * / 

/ * Fclose, printf, * / 


# include / * Cho va_start, * / 

/ * Va_list, va_end * / 


khoảng trống errmsg (const char * fmt, ...) 

{ 

va_list ap; 


vfprintf (myfile, fmt, ap); 

va_end (ap); 

} 


{ 

int num = 3; 

if ((myfile = fopen ("afile.txt", "w")) == NULL) 


khác 

{ 

errmsg ("Lỗi: Ký tự"% c 'không phải là% s \ n ",' a ', 

"Một số nguyên."); 

errmsg ("Lỗi: Yêu cầu% d% s% c", num, 

"Hoặc nhiều ký tự.", '\ N'); 

} 


}

Include: 

Prototype: char *tmpnam(char *s); 

Argument: s pointer to the temporary name 

Return Value: Returns a pointer to the filename generated and stores the 

filename in 

s. If it can not generate a filename, the NULL pointer is returned. 

Remarks: The created filename will not conflict with an existing file name. Use 

Đầu ra: 

Nội dung afile.txt 

Lỗi: chữ 'a' isnot một số nguyên. 

Lỗi: Yêu cầu 3 ormore ký tự. 

dsPIC 

® 


L_tmpnamto define the size of array the argument of tmpnampoints 

to. 


vprintf 


Example: #include /* for tmpnam, L_tmpnam, */ 

/* printf, NULL */ 


{ 

char *myfilename; 

char mybuf[L_tmpnam]; 

char *myptr = (char *) &mybuf; 

if ((myfilename = tmpnam(myptr)) == NULL) 

printf("Cannot create temporary file name"); 

else 

printf("Temporary file %s was created", 

myfilename); 

} 

Output: 

Temporary file ctm00001.tmp was created 

ungetc 

Description: Pushes character back onto stream. 

Include: 

Prototype: int ungetc(int c, FILE *stream); 

Argument: c character to be pushed back 


Return Value: Returns the pushed character if successful; otherwise, returns 

EOF 

Remarks: The pushed back character will be returned by a subsequent read on 

the stream. If more than one character is pushed back, they will be 

returned in the reverse order of their pushing. A successful call to a file 

positioning function (fseek, fsetposor rewind) cancels any pushed 

back characters. Only one character of pushback is guaranteed. 

Multiple calls to ungetcwithout an intervening read or file positioning 

operation may cause a failure. 

dsPIC 

Mô tả: In định dạng văn bản để stdoutusing một danh sách đối số chiều dài biến 

Bao gồm: 

Nguyên mẫu: int vprintf (const char * format, va_list ap); 

Đối số: chuỗi định dạng kiểm soát định dạng 

ap con trỏ đến một danh sách các đối số trở lại giá trị: Trả về số ký tự được tạo 

ra hoặc một số âm nếu một 



printf. 



cuộc gọi bổ sung cho va_arg. Điều này phải được thực hiện trước khi vprintf 


chi tiết xem stdarg.h 

Ví dụ: # include / * Cho vprintf, printf * / 




{ 

va_list ap; 


printf ("Lỗi:"); 

vprintf (fmt, ap); 

va_end (ap); 

} 


{ 

int num = 3; 

errmsg ("Bức thư '% c' không phải là% s \ n", 'a', 


errmsg ("Yêu cầu% d% s \ n", num,

® 



Example: #include /* for ungetc, fgetc, */ 


/* FILE, NULL, EOF */ 


{ 

FILE *buf; 

char y, c; 



else 

{ 



{ 

if (y == 'r') 

{ 

c = ungetc(y, buf); 

if (c != EOF) 

{ 

printf("2"); 


} 

} 

printf("%c", y); 


} 

fclose(buf); 

} 

} 

Input: 


Short 

Longer string 

Output: 

Sho2rt 

Longe2r st2ring 

"Hoặc nhiều ký tự. \ N"); 

} 

Đầu ra: 





vsprintf 

Mô tả: In định dạng văn bản cho một chuỗi bằng cách sử dụng một danh sách 

đối số chiều dài biến 

Bao gồm: 

Nguyên mẫu: int vsprintf (char * s, char * format, va_list 

ap); 

Đối số: s chuỗi lưu trữ cho đầu ra 


ap con trỏ đến một danh sách các đối số trở lại giá trị: Trả về số ký tự được lưu 

trữ trong sexcluding việc chấm dứt vô 

nhân vật. 


printf. 



cuộc gọi bổ sung cho va_arg. Điều này phải được thực hiện trước khi vsprintf 


chi tiết xem stdarg.h 

Ví dụ: # include / * Cho vsprintf, printf * / 




{ 

va_list ap; 



vsprintf (buf, fmt, ap); 

va_end (ap); 

printf ("Lỗi:% s", buf); 

} 


{ 

int num = 3;

ungetc (Continued) 



vfprintf 

Description: Prints formatted data to a stream using a variable length argument 

list. 

Include: 

 

Prototype: int vfprintf(FILE *stream, const char *format, 

va_list ap); 


errmsg ("Bức thư '% c' không phải là% s \ n", 'a', 


errmsg ("Yêu cầu% d% s \ n", num, 

"Hoặc nhiều ký tự. \ N"); 

} 

Đầu ra: 



dsPIC 

® 





ap pointer to a list of arguments 


an 

error occurs. 


printf. 

To access the variable length argument list, the apvariable must be 

initialized by the macro va_startand may be reinitialized by 

additional calls to va_arg. This must be done before the vfprintf 

function is called. Invoke va_endafter the function returns. For more 

details see stdarg.h. 

Example: #include /* forvfprintf, fopen, */ 

/* fclose, printf, */ 


#include /* for va_start, */ 

/* va_list, va_end */ 

FILE *myfile; 

void errmsg(const char *fmt, ...) 

{ 

va_list ap; 


vfprintf(myfile, fmt, ap); 

va_end(ap); 

} 


{ 

int num = 3; 

if ((myfile = fopen("afile.txt", "w")) == NULL) 

4.14 CHỨC NĂNG TIỆN ÍCH 

Các stdlib.hconsists tập tin tiêu đề của các loại, macro và các chức năng cung 

cấp các văn bản 

chuyển đổi, quản lý bộ nhớ, tìm kiếm và phân loại khả năng, và các chung 

tiện ích. 

div_t 

Mô tả: Một loại chứa một thương và phần còn lại của một bộ phận nguyên ký 

với toán hạng kiểu int. 

Bao gồm: 

Nguyên mẫu: struct {intquot, rem; } Div_t; 

Ghi chú: Đây là loại cấu trúc hàm trả về div. 

ldiv_t 

Mô tả: Một loại chứa một thương và phần còn lại của một bộ phận nguyên ký 

với toán hạng của loại dài. 

Bao gồm: 

Nguyên mẫu: struct {quot dài, rem; } Ldiv_t; 

Ghi chú: Đây là loại cấu trúc hàm trả về ldiv. 

size_t 


Bao gồm: 

wchar_t 

Mô tả: Một loại chứa một giá trị nhân vật rộng. 

Bao gồm: 

EXIT_FAILURE 

Mô tả: Báo cáo kết thúc không thành công. 

Bao gồm: 

Bình luận: EXIT_FAILUREis một giá trị cho các chức năng thoát để trở về mộ 

chấm dứt tình trạng không thành công


else 

{ 

errmsg("Error: The letter '%c' is not %s\n", 'a', 

"an integer value."); 

errmsg("Error: Requires %d%s%c", num, 

" or more characters.", '\n'); 

} 


} 

Output: 

Contents of afile.txt 

Error: The letter 'a' isnot an integer value. 

Error: Requires 3 ormore characters. 

dsPIC 

® 


Ví dụ: Xem exitfor ví dụ về sử dụng. 

EXIT_SUCCESS 

Mô tả: Báo cáo kết thúc thành công 

Bao gồm: 

Bình luận: EXIT_SUCCESSis một giá trị cho các chức năng thoát để trở về mộ 

thành công 

trạng thái chấm dứt. 

Ví dụ: Xem exitfor ví dụ về sử dụng. 



MB_CUR_MAX 

Mô tả: Tối đa số charactersin một nhân vật nhiều byte 

Bao gồm: 

Giá trị: 1 

NULL 

Mô tả: Giá trị của một con trỏ hằng rỗng 

Bao gồm: 

RAND_MAX 

DS51456B-page 268 

vprintf 


Mô tả: Giá trị tối đa khả năng được trả về bởi randfunction 

Bao gồm: 

Description: Prints formatted text to stdoutusing a variable length argument list 

Include: 

 

Prototype: int vprintf(const char *format, va_list ap); 

Arguments: format format control string 

ap pointer to a list of arguments Return Value: Returns number of characters 

generated or a negative number if an 

error occurs. 


printf. 



additional calls to va_arg. This must be done before the vprintf 


details see stdarg.h 

Example: #include /* for vprintf, printf */ 


/* va_list, va_end */ 


{ 


hủy bỏ 

Mô tả: hủy bỏ quá trình hiện tại. 

Bao gồm: 

Prototype: void abort (void); 

Bình luận: abortwill gây ra bộ vi xử lý để thiết lập lại. 


/ * Printf, FILE, NULL * / 

# include / * Cho hủy bỏ * / 


{ 


if ((myfile = fopen ("samp.fil", "r")) == NULL) 

{ 

printf ("Không thể mở samp.fil \ n"); 

hủy bỏ (); 

} 

khác 


fclose (myfile);

va_list ap; 


printf("Error: "); 

vprintf(fmt, ap); 

va_end(ap); 

} 


{ 

int num = 3; 

errmsg("The letter '%c' is not %s\n", 'a', 


errmsg("Requires %d%s\n", num, 

" or more characters.\n"); 

} 

Output: 





vsprintf 

Description: Prints formatted text to a string using a variable length argument 

list 

Include: 

 

Prototype: int vsprintf(char *s, const char *format, va_list 

ap); 

Arguments: s storage string for output 


ap pointer to a list of arguments Return Value: Returns number of characters 

stored in sexcluding the terminating null 

character. 


printf. 



additional calls to va_arg. This must be done before the vsprintf 


details see stdarg.h 

Example: #include /* for vsprintf, printf */ 


} 

Đầu ra: 

Không thể mở samp.fil 

ABRT 

dsPIC 

® 



abs 

Mô tả: Tính giá trị tuyệt đối. 

Bao gồm: 

Nguyên mẫu: int abs (int i); 

Đối số: i số nguyên giá trị 

Quay trở lại giá trị: Trả về giá trị tuyệt đối của tôi. 

Bình luận: Một số âm được trả về là tích cực; một số dương là 

không thay đổi. 


# include / * Cho abs * / 


{ 

int i; 

i = 12; 

printf ("Giá trị tuyệt đối của% d% d \ n", 

i, abs (i)); 

i = -2; 


i, abs (i)); 

i = 0; 


i, abs (i)); 

} 

Đầu ra: 

Giá trị tuyệt đối của 12 là 12 

Giá trị tuyệt đối của -2 là 2 


atexit 

Mô tả: Thanh ghi chức năng xác định được gọi khi chương trình 

chấm dứt bình thường. 

Bao gồm:

* va_list, va_end */ 


{ 

va_list ap; 



vsprintf(buf, fmt, ap); 

va_end(ap); 

printf("Error: %s", buf); 

} 


{ 

int num = 3; 

errmsg("The letter '%c' is not %s\n", 'a', 


errmsg("Requires %d%s\n", num, 

" or more characters.\n"); 

} 

Output: 



dsPIC 

® 


DS51456B-page 270 


4.14 UTILITY FUNCTIONS 

The header file stdlib.hconsists of types, macros and functions that provide text 

conversions, memory management, searching and sorting abilities, and other 

general 

utilities. 

div_t 

Description: A type that holds a quotient and remainder of a signed integer 

division 

with operands of type int. 

Include: 

Prototype: typedef struct { intquot, rem; } div_t; 

Remarks: This is the structure type returned by the function div. 

ldiv_t 

Description: A type that holds a quotient and remainder of a signed integer 

division 

Nguyên mẫu: int atexit (void (* func) (void)); 

Đối số: chức năng Func được gọi là 

Quay trở lại giá trị: Trả về một số không nếu thành công; nếu không, trả về một 

giá trị khác không. 

Ghi chú: Đối với các chức năng đăng ký để được gọi là, chương trình phải chấm 

dứt 

với các cuộc gọi exitfunction. 

Ví dụ: # include / * Cho scanf, printf * / 

# include / * Cho atexit, xuất cảnh * / 

good_msg trống (void); 

bad_msg trống (void); 

end_msg trống (void); 




{ 

int số; 

atexit (end_msg); 

printf ("Nhập số yêu thích của bạn:"); 

scanf ("% d", & số lượng); 

printf ("% d \ n", số lượng); 

if (số == 5) 

{ 

printf ("Good Choice \ n"); 

atexit (good_msg); 

exit (0); 

} 

khác 

{ 

("?% d \ n", số lượng) printf; 

atexit (bad_msg); 

exit (0); 

} 

} 

good_msg trống (void) 

{ 

printf ("Đó là một số lượng \ n tuyệt vời"); 

} 

bad_msg trống (void) 

{

with operands of type long. 

Include: 

Prototype: typedef struct { long quot, rem; } ldiv_t; 

Remarks: This is the structure type returned by the function ldiv. 

size_t 


Include: 

wchar_t 

Description: A type that holds a wide character value. 

Include: 

EXIT_FAILURE 

Description: Reports unsuccessful termination. 

Include: 

Remarks: EXIT_FAILUREis a value for the exit function to return an 

unsuccessful termination status 

Example: See exitfor example of use. 

EXIT_SUCCESS 

Description: Reports successful termination 

Include: 

Remarks: EXIT_SUCCESSis a value for the exit function to return a successful 

termination status. 

Example: See exitfor example of use. 



MB_CUR_MAX 

Description: Maximum number of charactersin a multibyte character 

Include: 

Value: 1 

NULL 

Description: The value of a null pointer constant 

Include: 

RAND_MAX 

Description: Maximum value capable of being returned by the randfunction 

Include: 

Value: 32767 

abort 

Description: Aborts the current process. 

Include: 

Prototype: void abort(void); 

printf ("Đó là một con số khủng khiếp \ n"); 

} 

end_msg trống (void) 

{ 

printf ("Bây giờ gocount một cái gì đó \ n"); 

} 

Đầu vào: 

Với nội dung của UartIn.txt (sử dụng như stdininput cho giả lập): 

5 

Đầu ra: 

Nhập số yêu thích của bạn: 5 

Good Choice 

Đó là một con số tuyệt vời 

Bây giờ đi đếm một cái gì đó 

Đầu vào: 

Với nội dung của UartIn.txt (sử dụng như stdininput cho giả lập): 

42 

Đầu ra: 

Nhập số yêu thích của bạn: 42 

42 !? 

Đó là một con số khủng khiếp 

Bây giờ đi đếm một cái gì đó 

atexit (Tiếp theo) 

dsPIC 

® 



atof 


Mô tả: Chuyển đổi một chuỗi đến một độ chính xác gấp đôi giá trị dấu chấm 

động. 

Bao gồm: 

Prototype: atof đôi (const char * s); 

Đối số: s con trỏ đến chuỗi được chuyển đổi 

Quay trở lại giá trị: Trả về giá trị chuyển đổi nếu thành công; nếu không, trả về 

0. 

Ghi chú: Số lượng có thể bao gồm những điều sau đây: 

[Khoảng trắng] [dấu hiệu] chữ số [.digits] 

[{E | E} [dấu hiệu] chữ số] 

khoảng trắng tùy chọn, theo sau là một signthen tùy chọn một chuỗi 

của một hoặc nhiều digitswith một điểm thập phân tùy chọn, theo sau là một

Remarks: abortwill cause the processor to reset. 


/* printf, FILE, NULL */ 

#include /* for abort */ 


{ 

FILE *myfile; 

if ((myfile = fopen("samp.fil", "r")) == NULL) 

{ 

printf("Cannot open samp.fil\n"); 

abort(); 

} 

else 



} 

Output: 

Cannot open samp.fil 

ABRT 

dsPIC 

® 



abs 

Description: Calculates the absolute value. 

Include: 

Prototype: int abs(int i); 

Argument: i integer value 

Return Value: Returns the absolute value of i. 

Remarks: A negative number is returned as positive; a positive number is 

unchanged. 


#include /* for abs */ 


{ 

int i; 

i = 12; 

printf("The absolute value of %d is %d\n", 

i, abs(i)); 

hoặc tùy chọn hơn digitsand một EOR tùy chọn Efollowed bởi một tùy chọn 

mũ đã ký kết. Việc chuyển đổi dừng lại khi lần đầu tiên được công nhận 

nhân vật đạt được. Việc chuyển đổi cũng giống như strtod (s, 0,0) 

ngoại trừ nó không có kiểm tra lỗi để errnowill không được thiết lập. 


# include / * Cho atof * / 


{ 

char a [] = "1,28"; 

char b [] = "27.835e2"; 

char c [] = "Number1"; 

x đôi; 

x = atof (a); 

printf ("String = \"% s \ "float =% f \ n", a, x); 

x = atof (b); 

printf ("String = \"% s \ "float =% f \ n", b, x); 

x = atof (c); 

printf ("String = \"% s \ "float =% f \ n", c, x); 

} 

Đầu ra: 

String = "1.28" float = 1,280000 

String = "27,835: e2" float = 2783,500000 

String = "Number1" float = 0.000000 


atoi 


Mô tả: Chuyển đổi một chuỗi số nguyên. 

Bao gồm: 

Nguyên mẫu: int atoi (const char * s); 

Đối số: s chuỗi được chuyển đổi 

Quay trở lại giá trị: Trả về số nguyên chuyển đổi nếu thành công; nếu không, tr 

về 0. 


[Khoảng trắng] [dấu hiệu] chữ số 


của một hoặc nhiều chữ số. Việc chuyển đổi dừng lại khi lần đầu tiên 

nhân vật không được công nhận là đạt. Việc chuyển đổi tương đương với 

(Int) strtol (s, 0,10), ngoại trừ nó không có kiểm tra lỗi để errno 

sẽ không được thiết lập. 

Ví dụ: # include / * Cho printf * /

i = -2; 


i, abs(i)); 

i = 0; 


i, abs(i)); 

} 

Output: 

The absolute value of 12 is 12 

The absolute value of -2 is 2 


atexit 

Description: Registers the specified function to be called when the program 

terminates normally. 

Include: 

Prototype: int atexit(void(*func)(void)); 

Argument: func function to be called 

Return Value: Returns a zero if successful; otherwise, returns a non-zero value. 

Remarks: For the registered functions to be called, the program must terminate 

with the exitfunction call. 

Example: #include /* for scanf, printf */ 

#include /* for atexit, exit */ 

void good_msg(void); 

void bad_msg(void); 

void end_msg(void); 




{ 

int number; 

# include / * Cho atoi * / 


{ 

char a [] = "-127"; 

char b [] = "Number1"; 

int x; 

x = atoi (a); 

printf ("String = \"% s \ "\ màu =% d \ n", a, x); 

x = atoi (b); 

printf ("String = \"% s \ "\ màu =% d \ n", b, x); 

} 

Đầu ra: 

String = "-127" int = -127 

String = "Number1" int = 0 

atol 

Mô tả: Chuyển đổi một chuỗi thành một số nguyên dài. 

Bao gồm: 

Prototype: atol dài (const char * s); 

Đối số: s chuỗi được chuyển đổi 

Quay trở lại giá trị: Trả về longinteger chuyển đổi nếu thành công; nếu không, 

trả về 0 


[Khoảng trắng] [dấu hiệu] chữ số 


của một hoặc nhiều chữ số. Việc chuyển đổi dừng lại khi lần đầu tiên 

nhân vật không được công nhận là đạt. Việc chuyển đổi tương đương với 

(Int) strtol (s, 0,10), ngoại trừ nó không có kiểm tra lỗi để errno 

sẽ không được thiết lập. 

dsPIC 

® 


atexit(end_msg); 



printf("Enter your favorite number:"); 

scanf("%d", &number); 

printf(" %d\n", number); 

if (number == 5) 

{ 

printf("Good Choice\n"); 

atexit(good_msg); 

exit(0); 


# include / * Cho atol * / 


{ 

char a [] = "-123.456"; 

char b [] = "2Number"; 

x dài; 

x = atol (a);

} 

else 

{ 

printf("%d!?\n", number); 

atexit(bad_msg); 

exit(0); 

} 

} 

void good_msg(void) 

{ 

printf("That's an excellent number\n"); 

} 

void bad_msg(void) 

{ 

printf("That's an awful number\n"); 

} 

void end_msg(void) 

{ 

printf("Now gocount something\n"); 

} 

Input: 

With contents of UartIn.txt(used as stdininput for simulator): 

5 

Output: 

Enter your favorite number: 5 

Good Choice 

That's an excellent number 

Now go count something 

Input: 

With contents of UartIn.txt(used as stdininput for simulator): 

42 

Output: 

Enter your favorite number: 42 

42!? 

That's an awful number 

Now go count something 

atexit (Continued) 

dsPIC 

® 

printf ("String = \"% s \ "int =% ld \ n", a, x); 

x = atol (b); 

printf ("String = \"% s \ "int =% ld \ n", b, x); 

} 

Đầu ra: 

String = "-123.456" int = -123.456 

String = "2Number" int = 2 

bsearch 

Mô tả: Thực hiện tìm kiếm nhị phân 

Bao gồm: 

Nguyên mẫu: void * bsearch (const void * quan trọng, const void * cơ sở, 

nelem size_t, size_t size, 

int (* CMP) (const void * ck, const void * ce)); 

Đối số: đối tượng quan trọng để tìm kiếm 

con trỏ cơ sở để bắt đầu tìm kiếm dữ liệu 

số nelem của các yếu tố 

kích thước kích thước của các yếu tố 

CMP con trỏ đến chức năng so sánh 

ck con trỏ đến chìa khóa cho việc tìm kiếm 

ce con trỏ đến phần tử được so sánh với phím. 

Quay trở lại giá trị: Trả về một con trỏ đến các đối tượng được tìm kiếm nếu tìm 

thấy; nếu không, 

trở về NULL. 

Bình luận: Giá trị trả về của hàm so sánh là 0 nếu ckis lớn hơn ce. 

Trong ví dụ sau, qsortis sử dụng để sắp xếp danh sách trước khi bsearch 

được gọi. bsearchrequires danh sách được sắp xếp theo 

chức năng so sánh. Đây compuses thứ tự tăng dần. 

atol (Tiếp theo) 



Ví dụ: # include / * Cho bsearch, qsort * / 

# include / * Cho printf, sizeof * / 

# xác định NUM 7 

int comp (const void * e1, const void * e2); 


{ 

int danh sách [NUM] = {35, 47,63, 25, 93, 16, 52}; 

int x, y; 

int * r;



atof 

Description: Converts a string to a double precision floating-point value. 

Include: 

Prototype: double atof(const char *s); 

Argument: s pointer to the string to be converted 

Return Value: Returns the converted value if successful; otherwise, returns 0. 

Remarks: The number may consist of the following: 

[whitespace] [sign] digits [.digits] 

[ { e | E }[sign]digits] 

optional whitespace, followed by an optional signthen a sequence 

of one or more digitswith an optional decimal point, followed by one 

or more optional digitsand an optional eor Efollowed by an optional 

signed exponent. The conversion stops when the first unrecognized 

character is reached. The conversion is the same as strtod(s,0,0) 

except it does no error checking so errnowill not be set. 


#include /* for atof */ 


{ 

char a[] = " 1.28"; 

char b[] = "27.835e2"; 

char c[] = "Number1"; 

double x; 

x = atof(a); 

printf("String = \"%s\" float = %f\n", a, x); 

x = atof(b); 

printf("String = \"%s\" float = %f\n", b, x); 

x = atof(c); 

printf("String = \"%s\" float = %f\n", c, x); 

} 

Output: 

String = "1.28" float = 1.280000 

String = "27.835:e2"float = 2783.500000 




atoi 

qsort (danh sách, NUM, sizeof (int), comp); 

printf ("Sắp xếp liệt kê:"); 

for (x = 0; x

Description: Converts a string to an integer. 

Include: 

Prototype: int atoi(const char *s); 

Argument: s string to be converted 

Return Value: Returns the converted integer if successful; otherwise, returns 0. 


[whitespace] [sign] digits 


of one or more digits. The conversion stops when the first 

unrecognized character is reached. The conversion is equivalent to 

(int) strtol(s,0,10)except it does no error checking so errno 

will not be set. 


#include /* for atoi */ 


{ 

char a[] = " -127"; 

char b[] = "Number1"; 

int x; 

x = atoi(a); 

printf("String = \"%s\"\tint = %d\n", a, x); 

x = atoi(b); 

printf("String = \"%s\"\tint = %d\n", b, x); 

} 

Output: 

String = " -127" int = -127 

String = "Number1" int = 0 

atol 

Description: Converts a string to a long integer. 

Include: 

Prototype: long atol(const char *s); 

Argument: s string to be converted 

Return Value: Returns the converted longinteger if successful; otherwise, 

returns 0 


[whitespace] [sign] digits 


of one or more digits. The conversion stops when the first 

unrecognized character is reached. The conversion is equivalent to 

Bao gồm: 

Nguyên mẫu: void * calloc (size_t nelem, size_t size); 

Đối số: số nelem của các yếu tố 

chiều dài kích thước của mỗi phần tử 

Quay trở lại giá trị: Trả về một con trỏ đến không gian được phân bổ nếu thành 

công; nếu không, 

trả về một con trỏ null. 

Ghi chú: Bộ nhớ được trả về bởi callocis liên kết chính xác cho bất kỳ dữ liệu 

kích thước 

phần tử và được khởi tạo bằng không. 

Ví dụ: / * Chương trình này cấp phát bộ nhớ cho * / 

/ * Mảng 'i' của longintegers và khởi tạo * / 

/ * Chúng bằng không. * / 

# include / * Cho printf, NULL * / 

# include / * Cho calloc, * miễn phí / 


{ 

int x; 

dài * i; 

i = (long *) calloc (5, sizeof (long)); 

if (i! = NULL) 

{ 

for (x = 0; x

(int) strtol(s,0,10)except it does no error checking so errno 

will not be set. 

dsPIC 

® 


DS51456B-page 276 



#include /* for atol */ 


{ 

char a[] = " -123456"; 

char b[] = "2Number"; 

long x; 

x = atol(a); 

printf("String = \"%s\" int = %ld\n", a, x); 

x = atol(b); 

printf("String = \"%s\" int = %ld\n", b, x); 

} 

Output: 

String = " -123456" int = -123456 

String = "2Number" int = 2 

bsearch 

Description: Performs a binary search 

Include: 

Prototype: void *bsearch(const void *key, const void *base, 

size_t nelem, size_t size, 

int (*cmp)(const void *ck, const void *ce)); 

Arguments: key object to search for 

base pointer to the start of the search data 

nelem number of elements 

size size of elements 

cmp pointer to the comparison function 

ck pointer to the key for the search 

ce pointer to the element being compared with the key. 

Return Value: Returns a pointer to the object being searched for if found; 

otherwise, 

returns NULL. 

Remarks: The value returned by the compare function is 0 if ckis greater than ce. 

denom mẫu 

Quay trở lại giá trị: Trả về thương và phần còn lại. 

Ghi chú: Các thương trở lại sẽ có những dấu hiệu tương tự như tử số chia 

với mẫu số. Các dấu hiệu cho phần còn lại sẽ được như vậy mà các 

thương lần mẫu số cộng với phần còn lại sẽ tương đương với 

tử số (* quot denom + rem = numer). Chia cho không sẽ gọi 

các lỗi ngoại lệ toán học, mà theo mặc định, sẽ gây ra một thiết lập lại. Viết 

xử lý lỗi toán học cần làm cái gì khác. 



Ví dụ: # include / * Cho div, div_t * / 

# include / * Forprintf * / 

khoảng trống __attribute __ ((__ interrupt__)) 

_MathError (Void) 

{ 

printf ("bất hợp pháp hướng dẫn thực hiện \ n"); 

hủy bỏ (); 

} 


{ 

int x, y; 

z div_t; 

x = 7; 

y = 3; 

printf ("Đối với div (% d,% d) \ n", x, y); 

z = div (x, y); 

printf ("thương là% d và" 

"Còn lại là% d \ n \ n", z.quot, z.rem); 

x = 7; 

y = -3; 


z = div (x, y); 



x = -5; 

y = 3; 


z = div (x, y); 

printf ("thương là% d và"

In the following example, qsortis used to sort the list before bsearch 

is called. bsearchrequires the list to be sorted according to the 

comparison function. This compuses ascending order. 

atol (Continued) 



Example: #include /* for bsearch, qsort */ 

#include /* for printf, sizeof */ 

#define NUM 7 

int comp(const void *e1, const void *e2); 


{ 

int list[NUM] = {35, 47,63, 25, 93, 16, 52}; 

int x, y; 

int *r; 

qsort(list, NUM, sizeof(int), comp); 

printf("Sorted List: "); 

for (x = 0; x < NUM; x++) 

printf("%d ", list[x]); 

y = 25; 

r = bsearch(&y, list,NUM, sizeof(int), comp); 

if (r) 

printf("\nThe value%d was found\n", y); 

else 

printf("\nThe value %d was not found\n", y); 

y = 75; 

r = bsearch(&y, list,NUM, sizeof(int), comp); 

if (r) 

printf("\nThe value%d was found\n", y); 

else 

printf("\nThe value %d was not found\n", y); 

} 

int comp(const void *e1, const void *e2) 

{ 

const int * a1 = e1; 


if (*a1 < *a2) 

return -1; 

else if (*a1 == *a2) 


x = 7; 

y = 7; 


z = div (x, y); 



x = 7; 

y = 0; 


z = div (x, y); 



} 

div (Tiếp theo) 

dsPIC 

® 



Đầu ra: 

Đối với div (7, 3) 

Các thương là 2 và phần còn lại là 1 

Đối với div (7, -3) 

Thương số là -2 và phần còn lại là 1 

Đối với div (-5, 3) 

Thương số là -1 và phần còn lại là -2 




Hướng dẫn thực hiện bất hợp pháp 

ABRT 

thoát 

Mô tả: Kết thúc chương trình sau khi làm sạch. 

Bao gồm: 

Nguyên mẫu: void exit (int trạng thái); 

Lập luận: tình trạng statusexit 

Bình luận: exitcalls bất kỳ chức năng đăng ký atexitin theo chiều ngược 

đăng ký, bừng bộ đệm, closesstream, đóng cửa bất kỳ tập tin tạm thời 

tạo ra với tmpfile, và thiết lập lại bộ vi xử lý. Chức năng này

eturn 0; 

else 

return 1; 

} 

Output: 

Sorted List: 16 25 35 47 52 63 93 

The value 25 was found 

The value 75 was not found 

bsearch (Continued) 

dsPIC 

® 



calloc 

Description: Allocates an array in memory and initializes the elements to 0. 

Include: 

Prototype: void *calloc(size_t nelem, size_t size); 

Arguments: nelem number of elements 

size length of each element 

Return Value: Returns a pointer to the allocated space if successful; otherwise, 

returns a null pointer. 

Remarks: Memory returned by callocis aligned correctly for any size data 

element and is initialized to zero. 

Example: /* This program allocates memory for the */ 

/* array 'i' of longintegers and initializes */ 

/* them to zero. */ 

#include /* for printf, NULL */ 

#include /* for calloc, free */ 


{ 

int x; 

long *i; 

i = (long *)calloc(5, sizeof(long)); 

if (i != NULL) 

{ 

for (x = 0; x < 5; x++) 

printf("i[%d] = %ld\n", x, i[x]); 

free(i); 

} 

tùy biến. Xem pic30-libs. 

Ví dụ: # include / * Cho fopen, printf, * / 


# include / * Để xuất cảnh * / 


{ 


if ((myfile = fopen ("samp.fil", "r")) == NULL) 

{ 

printf ("Không thể mở samp.fil \ n"); 

xuất cảnh (EXIT_FAILURE); 

} 

khác 

{ 


xuất cảnh (EXIT_SUCCESS); 

} 

printf ("Điều này sẽ không được in"); 

} 

Đầu ra: 

Không thể mở samp.fil 

div (Tiếp theo) 



miễn phí 

Mô tả: Giải phóng bộ nhớ. 

Bao gồm: 

Prototype: void free (void * ptr); 

Đối số: điểm ptr vào bộ nhớ được giải phóng 

Bình luận: giải phóng bộ nhớ trước đây giao calloc, malloc, hoặc 

realloc. Nếu freeis sử dụng trên không gian đã được deallocated 

(Bằng một cuộc gọi trước để freeor bởi realloc) hoặc trên không gian không 

được phân bổ 

với calloc, malloc, hoặc realloc, hành vi này là không xác định. 

Ví dụ: # include / * Forprintf, sizeof, * / 

/ * NULL * / 

# include / * Cho malloc, * miễn phí / 


{ 

dài * i;

else 

printf("Cannot allocate memory\n"); 

} 

Output: 

i[0] = 0 

i[1] = 0 

i[2] = 0 

i[3] = 0 

i[4] = 0 

div 

Description: Calculates the quotient and remainder of two numbers 

Include: 

Prototype: div_t div(int numer, int denom); 

Arguments: numer numerator 

denom denominator 

Return Value: Returns the quotient and the remainder. 

Remarks: The returned quotient will have the same sign as the numerator 

divided 

by the denominator. The sign for the remainder will be such that the 

quotient times the denominator plus the remainder will equal the 

numerator (quot * denom + rem = numer). Division by zero will invoke 

the math exception error, which by default, will cause a reset. Write a 

math error handler todo something else. 



Example: #include /* for div, div_t */ 

#include /* forprintf */ 

void __attribute__((__interrupt__)) 

_MathError(void) 

{ 

printf("Illegal instruction executed\n"); 

abort(); 

} 


{ 

int x, y; 

div_t z; 

x = 7; 

y = 3; 

if ((i = (long *) malloc (50 * sizeof (long))) == 

NULL) 

printf ("Không thể cấp phát bộ nhớ \ n"); 

khác 

{ 

printf ("bộ nhớ phân bổ \ n"); 

miễn phí (i); 

printf ("giải phóng bộ nhớ \ n"); 

} 

} 

Đầu ra: 

Cấp phát bộ nhớ 

Bộ nhớ giải phóng 

getenv 

Mô tả: Lấy một giá trị cho một biến môi trường. 

Bao gồm: 

Prototype: char * getenv (const char * name); 

Tên tên của biến môi trường: Đối số 

Quay trở lại giá trị: Trả về một con trỏ đến giá trị của biến môi trường nếu thàn 

công; 

nếu không, trả về một con trỏ null. 

Bình luận: Chức năng này phải được tùy chỉnh để được sử dụng như mô tả (xem 

pic30-libs). Theo mặc định không có mục trong danh sách môi trường 

cho getenvto tìm. 

dsPIC 

® 




Ví dụ: # include / * Cho printf, NULL * / 

# include / * Cho getenv * / 


{ 

char * incvar; 

incvar = getenv ("BAO GỒM"); 

if (incvar! = NULL) 

printf ("BAO GỒM biến môi trường =% s \ n", 

incvar); 

khác 

printf ("Không thể tìm thấy biến môi trường" 

"BAO GỒM");

printf("For div(%d, %d)\n", x, y); 


printf("The quotient is %d and the " 

"remainder is %d\n\n", z.quot, z.rem); 

x = 7; 

y = -3; 





x = -5; 

y = 3; 





x = 7; 

y = 7; 





x = 7; 

y = 0; 





} 

div (Continued) 

dsPIC 

® 



Output: 

For div(7, 3) 

The quotient is 2 and the remainder is 1 

For div(7, -3) 

The quotient is -2 and the remainder is 1 

} 

Đầu ra: 

Không thể tìm thấy biến môi trường BAO GỒM 

các phòng thí nghiệm 

Mô tả: Tính giá trị tuyệt đối của một số nguyên dài. 

Bao gồm: 

Prototype: phòng thí nghiệm dài (i dài); 

Đối số: i giá trị số nguyên dài 

Quay trở lại giá trị: Trả về giá trị tuyệt đối của tôi. 

Bình luận: Một số âm được trả về là tích cực; một số dương là 

không thay đổi. 


# include / * Cho các phòng thí nghiệm * / 


{ 

i dài; 

i = 123456; 

printf ("Giá trị tuyệt đối của% 7ld là 6LD% \ n", 

i, các phòng thí nghiệm (i)); 

i = -246.834; 



i = 0; 



} 

Đầu ra: 

Các of123456 giá trị tuyệt đối là 123.456 

Giá trị tuyệt đối là 246.834 -246.834 


getenv (Tiếp theo) 



ldiv 

Mô tả: Tính thương và phần còn lại của hai số nguyên dài. 

Bao gồm: 

Prototype: ldiv_t ldiv (numer dài, denom dài); 

Đối số: numer tử số 

denomdenominator

For div(-5, 3) 

The quotient is -1 and the remainder is -2 

For div(7, 7) 


For div(7, 0) 

Illegal instruction executed 

ABRT 

exit 

Description: Terminates program after clean up. 

Include: 

Prototype: void exit(int status); 

Argument: statusexit status 

Remarks: exitcalls any functions registered by atexitin reverse order of 

registration, flushes buffers, closesstream, closes any temporary files 

created with tmpfile, and resets the processor. This function is 

customizable. See pic30-libs. 

Example: #include /* for fopen, printf, */ 


#include /* for exit */ 


{ 

FILE *myfile; 

if ((myfile = fopen("samp.fil", "r" )) == NULL) 

{ 

printf("Cannot open samp.fil\n"); 

exit(EXIT_FAILURE); 

} 

else 

{ 


exit(EXIT_SUCCESS); 

} 

printf("This will not be printed"); 

} 

Output: 

Cannot open samp.fil 

div (Continued) 



Quay trở lại giá trị: Trả về quotientand phần còn lại. 

Ghi chú: Các thương trở lại sẽ có những dấu hiệu tương tự như tử số chia 

với mẫu số. Các dấu hiệu cho phần còn lại sẽ được như vậy mà các 

thương lần mẫu số cộng với phần còn lại sẽ tương đương với 

tử số (* quot denom + rem = numer). Nếu mẫu số là số không, 

hành vi này là không xác định. 

Ví dụ: # include / * Cho ldiv, ldiv_t * / 



{ 

dài x, y; 

ldiv_t z; 

x = 7; 

y = 3; 

printf ("Đối với ldiv (% ld,% ld) \ n", x, y); 

z = ldiv (x, y); 

printf ("thương là% ld và" 

"Còn lại là% ld \ n \ n", z.quot, z.rem); 

x = 7; 

y = -3; 





x = -5; 

y = 3; 





x = 7; 

y = 7; 





x = 7; 

y = 0; 

printf ("Đối với ldiv (% ld,% ld) \ n", x, y);

free 

Description: Frees memory. 

Include: 

Prototype: void free(void *ptr); 

Argument: ptr points to memory to be freed 

Remarks: Frees memory previously allocated with calloc, malloc, or 

realloc. If freeis used on space that has already been deallocated 

(by a previous call to freeor by realloc) or on space not allocated 

with calloc, malloc, or realloc, the behavior is undefined. 

Example: #include /* forprintf, sizeof, */ 

/* NULL */ 

#include /* for malloc, free */ 


{ 

long *i; 

if ((i = (long *)malloc(50 * sizeof(long))) == 

NULL) 


else 

{ 

printf("Memory allocated\n"); 

free(i); 

printf("Memory freed\n"); 

} 

} 

Output: 

Memory allocated 

Memory freed 

getenv 

Description: Get a value for an environment variable. 

Include: 

Prototype: char *getenv(const char *name); 

Argument: name name of environment variable 

Return Value: Returns a pointer to the value of the environment variable if 

successful; 

otherwise, returns a null pointer. 

Remarks: This function must be customized to be used as described (see 

pic30-libs). By default there are no entries in the environment list 

for getenvto find. 



"Còn lại là% ld \ n \ n", 

z.quot, z.rem); 

} 

dsPIC 

® 



Đầu ra: 

Đối với ldiv (7, 3) 


Đối với ldiv (7, -3) 


Đối với ldiv (-5, 3) 

Thương số là -1 và phần còn lại là -2 







Trong ví dụ cuối (ldiv (7,0)) mẫu số là số không, hành vi 

là không xác định. 

malloc 

Mô tả: Phân bổ bộ nhớ. 

Bao gồm: 

Nguyên mẫu: void * malloc (size_t size); 

Đối số: số kích thước của ký tự để phân bổ 

Quay trở lại giá trị: Trả về một con trỏ đến không gian được phân bổ nếu thành 



Bình luận: mallocdoes không khởi tạo bộ nhớ nó sẽ trả về. 

Ví dụ: # include / * Cho printf, sizeof, * / 

/ * NULL * / 

# include / * Cho malloc, * miễn phí / 


{ 

dài * i; 

if ((i = (long *) malloc (50 * sizeof (long))) == 

NULL)

dsPIC 

® 



Example: #include /* for printf, NULL */ 

#include /* for getenv */ 


{ 

char *incvar; 

incvar = getenv("INCLUDE"); 

if (incvar != NULL) 

printf("INCLUDE environment variable = %s\n", 

incvar); 

else 

printf("Cannot find environment variable " 

"INCLUDE "); 

} 

Output: 

Cannot find environment variable INCLUDE 

labs 

Description: Calculates the absolute value of a long integer. 

Include: 

Prototype: long labs(long i); 

Argument: i long integer value 

Return Value: Returns the absolute value of i. 

Remarks: A negative number is returned as positive; a positive number is 

unchanged. 


#include /* for labs */ 


{ 

long i; 

i = 123456; 

printf("The absolute value of %7ld is %6ld\n", 

i, labs(i)); 

i = -246834; 


i, labs(i)); 

i = 0; 


khác 

{ 



printf ("giải phóng bộ nhớ \ n"); 

} 

} 

Đầu ra: 


Bộ nhớ giải phóng 

ldiv (Tiếp theo) 



mblen 

Mô tả: Được chiều dài của một nhân vật nhiều byte. (Xem chú thích.) 

Bao gồm: 

Nguyên mẫu: int mblen (const char * s, size_t n); 

Đối số: s điểm cho nhân vật nhiều byte 

số n byte để kiểm tra 

Quay trở lại giá trị: Trả về số không nếu s điểm cho một nhân vật null; nếu 

không, trả về 1. 

Bình luận: MPLAB C30 không hỗ trợ các ký tự nhiều byte có độ dài lớn 

hơn 1 byte. 

mbstowcs 

Mô tả: Chuyển đổi một chuỗi đa byte cho một chuỗi ký tự rộng. (Xem chú 

thích.) 

Bao gồm: 

Mbstowcs size_t (wchar_t * WCS, const char * s,: nguyên mẫu 

size_t n); 

Đối số: WCS điểm đến chuỗi ký tự rộng 

s điểm cho chuỗi đa byte 

n số lượng ký tự rộng để chuyển đổi. 

Quay trở lại giá trị: Trả về số ký tự rộng lưu trữ bao gồm các null 

nhân vật. 

Bình luận: mbstowcsconverts nSố ký tự rộng trừ khi nó gặp 

một nhân vật rộng null đầu tiên. MPLAB C30 không hỗ trợ nhiều byte 

nhân vật có chiều dài lớn hơn 1 byte. 

mbtowc 

Mô tả: Chuyển đổi một nhân vật nhiều byte cho một nhân vật rộng. (Xem chú 

thích.)


i, labs(i)); 

} 

Output: 

The absolute value of123456 is 123456 

The absolute value of -246834 is 246834 


getenv (Continued) 



ldiv 

Bao gồm: 

Nguyên mẫu: int mbtowc (wchar_t * PwC, const char * s, size_t n); 

Đối số: điểm PwC cho nhiều nhân vật 

s điểm cho nhân vật nhiều byte 

số n byte để kiểm tra 

Quay trở lại giá trị: Trả về số không nếu spoints cho một nhân vật null; nếu 

không, trả về 1 

Ghi chú: Các ký tự rộng kết quả sẽ được lưu trữ tại PwC. MPLAB C30 không 

không hỗ trợ các ký tự nhiều byte có chiều dài lớn hơn 1 byte. 

dsPIC 

® 


Description: Calculates the quotient and remainder of two long integers. 

Include: 


qsort 


Prototype: ldiv_t ldiv(long numer, long denom); 

Arguments: numer numerator 

denomdenominator 

Return Value: Returns the quotientand the remainder. 

Remarks: The returned quotient will have the same sign as the numerator 

divided 

by the denominator. The sign for the remainder will be such that the 

quotient times the denominator plus the remainder will equal the 

numerator (quot * denom + rem = numer). If the denominator is zero, 

the behavior is undefined. 

Example: #include /* for ldiv, ldiv_t */ 



{ 

long x,y; 

ldiv_t z; 

x = 7; 

y = 3; 

printf("For ldiv(%ld, %ld)\n", x, y); 

z = ldiv(x, y); 

printf("The quotient is %ld and the " 

"remainder is %ld\n\n", z.quot, z.rem); 

x = 7; 

y = -3; 



Mô tả: Thực hiện sắp xếp nhanh chóng. 

Bao gồm: 

Prototype: void qsort (void * cơ sở, nelem size_t, size_t size, 

int (* CMP) (const void * e1, const void * e2)); 

Con trỏ cơ sở để bắt đầu của mảng: đối số 

số nelem của các yếu tố 

kích thước kích thước của các yếu tố 

CMP con trỏ đến chức năng so sánh 

e1 con trỏ đến chìa khóa cho các con trỏ tìm kiếm e2 cho các phần tử được so 

sánh với phím 

Bình luận: qsortoverwrites mảng với mảng được sắp xếp. Việc so sánh 

chức năng được cung cấp bởi người sử dụng. Inthe ví dụ sau đây, trong danh 

sách là 

sắp xếp theo chức năng so sánh. Đây compuses 

thứ tự tăng dần. 

Ví dụ: # include / * Cho qsort * / 


# xác định NUM 7 

int comp (const void * e1, const void * e2); 


{ 

int danh sách [NUM] = {35, 47, 63, 25, 93, 16, 52}; 

int x; 

printf ("Danh sách Unsorted:"); 

for (x = 0; x



x = -5; 

y = 3; 





x = 7; 

y = 7; 





x = 7; 

y = 0; 




"remainder is %ld\n\n", 

z.quot, z.rem); 

} 

dsPIC 

® 



Output: 

For ldiv(7, 3) 


For ldiv(7, -3) 


For ldiv(-5, 3) 

The quotient is -1 and the remainder is -2 





Explanation: 

In the last example (ldiv(7,0)) the denominator is zero, the behavior 

printf ("\ n"); 

printf ("Sắp xếp liệt kê:"); 

for (x = 0; x

is undefined. 

malloc 

Description: Allocates memory. 

Include: 

Prototype: void *malloc(size_t size); 

Argument: size number of characters to allocate 



Remarks: mallocdoes not initialize memory it returns. 

Example: #include /* for printf, sizeof, */ 

/* NULL */ 

#include /* for malloc, free */ 


{ 

long *i; 

if ((i = (long *)malloc(50 * sizeof(long))) == 

NULL) 


else 

{ 


free(i); 

printf("Memory freed\n"); 

} 

} 

Output: 


Memory freed 

ldiv (Continued) 



mblen 

Description: Gets the length of a multibyte character. (See Remarks.) 

Include: 

Prototype: int mblen(const char *s, size_t n); 

Arguments: s points to the multibyte character 

n number of bytes to check 

Return Value: Returns zero if s points to a null character; otherwise, returns 1. 

Remarks: MPLAB C30 does not support multibyte characters with length 

for (x = 0; x

greater 

than 1 byte. 

mbstowcs 

Description: Converts a multibyte string to a wide character string. (See 

Remarks.) 

Include: 

Prototype: size_t mbstowcs(wchar_t *wcs, const char *s, 

size_t n); 

Arguments: wcs points to the wide character string 

s points to the multibyte string 

n the number of wide characters to convert. 

Return Value: Returns the number of wide characters stored excluding the null 

character. 

Remarks: mbstowcsconverts nnumber of wide characters unless it encounters 

a null wide character first. MPLAB C30 does not support multibyte 

characters with length greater than 1 byte. 

mbtowc 

Description: Converts a multibyte character to a wide character. (See Remarks.) 

Include: 

Prototype: int mbtowc(wchar_t *pwc, const char *s, size_t n); 

Arguments: pwc points to the wide character 

s points to the multibyte character 

n number of bytes to check 

Return Value: Returns zero if spoints to a null character; otherwise, returns 1 

Remarks: The resulting wide character will be stored at pwc. MPLAB C30 does 

not support multibyte characters with length greater than 1 byte. 

dsPIC 

® 


DS51456B-page 286 

qsort 

Description: Performs a quick sort. 

Include: 


Prototype: void qsort(void *base, size_t nelem, size_t size, 

int (*cmp)(const void *e1, const void *e2)); 

Arguments: base pointer to the start of the array 

nelem number of elements 

size size of the elements 

cmp pointer to the comparison function 

e1 pointer to the key for the search e2 pointer to the element being compared 

== NULL) 


khác 

{ 


/ * Nhiệt độ con trỏ trong trường hợp realloc () không thành công * / 

j = i; 

if ((i = (long *) realloc (i, 25 * sizeof (long))) 

== NULL) 

{ 

printf ("Không thể tái phân bổ bộ nhớ \ n"); 

/ * J chỉ để cấp phát bộ nhớ * / 

miễn phí (j); 

} 

khác 

{ 

printf ("bộ nhớ phân bổ lại \ n"); 


} 

} 

} 

Đầu ra: 


Bộ nhớ phân bổ lại 

realloc (Tiếp theo) 



srand 

Mô tả: Đặt hạt giống khởi đầu cho chuỗi số giả ngẫu nhiên. 

Bao gồm: 

Prototype: void srand (unsigned int hạt giống); 

Giá trị bắt đầu hạt giống cho dãy số giả ngẫu nhiên: Đối số 


Bình luận: Chức năng này đặt hạt giống khởi đầu cho các số giả ngẫu nhiên 

tự tạo ra bởi các randfunction. Các randfunction sẽ 

luôn luôn trở về cùng một chuỗi các số nguyên hạt giống khi giống hệt nhau 

giá trị được sử dụng. Nếu randis gọi với một giá trị hạt giống số 1, trình tự 

số được tạo ra sẽ được giống như nếu randhad được gọi là 

mà không srandhaving được gọi là đầu tiên.

with the key 

Remarks: qsortoverwrites the array with the sorted array. The comparison 

function is supplied by the user. Inthe following example, the list is 

sorted according to the comparison function. This compuses 

ascending order. 

Example: #include /* for qsort */ 


#define NUM 7 

int comp(const void *e1,const void *e2); 


{ 

int list[NUM] = {35, 47, 63, 25, 93, 16, 52}; 

int x; 

printf("Unsorted List: "); 

for (x = 0; x < NUM; x++) 


qsort(list, NUM, sizeof(int), comp); 

printf("\n"); 

printf("Sorted List: "); 

for (x = 0; x < NUM; x++) 


} 

int comp(const void *e1,const void *e2) 

{ 



if (*a1 < *a2) 

return -1; 

else if (*a1 == *a2) 

return 0; 

else 

return 1; 

} 

Output: 

Unsorted List: 35 47 63 25 93 16 52 

Sorted List: 16 25 35 47 52 63 93 

Ví dụ: # include / * Forprintf * / 

# include / * Cho rand, srand * / 


{ 

int x; 

srand (7); 

for (x = 0; x

Description: Generates a pseudo-random integer. 

Include: 

Prototype: int rand(void); 

Return Value: Returns an integer between 0 and RAND_MAX. 

Remarks: Calls to this function return pseudo-random integer values in the 

range 

[0,RAND_MAX]. To use this function effectively, you must seed the 

random number generator using the srandfunction. This function will 

always return the same sequence ofintegers when no seeds are used 

(as in the example below) or whenidentical seed values are used. (See 

srandfor seed example.) 


#include /* for rand */ 


{ 

int x; 

for (x = 0; x < 5; x++) 

printf("Number = %d\n", rand()); 

} 

Output: 

Number = 21422 

Number = 2061 



Number = 9125 

Notice if the program is run a second time, the numbers are the same. 

See the example for srandto seed the random number generator. 

realloc 

Description: Reallocates memory to allow a size change. 

Include: 

Prototype: void *realloc(void *ptr, size_t size); 

Arguments: ptr points to previously allocated memory 

size new size to allocate to 



Remarks: If the existing object is smaller than the new object, the entire existing 

object is copied to the new object and the remainder of the new object 

is indeterminate. If the existing object is larger than the new object, the 

function copies as much of the existing object as will fit in the new 


{ 

char * kết thúc; 

char a [] = "1.28 inch"; 

char b [] = "27.835e2i"; 

char c [] = "Number1"; 

x đôi; 

x = strtod (a, và kết thúc); 

printf ("String = \"% s \ "float =% f \ n", a, x); 

printf ("Ngưng tại:% s \ n \ n", kết thúc); 

x = strtod (b, và kết thúc); 

printf ("String = \"% s \ "float =% f \ n", b, x); 


x = strtod (c, và kết thúc); 

printf ("String = \"% s \ "float =% f \ n", c, x); 


} 

Đầu ra: 

String = "1.28 inch" float = 1,280000 

Dừng lại ở: inch 

String = "27.835e2i" float = 2783,500000 

Dừng lại ở: i 


Dừng lại ở: Number1 

strtod (Tiếp theo) 



strtol 

Mô tả: Chuyển đổi một chuỗi một phần một số nguyên dài. 

Bao gồm: 

Prototype: strtol dài (const char * s, char ** endptr, int cơ sở); 

Đối số: chuỗi s được chuyển đổi 

endptr con trỏ đến các nhân vật atwhich chuyển đổi dừng lại 

cơ sở số lượng cơ sở để sử dụng trong chuyển đổi 

Quay trở lại giá trị: Trả về số chuyển đổi nếu thành công; nếu không, trả về 0. 

Ghi chú: Nếu baseis số không, strtolattempts để xác định các cơ sở tự động. 

Nó có thể là bát phân, xác định bởi một số không hàng đầu, hệ thập lục phân, 

xác định 

bởi một hàng đầu 0x hoặc 0X, hoặc thập phân trong các trường hợp khác. Nếu 

cơ sở được quy định

object. If reallocsucceeds in allocating a new object, the existing 

object will be deallocated; otherwise, the existing object is left 

unchanged. Keep a temporary pointerto the existing object since 

reallocwill return a null pointer on failure. 

dsPIC 

® 



Example: #include /* for printf, sizeof, NULL */ 

#include /* for realloc, malloc, free */ 


{ 

long *i, *j; 

if ((i = (long *)malloc(50 * sizeof(long))) 

== NULL) 


else 

{ 


/* Temp pointer in case realloc() fails */ 

j = i; 

if ((i = (long *)realloc(i, 25 * sizeof(long))) 

== NULL) 

{ 

printf("Cannot reallocate memory\n"); 

/* j pointed to allocated memory */ 

free(j); 

} 

else 

{ 

printf("Memory reallocated\n"); 

free(i); 

} 

} 

} 

Output: 


Memory reallocated 

realloc (Continued) 

strtolconverts một chuỗi số và chữ cái az (trường hợp 

không nhạy cảm), nơi az đại diện cho số 10-36. Chuyển đổi 

dừng lại khi một trong số basenumber là gặp phải. điểm để endptrwill 

phần còn lại của chuỗi bắt đầu với nhân vật không thể đảo ngược đầu tiên. 

Nếu một lỗi xảy ra nhiều, errnowill được thiết lập. 


# include / * Cho strtol * / 


{ 


char a [] = "-12BGEE"; 

char b [] = "1234Number"; 

x dài; 

x = strtol (a, và kết thúc, 16); 

printf ("String = \"% s \ "dài =% ld \ n", a, x); 


x = strtol (b, và kết thúc, 4); 

printf ("String = \"% s \ "dài =% ld \ n", b, x); 


} 

Đầu ra: 

String = "-12BGEE" dài = -299 

Dừng lại ở: GEE 

String = "1234Number" dài = 27 

Dừng lại ở: 4Number 

dsPIC 

® 



strtoul 

Mô tả: Chuyển đổi một chuỗi một phần một số nguyên dài không dấu. 

Bao gồm: 

Prototype: strtoul unsigned dài (const char * s, char ** endptr, 

int cơ sở); 

Đối số: chuỗi s được chuyển đổi 

con trỏ endptr với nhân vật mà tại đó việc chuyển đổi dừng lại 

cơ sở số lượng cơ sở để sử dụng trong chuyển đổi 

Quay trở lại giá trị: Trả về số chuyển đổi nếu thành công; nếu không, trả về 0. 

Ghi chú: Nếu baseis số không, strtolattempts để xác định các cơ sở tự động. 

Nó có thể là bát phân, xác định bởi một số không hàng đầu, hệ thập lục phân,



srand 

Description: Set the starting seed for the pseudo-random number sequence. 

Include: 

Prototype: void srand(unsigned int seed); 

Argument: seed starting value for the pseudo-random number sequence 


Remarks: This function sets the starting seed for the pseudo-random number 

sequence generated by the randfunction. The randfunction will 

always return the same sequence of integers when identical seed 

values are used. If randis called with a seed value of 1, the sequence 

of numbers generated will be the same as if randhad been called 

without srandhaving been called first. 

Example: #include /* forprintf */ 

#include /* for rand, srand */ 


{ 

int x; 

srand(7); 

for (x = 0; x < 5; x++) 

printf("Number = %d\n", rand()); 

} 

Output: 


Number = 5931 




strtod 

Description: Converts a partial string to a floating-point number of type double. 

Include: 

Prototype: double strtod(const char *s, char **endptr); 

Arguments: s string to be converted endptr pointer to the character at which the 

conversion stopped 

Return Value: Returns the converted number if successful; otherwise, returns 0. 


[whitespace] [sign] digits [.digits] 

[ { e | E }[sign]digits] 

xác định 

bởi một hàng đầu 0x hoặc 0X, hoặc thập phân trong các trường hợp khác. Nếu 

cơ sở được quy định 

strtolconverts một chuỗi số và chữ cái az (trường hợp 

không nhạy cảm), nơi az đại diện cho số 10-36. Chuyển đổi 

dừng lại khi một trong số cơ số là gặp phải. điểm để endptrwill 

phần còn lại của chuỗi bắt đầu với nhân vật không thể đảo ngược đầu tiên. 

Nếu một lỗi xảy ra nhiều, errnowill được thiết lập. 


# include / * Cho strtoul * / 


{ 


char a [] = "12BGET3"; 

char b [] = "0x1234Number"; 

char c [] = "-123abc"; 

x unsigned dài; 

x = strtoul (a, và kết thúc, 25); 

printf ("String = \"% s \ "dài =% lu \ n", a, x); 


x = strtoul (b, và kết thúc, 0); 

printf ("String = \"% s \ "dài =% lu \ n", b, x); 


x = strtoul (c, và kết thúc, 0); 

printf ("String = \"% s \ "dài =% lu \ n", c, x); 


} 

Đầu ra: 

String = "12BGET3" dài = 429.164 

Dừng lại ở: T3 

String = "0x1234Number" dài = 4660 

Dừng lại ở: Số 

String = "-123abc" dài = 4294967173 

Dừng lại ở: abc 



hệ thống 

Mô tả: Thực hiện một lệnh. 

Bao gồm: 

Nguyên mẫu: int hệ thống (const char * s);

optional whitespace, followed by an optional sign,then a sequence 

of one or more digitswith an optional decimal point, followed by one 

or more optional digitsand an optional eor Efollowed by an optional 

signed exponent. 

strtodconverts the string until it reaches a character that cannot be 

converted to a number. endptrwill point to the remainder of the string 

starting with the first unconverted character. 

If a range error occurs, errnowill be set. 

dsPIC 

® 




#include /* for strtod */ 


{ 

char *end; 

char a[] = "1.28 inches"; 

char b[] = "27.835e2i"; 

char c[] = "Number1"; 

double x; 

x = strtod(a, &end); 

printf("String = \"%s\" float = %f\n", a, x ); 

printf("Stopped at: %s\n\n", end ); 

x = strtod(b, &end); 

printf("String = \"%s\" float = %f\n", b, x ); 


x = strtod(c, &end); 

printf("String = \"%s\" float = %f\n", c, x ); 


} 

Output: 

String = "1.28 inches" float = 1.280000 

Stopped at: inches 

String = "27.835e2i"float = 2783.500000 

Stopped at: i 


Stopped at: Number1 

Đối số: s lệnh được thực thi 

Bình luận: Chức năng này phải được tùy chỉnh để được sử dụng như mô tả (xem 

pic30-libs). Theo mặc định systemwill gây ra một thiết lập lại nếu được gọi với 

bất cứ điều gì khác hơn là NULL. hệ thống (NULL) sẽ không làm gì cả. 

Ví dụ: / * Chương trình này sử dụng hệ thống * / 

/ * Để TYPE tập tin nguồn của nó. * / 

# include / * Cho hệ thống * / 


{ 

hệ thống ("loại sampsystem.c"); 

} 

Đầu ra: 

Hệ thống (loại sampsystem.c) được gọi là: hủy bỏ 

wctomb 

Mô tả: Chuyển đổi một nhân vật rộng để một nhân vật nhiều byte. (Xem chú 

thích.) 

Bao gồm: 

Nguyên mẫu: int wctomb (char * s, WCHAR wchar_t); 

Đối số: s điểm cho nhân vật nhiều byte 

WCHAR nhân vật rộng được chuyển đổi 

Quay trở lại giá trị: Trả về số không nếu s điểm cho một nhân vật null; nếu 

không, trả về 1. 

Bình luận: Kết quả là nhân vật nhiều byte được lưu trữ tại s. MPLAB C30 

không 

hỗ trợ các ký tự nhiều byte có chiều dài lớn hơn 1 nhân vật. 

wcstombs 

Mô tả: Chuyển đổi một chuỗi ký tự rộng để một chuỗi đa byte. (Xem chú thích. 

Bao gồm: 

Wcstombs size_t (char * s, const wchar_t * WCS,: nguyên mẫu 

size_t n); 

Đối số: s điểm cho chuỗi đa byte 

WCS chỉ vào chuỗi ký tự rộng 

n số ký tự để chuyển đổi 

Quay trở lại giá trị: Trả về số ký tự được lưu trữ bao gồm các ký tự null. 

Bình luận: wcstombsconverts nSố ký tự nhiều byte trừ khi nó 

gặp một ký tự null đầu tiên. MPLAB C30 không hỗ trợ 

ký tự nhiều byte có chiều dài lớn hơn 1 nhân vật. 

dsPIC 

® 


strtod (Continued) 





strtol 

Description: Converts a partial string to a long integer. 

Include: 

Prototype: long strtol(const char *s, char **endptr, int base); 

Arguments: s string to be converted 

endptr pointer to the character atwhich the conversion stopped 

base number base to use in conversion 


Remarks: If baseis zero, strtolattempts to determine the base automatically. 

It can be octal, determined by a leading zero, hexadecimal, determined 

by a leading 0x or 0X, or decimal in any other case. If base is specified 

strtolconverts a sequence of digits and letters a-z (case 

insensitive), where a-z represents the numbers 10-36. Conversion 

stops when an out of basenumber is encountered. endptrwill point to 

the remainder of the string starting with the first unconverted character. 



#include /* for strtol */ 


{ 

char *end; 

char a[] = "-12BGEE"; 

char b[] = "1234Number"; 

long x; 

x = strtol(a, &end, 16); 

printf("String = \"%s\" long = %ld\n", a, x ); 


x = strtol(b, &end, 4); 

printf("String = \"%s\" long = %ld\n", b, x ); 


} 

Output: 

String = "-12BGEE" long = -299 

Stopped at: GEE 

String = "1234Number" long = 27 

Stopped at: 4Number 

dsPIC 

4.15 CHỨC NĂNG STRING 

Các string.hconsists tập tin tiêu đề của các loại, macro và các chức năng cung 

cấp các công cụ 

để thao tác chuỗi. 

size_t 


Bao gồm: 

NULL 


Bao gồm: 

memchr 

Mô tả: Tọa lạc một nhân vật trong một bộ đệm. 

Bao gồm: 

Nguyên mẫu: void * memchr (const void * s, int c, size_t n); 

Đối số: s con trỏ vào bộ đệm 

c nhân vật để tìm kiếm 

số n của các nhân vật để kiểm tra 

Quay trở lại giá trị: Trả về một con trỏ đến vị trí của trận đấu nếu thành 


trả về null. 

Bình luận: memchrstops khi nó tìm thấy sự xuất hiện đầu tiên của cor sau khi 

tìm kiếm 

nSố ký tự. 

Ví dụ: # include / * Cho memchr, NULL * / 



{ 

char buf1 [50] = "Bây giờ là mấy?"; 

char ch1 = 'i', CH2 = 'y'; 

char * ptr; 

res int; 

printf ("buf1:% s \ n \ n", buf1); 

ptr = memchr (buf1, ch1, 50); 

if (ptr! = NULL) 

{ 

res = ptr - buf1 1; 

printf ("% c tìm thấy ở vị trí% d \ n", ch1, độ phân giải); 

} 

khác 

printf ("% c không tìm thấy \ n", ch1); 

Thư viện chuẩn C với hàm toán học

® 



strtoul 

Description: Converts a partial string to an unsigned long integer. 

Include: 

Prototype: unsigned long strtoul(const char *s, char **endptr, 

int base); 

Arguments: s string to be converted 

endptr pointer to the character at which the conversion stopped 

base number base to use in conversion 


Remarks: If baseis zero, strtolattempts to determine the base automatically. 

It can be octal, determined by a leading zero, hexadecimal, determined 

by a leading 0x or 0X, or decimal in any other case. If base is specified 

strtolconverts a sequence of digits and letters a-z (case 

insensitive), where a-z represents the numbers 10-36. Conversion 

stops when an out of base number is encountered. endptrwill point to 

the remainder of the string starting with the first unconverted character. 



#include /* for strtoul */ 


{ 

char *end; 

char a[] = "12BGET3"; 

char b[] = "0x1234Number"; 

char c[] = "-123abc"; 

unsigned long x; 

x = strtoul(a, &end, 25); 

printf("String = \"%s\" long = %lu\n", a, x ); 


x = strtoul(b, &end, 0); 

printf("String = \"%s\" long = %lu\n", b, x ); 


x = strtoul(c, &end, 0); 

printf("String = \"%s\" long = %lu\n", c, x ); 


} 



ptr = memchr (buf1, CH2, 50); 


{ 


printf ("% c tìm thấy atposition% d \ n", CH2, độ phân giải); 

} 

khác 

printf ("% c không tìm thấy \ n", CH2); 

} 

Đầu ra: 

buf1: Bây giờ là mấy? 

tôi tìm thấy ở vị trí 7 

y không tìm thấy 

memcmp 

Mô tả: So sánh nội dung của hai bộ đệm. 

Bao gồm: 

Nguyên mẫu: int memcmp (const void * s1, const void * s2, size_t n); 

Đối số: s1 đệm đầu tiên 

s2 đệm thứ hai 

số n ký tự để so sánh 

Quay trở lại giá trị: Trả về một số dương nếu s1is lớn hơn s2, bằng không nếu 

s1is bằng 

s2, hoặc một số âm nếu s1is ít hơn s2. 

Ghi chú: Chức năng này so sánh ncharacters đầu tiên trong s1to n đầu tiên 

nhân vật trong s2and trả về một giá trị cho biết liệu bộ đệm 

ít hơn, bằng hoặc lớn hơn so với nhau. 

Ví dụ: # include / * Memcmp * / 



{ 

char buf1 [50] = "đâu là thời điểm"; 

char buf2 [50] = "Họ đã đi đâu?"; 

char buf3 [50] = "Tại sao?"; 

res int; 

printf ("buf1:% s \ n", buf1); 



res = memcmp (buf1, buf2, 6);

Output: 

String = "12BGET3" long = 429164 

Stopped at: T3 

String = "0x1234Number" long = 4660 

Stopped at: Number 

String = "-123abc" long = 4294967173 

Stopped at: abc 



system 

Description: Execute a command. 

Include: 

Prototype: int system(const char *s); 

Argument: s command to be executed 

Remarks: This function must be customized to be used as described (see 

pic30-libs). By default systemwill cause a reset if called with 

anything other than NULL. system(NULL)will do nothing. 

Example: /* This program uses system */ 

/* to TYPE its source file. */ 

#include /* for system */ 


{ 

system("type sampsystem.c"); 

} 

Output: 

System(type sampsystem.c) called: Aborting 

wctomb 

Description: Converts a wide character to a multibyte character. (See Remarks.) 

Include: 

Prototype: int wctomb(char *s, wchar_t wchar); 

Arguments: s points to the multibyte character 

wchar the wide character to be converted 

Return Value: Returns zero if s points to a null character; otherwise, returns 1. 

Remarks: The resulting multibyte character is stored at s. MPLAB C30 does not 

support multibyte characters with length greater than 1 character. 

wcstombs 

Description: Converts a wide character string to a multibyte string. (See 

Remarks.) 

Include: 

if (res

Prototype: size_t wcstombs(char *s, const wchar_t *wcs, 

size_t n); 

Arguments: s points to the multibyte string 

wcs points to the wide character string 

n the number of characters to convert 

Return Value: Returns the number of characters stored excluding the null 

character. 

Remarks: wcstombsconverts nnumber of multibyte characters unless it 

encounters a null character first. MPLAB C30 does not support 

multibyte characters with length greater than 1 character. 

dsPIC 

® 




memcpy 

Mô tả: Bản sao các ký tự từ một bộ đệm khác. 

Bao gồm: 

Nguyên mẫu: void * memcpy (void * dst, const void * src, size_t n); 

Đối số: đệm dst để sao chép nhân vật 

src đệm để sao chép các nhân vật từ 

số n ký tự sao chép 

Quay trở lại giá trị: Trả dst. 

Bình luận: memcpycopies ncharacters từ bộ đệm các nguồn srcto 

điểm đến dst đệm. Nếu bộ đệm chồng lên nhau, hành vi này là không xác định. 

Ví dụ: # include / * Memcpy * / 

DS51456B-page 294 



4.15 STRING FUNCTIONS 

The header file string.hconsists of types, macros and functions that provide tools 

to manipulate strings. 

size_t 


Include: 

NULL 


Include: 

memchr 

Description: Locates a character in a buffer. 

Include: 

Prototype: void *memchr(const void *s, int c, size_t n); 

Arguments: s pointer to the buffer 

c character to search for 

n number of characters to check 

Return Value: Returns a pointer to the location of the match if successful; 

otherwise, 

returns null. 

Remarks: memchrstops when it finds the first occurrence of cor after searching 

nnumber of characters. 

Example: #include /* for memchr, NULL */ 



{ 

char buf1[50] = "What time is it?"; 


{ 

char buf1 [50] = ""; 






memcpy (buf1, buf2, 6); 

printf ("buf1 sau memcpy 6 ký tự của" 

"Buf2: \ n \ t% s \ n", buf1); 


memcpy (buf1, buf3, 5); 

printf ("buf1 sau memcpy 5 ký tự của" 

"Buf3: \ n \ t% s \ n", buf1); 

} 

Đầu ra: 

buf1: 

buf2: đâu là thời gian? 

buf3: Tại sao? 

buf1 sau memcpy of6 ký tự của buf2: 

Ở đâu 

buf1 sau memcpy of5 ký tự của buf3: 

Tại sao? 

dsPIC

char ch1 = 'i', ch2 = 'y'; 

char *ptr; 

int res; 

printf("buf1 : %s\n\n", buf1); 

ptr = memchr(buf1, ch1, 50); 

if (ptr != NULL) 

{ 

res = ptr - buf1 + 1; 

printf("%c found at position %d\n", ch1, res); 

} 

else 

printf("%c not found\n", ch1); 



printf("\n"); 

ptr = memchr(buf1, ch2, 50); 


{ 


printf("%c found atposition %d\n", ch2, res); 

} 

else 


} 

Output: 

buf1 : What time is it? 

i found at position 7 

y not found 

memcmp 

Description: Compare the contents of two buffers. 

Include: 

Prototype: int memcmp(const void *s1, const void *s2, size_t n); 

Arguments: s1 first buffer 

s2 second buffer 

n number of characters to compare 

Return Value: Returns a positive number if s1is greater than s2, zero if s1is 

equal to 

s2, or a negative number if s1is less than s2. 

Remarks: This function compares the first ncharacters in s1to the first n 

® 



memmove 


Mô tả: Bản sao n ký tự của sourcebuffer vào bộ đệm đích, 

ngay cả khi các khu vực chồng chéo lên nhau. 

Bao gồm: 

Nguyên mẫu: void * memmove (void * s1, const void * s2, size_t n); 

Đối số: s1 đệm để sao chép nhân vật (đích) 

s2 đệm để sao chép các nhân vật từ (source) 

số n ký tự sao chép từ s2to s1 

Quay trở lại giá trị: Trả về một con trỏ đến bộ đệm điểm đến 

Ghi chú: Nếu bộ đệm chồng chéo, hiệu quả là asif các nhân vật được đọc đầu 

tiên 

s2then bằng văn bản cho s1so bộ đệm không bị hỏng. 

Ví dụ: # include / * Cho memmove * / 



{ 

char buf1 [50] = "Khi thời gian cuộc tuần hành trên"; 






memmove (buf1, buf2, 6); 

printf ("buf1 sau memmove 6 ký tự của" 

"Buf2: \ n \ t% s \ n", buf1); 


memmove (buf1, buf3, 5); 

printf ("buf1 sau memmove 5 ký tự của" 

"Buf3: \ n \ t% s \ n", buf1); 

} 

Đầu ra: 

buf1: Khi thời gian cuộc tuần hành trên 



buf1 sau memmove 6 ký tự của buf2: 

Trường hợp ime cuộc tuần hành trên 

buf1 sau memmove 5 ký tự của buf3:

characters in s2and returns a value indicating whether the buffers are 

less than, equal to or greater than each other. 

Example: #include /* memcmp */ 



{ 

char buf1[50] = "Where is the time?"; 

char buf2[50] = "Where did they go?"; 

char buf3[50] = "Why?"; 

int res; 

printf("buf1 : %s\n", buf1); 



res = memcmp(buf1, buf2, 6); 

if (res < 0) 

printf("buf1 comes before buf2\n"); 

else if (res == 0) 

printf("6 characters of buf1 and buf2 " 

"are equal\n"); 

else 


memchr (Continued) 

dsPIC 

® 



printf("\n"); 


if (res < 0) 





else 


printf("\n"); 


if (res < 0) 


Tại sao? 



memset 

Mô tả: Bản sao các nhân vật được chỉ định vào bộ đệm đích. 

Bao gồm: 

Nguyên mẫu: void * memset (void * s, int c, size_t n); 

Đối số: s đệm 

c nhân vật để đưa vào bộ đệm 

số n lần 

Quay trở lại giá trị: Trả về đệm với các nhân vật bằng văn bản cho nó. 

Ghi chú: Các ký tự cis bằng văn bản cho ntimes đệm. 

Ví dụ: # include / * Cho memset * / 



{ 


char buf2 [20] = ""; 

char ch1 =, = CH2 'y' '?'; 

char * ptr; 

res int; 

printf ("memset (\"% s \ ", \ '% c \', 4); \ n", buf1, ch1); 

memset (buf1, ch1, 4); 

printf ("buf1 aftermemset:% s \ n", buf1); 


printf ("memset (\"% s \ ", \ '% c \', 10); \ n", buf2, CH2); 

memset (buf2, CH2, 10); 

printf ("buf2 aftermemset:% s \ n", buf2); 

} 

Đầu ra: 

memset ("thời gian gì isit?", 4 '?'); 

buf1 sau khi memset: ???? thời gian là nó? 

memset ("", 'y', 10); 

buf2 sau khi memset: yyyyyyyyyy 

dsPIC 

® 



strcat




else 


} 

Output: 

buf1 : Where is the time? 

buf2 : Where did they go? 

buf3 : Why? 

6 characters of buf1and buf2 are equal 

buf2 comes before buf1 


memcmp (Continued) 



memcpy 

Description: Copies characters from one buffer to another. 

Include: 

Prototype: void *memcpy(void *dst, const void *src, size_t n); 

Arguments: dst buffer to copy characters to 

src buffer to copy characters from 

n number of characters to copy 

Return Value: Returns dst. 

Remarks: memcpycopies ncharacters from the source buffer srcto the 

destination buffer dst. If the buffers overlap, the behavior is undefined. 

Example: #include /* memcpy */ 



{ 

char buf1[50] = ""; 






memcpy(buf1, buf2, 6); 

printf("buf1 after memcpy of 6 chars of " 

"buf2: \n\t%s\n", buf1); 

Mô tả: Gắn thêm một bản sao của mã nguồn stringto cuối của chuỗi đích. 

Bao gồm: 

Prototype: char * strcat (char * s1, const char * s2); 

Đối số: s1 null chấm dứt chuỗi đích để sao chép vào 

s2 null chấm dứt chuỗi nguồn được sao chép 

Quay trở lại giá trị: Trả về một con trỏ đến chuỗi đích. 

Ghi chú: Chức năng này gắn thêm chuỗi nguồn (bao gồm cả việc chấm dứt vô 

nhân vật) vào cuối của chuỗi đích. Các nhân vật ban đầu của 

chuỗi nguồn sẽ ghi đè lên các ký tự null ở cuối của 

chuỗi đích. Nếu bộ đệm chồng lên nhau, hành vi này là không xác định. 

Ví dụ: # include / * Cho strcat, strlen * / 



{ 

char buf1 [50] = "Chúng tôi ở đây"; 



printf ("\ t (% d ký tự) \ n \ n", strlen (buf1)); 



strcat (buf1, buf2); 

printf ("buf1 sau strcat của buf2: \ n \ t% s \ n", 

buf1); 

printf ("\ t (% d ký tự) \ n", strlen (buf1)); 


strcat (buf1, "Tại sao?"); 

printf ("buf1 sau strcatof \" Tại sao \? ": \ n \ t% s \ n", 

buf1); 


} 

Đầu ra: 

buf1: Chúng tôi ở đây 

(10 ký tự) 


(18 ký tự) 

buf1 sau strcat của buf2: 

Chúng tôi hereWhere là thời gian? 

(28 ký tự) 

buf1 sau strcat của "Tại sao?":

printf("\n"); 

memcpy(buf1, buf3, 5); 

printf("buf1 after memcpy of 5 chars of " 


} 

Output: 

buf1 : 


buf3 : Why? 

buf1 after memcpy of6 chars of buf2: 

Where 

buf1 after memcpy of5 chars of buf3: 

Why? 

dsPIC 

® 


DS51456B-page 298 

memmove 


Description: Copies n characters of the sourcebuffer into the destination buffer, 

even if the regions overlap. 

Include: 

Prototype: void *memmove(void *s1, const void *s2, size_t n); 

Arguments: s1 buffer to copy characters to (destination) 

s2 buffer to copy characters from (source) 

n number of characters to copy from s2to s1 

Return Value: Returns a pointer to the destination buffer 

Remarks: If the buffers overlap, the effect is asif the characters are read first 

from 

s2then written to s1so the buffer is not corrupted. 

Example: #include /* for memmove */ 



{ 

char buf1[50] = "When time marches on"; 






Chúng tôi hereWhere là thời gian? Tại sao? 

(32 ký tự) 



strchr 

Mô tả: Tọa lạc xuất hiện đầu tiên của một nhân vật được quy định trong một 

chuỗi. 

Bao gồm: 

Prototype: char * strchr (const char * s, int c); 

Đối số: s con trỏ đến chuỗi 


Quay trở lại giá trị: Trả về một con trỏ đến vị trí của trận đấu nếu thành 



Bình luận: chức năng này tìm kiếm chuỗi sto tìm sự xuất hiện đầu tiên của 

nhân vật c. 

Ví dụ: # include / * Forstrchr, NULL * / 



{ 


char ch1 = 'm', CH2 = 'y'; 

char * ptr; 

res int; 


ptr = strchr (buf1, ch1); 


{ 


printf ("% c tìm thấy atposition% d \ n", ch1, độ phân giải); 

} 

khác 



ptr = strchr (buf1, CH2); 


{ 



}

memmove(buf1, buf2, 6); 

printf("buf1 after memmove of 6 chars of " 


printf("\n"); 

memmove(buf1, buf3, 5); 

printf("buf1 after memmove of 5 chars of " 


} 

Output: 

buf1 : When time marches on 


buf3 : Why? 

buf1 after memmove of 6 chars of buf2: 

Where ime marches on 

buf1 after memmove of 5 chars of buf3: 

Why? 



memset 

Description: Copies the specified character into the destination buffer. 

Include: 

Prototype: void *memset(void *s, int c, size_t n); 

Arguments: s buffer 

c character to put in buffer 

n number of times 

Return Value: Returns the buffer with characters written to it. 

Remarks: The character cis written to the buffer ntimes. 

Example: #include /* for memset */ 



{ 


char buf2[20] = ""; 

char ch1 = '?', ch2 = 'y'; 

char *ptr; 

int res; 

printf("memset(\"%s\", \'%c\',4);\n", buf1, ch1); 

memset(buf1, ch1, 4); 

printf("buf1 aftermemset: %s\n", buf1); 

khác 


} 

Đầu ra: 


m tìm thấy ở vị trí 8 


dsPIC 

® 



strcmp 

Mô tả: So sánh hai chuỗi. 

Bao gồm: 


Nguyên mẫu: int strcmp (const char * s1, const char * s2); 

Đối số: s1 chuỗi đầu tiên 

chuỗi s2second 


s1is bằng 


Ghi chú: Chức năng này so sánh nhân vật tiếp từ s1and s2until 

chúng không bằng nhau hoặc terminator null được đạt tới. 

Ví dụ: # include / * Cho strcmp * / 



{ 




res int; 




res = strcmp (buf1, buf2); 

if (res

printf("\n"); 

printf("memset(\"%s\", \'%c\',10);\n", buf2, ch2); 

memset(buf2, ch2, 10); 

printf("buf2 aftermemset: %s\n", buf2); 

} 

Output: 

memset("What time isit?", '?',4); 

buf1 after memset: ???? time is it? 

memset("", 'y',10); 

buf2 after memset: yyyyyyyyyy 

dsPIC 

® 


DS51456B-page 300 

strcat 


Description: Appends a copy of the source stringto the end of the destination 

string. 

Include: 

Prototype: char *strcat(char *s1, const char *s2); 

Arguments: s1 null terminated destination string to copy to 

s2 null terminated source string to be copied 

Return Value: Returns a pointer to the destination string. 

Remarks: This function appends the source string (including the terminating 

null 

character) to the end of the destination string. The initial character of 

the source string overwrites the null character at the end of the 

destination string. If the buffers overlap, the behavior is undefined. 

Example: #include /* for strcat, strlen */ 



{ 

char buf1[50] = "We're here"; 



printf("\t(%d characters)\n\n", strlen(buf1)); 



strcat(buf1, buf2); 

printf("buf1 after strcat of buf2: \n\t%s\n", 

buf1); 


res = strcmp (buf1, buf3); 

if (res

printf("\t(%d characters)\n", strlen(buf1)); 

printf("\n"); 

strcat(buf1, "Why?"); 

printf("buf1 after strcatof \"Why?\": \n\t%s\n", 

buf1); 


} 

Output: 

buf1 : We're here 

(10 characters) 



buf1 after strcat of buf2: 

We're hereWhere is the time? 


buf1 after strcat of "Why?": 

We're hereWhere is the time?Why? 




strchr 

Description: Locates the first occurrence of a specified character in a string. 

Include: 

Prototype: char *strchr(const char *s, int c); 

Arguments: s pointer to the string 


Return Value: Returns a pointer to the location of the match if successful; 

otherwise, 


Remarks: This function searches the string sto find the first occurrence of the 

character c. 

Example: #include /* forstrchr, NULL */ 



{ 


char ch1 = 'm', ch2 = 'y'; 

char *ptr; 

int res; 

Mô tả: Sao chép chuỗi nguồn vào chuỗi đích. 

Bao gồm: 

Prototype: char * strcpy (char * s1, const char * s2); 

Đối số: s1 chuỗi đích để sao chép vào 

chuỗi nguồn s2 sao chép từ 


Bình luận: Tất cả các nhân vật của s2are sao chép, bao gồm ký tự chấm dứt nul 

Nếu chuỗi chồng chéo lên nhau, hành vi này là không xác định. 

Ví dụ: # include / * Forstrcpy, strlen * / 



{ 







strcpy (buf1, buf2); 

printf ("buf1 sau strcpy của buf2: \ n \ t% s \ n \ n", 

buf1); 

strcmp (Tiếp theo) 

dsPIC 

® 



strcpy (buf1, buf3); 

printf ("buf1 sau strcpy của buf3: \ n \ t% s \ n", 

buf1); 

} 

Đầu ra: 




buf1 sau strcpy của buf2: 

Ở đâu thời gian? 

buf1 sau strcpy của buf3: 

Tại sao? 

strcspn


ptr = strchr(buf1, ch1); 


{ 



} 

else 


printf("\n"); 

ptr = strchr(buf1, ch2); 


{ 



} 

else 


} 

Output: 


m found at position 8 

y not found 

dsPIC 

® 


DS51456B-page 302 

strcmp 

Description: Compares two strings. 

Include: 


Prototype: int strcmp(const char *s1, const char *s2); 

Arguments: s1 first string 

s2second string 


equal to 


Remarks: This function compares successive characters from s1and s2until 

they are not equal or the null terminator is reached. 

Example: #include /* for strcmp */ 

Mô tả: Tính toán số lượng các ký tự liên tiếp vào đầu của một 

chuỗi không được containedin một tập hợp các ký tự. 

Bao gồm: 

Prototype: strcspn size_t (const char * s1, const char * s2); 

Đối số: con trỏ s1 vào chuỗi cần tìm kiếm 

s2 con trỏ đến ký tự để tìm kiếm 

Quay trở lại giá trị: Trả về độ dài của phân khúc này trong s1not chứa các ký tự 

được tìm thấy trong s2. 

Bình luận: chức năng này sẽ xác định các ký tự liên tiếp từ numberof 

đầu s1that không có trong s2. 

Ví dụ: # include / * Cho strcspn * / 



{ 

char str1 [20] = "hello"; 

char str2 [20] = "aeiou"; 

char str3 [20] = "động vật"; 

char str4 [20] = "xyz"; 

res int; 

res = strcspn (str1, str2); 

printf ("strcspn (\"% s \ ", \"% s \ ") =% d \ n", 

str1, str2, độ phân giải); 







} 

Đầu ra: 

strcspn ("hello", "aeiou") = 1 

strcspn ("động vật", "aeiou") = 0 

strcspn ("động vật", "xyz") = 6 

strcpy (Tiếp theo) 




Trong kết quả đầu tiên, eis trong s2so nó ngừng đếm sau khi h. 

Trong kết quả thứ hai, ais trong s2.



{ 




int res; 




res = strcmp(buf1, buf2); 

if (res < 0) 



printf("buf1 andbuf2 are equal\n"); 

else 


printf("\n"); 

res = strcmp(buf1, buf3); 

if (res < 0) 



printf("buf1 andbuf3 are equal\n"); 

else 


printf("\n"); 

res = strcmp("Why?", buf3); 

if (res < 0) 

printf("\"Why?\"comes before buf3\n"); 


printf("\"Why?\" and buf3 are equal\n"); 

else 

printf("buf3 comes before \"Why?\"\n"); 

} 



Output: 



Trong kết quả thứ ba, không ai trong số các nhân vật của s1are trong s2so tất cả 

nhân vật được tính. 

dột 

Mô tả: Được một thông báo lỗi nội bộ. 

Bao gồm: 

Prototype: char * dột (int errcode); 

Errcode số của mã lỗi: Đối số 

Quay trở lại giá trị: Trả về một con trỏ đến một thông báo lỗi nội bộ để 

stringcorresponding 

mã lỗi errcode quy định. 

Ghi chú: Các mảng trỏ đến bởi strerrormay được ghi đè bởi một 

cuộc gọi tiếp theo để chức năng này. 


/ * Printf, FILE, NULL * / 

# include / * Cho dột * / 

# include / * Cho errno * / 


{ 


if ((myfile = fopen ("samp.fil", "r +")) == NULL) 

printf ("Không thể mở samp.fil:% s \ n", 

dột (errno)); 

khác 



} 

Đầu ra: 

Không thể mở samp.fil: tập tin lỗi mở 

strlen 

Mô tả: Tìm chiều dài của một chuỗi. 

Bao gồm: 

Prototype: size_t strlen (const char * s); 

Đối số: s chuỗi 

Quay trở lại giá trị: Trả về độ dài của một chuỗi. 

Bình luận: Chức năng này quyết định độ dài của chuỗi, không bao gồm 

chấm dứt ký tự null. 

strcspn (Tiếp theo) 

dsPIC 

® 


uf3 : Why? 



"Why?" and buf3 are equal 

strcoll 

Description: Compares one string to another. (See Remarks.) 

Include: 

Prototype: int strcoll(const char *s1, const char *s2); 


s2 second string 

Return Value: Using the locale-dependent rules, itreturns a positive number if 

s1is 

greater than s2, zero if s1is equal to s2, or a negative number if s1is 

less than s2. 

Remarks: Since MPLAB C30 does not support alternate locales, this function is 

equivalent to strcmp. 

strcpy 

Description: Copy the source string into the destination string. 

Include: 

Prototype: char *strcpy(char *s1, const char *s2); 

Arguments: s1 destination string to copy to 

s2 source string to copy from 


Remarks: All characters of s2are copied, including the null terminating 

character. 

If the strings overlap, the behavior is undefined. 

Example: #include /* forstrcpy, strlen */ 



{ 







strcpy(buf1, buf2); 

printf("buf1 after strcpy of buf2: \n\t%s\n\n", 

buf1); 

strcmp (Continued) 


Ví dụ: # include / * Cho strlen * / 



{ 


char str1 [20] = "Chúng tôi đang ở đây"; 

char str2 [20] = ""; 

char str3 [20] = "Sao lại là tôi?"; 

printf ("str1:% s \ n", str1); 

printf ("\ t (string chiều dài =% d ký tự) \ n \ n", 

strlen (str1)); 


printf ("\ t (string chiều dài =% d ký tự) \ n \ n", 



printf ("\ t (string chiều dài =% d ký tự) \ n \ n \ n", 


} 

Đầu ra: 

str1: Chúng tôi đang ở đây 

(Chiều dài chuỗi = 11 ký tự) 

str2: 


str3: Tại sao tôi không? 


strncat 

Mô tả: Thêm một số quy định của ký tự từ chuỗi nguồn đến 

chuỗi đích. 

Bao gồm: 

Prototype: char * strncat (char * s1, const char * s2, size_t n); 



số n của các nhân vật để phụ thêm 


Ghi chú: Chức năng này gắn thêm lên đến ncharacters (một nhân vật vô giá trị 

và 

nhân vật mà theo nó không nối) từ chuỗi nguồn đến 

kết thúc của chuỗi đích. Nếu một ký tự null không gặp, sau đó 

một ký tự null chấm dứt được gắn vào kết quả. Nếu dây 

chồng chéo lên nhau, hành vi này là không xác định.

dsPIC 

® 


DS51456B-page 304 

strcpy(buf1, buf3); 


printf("buf1 after strcpy of buf3: \n\t%s\n", 

buf1); 

} 

Output: 



buf3 : Why? 

buf1 after strcpy of buf2: 

Where is the time? 

buf1 after strcpy of buf3: 

Why? 

strcspn 

Description: Calculate the number of consecutive characters at the beginning of 

a 

string that are not containedin a set of characters. 

Include: 

Prototype: size_t strcspn(const char *s1, const char *s2); 

Arguments: s1 pointer to the string to be searched 

s2 pointer to characters to search for 

Return Value: Returns the length of the segment in s1not containing characters 

found in s2. 

Remarks: This function will determine the numberof consecutive characters 

from 

the beginning of s1that are not contained in s2. 

Example: #include /* for strcspn */ 



{ 

char str1[20] = "hello"; 

char str2[20] = "aeiou"; 

char str3[20] = "animal"; 

char str4[20] = "xyz"; 

int res; 

res = strcspn(str1, str2); 

printf("strcspn(\"%s\", \"%s\") = %d\n", 

Ví dụ: # include / * Cho strncat, strlen * / 



{ 




strlen (Tiếp theo) 








printf ("\ t (% d ký tự) \ n \ n \ n", strlen (buf3)); 

strncat (buf1, buf2, 6); 

printf ("buf1 sau strncat 6 ký tự" 

"Của buf2: \ n \ t% s \ n", buf1); 




printf ("buf1 sau strncat 25 ký tự" 





printf ("buf1 sau strncat của 4 nhân vật" 



} 

Đầu ra: 


(10 ký tự) 


(18 ký tự) 


(4 ký tự) 

buf1 sau strncat 6 ký tự của buf2:

str1, str2, res); 







} 

Output: 

strcspn("hello", "aeiou") = 1 

strcspn("animal", "aeiou") = 0 

strcspn("animal", "xyz") = 6 

strcpy (Continued) 



Explanation: 

In the first result, eis in s2so it stops counting after h. 

In the second result, ais in s2. 

In the third result, none of the characters of s1are in s2so all 

characters are counted. 

strerror 

Description: Gets an internal error message. 

Include: 

Prototype: char *strerror(int errcode); 

Argument: errcode number of the error code 

Return Value: Returns a pointer to an internal error message 

stringcorresponding to 

the specified error code errcode. 

Remarks: The array pointed to by strerrormay be overwritten by a 

subsequent call to this function. 


/* printf, FILE, NULL */ 

#include /* for strerror */ 

#include /* for errno */ 


{ 

FILE *myfile; 

if ((myfile = fopen("samp.fil", "r+")) == NULL) 

printf("Cannot open samp.fil: %s\n", 

Chúng tôi hereWhere 

(16 ký tự) 

buf1 sau strncat 25 ký tự của buf2: 

Chúng tôi hereWhere ở đâu thời gian? 

(34 ký tự) 

buf1 sau strncat của 4 nhân vật của buf3: 

Chúng tôi hereWhere ở đâu thời gian? Tại sao? 

(38 ký tự) 

strncat (Tiếp theo) 

dsPIC 

® 



strncmp 


Mô tả: So sánh hai chuỗi, cho đến một số quy định của ký tự. 

Bao gồm: 

Nguyên mẫu: int strncmp (const char * s1, const char * s2, 

size_t n); 

Đối số: s1 chuỗi đầu tiên 

s2 chuỗi thứ hai 

số n ký tự để so sánh 


s1is bằng 


Bình luận: strncmpreturns một giá trị dựa trên các nhân vật đầu tiên mà khác 

giữa s1and s2. Nhân vật tiếp theo một ký tự null không 

so sánh. 

Ví dụ: # include / * Cho strncmp * / 



{ 




res int; 




res = strncmp (buf1, buf2, 6); 

if (res

strerror(errno)); 

else 



} 

Output: 

Cannot open samp.fil: file open error 

strlen 

Description: Finds the length of a string. 

Include: 

Prototype: size_t strlen(const char *s); 

Argument: s the string 

Return Value: Returns the length of a string. 

Remarks: This function determines the length of the string, not including the 

terminating null character. 

strcspn (Continued) 

dsPIC 

® 



Example: #include /* for strlen */ 



{ 

char str1[20] = "We are here"; 

char str2[20] = ""; 

char str3[20] = "Why me?"; 

printf("str1 : %s\n", str1); 

printf("\t(string length = %d characters)\n\n", 

strlen(str1)); 


printf("\t(string length = %d characters)\n\n", 



printf("\t(string length = %d characters)\n\n\n", 


} 

Output: 

str1 : We are here 

printf ("buf1 đến trước buf2 \ n"); 

if (res == 0) 

printf ("6 charactersof buf1 và buf2" 

"Bằng nhau \ n"); 

khác 

printf ("buf2 đến trước buf1 \ n"); 


res = strncmp (buf1, buf2, 20); 

if (res

(string length = 11 characters) 

str2 : 


str3 : Why me? 


strncat 

Description: Append a specified number of characters from the source string to 

the 

destination string. 

Include: 

Prototype: char *strncat(char *s1, const char *s2, size_t n); 



n number of characters to append 


Remarks: This function appends up to ncharacters (a null character and 

characters that follow it are not appended) from the source string to the 

end of the destination string. If a null character is not encountered, then 

a terminating null character is appended to the result. If the strings 

overlap, the behavior is undefined. 

Example: #include /* for strncat, strlen */ 



{ 




số n ký tự sao chép 


Bình luận: Bản sao ncharacters từ chuỗi nguồn vào chuỗi đích. Nếu 

chuỗi nguồn ít hơn ncharacters, điểm đến đầy 

ký tự null tổng ncharacters. Nếu ncharacters đã được sao chép và không có 

ký tự rỗng được tìm thấy sau đó các chuỗi điểm đến sẽ không được 

null-chấm dứt. Nếu chuỗi chồng chéo lên nhau, hành vi này là không xác định. 

Ví dụ: # include / * Forstrncpy, strlen * / 



{ 




buf4 char [7] = "Ở đâu?"; 





strncmp (Tiếp theo) 

dsPIC 

® 





strncpy (buf1, buf2, 6); 


strlen (Continued) 








printf("\t(%d characters)\n\n\n", strlen(buf3)); 

strncat(buf1, buf2, 6); 

printf("buf1 after strncat of 6 characters " 

"of buf2: \n\t%s\n", buf1); 

printf ("buf1 sau strncpy 6 ký tự" 





printf ("buf1 sau strncpy của 18 nhân vật" 





printf ("buf1 sau strncpy 5 ký tự" 

"Của buf3: \ n \ t% s \ n", buf1);


printf("\n"); 





printf("\n"); 





} 

Output: 





buf3 : Why? 


buf1 after strncat of 6 characters of buf2: 

We're hereWhere 



We're hereWhere Where is the time? 



We're hereWhere Where is the time?Why? 


strncat (Continued) 

dsPIC 

® 





printf ("buf1 sau strncpy của 9 nhân vật" 



} 

Đầu ra: 




buf4: ở đâu? 

buf1 sau strncpy 6 ký tự của buf2: 

Trường hợp ở đây 

(10 ký tự) 

buf1 sau strncpy của 18characters của buf2: 

Ở đâu thời gian? 

(18 ký tự) 

buf1 sau strncpy 5 ký tự của buf3: 

Tại sao? 

(4 ký tự) 

buf1 sau strncpy của 9 nhân vật của buf4: 

Ở đâu? 

(6 ký tự) 

strncpy (Tiếp theo) 




Mỗi bộ đệm chứa chuỗi thể hiện, tiếp theo là ký tự null cho một 

chiều dài của 50 dùng strlenwill tìm thấy chiều dài của chuỗi lên đến nhưng 

không 

bao gồm các ký tự null đầu tiên. 

Trong ví dụ đầu tiên, 6 ký tự của buf2 ("ở đâu") thay thế 6 tháng đầu năm 

DS51456B-page 308 

strncmp 


nhân vật của buf1 ("Chúng tôi") và phần còn lại của buf1remains cùng 

("Ở đây" cộng với ký tự null). 

Description: Compare two strings, up to a specified number of characters. 

Include: 

Prototype: int strncmp(const char *s1, const char *s2, 

size_t n); 


Trong ví dụ thứ hai, 18 ký tự thay thế 18 ký tự đầu tiên của 

buf1and phần còn lại vẫn còn ký tự null. 

Trong ví dụ thứ ba, 5 nhân vật của buf3 ("Tại sao?" Cộng với một null 

chấm dứt ký tự) thay thế 5 ký tự đầu tiên của buf1. buf1now 

thực sự có ("Tại sao?", 1 nhân vật vô giá trị, "được thời gian?", 32 rỗng

s2 second string 

n number of characters to compare 


equal to 


Remarks: strncmpreturns a value based on the first character that differs 

between s1and s2. Characters that follow a null character are not 

compared. 

Example: #include /* for strncmp */ 



{ 




int res; 




res = strncmp(buf1, buf2, 6); 

if (res < 0) 



printf("6 charactersof buf1 and buf2 " 


else 


printf("\n"); 

res = strncmp(buf1, buf2, 20); 

if (res < 0) 





else 




printf("\n"); 

ký tự). strlenshows 4 nhân vật vì nó dừng lại khi nó 

đạt các ký tự null đầu tiên. 

Trong ví dụ thứ tư, kể từ khi buf4is chỉ có 7 nhân vật strncpyuses 2 

ký tự null bổ sung thay thế 9 ký tự đầu tiên của buf1. Các 

kết quả của buf1is 6 ký tự ("Ở đâu?") tiếp theo là 3 ký tự null, 

tiếp theo là 9 ký tự ("thời gian?"), tiếp theo là 32 ký tự null. 

strpbrk 

Mô tả: Tìm kiếm một chuỗi cho sự xuất hiện đầu tiên của một nhân vật từ một 

quy định 

tập hợp các ký tự. 

Bao gồm: 

Prototype: char * strpbrk (const char * s1, const char * s2); 



Quay trở lại giá trị: Trả về một con trỏ đến các nhân vật xuất hiện trong s1if tìm 

thấy; nếu không, 


Bình luận: Chức năng này sẽ tìm kiếm s1for sự xuất hiện đầu tiên của một nhân 

vật 

chứa trong s2. 

Ví dụ: # include / * Cho strpbrk, NULL * / 



{ 

char str1 [20] = "Bây giờ là mấy?"; 


char str3 [20] = "EOU?"; 

char * ptr; 

res int; 

printf ("strpbrk (\"% s \ ", \"% s \ ") \ n", str1, str2); 

ptr = strpbrk (str1, str2); 


{ 

res = ptr - str1 + 1; 

printf ("phù hợp với vị trí foundat% d \ n", độ phân giải); 

} 

khác 

printf ("phù hợp không tìm thấy \ n"); 

strncpy (Tiếp theo) 

dsPIC 

®

es = strncmp(buf1, buf3, 20); 

if (res < 0) 





else 


} 

Output: 



buf3 : Why? 

6 characters of buf1 and buf2 are equal 



strncpy 

Description: Copy characters from the source string into the destination string, 

up to 

the specified number of characters. 

Include: 

Prototype: char *strncpy(char *s1, const char *s2, size_t n); 



n number of characters to copy 


Remarks: Copies ncharacters from the source string to the destination string. If 

the source string is less than ncharacters, the destination is filled with 

null characters to total ncharacters. If ncharacters were copied and no 

null character was found then the destination string will not be 

null-terminated. If the strings overlap, the behavior is undefined. 

Example: #include /* forstrncpy, strlen */ 



{ 




char buf4[7] = "Where?"; 





printf ("strpbrk (\"% s \ ", \"% s \ ") \ n", str1, str3); 

ptr = strpbrk (str1, str3); 


{ 


printf ("phù hợp với tìm thấy ở vị trí% d \ n", độ phân giải); 

} 

khác 

printf ("matchnot tìm thấy \ n"); 

} 

Đầu ra: 

strpbrk ("thời gian gì isit?", "xyz") 

phù hợp không tìm thấy 

strpbrk ("thời gian gì isit?", "EOU?") 

phù hợp với tìm thấy ở vị trí 9 

strrchr 

Mô tả: Tìm kiếm sự xuất hiện cuối cùng của một nhân vật được quy định trong 

một chuỗi. 

Bao gồm: 

Prototype: char * strrchr (const char * s, int c); 

Đối số: s con trỏ đến chuỗi cần tìm kiếm 


Quay trở lại giá trị: Trả về một con trỏ tới các nhân vật nếu tìm thấy; nếu không 

trả về một null 

con trỏ. 

Ghi chú: Chức năng tìm kiếm chuỗi, bao gồm cả việc chấm dứt vô 

nhân vật, để tìm sự xuất hiện cuối cùng của nhân vật c. 

Ví dụ: # include / * Cho strrchr, NULL * / 



{ 


char ch1 = 'm', CH2 = 'y'; 

char * ptr; 

res int; 


ptr = strrchr (buf1, ch1);





strncmp (Continued) 

dsPIC 

® 



strncpy(buf1, buf2, 6); 

printf("buf1 after strncpy of 6 characters " 


printf("\t( %d characters)\n", strlen(buf1)); 

printf("\n"); 





printf("\n"); 





printf("\n"); 





} 

Output: 



buf3 : Why? 

buf4 : Where? 

buf1 after strncpy of 6 characters of buf2: 

Where here 

( 10 characters) 

buf1 after strncpy of 18characters of buf2: 

Where is the time? 


{ 


printf ("% c tìm thấy ở vị trí% d \ n", ch1, độ phân giải); 

} 

khác 


strpbrk (Tiếp theo) 




ptr = strrchr (buf1, CH2); 


{ 



} 

khác 


} 

Đầu ra: 


m tìm thấy ở vị trí 8 


strspn 

Mô tả: Tính toán số lượng các ký tự liên tiếp vào đầu của một 

chuỗi được chứa trong một tập hợp các ký tự. 

Bao gồm: 

Prototype: strspn size_t (const char * s1, const char * s2); 



Quay trở lại giá trị: Trả về số ký tự liên tiếp từ đầu s1 

được chứa trong s2. 

Ghi chú: Chức năng này ngừng tìm kiếm khi một nhân vật s1is không s2. 

Ví dụ: # include / * Cho strspn * / 



{ 

char str1 [20] = "động vật";



Why? 



Where? 


strncpy (Continued) 



Explanation: 

Each buffer contains the string shown,followed by null characters for a 

length of 50. Using strlenwill find the length of the string up to but not 

including the first null character. 

In the first example, 6 characters of buf2(“Where “) replace the first 6 

characters of buf1("We're ") and the rest of buf1remains the same 

("here" plus null characters). 

In the second example, 18 characters replace the first 18 characters of 

buf1and the rest remain null characters. 

In the third example, 5 characters of buf3("Why?" plus a null 

terminating character) replace the first 5 characters of buf1. buf1now 

actually contains ("Why?", 1 null character, " is the time?", 32 null 

characters). strlenshows 4 characters because it stops when it 

reaches the first null character. 

In the fourth example, since buf4is only 7 characters strncpyuses 2 

additional null characters to replace the first 9 characters of buf1. The 

result of buf1is 6 characters ("Where?") followed by 3 null characters, 

followed by 9 characters ("the time?"), followed by 32 null characters. 

strpbrk 

Description: Search a string for the first occurrence of a character from a 

specified 

set of characters. 

Include: 

Prototype: char *strpbrk(const char *s1, const char *s2); 



Return Value: Returns a pointer to the matched character in s1if found; 

otherwise, 


Remarks: This function will search s1for the first occurrence of a character 

char str2 [20] = "aeiounm"; 

char str3 [20] = "aimnl"; 


res int; 

res = strspn (str1, str2); 

printf ("strspn (\"% s \ ", \"% s \ ") =% d \ n", 








} 

strrchr (Tiếp theo) 

dsPIC 

® 



Đầu ra: 

strspn ("động vật", "aeiounm") = 5 

strspn ("động vật", "aimnl") = 6 

strspn ("động vật", "xyz") = 0 


Trong kết quả đầu tiên, lis không s2. 


Trong kết quả thứ hai, chấm dứt rỗng không có trong s2. 

Trong kết quả thứ ba, ais không s2, vì vậy việc so sánh dừng lại. 

strstr 

Mô tả: Tìm kiếm chuỗi xảy ra ofa đầu tiên trong chuỗi khác. 

Bao gồm: 

Prototype: char * strstr (const char * s1, const char * s2); 


s2 con trỏ đến chuỗi cần tìm kiếm 

Quay trở lại giá trị: Trả về địa chỉ của phần tử đầu tiên phù hợp với chuỗi nếu 

tìm thấy; nếu không, trả về một con trỏ null. 

Ghi chú: Chức năng này sẽ tìm thấy sự xuất hiện đầu tiên của chuỗi s2 (không 

bao gồm các 

vô terminator) trong chuỗi s1. Nếu s2points một chuỗi số không dài, 

s1is trả lại. 

Ví dụ: # include / * Cho strstr, NULL * /

contained in s2. 

Example: #include /* for strpbrk, NULL */ 



{ 

char str1[20] = "What time is it?"; 


char str3[20] = "eou?"; 

char *ptr; 

int res; 

printf("strpbrk(\"%s\", \"%s\")\n", str1, str2); 

ptr = strpbrk(str1, str2); 


{ 


printf("match foundat position %d\n", res); 

} 

else 

printf("match not found\n"); 

strncpy (Continued) 

dsPIC 

® 



printf("\n"); 

printf("strpbrk(\"%s\", \"%s\")\n", str1, str3); 

ptr = strpbrk(str1, str3); 


{ 


printf("match found at position %d\n", res); 

} 

else 

printf("matchnot found\n"); 

} 

Output: 

strpbrk("What time isit?", "xyz") 

match not found 

strpbrk("What time isit?", "eou?") 



{ 

char str1 [20] = "Bây giờ là mấy?"; 

char str2 [20] = "là"; 


char * ptr; 

res int; 



printf ("str3:% s \ n \ n", str3); 

ptr = strstr (str1, str2); 


{ 


printf ("\"% s \ "được tìm thấy ở vị trí% d \ n", 

str2, độ phân giải); 

} 

khác 

printf ("\"% s \ "không tìm thấy \ n", str2); 

strspn (Tiếp theo) 




ptr = strstr (str1, str3); 


{ 


printf ("\"% s \ "được tìm thấy ở vị trí% d \ n", 

str3, độ phân giải); 

} 

khác 

printf ("\"% s \ "không tìm thấy \ n", str3); 

} 

Đầu ra: 

str1: Bây giờ là mấy? 

str2: là 

str3: xyz 

"Được" tìm thấy ở vị trí 11

match found at position 9 

strrchr 

Description: Search for the last occurrence of a specified character in a string. 

Include: 

Prototype: char *strrchr(const char *s, int c); 

Arguments: s pointer to the string to be searched 


Return Value: Returns a pointer to the character if found; otherwise, returns a 

null 

pointer. 

Remarks: The function searches the string s, including the terminating null 

character, to find the last occurrence of character c. 

Example: #include /* for strrchr, NULL */ 



{ 


char ch1 = 'm', ch2 = 'y'; 

char *ptr; 

int res; 


ptr = strrchr(buf1, ch1); 


{ 


printf("%c found at position %d\n", ch1, res); 

} 

else 


strpbrk (Continued) 



printf("\n"); 

ptr = strrchr(buf1, ch2); 


{ 


"Xyz" không tìm thấy 

strtok 

Mô tả: Phá vỡ một chuỗi thành chuỗi con, hoặc thẻ, bằng cách chèn các ký tự 

null ở 

nơi phân cách quy định. 

Bao gồm: 

Prototype: char * strtok (char * s1, const char * s2); 

Đối số: con trỏ s1 vào chuỗi kết thúc để được tìm kiếm 

s2 con trỏ tới ký tự cần tìm kiếm (sử dụng như là ký tự phân cách) 

Quay trở lại giá trị: Trả về một con trỏ đến ký tự đầu tiên của một mã thông báo 

(ký tự đầu tiên trong 

s1that không xuất hiện trong tập hợp các ký tự của s2). Nếu không có dấu hiệu 

là 

tìm thấy, con trỏ null được trả về. 

Bình luận: Một chuỗi các cuộc gọi đến các chức năng này có thể được sử dụng 

để tách một chuỗi thành 

chuỗi con (hoặc thẻ) bằng cách thay thế các ký tự quy định với null 

ký tự. Lần đầu tiên chức năng này được gọi vào một chuỗi ký tự, 

chuỗi cần được thông qua trong s1. Sau lần đầu tiên, chức năng này có thể 

tiếp tục phân tích các chuỗi từ dấu phân cách cuối cùng bằng cách gọi nó với 

một 

giá trị null được thông qua trong s1. 

Nó bỏ qua tất cả nhân vật chính xuất hiện trong chuỗi s2 (ký tự phân cách), 

sau đó bỏ qua tất cả các nhân vật không xuất hiện trong s2 (phân khúc này của 

nhân vật là các mã thông báo), và sau đó ghi đè các ký tự tiếp theo với một 

nhân vật vô giá trị, chấm dứt các mã thông báo hiện hành. Chức năng strtokthen 

tiết kiệm một con trỏ tới ký tự sau đó, từ đó tiếp theo 

tìm kiếm sẽ bắt đầu. Nếu strtokfinds sự kết thúc của chuỗi trước khi nó tìm thấy 

một 

dấu phân cách, các mã thông báo hiện tại kéo dài cuối tothe của chuỗi chỉ ra 

bởi s1. Nếu đây là cuộc gọi đầu tiên strtok, nó không sửa đổi các chuỗi (không 

ký tự null được ghi vào s1). Tập hợp các ký tự được thông qua 

trong s2need không phải là samefor mỗi cuộc gọi đến strtok. 

Nếu strtokis gọi với một tham số có giá trị cho s1after cuộc gọi ban đầu, 

chuỗi thành chuỗi tosearch mới. Chuỗi cũ trước đây 

tìm kiếm sẽ bị mất. 

strstr (Tiếp theo) 

dsPIC 

® 





} 

Ví dụ: # include / * Cho strtok, NULL * /

else 


} 

Output: 


m found at position 8 

y not found 

strspn 

Description: Calculate the number of consecutive characters at the beginning of 

a 

string that are contained in a set of characters. 

Include: 

Prototype: size_t strspn(const char *s1, const char *s2); 



Return Value: Returns the number of consecutive characters from the beginning 

of s1 

that are contained in s2. 

Remarks: This function stops searching when a character from s1is not in s2. 

Example: #include /* for strspn */ 



{ 

char str1[20] = "animal"; 

char str2[20] = "aeiounm"; 

char str3[20] = "aimnl"; 


int res; 

res = strspn(str1, str2); 

printf("strspn(\"%s\", \"%s\") = %d\n", 








} 

strrchr (Continued) 

dsPIC 



{ 

char str1 [30] = "Ở đây, ontop của thế giới!"; 

char DELIM làm phân cách [5] = ",."; 

char * từ; 

int x; 


x = 1; 

từ = strtok (str1, DELIM làm phân cách); 

trong khi (từ! = NULL) 

{ 

printf ("từ% d:% s \ n", x ++, văn bản); 

từ = strtok (NULL, DELIM làm phân cách); 

} 

} 

Đầu ra: 

str1: Ở đây, trên đỉnh của thế giới! 

từ 1: Ở đây 

từ 2: trên 

từ 3: đầu 

từ 4: của 

từ 5: 

từ 6: thế giới! 

strxfrm 

Mô tả: Transforms một chuỗi bằng cách sử dụng quy tắc địa phương phụ thuộc 

vào. (Xem chú thích.) 

Bao gồm: 

Prototype: strxfrm size_t (char * s1, const char * s2, size_t n); 

Đối số: s1 chuỗi điểm đến 

chuỗi nguồn s2 được chuyển đổi 

số n ký tự để chuyển đổi 

Quay trở lại giá trị: Trả về chiều dài của chuỗi biến đổi không bao gồm 

chấm dứt ký tự null. Nếu nis hết, những chuỗi không được chuyển đổi (s1 

có thể là một điểm vô giá trị trong trường hợp này) và chiều dài của s2is trả lại. 

Ghi chú: Nếu giá trị trả về là lớn hơn hoặc bằng n, nội dung của s1is 

không xác định. Kể từ MPLAB C30 doesnot miền địa phương hỗ trợ thay thế, 

việc chuyển đổi tương đương với strcpy, ngoại trừ chiều dài của 

chuỗi điểm đến được giới hạn bởi n-1. 

strtok (Tiếp theo)

® 


DS51456B-page 314 

Output: 

strspn("animal", "aeiounm") = 5 

strspn("animal", "aimnl") = 6 

strspn("animal", "xyz") = 0 

Explanation: 

In the first result, lis not in s2. 


In the second result, the terminating null is not in s2. 

In the third result, ais not in s2, so the comparison stops. 

strstr 

Description: Search for the first occurrence ofa string inside another string. 

Include: 

Prototype: char *strstr(const char *s1, const char *s2); 


s2 pointer to substring to be searched for 

Return Value: Returns the address of the first element that matches the substring 

if 

found; otherwise, returns a null pointer. 

Remarks: This function will find the first occurrence of the string s2(excluding 

the 

null terminator) within the string s1. If s2points to a zero length string, 

s1is returned. 

Example: #include /* for strstr, NULL */ 



{ 

char str1[20] = "What time is it?"; 

char str2[20] = "is"; 


char *ptr; 

int res; 



printf("str3 : %s\n\n", str3); 

ptr = strstr(str1, str2); 


{ 




4.16 Ngày giờ CHỨC NĂNG 

Các time.hconsists tập tin tiêu đề của các loại, macro và chức năng điều khiển 

thời gian. 

clock_t 

Mô tả: Cửa hàng xử lý thời gian giá trị. 

Bao gồm: 

Prototype: typedef clock_t dài 

size_t 


Bao gồm: 

struct tm 

Mô tả: Cơ cấu sử dụng để giữ thời gian và ngày (thời gian lịch). 

Bao gồm: 

Nguyên mẫu: struct tm { 

int tm_sec; / * Giây sau khi phút (0-61) * / 

/ * Cho phép đến hai giây nhuận * / 

int tm_min; / * Phút sau khi giờ (0-59) * / 

int tm_hour; / * Giờ kể từ nửa đêm (0-23) * / 

int tm_mday; / * Ngày trong tháng (1-31) * / 

int tm_mon; / * Tháng (0-11 tháng một nơi = 0) * / 

int tm_year; / * Năm kể từ năm 1900 * / 

int tm_wday; / * Ngày trong tuần (0-6 nơi chủ nhật = 0) * / 

int tm_yday; / * Ngày trong năm (0-365 nơi 01 tháng 1 = 0) * / 

int tm_isdst; / * Daylight Savings Time cờ * / 

} 

Ghi chú: Nếu tm_isdst isa giá trị tích cực, ánh sáng ban ngày tiết kiệm có hiệu 

lực. Nếu đó là 

thời gian không, tiết kiệm ánh sáng không có hiệu lực. Nếu đó là một giá trị âm 

tình trạng của Daylight Saving Time không được biết đến. 

time_t 

Mô tả: Đại diện cho các giá trị thời gian lịch. 

Bao gồm: 

Prototype: typedef time_t dài 

CLOCKS_PER_SEC 

Mô tả: Số đồng hồ xử lý mỗi giây. 

Bao gồm: 

Prototype: # define CLOCKS_PER_SEC 

Giá trị: 1 

Bình luận: MPLAB C30 trả về bọ ve đồng hồ (chu kỳ hướng dẫn) không phải

printf("\"%s\" found at position %d\n", 

str2, res); 

} 

else 

printf("\"%s\" not found\n", str2); 

strspn (Continued) 



printf("\n"); 

ptr = strstr(str1, str3); 


{ 


printf("\"%s\" found at position %d\n", 

str3, res); 

} 

else 

printf("\"%s\" not found\n", str3); 

} 

Output: 

str1 : What time is it? 

str2 : is 

str3 : xyz 

"is" found at position 11 

"xyz" not found 

strtok 

Description: Break a string into substrings, or tokens, by inserting null 

characters in 

place of specified delimiters. 

Include: 

Prototype: char *strtok(char *s1, const char *s2); 

Arguments: s1 pointer to the null terminated string to be searched 

s2 pointer to characters to be searched for (used as delimiters) 

Return Value: Returns a pointer to the first character of a token (the first 

character in 

s1that does not appear in the set of characters of s2). If no token is 

found, the null pointer is returned. 

Remarks: A sequence of calls to this function can be used to split up a string 

into 

substrings (or tokens) by replacing specified characters with null 

thời gian thực tế. 

dsPIC 

® 



NULL 


Bao gồm: 

asctime 

Mô tả: Chuyển đổi cơ cấu thời gian để một chuỗi ký tự. 

Bao gồm: 

Prototype: char * asctime (const struct tm * tptr); 

Đối số: tptr lần / ngày cấu trúc 

Quay trở lại giá trị: Trả về một con trỏ đến một chuỗi ký tự định dạng sau: 

DDD MMM dd hh: mm: ss YYYY 

DDDis ngày trong tuần 

MMMis tháng trong năm 

ddis ngày của tháng 

hhis giờ 

phút mmis 

SSIS thứ hai 

YYYYis năm 

Ví dụ: # include / * Cho asctime, tm * / 


dễ bay hơi int i; 


{ 

struct tm khi; 

whattime time_t; 

when.tm_sec = 30; 

when.tm_min = 30; 

when.tm_hour = 2; 

when.tm_mday = 1; 

when.tm_mon = 1; 

when.tm_year = 103; 

whattime = mktime (và khi nào); 

printf ("Ngày và thời gian là% s \ n", asctime (và khi nào)); 

} 

Đầu ra:

characters. The first time this function is invoked on a particular string, 

that string should be passed in s1. After the first time, this function can 

continue parsing the string from the last delimiter by invoking it with a 

null value passed in s1. 

It skips all leading characters that appear in the string s2(delimiters), 

then skips all characters not appearing in s2(this segment of 

characters is the token), and then overwrites the next character with a 

null character, terminating the current token. The function strtokthen 

saves a pointer to the character that follows,from which the next 

search will start. If strtokfinds the end of the string before it finds a 

delimiter, the current token extends tothe end of the string pointed to 

by s1. If this is the first call to strtok, it does not modify the string (no 

null characters are written to s1). The set of characters that is passed 

in s2need not be the samefor each call to strtok. 

If strtokis called with a non-null parameter for s1after the initial call, 

the string becomes the new string tosearch. The old string previously 

searched will be lost. 

strstr (Continued) 

dsPIC 

® 


Ngày và thời gian là Sat 01 tháng 2 năm 2003 02:30:30 

đồng hồ 

Mô tả: Tính toán thời gian xử lý. 

Bao gồm: 

Prototype: đồng hồ clock_t (void); 

Quay trở lại giá trị: Trả về số của đồng hồ bọ ve thời gian xử lý trôi qua. 

Ghi chú: Nếu môi trường mục tiêu không thể đo lường thời gian xử lý trôi qua, 

các 

chức năng trả về -1, vào vai một clock_t. (Tức là (clock_t) -1) Theo mặc định, 

MPLAB C30 trả về thời gian là chu kỳ hướng dẫn. 



Ví dụ: # include / * Cho đồng hồ * / 




{ 

clock_t bắt đầu, dừng lại; 

int ct; 

bắt đầu = đồng hồ (); 

for (i = 0; i

Output: 

str1 : Here, on top of the world! 

word 1: Here 

word 2: on 

word 3: top 

word 4: of 

word 5: the 

word 6: world! 

strxfrm 

Description: Transforms a string using the locale-dependent rules. (See 

Remarks.) 

Include: 

Prototype: size_t strxfrm(char *s1, const char *s2, size_t n); 

Arguments: s1 destination string 

s2 source string to be transformed 

n number of characters to transform 

Return Value: Returns the length of the transformed string not including the 

terminating null character. If nis zero, the string is not transformed (s1 

{ 

whattime time_t; 

struct tm nowtime; 

nowtime.tm_sec = 30; 

nowtime.tm_min = 30; 

nowtime.tm_hour = 2; 

nowtime.tm_mday = 1; 

nowtime.tm_mon = 1; 

nowtime.tm_year = 103; 

whattime = mktime (& nowtime); 

printf ("Ngày và thời gian% s \ n", ctime (& whattime)); 

} 

Đầu ra: 

Ngày và thời gian Sat Feb1 2003 02:30:30 

đồng hồ (tiếp theo) 

dsPIC 

® 


may be a point null in this case) and the length of s2is returned. 

Remarks: If the return value is greater than or equal to n, the content of s1is 


difftime 


indeterminate. Since MPLAB C30 doesnot support alternate locales, 

the transformation is equivalent to strcpy, except that the length of 

the destination string is bounded by n-1. 

strtok (Continued) 



4.16 DATE AND TIME FUNCTIONS 

The header file time.hconsists of types, macros and functions that manipulate 

time. 

clock_t 

Description: Stores processor time values. 

Include: 

Prototype: typedef long clock_t 

size_t 


Include: 

struct tm 

Description: Structure used to hold the time and date (calendar time). 

Include: 

Prototype: struct tm { 

Mô tả: Tìm sự khác biệt giữa hai lần. 

Bao gồm: 

Prototype: difftime đôi (time_t t1, t0 time_t); 

Đối số: t1 kết thúc thời gian 

t0 thời gian bắt đầu 

Quay trở lại giá trị: Trả về số giây giữa t1and t0. 

Ghi chú: Theo mặc định, MPLAB C30 trả về thời gian là chu kỳ hướng dẫn để 

difftimereturns số lượng bọ ve giữa t1and t0. 

Ví dụ: # include / * Cho đồng hồ, difftime * / 




{ 

clock_t bắt đầu, dừng lại; 

đôi trôi qua; 

bắt đầu = đồng hồ (); 

for (i = 0; i

int tm_sec; /*seconds after the minute ( 0 to 61 ) */ 

/* allows for up to two leap seconds */ 

int tm_min; /* minutes after the hour ( 0 to 59 ) */ 

int tm_hour; /* hours since midnight ( 0 to 23 ) */ 

int tm_mday; /* day of month ( 1 to 31 ) */ 

int tm_mon; /* month ( 0 to 11 where January = 0 ) */ 

int tm_year; /* years since 1900 */ 

int tm_wday; /* day of week ( 0 to 6 where Sunday = 0 ) */ 

int tm_yday; /* day of year ( 0 to 365 where January 1 = 0 ) */ 

int tm_isdst; /* Daylight Savings Time flag */ 

} 

Remarks: If tm_isdst isa positive value, Daylight Savings is in effect. If it is 

zero, Daylight Saving time is not in effect. If it is a negative value, the 

status of Daylight Saving Time is not known. 

time_t 

Description: Represents calendar time values. 

Include: 

Prototype: typedef long time_t 

CLOCKS_PER_SEC 

Description: Number of processor clocks per second. 

Include: 

Prototype: #define CLOCKS_PER_SEC 

Value: 1 

Remarks: MPLAB C30 returns clock ticks (instruction cycles) not actual time. 

dsPIC 

® 


printf ("stop =% ld \ n", dừng lại); 

trôi qua = difftime (dừng lại, bắt đầu); 

printf ("Thời gian đã qua =% .0f \ n", trôi qua); 

} 

Đầu ra: 

bắt đầu = 0 

ngăn chặn = 317 

Thời gian đã qua = 317 

gmtime 

Mô tả: Chuyển đổi lịch thời gian để cấu trúc thời gian thể hiện như Universal 

Time 

Phối hợp (UTC) còn được gọi asGreenwich Mean Time (GMT). 

Bao gồm: 

Nguyên mẫu: struct tm * gmtime (time_t * const tod); 

Đối số: con trỏ tod gian lưu trữ 

Quay trở lại giá trị: Trả về địa chỉ của cấu trúc thời gian. 

Ghi chú: Chức năng này phá vỡ todvalue vào cấu trúc thời gian của loại 

tm. Theo mặc định, MPLAB C30 trả về thời gian là chu kỳ hướng dẫn. Với 

gmtimeand mặc định này localtimewill tương đương trừ gmtime 

sẽ returntm_isdst (Daylight Savings Time cờ) là không để cho biết 

mà Daylight Savings Time không có hiệu lực. 



Ví dụ: # include / * Cho gmtime, asctime, * / 

/ * Time_t, tm * / 



{ 

DS51456B-page 318 

NULL 


giờ time_t; 

struct tm * Newtime; 


Include: 

asctime 

Description: Converts the time structure to a character string. 

Include: 

Prototype: char *asctime(const struct tm *tptr); 

Argument: tptr time/date structure 

Return Value: Returns a pointer to a character string of the following format: 

DDD MMM dd hh:mm:ss YYYY 

DDDis day of the week 

timer = 1066668182; / * Thứ 16:43:02 ngày 20 tháng 10 năm 2003 * / 

Newtime = gmtime (và thời gian); 

printf ("UTC thời gian =% s \ n", asctime (Newtime)); 

} 

Đầu ra: 

UTC thời gian = Thứ hai ngày 20 tháng 10 năm 2003 16:43:02 

localtime 

Mô tả: Chuyển đổi một giá trị thời gian địa phương. 

Bao gồm: 

Nguyên mẫu: struct tm * localtime (const time_t * tod);

MMMis month of the year 

ddis day of the month 

hhis hour 

mmis minute 

ssis second 

YYYYis year 

Example: #include /*for asctime, tm */ 


volatile int i; 


{ 

struct tm when; 

time_t whattime; 

when.tm_sec = 30; 

when.tm_min = 30; 

when.tm_hour = 2; 

when.tm_mday = 1; 

when.tm_mon = 1; 

when.tm_year = 103; 

whattime = mktime(&when); 

printf("Day and time is %s\n", asctime(&when)); 

} 

Output: 

Đối số: con trỏ tod gian lưu trữ 

Quay trở lại giá trị: Trả về địa chỉ cơ cấu thời gian. 

Ghi chú: Theo mặc định, MPLAB C30 trả về chu kỳ hướng dẫn timeas. Với 

điều này 

localtimeand mặc định gmtimewill tương đương trừ localtime 

sẽ trở lại tm_isdst (Daylight Savings Time cờ) là -1 để chỉ ra rằng 

tình trạng của Daylight Savings Time không được biết đến. 

Ví dụ: # include / * Cho localtime, * / 

/ * Asctime, time_t, tm * / 



{ 

giờ time_t; 



Newtime = localtime (và thời gian); 

printf ("Giờ địa phương =% s \ n", asctime (Newtime)); 

} 

Đầu ra: 

Giờ địa phương = Thứ Oct20 2003 16:43:02 

gmtime (Tiếp theo) 

dsPIC 

® 


Day and time is Sat Feb 1 02:30:30 2003 

clock 


mktime 


Description: Calculates the processor time. 

Include: 

Prototype: clock_t clock(void); 

Return Value: Returns the number of clock ticks of elapsed processor time. 

Remarks: If the target environment cannot measure elapsed processor time, the 

function returns -1, cast as a clock_t. (i.e. (clock_t) -1) By default, 

MPLAB C30 returns the time as instruction cycles. 



Example: #include /* for clock */ 




{ 

Mô tả: Chuyển đổi giờ địa phương đến một giá trị lịch. 

Bao gồm: 

Prototype: time_t mktime (struct tm * tptr); 

Đối số: tptr một con trỏ đến cấu trúc thời gian 

Quay trở lại giá trị: Trả lại thời gian lịch được mã hóa như là một giá trị time_t. 

Ghi chú: Nếu thời gian lịch không thể được đại diện, chức năng trả về -1, diễn 

viên 

như một time_t (tức là (time_t) -1). 

Ví dụ: # include / * Cho localtime, * / 

/ * Asctime, mktime, * / 

/ * Time_t, tm * / 



{

clock_t start, stop; 

int ct; 

start = clock(); 

for (i = 0; i < 10; i++) 

stop = clock(); 

printf("start = %ld\n", start); 

printf("stop = %ld\n", stop); 

} 

Output: 

start = 0 

stop = 317 

ctime 

Description: Converts calendar time to a string representation of local time. 

Include: 

Prototype: char *ctime(const time_t *tod); 

Argument: tod pointer to stored time 

Return Value: Returns the address of a string thatrepresents the local time of the 

parameter passed. 

Remarks: This function is equivalent to asctime(localtime(tod)). 

Example: #include /* for mktime, tm, ctime */ 



{ 

time_t whattime; 

struct tm nowtime; 

nowtime.tm_sec = 30; 

nowtime.tm_min = 30; 

nowtime.tm_hour = 2; 

nowtime.tm_mday = 1; 

nowtime.tm_mon = 1; 

nowtime.tm_year = 103; 

whattime = mktime(&nowtime); 

printf("Day and time %s\n", ctime(&whattime)); 

} 

Output: 

Day and time Sat Feb1 02:30:30 2003 

clock (Continued) 

dsPIC 

® 

giờ time_t, whattime; 



/ * Localtime phân bổ không gian cho struct tm * / 


printf ("Giờ địa phương =% s", asctime (Newtime)); 

whattime = mktime (Newtime); 

printf ("thời gian Lịch như time_t =% ld \ n", 

whattime); 

} 

Đầu ra: 

Giờ địa phương = Thứ hai ngày 20 Tháng 10 2003 16:43:02 

Lịch thời gian như time_t = 1066668182 

strftime 

Mô tả: Định dạng cấu trúc thời gian để một chuỗi dựa trên các thông số định 

dạng. 

Bao gồm: 

Prototype: size_t strftime (char * s, size_t n, 

const char * format, const struct tm * tptr); 

Đối số: chuỗi soutput 

n chiều dài tối đa của chuỗi 

định dạng định dạng kiểm soát chuỗi 

tptr con trỏ đến cấu trúc dữ liệu tm 

Quay trở lại giá trị: Trả về số ký tự được đặt trong mảng s nếu tổng số 

bao gồm cả việc chấm dứt null là không lớn hơn n. Nếu không, 

chức năng trả về 0 và các nội dung của mảng sare không xác định. 

Ghi chú: Các thông số định dạng theo: 

% Một tên các ngày trong tuần viết tắt 

% A tên các ngày trong tuần đầy đủ 

% B tên tháng viết tắt 

% Name tháng đầy đủ B 

% C ngày thích hợp và đại diện thời gian 

% D ngày của tháng (01-31) 

% H giờ trong ngày (00-23) 



% I giờ trong ngày (01-12) 

% J ngày trong năm (001-366) 

% M tháng trong năm (01-12) 

% M phút của giờ (00-59)


DS51456B-page 320 

difftime 


Description: Find the difference between two times. 

Include: 

Prototype: double difftime(time_t t1, time_t t0); 

Arguments: t1 ending time 

t0 beginning time 

Return Value: Returns the number of seconds between t1and t0. 

Remarks: By default, MPLAB C30 returns the time as instruction cycles so 

difftimereturns the number of ticks between t1and t0. 

Example: #include /*for clock, difftime */ 




{ 

clock_t start, stop; 

double elapsed; 

start = clock(); 

for (i = 0; i < 10; i++) 

stop = clock(); 

printf("start = %ld\n", start); 

printf("stop = %ld\n", stop); 

elapsed = difftime(stop, start); 

printf("Elapsed time = %.0f\n", elapsed); 

} 

Output: 

start = 0 

stop = 317 

Elapsed time = 317 

gmtime 

Description: Converts calendar time to time structure expressed as Universal 

Time 

Coordinated (UTC) also known asGreenwich Mean Time (GMT). 

Include: 

Prototype: struct tm *gmtime(const time_t *tod); 


Return Value: Returns the address of the time structure. 

Remarks: This function breaks down the todvalue into the time structure of type 

% P AM / PM vấn thiết kế 

% S thứ hai của phút (00-61) 

cho phép đến hai giây nhuận 

% U số tuần của năm mà Chủ nhật là ngày đầu tiên của tuần 1 

(00-53) 

% W ngày trong tuần, nơi Chủ nhật là ngày 0 (0-6) 

% W số tuần trong năm, nơi thứ hai là ngày đầu tiên của tuần 1 

(00-53) 

% X đại diện ngày thích hợp 

% X đại diện thời điểm thích hợp 

% Năm y mà không cần thế kỷ (00-99) 

% Y năm với thế kỷ 

Khu% Z thời gian (có thể viết tắt) hoặc không có ký tự nếu múi giờ là 

không có sẵn 

%% Tính phần trăm% 

Ví dụ: # include / * Cho strftime, * / 

/ * Localtime, * / 

/ * Time_t, tm * / 



{ 

giờ time_t, whattime; 




/ * Localtime phân bổ không gian cho cấu trúc * / 


strftime (buf, 128, "Đó là một% A,% d ngày vào" 

". Tháng% B trong năm% Y \ n", Newtime); 

printf (buf); 

strftime (buf, 128, "Đó là tuần W% vào năm" 

"Hoặc jdays% vào năm \ n.", Newtime); 

printf (buf); 

} 

Đầu ra: 

Đó là một thứ hai, 20 ngày vào tháng Mười năm 

năm 2003. 

Đó là 42 tuần vào năm hoặc 293 ngày vào 

năm.

tm. By default, MPLAB C30 returns the time as instruction cycles. With 

this default gmtimeand localtimewill be equivalent except gmtime 

will returntm_isdst(Daylight Savings Time flag) as zero to indicate 

that Daylight Savings Time is not in effect. 



Example: #include /* for gmtime, asctime, */ 

/* time_t, tm */ 



{ 

time_t timer; 

struct tm *newtime; 

timer = 1066668182; /* Mon Oct 20 16:43:02 2003 */ 

newtime = gmtime(&timer); 

printf("UTC time = %s\n", asctime(newtime)); 

} 

Output: 

UTC time = Mon Oct 20 16:43:02 2003 

localtime 

Description: Converts a value to the local time. 

Include: 

Prototype: struct tm *localtime(const time_t *tod); 


Return Value: Returns the address ofthe time structure. 

Remarks: By default, MPLAB C30 returns the timeas instruction cycles. With 

this 

default localtimeand gmtimewill be equivalent except localtime 

will return tm_isdst(Daylight Savings Time flag) as -1 to indicate that 

the status of Daylight Savings Time is not known. 

Example: #include /* for localtime, */ 

/* asctime, time_t, tm */ 



{ 

time_t timer; 


timer = 1066668182; /* Mon Oct 20 16:43:02 2003 */ 

newtime = localtime(&timer); 

strftime (Tiếp theo) 

dsPIC 

® 



thời gian 

Mô tả: Tính thời gian lịch hiện tại. 

Bao gồm: 


Nguyên mẫu: thời gian time_t (time_t * tod); 

Đối số: con trỏ tod để vị trí lưu trữ cho thời gian 

Quay trở lại giá trị: Trả lại thời gian lịch được mã hóa như là một giá trị time_t. 

Ghi chú: Nếu môi trường mục tiêu không thể xác định thời gian, chức năng 

trả về -1, vào vai một time_t. Theo mặc định, MPLAB C30 trả về thời gian 

như chu kỳ hướng dẫn. Chức năng này là tùy chỉnh. Xem pic30-libs. 

Ví dụ: # include / * Thời gian * / 




{ 

time_t ve; 

thời gian (0); / * Thời gian bắt đầu * / 

for (i = 0; i

printf("Local time = %s\n", asctime(newtime)); 

} 

Output: 

Local time = Mon Oct20 16:43:02 2003 

gmtime (Continued) 

dsPIC 

® 


nếu 

Kết quả underflowed (giá trị trả về là quá nhỏ). 

Phản ứng với giá trị đặc biệt, chẳng hạn như Nans, số không, và infinities, có 

thể thay đổi tùy thuộc 

theo chức năng. Mỗi mô tả chức năng bao gồm một định nghĩa của các chức 

năng của 

đáp ứng với giá trị đó. 

HUGE_VAL 

Mô tả: HUGE_VALis trả về bởi một chức năng trên một loạt lỗi (ví dụ, chức 

năng 

DS51456B-page 322 

mktime 


cố gắng để trả lại một giá trị quá lớn để được đại diện trong các mục tiêu 

chính xác). 

Description: Converts local time to a calendar value. 

Include: 

Prototype: time_t mktime(struct tm *tptr); 

Argument: tptr a pointer to the time structure 

Return Value: Returns the calendar time encoded as a value of time_t. 

Remarks: If the calendar time cannot be represented, the function returns -1, 

cast 

as a time_t(i.e. (time_t) -1). 

Example: #include /*for localtime, */ 

/* asctime, mktime, */ 




{ 

time_t timer, whattime; 


timer = 1066668182; /* Mon Oct 20 16:43:02 2003 */ 

/* localtime allocates space for struct tm */ 


printf("Local time = %s", asctime(newtime)); 

whattime = mktime(newtime); 

printf("Calendar time as time_t = %ld\n", 

whattime); 

} 

Output: 

Local time = Mon Oct 20 16:43:02 2003 

Calendar time as time_t = 1066668182 

strftime 

Bao gồm: 

Bình luận: -HUGE_VALis trả lại nếu kết quả chức năng là tiêu cực và quá lớn 

(Độ lớn) được đại diện trên cả chặng đường mục tiêu chính xác. Khi 

kết quả in được +/- HUGE_VAL, nó sẽ được đại diện bởi +/- inf. 

acos 

Mô tả: Tính hàm hồ quang cosin lượng giác của một độ chính xác kép 

giá trị dấu chấm động. 

Bao gồm: 

Prototype: acos đôi (double x); 

Đối số: giá trị x giữa -1 và 1 mà trả lại cosin hồ quang 

Quay trở lại giá trị: Trả về cosin hồ quang trong radian trong khoảng từ 0 đến p 

(bao gồm). 

Bình luận: Một lỗi xảy ra nếu miền XIS ít hơn 1 hoặc lớn hơn 1. 

Ví dụ: # include / * Cho acos * / 

# include / * Cho printf, perror * / 



{ 

double x, y; 

errno = 0; 

x = -2,0; 

y = acos (x); 

if (errno) 

perror ("Lỗi"); 

printf ("arccosine của% f% f \ n \ n", x, y); 

dsPIC 

® 


Description: Formats the time structure to a string based on the format 

parameter. 



Include: 

Prototype: size_t strftime(char *s, size_t n, 

const char *format, const struct tm *tptr); 

Arguments: soutput string 

n maximum length of string 

format format-control string 

tptr pointer to tm data structure 

Return Value: Returns the number of characters placed in the array s if the total 

including the terminating null is not greater than n. Otherwise, the 

function returns 0 and the contents of array sare indeterminate. 

Remarks: The format parameters follow: 

%a abbreviated weekday name 

%A full weekday name 

%b abbreviated month name 

%B full month name 

%c appropriate date and time representation 

%d day of the month (01-31) 

%H hour of the day (00-23) 



%I hour of the day (01-12) 

%j day of the year (001-366) 

%m month of the year (01-12) 

%M minute of the hour (00-59) 

%p AM/PM designator 

%S second of the minute (00-61) 

allowing for up to two leap seconds 

%U week number of the year where Sunday is the first day of week 1 

(00-53) 

%w weekday where Sunday is day 0 (0-6) 

%W week number of the year where Monday is the first day of week 1 

(00-53) 

%x appropriate date representation 

%X appropriate time representation 

%y year without century (00-99) 

%Y year with century 

%Z time zone (possibly abbreviated) or no characters if time zone is 

unavailable 

%% percent character % 

errno = 0; 

x = 0,10; 

y = acos (x); 

if (errno) 



} 

Đầu ra: 

Lỗi: lỗi miền 

Các arccosine của -2,000000 là nan 

Các arccosine của 0.100000 là 1.470629 

acosf 

Mô tả: Tính hàm hồ quang cosin lượng giác của một độ chính xác đơn 


Bao gồm: 

Prototype: acosf nổi (float x); 

Giá trị x giữa -1 và 1: Đối số 

Quay trở lại giá trị: Trả về cosin hồ quang trong radian trong khoảng of0 đến pi 

(bao gồm). 


Ví dụ: # include / * Cho acosf * / 




{ 

float x, y; 

errno = 0; 

x = 2.0F; 

y = acosf (x); 

if (errno) 



errno = 0; 

x = 0.0f; 


if (errno) 


printf ("arccosine của% f% f \ n", x, y); 

} 

Đầu ra:

Example: #include /* for strftime, */ 

/* localtime, */ 




{ 

time_t timer, whattime; 



timer = 1066668182; /* Mon Oct 20 16:43:02 2003 */ 

/* localtime allocates space for structure */ 


strftime(buf, 128, "It was a %A, %d days into the " 

"month of %B in the year %Y.\n", newtime); 

printf(buf); 

strftime(buf, 128, "It was %W weeks into the year " 

"or %jdays into the year.\n", newtime); 

printf(buf); 

} 

Output: 

It was a Monday, 20 days into the month of October in 

the year 2003. 

It was 42 weeks into the year or 293 days into the 

year. 

strftime (Continued) 

dsPIC 

® 



Các arccosine của 2.000000 là nan 

Các arccosine của 0.000000 là 1.570796 

acos (Tiếp theo) 



asin 

Mô tả: Tính hàm sin cung lượng giác của một độ chính xác kép 


Bao gồm: 

Prototype: asin đôi (double x); 

Đối số: giá trị x giữa -1 và 1 mà trả lại arc sine 

Quay trở lại giá trị: Trả về sin hồ quang trong radian trong khoảng -pi / 2 đến + 

pi / 2 (bao gồm). 


Ví dụ: # include / * Cho asin * / 




{ 

double x, y; 

errno = 0; 

x = 2,0; 

y = asin (x); 

if (errno) 


printf ("arcsine của% f% f \ n \ n", x, y); 

errno = 0; 

x = 0,0; 

DS51456B-page 324 

time 


y = asin (x); 

if (errno) 

Description: Calculates the current calendar time. 

Include: 

Prototype: time_t time(time_t *tod); 

Argument: tod pointer to storage location for time 

Return Value: Returns the calendar time encoded as a value of time_t. 

Remarks: If the target environment cannot determine the time, the function 

returns -1, cast as a time_t. By default, MPLAB C30 returns the time 

as instruction cycles. This function is customizable. See pic30-libs. 

Example: #include /*for time */ 



} 

Đầu ra: 


Các arcsine của 2.000000 là nan 

Các arcsine của 0.000000 là 0.000000 

asinf 

Mô tả: Tính hàm sin cung lượng giác của một độ chính xác đơn




{ 

time_t ticks; 

time(0); /* start time */ 

for (i = 0; i < 10; i++) /* waste time */ 

time(&ticks); /* get time */ 

printf("Time = %ld\n", ticks); 

} 

Output: 

Time = 256 



4.17 MATHEMATICAL FUNCTIONS 


Bao gồm: 

Prototype: asinf nổi (float x); 

Giá trị x giữa -1 và 1: Đối số 

Quay trở lại giá trị: Trả về sin hồ quang trong radian trong khoảng -pi / 2 đến + 

pi / 2 (bao gồm). 


Ví dụ: # include / * Cho asinf * / 




{ 

float x, y; 

dsPIC 

® 


The header file math.hconsists of a macro and various functions that calculate 

common mathematical operations. Error conditions may be handled with a 

domain error or 

range error (see errno.h). 


errno = 0; 

x = 2.0F; 


A domain error occurs when the input argument is outside the domain over 

which the 

function is defined. The error is reported by storing the value of EDOMin 

errnoand 

returning a particular value defined for each function. 

A range error occurs when the result is too large or too small to be represented 

in the 

target precision. The error is reported by storing the value of ERANGEin 

errnoand 

returning HUGE_VALif the result overflowed (return value was too large) or a 

zero if the 

result underflowed (return value is too small). 

Responses to special values, such as NaNs, zeros, and infinities, may vary 

depending 

upon the function. Each function description includes a definition of the 

function's 

response to such values. 

HUGE_VAL 

Description: HUGE_VALis returned by a function on a range error (e. g., the 

function 

tries to return a value too large to be represented in the target 

precision). 

Include: 

Remarks: -HUGE_VALis returned if a function result is negative and is too 

large 

y = asinf (x); 

if (errno) 



errno = 0; 

x = 0.0f; 

y = asinf (x); 

if (errno) 



} 

Đầu ra: 


Các arcsine của 2.000000 là nan 

Các arcsine của 0.000000 là 0.000000 

atan 

Mô tả: Tính hàm hồ quang tang lượng giác của một độ chính xác kép 


Bao gồm: 

Prototype: atan đôi (double x); 

Đối số: x giá trị mà trả lại tang cung

(in magnitude) to be represented inthe target precision. When the 

printed result is +/- HUGE_VAL, it will be represented by +/- inf. 

acos 

Description: Calculates the trigonometric arc cosine function of a double 

precision 

floating-point value. 

Include: 

Prototype: double acos (double x); 

Argument: x value between -1 and 1 for which to return the arc cosine 

Return Value: Returns the arc cosine in radians in the range of 0 to pi 

(inclusive). 

Remarks: A domain error occurs if xis less than -1 or greater than 1. 

Example: #include /* for acos */ 

#include /* for printf, perror */ 



{ 

double x,y; 

errno = 0; 

x = -2.0; 

y = acos (x); 

if (errno) 

perror("Error"); 

printf("The arccosine of %f is %f\n\n", x, y); 

dsPIC 

® 


Quay trở lại giá trị: Trả về tang cung trong radian trong khoảng -pi / 2 đến + pi 

2 

(Bao gồm). 

Bình luận: Không có tên miền hoặc phạm vi lỗi sẽ xảy ra. 

Ví dụ: # include / * Cho atan * / 



{ 

double x, y; 

x = 2,0; 

y = atan (x); 

printf ("arctangent của% f% f \ n \ n", x, y); 

x = -1,0; 

y = atan (x); 


} 

Đầu ra: 

Các arctangent của 2.000000 là 1.107149 

Các arctangent của -1,000000 là -,785398 

asinf (Tiếp theo) 



atanf 

Mô tả: Tính hàm hồ quang tang lượng giác của một độ chính xác đơn 


Bao gồm: 

Prototype: atanf nổi (float x); 

DS51456B-page 326 


Đối số: x giá trị mà trả lại tang cung 

errno = 0; 

x = 0.10; 

y = acos (x); 

if (errno) 



} 

Output: 

Error: domain error 

The arccosine of -2.000000 is nan 

The arccosine of 0.100000 is 1.470629 

acosf 

Quay trở lại giá trị: Trả về tang cung trong radian trong khoảng -pi / 2 đến + pi 

2 

(Bao gồm). 

Bình luận: Không có tên miền hoặc rangeerror sẽ xảy ra. 

Ví dụ: # include / * Cho atanf * / 



{ 

float x, y; 

x = 2.0F; 

y = atanf (x); 

printf ("arctangent của% f% f \ n \ n", x, y);

Description: Calculates the trigonometric arc cosine function of a single 

precision 


Include: 

Prototype: float acosf (float x); 

Argument: x value between -1 and 1 

Return Value: Returns the arc cosine in radians in the range of0 to pi 

(inclusive). 


Example: #include /* for acosf */ 




{ 

float x, y; 

errno = 0; 

x = 2.0F; 


if (errno) 



errno = 0; 

x = 0.0F; 


if (errno) 


printf("The arccosine of %f is %f\n", x, y); 

} 

Output: 


The arccosine of 2.000000 is nan 

The arccosine of 0.000000 is 1.570796 

acos (Continued) 



asin 

Description: Calculates the trigonometric arc sine function of a double precision 


Include: 

Prototype: double asin (double x); 

x = -1.0F; 



} 

Đầu ra: 

Các arctangent của 2.000000 là 1.107149 

Các arctangent của -1,000000 là -,785398 

atan2 

Mô tả: Tính hàm lượng giác cung tiếp tuyến của y / x. 

Bao gồm: 

Prototype: atan2 đôi (double y, double x); 

Đối số: giá trị yy mà trả lại tang cung 

giá trị xx mà trả lại tang cung 

Quay trở lại giá trị: Trả về inradians hồ quang tiếp xúc trong khoảng từ-pi pi 

(bao gồm) 

với góc tọa độ được xác định bởi các dấu hiệu của cả hai tham số. 

Bình luận: Một lỗi xảy ra nếu cả hai miền xand Yare không hoặc cả hai xand 

Yare 

+/- Vô cùng. 

Ví dụ: # include / * Cho atan2 * / 




{ 

double x, y, z; 

dsPIC 

® 



errno = 0; 

x = 0,0; 

y = 2,0; 

z = atan2 (x, y); 

if (errno) 



printf ("arctangent của% f / f% là% f \ n \ n", 

x, y, z); 

errno = 0; 

x = -1,0; 

y = 0.0;

Argument: x value between -1 and 1 for which to return the arc sine 

Return Value: Returns the arc sine in radians in the range of -pi/2 to +pi/2 

(inclusive). 


Example: #include /* for asin */ 




{ 

double x, y; 

errno = 0; 

x = 2.0; 

y = asin (x); 

if (errno) 


printf("The arcsine of %f is %f\n\n", x, y); 

errno = 0; 

x = 0.0; 

y = asin (x); 

if (errno) 


printf("The arcsine of %f is %f\n\n", x, y); 

} 

Output: 


The arcsine of 2.000000 is nan 

The arcsine of 0.000000 is 0.000000 

asinf 

Description: Calculates the trigonometric arc sine function of a single precision 


Include: 

Prototype: float asinf (float x); 

Argument: x value between -1 and 1 

Return Value: Returns the arc sine in radians in the range of -pi/2 to +pi/2 

(inclusive). 


Example: #include /* for asinf */ 




z = atan2 (x, y); 

if (errno) 



x, y, z); 

errno = 0; 

x = 0,0; 

y = 0.0; 

z = atan2 (x, y); 

if (errno) 



x, y, z); 

} 

Đầu ra: 

Các arctangent của 2.000000 / 0.000000 là 1.570796 

Các arctangent của 0.000000 / -1,000000 là 3,141593 


Các arctangent của 0.000000 / 0.000000 là nan 

atan2 (Tiếp theo) 



atan2f 

Mô tả: Tính hàm lượng giác cung tiếp tuyến của y / x. 

Bao gồm: 

Prototype: atan2f nổi (float y, float x); 

Đối số: giá trị yy mà trả lại tang cung 

giá trị xx mà trả lại tang cung 

Quay trở lại giá trị: Trả về inradians hồ quang tiếp xúc trong khoảng từ-pi pi vớ 

góc phần tư được xác định bởi các dấu hiệu của cả hai tham số. 

Bình luận: Một lỗi xảy ra nếu cả hai miền xand Yare không hoặc cả hai xand 

Yare 

+/- Vô cùng. 

Ví dụ: # include / * Cho atan2f * / 




{ 

nổi x, y, z; 

errno = 0;

{ 

float x, y; 

dsPIC 

® 


DS51456B-page 328 

errno = 0; 

x = 2.0F; 

y = asinf(x); 

if (errno) 



printf("The arcsine of%f is %f\n\n", x, y); 

errno = 0; 

x = 0.0F; 

y = asinf(x); 

if (errno) 


printf("The arcsine of%f is %f\n\n", x, y); 

} 

Output: 


The arcsine of 2.000000 is nan 

The arcsine of 0.000000 is 0.000000 

atan 

Description: Calculates the trigonometric arc tangent function of a double 

precision 


Include: 

Prototype: double atan (double x); 

Argument: x value for which to return the arc tangent 

Return Value: Returns the arc tangent in radians in the range of -pi/2 to +pi/2 

(inclusive). 

x = 2.0F; 

y = 0.0f; 

z = atan2f (y, x); 

if (errno) 



x, y, z); 

errno = 0; 

x = 0.0f; 

y = -1.0F; 


if (errno) 



x, y, z); 

errno = 0; 

x = 0.0f; 

y = 0.0f; 


if (errno) 



x, y, z); 

} 

Đầu ra: 

Các arctangent của 2.000000 / 0.000000 là 1.570796 

Các arctangent của 0.000000 / -1,000000 là 3,141593 


Các arctangent của 0.000000 / 0.000000 là nan 

dsPIC 

® 


Remarks: No domain or range error will occur. 

Example: #include /*for atan */ 


ceil 




{ 

double x, y; 

x = 2.0; 

Mô tả: Tính trần của một giá trị. 

Bao gồm: 

Prototype: ceil đôi (double x); 

Đối số: xa giá trị dấu chấm động mà trở về trần. 

Quay trở lại giá trị: Trả về giá trị nguyên nhỏ nhất lớn hơn hoặc bằng x.

y = atan (x); 

printf("The arctangent of%f is %f\n\n", x, y); 

x = -1.0; 

y = atan (x); 


} 

Output: 

The arctangent of 2.000000 is 1.107149 

The arctangent of -1.000000 is -0.785398 

asinf (Continued) 



atanf 

Description: Calculates the trigonometric arc tangent function of a single 

precision 


Include: 

Prototype: float atanf (float x); 

Argument: x value for which to return the arc tangent 

Return Value: Returns the arc tangent in radians in the range of -pi/2 to +pi/2 

(inclusive). 

Remarks: No domain or rangeerror will occur. 

Example: #include /* for atanf */ 



{ 

float x, y; 

x = 2.0F; 



x = -1.0F; 



} 

Output: 

The arctangent of 2.000000 is 1.107149 

The arctangent of -1.000000 is -0.785398 

atan2 

Description: Calculates the trigonometric arc tangent function of y/x. 

Bình luận: Không có tên miền hoặc phạm vi lỗi sẽ xảy ra. Xem sàn. 

Ví dụ: # include / * Cho trần nhà * / 



{ 

double x [8] = {2.0, 1.75, 1.5, 1.25, -2.0, 

-1.75, -1.5, -1.25}; 

y kép; 

int i; 

for (i = 0; i

Include: 

Prototype: double atan2 (double y, double x); 

Arguments: y y value for which to return the arc tangent 

x x value for which to return the arc tangent 

Return Value: Returns the arc tangent inradians in the range of-pi to pi 

(inclusive) 

with the quadrant determined by the signs of both parameters. 

Remarks: A domain error occurs if both xand yare zero or both xand yare 

+/- infinity. 

Example: #include /* for atan2 */ 




{ 


dsPIC 

® 


nổi y; 

int i; 

for (i = 0; i

if (errno) 


printf("The arctangent of %f/%f is %f\n\n", 

y, x, z); 

} 

Output: 

The arctangent of 2.000000/0.000000 is 1.570796 

The arctangent of 0.000000/-1.000000 is 3.141593 


The arctangent of 0.000000/0.000000 is nan 

atan2 (Continued) 



atan2f 

Description: Calculates the trigonometric arc tangent function of y/x. 

Include: 

Prototype: float atan2f (float y, float x); 

Arguments: y y value for which to return the arc tangent 

x x value for which to return the arc tangent 

Return Value: Returns the arc tangent inradians in the range of-pi to pi with the 

quadrant determined by the signs of both parameters. 

Remarks: A domain error occurs if both xand yare zero or both xand yare 

+/- infinity. 

Example: #include /* for atan2f */ 




{ 

float x, y, z; 

errno = 0; 

x = 2.0F; 

y = 0.0F; 


if (errno) 



y, x, z); 

errno = 0; 

x = 0.0F; 



errno = 0; 

x = 0,0; 

y = cos (x); 

if (errno) 


printf ("cô sin của% f% f \ n \ n", x, y); 

} 

Đầu ra: 

Các cô sin của -1,000000 là 0,540302 

Các cô sin của 0.000000 là 1.000000 

cosf 


Mô tả: Tính hàm cosin lượng giác của một độ chính xác đơn 

nổi giá trị điểm. 

Bao gồm: 

Prototype: cosf nổi (float x); 

Đối số: x giá trị mà toreturn cô sin 

Quay trở lại giá trị: Trả về cosin của xin radian trong phạm vi của -1 đến 1 bao 

gồm. 

Bình luận: Một lỗi miền sẽ xảy ra nếu XIS một NaN hoặc vô cùng. 

Ví dụ: # include / * Cho cosf * / 




{ 

float x, y; 

errno = 0; 

x = -1.0F; 

y = cosf (x); 

if (errno) 



errno = 0; 

x = 0.0f; 

y = cosf (x); 

if (errno) 



}

y = -1.0F; 


if (errno) 



y, x, z); 

errno = 0; 

x = 0.0F; 

y = 0.0F; 


if (errno) 



y, x, z); 

} 

Output: 

The arctangent of 2.000000/0.000000 is 1.570796 

The arctangent of 0.000000/-1.000000 is 3.141593 


The arctangent of 0.000000/0.000000 is nan 

dsPIC 

® 



ceil 

Description: Calculates the ceiling of a value. 

Include: 

Prototype: double ceil(double x); 

Argument: x a floating-point value for which to return the ceiling. 

Return Value: Returns the smallest integer value greater than or equal to x. 

Remarks: No domain or range error will occur. See floor. 

Example: #include /*for ceil */ 



{ 

double x[8] = {2.0, 1.75, 1.5, 1.25, -2.0, 

-1.75, -1.5, -1.25}; 

double y; 

int i; 

Đầu ra: 

Các cô sin của -1,000000 là 0,540302 

Các cô sin của 0.000000 là 1.000000 

cos (Tiếp theo) 



cosh 

Mô tả: Tính hàm cosin hyperbol của một độ chính xác gấp đôi nổi 

giá trị điểm. 

Bao gồm: 

Prototype: cosh đôi (double x); 

Đối số: x giá trị mà trả lại cosin hyperbol 

Quay trở lại giá trị: Trả về cosin hyperbol của x 

Bình luận: Một loạt lỗi sẽ xảy ra nếu độ lớn của XIS quá lớn. 

Ví dụ: # include / * Cho cosh * / 




{ 

double x, y; 

errno = 0; 

x = -1,5; 

y = cosh (x); 

if (errno) 


printf ("cosin hyperbol của% f% f \ n \ n", 

x, y); 

errno = 0; 

x = 0,0; 

y = cosh (x); 

if (errno) 



x, y); 

errno = 0; 

x = 720,0; 

y = cosh (x); 

if (errno) 

perror ("Lỗi");

for (i=0; i

The ceiling for 2.000000 is 2.000000 




The ceiling for -2.000000 is -2.000000 




cos 

Description: Calculates the trigonometric cosine function of a double precision 

floating point value. 

Include: 

Prototype: double cos (double x); 

Argument: x value for which toreturn the cosine 

Return Value: Returns the cosine of xin radians in the ranges of -1 to 1 

inclusive. 

Remarks: A domain error will occur if xis a NaN or infinity. 

Example: #include /* for cos*/ 




{ 

double x,y; 

errno = 0; 

x = -1.0; 

y = cos (x); 

if (errno) 


printf("The cosine of%f is %f\n\n", x, y); 

dsPIC 

® 


x, y); 

errno = 0; 

x = 720.0F; 

y = coshf (x); 

if (errno) 



x, y); 

} 

Đầu ra: 

Cosin hyperbol của-1.000000 là 1.543081 

Cosin hyperbol of0.000000 là 1,000000 

Lỗi: lỗi phạm vi 

Cosin hyperbol of720.000000 là inf 



exp 

Mô tả: Tính hàm OFX mũ (e lũy thừa x nơi 

x là độ chính xác gấp đôi giá trị nổi điểm). 

Bao gồm: 

Prototype: điểm kinh nghiệm gấp đôi (double x); 

Đối số: x giá trị mà để trả lại theo cấp số nhân 

Quay trở lại giá trị: Trả về số mũ của x. Trên một tràn, expreturns infand trên 

Van cân bằng một expreturns 0. 

Bình luận: Một loạt lỗi xảy ra nếu độ lớn của XIS quá lớn. 

Ví dụ: # include / * Cho điểm kinh nghiệm * / 




{ 

double x, y; 

errno = 0; 

DS51456B-page 334 

errno = 0; 

x = 0.0; 

y = cos (x); 

if (errno) 



x = 1,0; 

y = exp (x); 

if (errno) 


printf ("mũ của% f% f \ n \ n", x, y); 

errno = 0; 

printf("The cosine of %f is %f\n\n", x, y); 

x = 1E3;

} 

Output: 

The cosine of -1.000000 is 0.540302 

The cosine of 0.000000 is 1.000000 

cosf 

Description: Calculates the trigonometric cosine function of a single precision 


Include: 

Prototype: float cosf (float x); 

Argument: x value for which toreturn the cosine 

Return Value: Returns the cosine of xin radians in the ranges of -1 to 1 

inclusive. 


Example: #include /* for cosf */ 




{ 

float x, y; 

errno = 0; 

y = exp (x); 

if (errno) 



errno = 0; 

x = -1E3; 

y = exp (x); 

if (errno) 



} 

Đầu ra: 

Các mũ của 1.000000 là 2.718282 


Các mũ của 1000.000000 là inf 


Các mũ của -1000,000000 là 0.000000 

dsPIC 

® 


x = -1.0F; 

y = cosf (x); 


expf 


if (errno) 



errno = 0; 

x = 0.0F; 

y = cosf (x); 

if (errno) 



} 

Output: 

The cosine of -1.000000 is 0.540302 

The cosine of 0.000000 is 1.000000 

cos (Continued) 



cosh 

Mô tả: Tính hàm mũ của x (e lũy thừa x nơi 

x là độ chính xác đơn giá trị nổi điểm). 

Bao gồm: 

Prototype: expf nổi (float x); 

Đối số: x nổi giá trị điểm mà trả lại theo cấp số nhân 

Quay trở lại giá trị: Trả về số mũ của x. Trên một tràn, expfreturns infand trên 

một điểm kinh nghiệm Van cân bằng trả về 0. 

Bình luận: Một loạt lỗi xảy ra nếu độ lớn của XIS quá lớn. 

Ví dụ: # include / * Cho expf * / 




{ 

float x, y; 

errno = 0; 

x = 1.0f; 

y = expf (x);

Description: Calculates the hyperbolic cosine function of a double precision 

floating 

point value. 

Include: 

Prototype: double cosh (double x); 

Argument: x value for which to return the hyperbolic cosine 

Return Value: Returns the hyperbolic cosine of x 

Remarks: A range error will occur if the magnitude of xis too large. 

Example: #include /* for cosh */ 




{ 

double x, y; 

errno = 0; 

x = -1.5; 

y = cosh (x); 

if (errno) 


printf("The hyperbolic cosine of %f is %f\n\n", 

x, y); 

errno = 0; 

x = 0.0; 

y = cosh (x); 

if (errno) 



x, y); 

errno = 0; 

x = 720.0; 

y = cosh (x); 

if (errno) 



x, y); 

} 

Output: 

The hyperbolic cosine of-1.500000 is 2.352410 

The hyperbolic cosine of0.000000 is 1.000000 

if (errno) 



errno = 0; 

x = 1.0E3F; 

y = expf (x); 

if (errno) 



errno = 0; 

x = -1.0E3F; 

y = expf (x); 

if (errno) 



} 

Đầu ra: 

Các mũ của 1.000000 là 2.718282 


Các mũ của 1000.000000 là inf 


Các mũ của -1000,000000 là 0.000000 



fabs 

Mô tả: Tính giá trị tuyệt đối của một giá trị chính xác điểm nổi gấp đôi. 

Bao gồm: 

Prototype: fabs đôi (double x); 

Đối số: x nổi giá trị điểm mà toreturn giá trị tuyệt đối 

Quay trở lại giá trị: Trả về giá trị tuyệt đối của x. (Một số âm được trả về như 

tích cực, một số dương là không thay đổi.) 


Ví dụ: # include / * Cho fabs * / 



{ 

double x, y; 

x = 1,75; 

y = fabs (x);

Error: range error 

The hyperbolic cosine of 720.000000 is inf 

dsPIC 

® 


DS51456B-page 336 

coshf 


Description: Calculates the hyperbolic cosine function of a single precision 

floating 

point value. 

Include: 

Prototype: float coshf (float x); 

Argument: x value for which to return the hyperbolic cosine 

Return Value: Returns the hyperbolic cosine of x 


Example: #include /* for coshf */ 




{ 

float x, y; 

errno = 0; 

x = -1.0F; 


if (errno) 



x, y); 

errno = 0; 

x = 0.0F; 


if (errno) 



printf ("Giá trị tuyệt đối của% f% f \ n", x, y); 

x = -1,5; 

y = fabs (x); 


} 

Đầu ra: 

Giá trị tuyệt đối là 1.750000 1.750000 

Giá trị tuyệt đối của -1,500000 là 1,500000 

fabsf 

Mô tả: Tính giá trị tuyệt đối của một giá trị điểm duy nhất chính xác nổi. 

Bao gồm: 

Prototype: fabsf nổi (float x); 

Đối số: x nổi giá trị điểm mà trở về giá trị tuyệt đối 

Quay trở lại giá trị: Trả về giá trị tuyệt đối của x. (Một số âm được trả về như 

tích cực, một số dương là không thay đổi.) 


Ví dụ: # include / * Cho fabsf * / 



{ 

float x, y; 

x = 1.75F; 

y = fabsf (x); 


x = -1.5F; 



} 

Đầu ra: 

Giá trị tuyệt đối là 1.750000 1.750000 

Giá trị tuyệt đối của -1,500000 là 1,500000 

dsPIC 

® 


x, y); 

errno = 0; 


sàn 


x = 720.0F; 


if (errno) 

Mô tả: Tính toán sàn của một giá trị chính xác điểm nổi gấp đôi. 

Bao gồm: 

Prototype: Tầng đôi (double x);



x, y); 

} 

Output: 

The hyperbolic cosine of-1.000000 is 1.543081 

The hyperbolic cosine of0.000000 is 1.000000 


The hyperbolic cosine of720.000000 is inf 


exp 


Description: Calculates the exponential function ofx (e raised to the power x 

where 

x is a double precision floating point value). 

Include: 

Prototype: double exp (double x); 

Argument: x value for which to return the exponential 

Return Value: Returns the exponential of x. On an overflow, expreturns infand 

on 

an underflow expreturns 0. 

Remarks: A range error occurs if the magnitude of xis too large. 

Example: #include /* for exp*/ 




{ 

double x, y; 

errno = 0; 

x = 1.0; 

y = exp (x); 

if (errno) 


printf("The exponential of %f is %f\n\n", x, y); 

errno = 0; 

x = 1E3; 

y = exp (x); 

if (errno) 



Đối số: x nổi giá trị điểm mà quay trở lại sàn. 

Quay trở lại giá trị: Trả về giá trị nguyên lớn nhất nhỏ hơn hoặc bằng x. 

Bình luận: Không có tên miền hoặc phạm vi lỗi sẽ xảy ra. Xem làm trần nhà. 

Ví dụ: # include / * Sàn * / 



{ 

double x [8] = {2.0, 1.75, 1.5, 1.25, -2.0, 

-1.75, -1.5, -1.25}; 

y kép; 

int i; 

for (i = 0; i

errno = 0; 

x = -1E3; 

y = exp (x); 

if (errno) 



} 

Output: 

The exponential of 1.000000 is 2.718282 


The exponential of 1000.000000 is inf 


The exponential of -1000.000000 is 0.000000 

dsPIC 

® 


DS51456B-page 338 

expf 


Description: Calculates the exponential function of x (e raised to the power x 

where 

x is a single precision floating point value). 

Include: 

Prototype: float expf (float x); 

Argument: x floating point value for which to return the exponential 

Return Value: Returns the exponential of x. On an overflow, expfreturns infand 

on 

an underflow exp returns 0. 

Remarks: A range error occurs if the magnitude of xis too large. 

Example: #include /* for expf */ 




{ 

float x, y; 

errno = 0; 

x = 1.0F; 

y = expf (x); 

if (errno) 



nổi x [8] = {2.0F, 1.75F, 1.5F, 1.25F, 

-2.0F, -1.75F, -1.5F, -1.25F}; 

nổi y; 

int i; 

for (i = 0; i

errno = 0; 

x = 1.0E3F; 

y = expf (x); 

if (errno) 



errno = 0; 

x = -1.0E3F; 

y = expf (x); 

if (errno) 



} 

Output: 

The exponential of 1.000000 is 2.718282 


The exponential of 1000.000000 is inf 


The exponential of -1000.000000 is 0.000000 



fabs 

Description: Calculates the absolute value of a double precision floating point 

value. 

Include: 

Prototype: double fabs(double x); 

Argument: x floating point value for which toreturn the absolute value 

Return Value: Returns the absolute value of x. (A negative number is returned 

as 

positive, a positive number is unchanged.) 


Example: #include /*for fabs */ 



{ 

double x, y; 

x = 1.75; 

y = fabs (x); 

printf("The absolute value of %f is %f\n", x, y); 

x = -1.5; 

if (errno) 


printf ("Đối với fmod (% f, f%) còn lại là% f \ n \ n", 

x, y, z); 

floorf (Tiếp theo) 

dsPIC 

® 



errno = 0; 

x = 7,0; 

y = 7.0; 

z = fmod (x, y); 

if (errno) 



x, y, z); 

errno = 0; 

x = -5,0; 

y = 3,0; 


if (errno) 



x, y, z); 

errno = 0; 

x = 5,0; 

y = -3,0; 


if (errno) 



x, y, z); 

errno = 0; 

x = -5,0; 

y = -5,0; 


if (errno) 

perror ("Lỗi");

y = fabs (x); 


} 

Output: 

The absolute value of 1.750000 is 1.750000 

The absolute value of -1.500000 is 1.500000 

fabsf 

Description: Calculates the absolute value of a single precision floating point 

value. 

Include: 

Prototype: float fabsf(float x); 

Argument: x floating point value for which to return the absolute value 

Return Value: Returns the absolute value of x. (A negative number is returned 

as 

positive, a positive number is unchanged.) 


Example: #include /* for fabsf */ 



{ 

float x,y; 

x = 1.75F; 



x = -1.5F; 



} 

Output: 

The absolute value of 1.750000 is 1.750000 

The absolute value of -1.500000 is 1.500000 

dsPIC 

® 


DS51456B-page 340 

floor 


Description: Calculates the floor of a double precision floating point value. 

Include: 

Prototype: double floor (double x); 

Argument: x floating point value for which to return the floor. 


x, y, z); 

errno = 0; 

x = 7,0; 

y = 0.0; 


if (errno) 



x, y, z); 

} 

Đầu ra: 

Đối với fmod (7.000000, 3.000000) còn lại là 1.000000 

Đối với fmod (7.000000, 7.000000) còn lại là 0.000000 

Đối với fmod (-5,000000, 3,000000) còn lại là -2,000000 

Đối với fmod (5.000000, -3,000000) còn lại là 2,000000 

Đối với fmod (-5,000000, -5,000000) còn lại là -,000000 


Đối với fmod (7.000000, 0.000000) còn lại là nan 

fmod (Tiếp theo) 



fmodf 

Mô tả: Tính toán phần còn lại của x / y như một giá trị chính xác duy nhất. 

Bao gồm: 

Prototype: fmodf nổi (float x, float y); 

Đối số: xa đơn giá trị điểm chính xác nổi 

ya đơn chính xác nổi giá trị điểm 

Quay trở lại giá trị: Trả về phần còn lại của xdivided của y. 

Ghi chú: Nếu y = 0, một lỗi miền xảy ra. Nếu YIS khác không, kết quả sẽ có 

cùng dấu hiệu như xand tầm quan trọng của kết quả sẽ thấp hơn 

tầm quan trọng của y. 

Ví dụ: # include / * Cho fmodf * / 




{ 


errno = 0;

Return Value: Returns the largest integer value less than or equal to x. 

Remarks: No domain or range error will occur. See ceil. 

Example: #include /* for floor */ 



{ 

double x[8] = {2.0, 1.75, 1.5, 1.25, -2.0, 

-1.75, -1.5, -1.25}; 

double y; 

int i; 

for (i=0; i

-2.0F, -1.75F, -1.5F, -1.25F}; 

float y; 

int i; 

for (i=0; i


printf("For fmod(%f, %f) the remainder is %f\n\n", 

x, y, z); 

floorf (Continued) 

dsPIC 

® 



errno = 0; 

x = 7.0; 

y = 7.0; 

z = fmod(x, y); 

if (errno) 



x, y, z); 

errno = 0; 

x = -5.0; 

y = 3.0; 


if (errno) 



x, y, z); 

errno = 0; 

x = 5.0; 

y = -3.0; 


if (errno) 



x, y, z); 

errno = 0; 

x = -5.0; 

y = -5.0; 


if (errno) 



fmodf (Tiếp theo) 



x = 50.0; 

y = frexp (x, & n); 

printf ("Đối với frexp của% f \ n phần là% f \ n", 

x, y); 

printf ("và số mũ là% d \ n \ n", n); 

x = -2,5; 



x, y); 


x = 0,0; 



x, y); 


} 

Đầu ra: 

Đối với frexp của 50.000000 

phần là 0.781250 

và số mũ là 6 

Đối với frexp của -2,500000 

phần là -,625000 


Đối với frexp của 0.000000 

phần là 0.000000 


frexpf 

Mô tả: Được phần và số mũ của một điểm chính xác nổi duy nhất 

số. 

Bao gồm: 

Prototype: frexpf nổi (float x, int * exp); 

Đối số: x nổi giá trị điểm mà trả lại phần và 

số mũ 

* Exp con trỏ đến một số mũ nguyên lưu trữ 

Quay trở lại giá trị: Trả về phân số, exppoints với số mũ. Nếu XIS 0, chức năng 

trả về 0 cho cả hai phần và số mũ. 

Bình luận: Giá trị tuyệt đối của phần là trên cả chặng đường khoảng 1/2 (bao

x, y, z); 

errno = 0; 

x = 7.0; 

y = 0.0; 


if (errno) 



x, y, z); 

} 

Output: 

For fmod(7.000000, 3.000000) the remainder is 1.000000 

For fmod(7.000000, 7.000000) the remainder is 0.000000 

For fmod(-5.000000, 3.000000) the remainder is -2.000000 

For fmod(5.000000, -3.000000) the remainder is 2.000000 

For fmod(-5.000000, -5.000000) the remainder is -0.000000 


For fmod(7.000000, 0.000000) the remainder is nan 

fmod (Continued) 



fmodf 

Description: Calculates the remainder of x/y as a single precision value. 

Include: 

Prototype: float fmodf(float x, float y); 

Arguments: x a single precision floating point value 

y a single precision floating point value 

Return Value: Returns the remainder of xdivided by y. 

Remarks: If y= 0, a domain error occurs. If yis nonzero, the result will have the 

same sign as xand the magnitude of the result will be less than the 

magnitude of y. 

Example: #include /* for fmodf */ 




{ 

float x,y,z; 

errno = 0; 

x = 7.0F; 

gồm) tới 1 

(Độc quyền). Không có lỗi miền orrange sẽ xảy ra. 

Ví dụ: # include / * Cho frexpf * / 



{ 

float x, y; 

int n; 

frexp (Tiếp theo) 

dsPIC 

® 



x = 0.15F; 

y = frexpf (x, & n); 

printf ("Đối với frexpf của% f \ n phần là% f \ n", 

x, y); 


x = -2.5F; 



x, y); 


x = 0.0f; 



x, y); 


} 

Đầu ra: 

Đối với frexpf của 0.150000 

phần là 0.600000 

và số mũ là -2 

Đối với frexpf của -2,500000 

phần là -,625000 


Đối với frexpf của 0.000000 

phần là 0.000000 

và số mũ là 0

y = 3.0F; 

z = fmodf (x, y); 

if (errno) 


printf("For fmodf (%f, %f) the remainder is" 

" %f\n\n", x, y, z); 

errno = 0; 

x = -5.0F; 

y = 3.0F; 


if (errno) 


printf("For fmodf (%f, %f)the remainder is" 

" %f\n\n", x, y, z); 

errno = 0; 

x = 5.0F; 

y = -3.0F; 


if (errno) 



" %f\n\n", x, y, z); 

errno = 0; 

x = 5.0F; 

y = -5.0F; 


if (errno) 



" %f\n\n", x, y, z); 

dsPIC 

® 



errno = 0; 

x = 7.0F; 

y = 0.0F; 


if (errno) 

ldexp 

Mô tả: Tính toán kết quả của một số điểm nổi doubleprecision 

nhân với số mũ của 2. 

Bao gồm: 

Prototype: ldexp đôi (double x, int cũ); 

Đối số: x nổi giá trị điểm 

số mũ nguyên cũ 

Quay trở lại giá trị: Trả về x * 2 ^ cũ. Trên một tràn, ldexpreturns infand trên 

Van cân bằng, ldexpreturns 0. 

Bình luận: Một lỗi xảy ra trên phạm vi sẽ tràn hoặc tràn dưới. 

Ví dụ: # include / * Cho ldexp * / 




{ 

double x, y; 

int n; 

frexpf (Tiếp theo) 



errno = 0; 

x = -0,625; 

n = 2; 

y = ldexp (x, n); 

if (errno) 


printf ("Đối với một số =% fand một số mũ =% d \ n", 

x, n); 

printf ("ldexp (% f,% d) =% f \ n \ n", 

x, n, y); 

errno = 0; 

x = 2,5; 

n = 3; 


if (errno) 



x, n); 

printf ("ldexp (% f,% d) =% f \ n \ n",


printf("For fmodf (%f,%f) the remainder is" 

" %f\n\n", x, y, z); 

errno = 0; 

x = 7.0F; 

y = 7.0F; 


if (errno) 


printf("For fmodf (%f,%f) the remainder is" 

" %f\n\n", x, y, z); 

} 

Output: 

For fmodf (7.000000,3.000000) the remainder is 1.000000 

For fmodf (-5.000000, 3.000000) the remainder is -2.000000 

For fmodf (5.000000, -3.000000) the remainder is 2.000000 

For fmodf (5.000000, -5.000000) the remainder is 0.000000 


For fmodf (7.000000,0.000000) the remainder is nan 

For fmodf (7.000000,7.000000) the remainder is 0.000000 

frexp 

Description: Gets the fraction and the exponent ofa double precision floating 

point 

number. 

Include: 

Prototype: double frexp (double x, int *exp); 

Arguments: x floating point value for which to return the fraction and 

exponent 

*exp pointer to a stored integer exponent 

Return Value: Returns the fraction, exppoints to the exponent. If xis 0, the 

function 

returns 0 for both the fraction and exponent. 

Remarks: The absolute value of the fraction is in the range of 1/2 (inclusive) to 

1 

(exclusive). No domain or range error will occur. 

Example: #include /* for frexp */ 



{ 

double x,y; 

x, n, y); 

errno = 0; 

x = 15,0; 

n = 10000; 


if (errno) 



x, n); 

printf ("ldexp (% f,% d) =% f \ n \ n", 

x, n, y); 

} 

Đầu ra: 

Đối với một số = -,625000 và một số mũ = 2 

ldexp (-,625000, 2) = -2,500000 

Đối với một số = 2.500000 và một số mũ = 3 

ldexp (2.500000, 3) = 20,000000 



ldexp (15.000000, 10000) = inf 

ldexpf 

Mô tả: Tính toán kết quả của một số điểm chính xác đơn nổi 

nhân với số mũ của 2. 

Bao gồm: 

Prototype: ldexpf nổi (float x, int cũ); 

Đối số: x nổi giá trị điểm 

exinteger mũ 

Quay trở lại giá trị: Trả về x * 2 ^ cũ. Trên một tràn, ldexpreturns infand trên 

Van cân bằng, ldexpreturns 0. 

ldexp (Tiếp theo) 

dsPIC 

® 



Bình luận: Một lỗi xảy ra trên phạm vi sẽ tràn hoặc tràn dưới. 

Ví dụ: # include / * Cho ldexpf * / 



int main (void)

int n; 

fmodf (Continued) 



x = 50.0; 

y = frexp (x, &n); 

printf("For frexp of %f\n the fraction is %f\n ", 

x, y); 

printf(" and the exponent is %d\n\n", n); 

x = -2.5; 



x, y); 


x = 0.0; 



x, y); 


} 

Output: 

For frexp of 50.000000 

the fraction is 0.781250 

and the exponent is 6 

For frexp of -2.500000 

the fraction is -0.625000 


For frexp of 0.000000 



frexpf 

Description: Gets the fraction and the exponent of a single precision floating 

point 

number. 

Include: 

Prototype: float frexpf (float x, int *exp); 

Arguments: x floating point value for which to return the fraction and 

exponent 

*exp pointer to a stored integer exponent 

{ 

float x, y; 

int n; 

errno = 0; 

x = -0.625F; 

n = 2; 

y = ldexpf (x, n); 

if (errno) 



x, n); 

printf ("ldexpf (% f,% d) =% f \ n \ n", 

x, n, y); 

errno = 0; 

x = 2.5F; 

n = 3; 


if (errno) 



x, n); 


x, n, y); 

errno = 0; 

x = 15.0F; 

n = 10000; 


if (errno) 



x, n); 


x, n, y); 

} 

Đầu ra: 

Đối với một số = -,625000 và một số mũ = 2 

ldexpf (-,625000, 2) = -2,500000 


ldexpf (2.500000, 3) = 20,000000

Return Value: Returns the fraction, exppoints to the exponent. If xis 0, the 

function 

returns 0 for both the fraction and exponent. 

Remarks: The absolute value of the fraction is inthe range of 1/2 (inclusive) to 1 

(exclusive). No domain orrange error will occur. 

Example: #include /* for frexpf */ 



{ 

float x,y; 

int n; 

frexp (Continued) 

dsPIC 

® 




ldexpf (15.000000, 10000) = inf 

ldexpf (Tiếp theo) 



đăng nhập 

Mô tả: Tính logarit tự nhiên của một điểm chính xác đôi nổi 

giá trị. 

Bao gồm: 

Nguyên mẫu: đăng nhập tăng gấp đôi (double x); 

Đối số: x bất kỳ giá trị tích cực mà trả lại đăng nhập 

Quay trở lại giá trị: Trả về logarit tự nhiên của x. -infis trả lại nếu XIS 0 và NaN 

trả lại nếu XIS một số âm. 

Bình luận: Một lỗi miền xảy ra nếu x ≤0. 

DS51456B-page 346 

x = 0.15F; 

y = frexpf (x, &n); 


Ví dụ: # include / * Để đăng nhập * / 



printf("For frexpf of %f\n the fraction is %f\n ", 

x, y); 


x = -2.5F; 



x, y); 


x = 0.0F; 



x, y); 


} 

Output: 

For frexpf of 0.150000 


and the exponent is -2 

For frexpf of -2.500000 

the fraction is -0.625000 



{ 

double x, y; 

errno = 0; 

x = 2,0; 

y = log (x); 

if (errno) 


printf ("logarit tự nhiên của% f% f \ n \ n", 

x, y); 

errno = 0; 

x = 0,0; 

y = log (x); 

if (errno) 



x, y); 

errno = 0; 

x = -2,0; 

y = log (x); 

if (errno)

For frexpf of 0.000000 



ldexp 

Description: Calculates the result of a doubleprecision floating point number 

multiplied by an exponent of 2. 

Include: 

Prototype: double ldexp(double x, int ex); 

Arguments: x floating point value 

ex integer exponent 

Return Value: Returns x* 2^ex. On an overflow, ldexpreturns infand on an 

underflow, ldexpreturns 0. 

Remarks: A range error will occur on overflow or underflow. 

Example: #include /* for ldexp */ 




{ 

double x,y; 

int n; 

frexpf (Continued) 



errno = 0; 

x = -0.625; 

n = 2; 


if (errno) 


printf("For a number = %fand an exponent = %d\n", 

x, n); 

printf(" ldexp(%f, %d) = %f\n\n", 

x, n, y); 

errno = 0; 

x = 2.5; 

n = 3; 


if (errno) 




x, y); 

} 

Đầu ra: 

Các of2.000000 logarit tự nhiên là 0,693147 

Các of0.000000 logarit tự nhiên là -INF 


Logarit tự nhiên của -2,000000 là nan 

dsPIC 

® 



log10 

Mô tả: Tính logarit cơ số 10 của một điểm chính xác đôi nổi 

giá trị. 

Bao gồm: 

Prototype: log10 đôi (double x); 

Đối số: x bất kỳ độ chính xác kép nổi điểm số dương 

Quay trở lại giá trị: Trả về logarit cơ số 10 của x. -infis trả lại nếu XIS 0 và NaN 

được trả lại nếu XIS một số âm. 


Ví dụ: # include / * Cho log10 * / 




{ 

double x, y; 

errno = 0; 

x = 2,0; 

y = log10 (x); 

if (errno) 


printf ("Các cơ sở-10 logarit% f% f \ n \ n", 

x, y); 

errno = 0; 

x = 0,0; 

y = log10 (x); 

if (errno)


x, n); 


x, n, y); 

errno = 0; 

x = 15.0; 

n = 10000; 


if (errno) 



x, n); 


x, n, y); 

} 

Output: 

For a number = -0.625000 and an exponent = 2 

ldexp(-0.625000, 2) = -2.500000 

For a number = 2.500000 and an exponent = 3 

ldexp(2.500000, 3) = 20.000000 



ldexp(15.000000, 10000) = inf 

ldexpf 

Description: Calculates the result of a single precision floating point number 

multiplied by an exponent of 2. 

Include: 

Prototype: float ldexpf(float x, int ex); 

Arguments: x floating point value 

exinteger exponent 

Return Value: Returns x* 2^ex. On an overflow, ldexpreturns infand on an 

underflow, ldexpreturns 0. 

ldexp (Continued) 

dsPIC 

® 



Remarks: A range error will occur on overflow or underflow. 

Example: #include /* for ldexpf */ 



x, y); 

errno = 0; 

x = -2,0; 

y = log10 (x); 

if (errno) 



x, y); 

} 

Đầu ra: 

Các cơ sở of2.000000-10 logarit là 0,301030 

Các cơ sở-10 logarit 0.000000 là -INF 


Các cơ sở-10 logarit-2,000000 là nan 



log10f 

Mô tả: Tính điểm cơ số 10 logarit ofa độ chính xác đơn nổi 

giá trị. 

Bao gồm: 

Prototype: log10f nổi (float x); 

Đối số: x bất kỳ chính xác duy nhất nổi điểm số dương 

Quay trở lại giá trị: Trả về logarit cơ số 10 của x. -infis trả lại nếu XIS 0 và NaN 

được trả lại nếu XIS một số âm. 


Ví dụ: # include / * Cho log10f * / 




{ 

float x, y; 

errno = 0; 

x = 2.0F; 

y = log10f (x); 

if (errno) 


printf ("Các cơ sở-10 logarit% f% f \ n \ n",




{ 

float x,y; 

int n; 

errno = 0; 

x = -0.625F; 

n = 2; 


if (errno) 



x, n); 

printf(" ldexpf(%f, %d) = %f\n\n", 

x, n, y); 

errno = 0; 

x = 2.5F; 

n = 3; 


if (errno) 



x, n); 


x, n, y); 

errno = 0; 

x = 15.0F; 

n = 10000; 


if (errno) 



x, n); 


x, n, y); 

} 

Output: 

For a number = -0.625000 and an exponent = 2 

x, y); 

errno = 0; 

x = 0.0f; 

y = log10f (x); 

if (errno) 



x, y); 

errno = 0; 

x = -2.0F; 

y = log10f (x); 

if (errno) 



x, y); 

} 

Đầu ra: 

Các cơ sở of2.000000-10 logarit là 0,301030 


Các cơ sở-10 logarit of0.000000 là -INF 


Các cơ sở-10 logarit -2,000000 là nan 

dsPIC 

® 



logf 

Mô tả: Tính logarit tự nhiên của một điểm chính xác nổi duy nhất 

giá trị. 

Bao gồm: 

Prototype: logf nổi (float x); 

Đối số: x bất kỳ giá trị tích cực mà trả lại đăng nhập 

Quay trở lại giá trị: Trả về logarit tự nhiên của x. -infis trả lại nếu XIS 0 và NaN 

trả lại nếu XIS một số âm. 


Ví dụ: # include / * Cho logf * / 



int main (void)

ldexpf(-0.625000, 2) = -2.500000 


ldexpf(2.500000, 3) = 20.000000 



ldexpf(15.000000, 10000) = inf 

ldexpf (Continued) 


log 


Description: Calculates the natural logarithm of a double precision floating 

point 

value. 

Include: 

Prototype: double log(double x); 

Argument: x any positive value for which to return the log 

Return Value: Returns the natural logarithm of x. -infis returned if xis 0 and 

NaN is 

returned if xis a negative number. 

Remarks: A domain error occurs if x ≤0. 

Example: #include /* for log*/ 




{ 

double x, y; 

errno = 0; 

x = 2.0; 

y = log (x); 

if (errno) 


printf("The natural logarithm of %f is %f\n\n", 

x, y); 

errno = 0; 

x = 0.0; 

y = log (x); 

if (errno) 



x, y); 

{ 

float x, y; 

errno = 0; 

x = 2.0F; 

y = logf (x); 

if (errno) 



x, y); 

errno = 0; 

x = 0.0f; 

y = logf (x); 

if (errno) 



x, y); 

errno = 0; 

x = -2.0F; 

y = logf (x); 

if (errno) 



x, y); 

} 

Đầu ra: 

Các of2.000000 logarit tự nhiên là 0,693147 

Logarit tự nhiên của 0.000000 là -INF 


Logarit tự nhiên của-2.000000 là nan 



modf 

Mô tả: Tách một độ chính xác kép nổi pointvalue vào phân đoạn và số nguyên 

các bộ phận. 

Bao gồm: 

Prototype: modf đôi (double x, double * pint); 

Đối số: x độ chính xác gấp đôi giá trị dấu chấm động 

pint con trỏ để lưu trữ một phần nguyên 

Quay trở lại giá trị: Trả về phần thập phân có chữ ký và pintpoints đến phần 

nguyên.

errno = 0; 

x = -2.0; 

y = log (x); 

if (errno) 



x, y); 

} 

Output: 

The natural logarithm of2.000000 is 0.693147 

The natural logarithm of0.000000 is -inf 


The natural logarithm of -2.000000 is nan 

dsPIC 

® 


Bình luận: Giá trị tuyệt đối của các phần phân đoạn nằm trong khoảng từ 0 (bao 

gồm) 

1 (độc quyền). Không có lỗi nhiều domainor sẽ xảy ra. 

Ví dụ: # include / * Cho modf * / 



{ 

double x, y, n; 

x = 0,707; 

y = modf (x, & n); 

printf ("% f Đối với phần là% f \ n", x, y); 

printf ("và các số nguyên là 0.f% \ n \ n", n); 

x = -15,2121; 

y = modf (x, & n); 



} 

DS51456B-page 350 

log10 


Đầu ra: 

Đối với 0.707000 phần là 0.707000 

Description: Calculates the base-10 logarithm of a double precision floating 

point 

value. 

Include: 

Prototype: double log10(double x); 

Argument: x any double precision floating point positive number 

Return Value: Returns the base-10 logarithm of x. -infis returned if xis 0 and 

NaN 

is returned if xis a negative number. 


Example: #include /* for log10 */ 




{ 

double x, y; 

errno = 0; 

x = 2.0; 

y = log10 (x); 

if (errno) 


printf("The base-10 logarithm of %f is %f\n\n", 

và các số nguyên là 0 

Đối với -15,212100 phần là -,212100 

và các số nguyên là -15 

dsPIC 

® 



modff 


Mô tả: Tách một độ chính xác giá trị dấu chấm duy nhất vào phân đoạn và số 

nguyên 

các bộ phận. 

Bao gồm: 

Prototype: modff nổi (float x, float * pint); 

Đối số: x độ chính xác đơn giá trị dấu chấm 

con trỏ pint để phần nguyên lưu trữ 

Quay trở lại giá trị: Trả về phần thập phân có chữ ký và pintpoints đến phần 

nguyên. 

Bình luận: Giá trị tuyệt đối của các phần phân đoạn nằm trong khoảng từ 0 (bao 

gồm) 

1 (độc quyền). Không có lỗi nhiều domainor sẽ xảy ra. 

Ví dụ: # include / * Cho modff * / 


x, y); 

errno = 0; 

x = 0.0; 

y = log10 (x); 

if (errno) 



x, y); 

errno = 0; 

x = -2.0; 

y = log10 (x); 

if (errno) 



x, y); 

} 

Output: 

The base-10 logarithm of2.000000 is 0.301030 

The base-10 logarithm of 0.000000 is -inf 


The base-10 logarithm of-2.000000 is nan 



log10f 

Description: Calculates the base-10 logarithm ofa single precision floating point 

value. 

Include: 

Prototype: float log10f(float x); 

Argument: x any single precision floating point positive number 

Return Value: Returns the base-10 logarithm of x. -infis returned if xis 0 and 

NaN 

is returned if xis a negative number. 


Example: #include /* for log10f */ 




{ 

float x, y; 


{ 

float x, y, n; 

x = 0.707F; 

y = modff (x, & n); 



x = -15.2121F; 

y = modff (x, & n); 



} 

Đầu ra: 

Đối với 0.707000 phần là 0.707000 

và các số nguyên là 0 

Đối với -15,212100 phần là -,212100 

và các số nguyên là -15 



pow 

Mô tả: Tính x lũy thừa y. 

Bao gồm: 

Prototype: pow đôi (double x, double y); 

Đối số: x cơ sở 

mũ ythe 

Quay trở lại giá trị: Trả về xraised cho y sức mạnh (x ^ y). 

Ghi chú: Nếu YIS 0 powreturns 1 Nếu XIS 0.0 và YIS nhỏ hơn 0 powreturns in 

và một lỗi xảy ra miền. Nếu tràn kết quả hoặc underflows, một 

phạm vi lỗi xảy ra. 

Ví dụ: # include / * Cho pow * / 




{ 


errno = 0; 

x = -2,0; 

y = 3,0; 

z = pow (x, y);

errno = 0; 

x = 2.0F; 

y = log10f(x); 

if (errno) 



x, y); 

errno = 0; 

x = 0.0F; 


if (errno) 



x, y); 

errno = 0; 

x = -2.0F; 


if (errno) 



x, y); 

} 

Output: 

The base-10 logarithm of2.000000 is 0.301030 


The base-10 logarithm of0.000000 is -inf 


The base-10 logarithm of -2.000000 is nan 

dsPIC 

® 



logf 

Description: Calculates the natural logarithm of a single precision floating point 

value. 

Include: 

Prototype: float logf(float x); 

Argument: x any positive value for which to return the log 

Return Value: Returns the natural logarithm of x. -infis returned if xis 0 and 

if (errno) 


printf ("% f% f nâng lên là% f \ n \ n", x, y, z); 

errno = 0; 

x = 3,0; 

y = -0,5; 

z = pow (x, y); 

if (errno) 



errno = 0; 

x = 4,0; 

y = 0.0; 

z = pow (x, y); 

if (errno) 



errno = 0; 

x = 0,0; 

y = -3,0; 

z = pow (x, y); 

if (errno) 



} 

Đầu ra: 

-2,000000 Nâng lên 3,000000 là -8,000000 

3.000000 nâng lên -,500000 là 0,577350 

4.000000 nâng lên là 0.000000 1.000000 


0.000000 nâng lên -3,000000 là inf 

dsPIC 

® 



powf 

Mô tả: Tính x lũy thừa y. 

Bao gồm: 

Prototype: powf nổi (float x, float y);

NaN is 

returned if xis a negative number. 


Example: #include /* for logf */ 




{ 

float x, y; 

errno = 0; 

x = 2.0F; 

y = logf (x); 

if (errno) 



x, y); 

errno = 0; 

x = 0.0F; 

y = logf (x); 

if (errno) 



x, y); 

errno = 0; 

x = -2.0F; 

y = logf (x); 

if (errno) 



x, y); 

} 

Output: 

The natural logarithm of2.000000 is 0.693147 

The natural logarithm of 0.000000 is -inf 


The natural logarithm of-2.000000 is nan 



modf 

Đối số: Xbase 

yexponent 

Quay trở lại giá trị: Trả về xraised cho y sức mạnh (x ^ y). 

Ghi chú: Nếu YIS 0 powfreturns 1 Nếu XIS 0.0 và YIS nhỏ hơn 0 powfreturns 

infand một lỗi miền xảy ra. Nếu tràn kết quả hoặc underflows, một 

phạm vi lỗi xảy ra. 

Ví dụ: # include / * Cho powf * / 




{ 


errno = 0; 

x = -2.0F; 

y = 3.0F; 

z = powf (x, y); 

if (errno) 



errno = 0; 

x = 3.0F; 

y = -0.5F; 


if (errno) 



errno = 0; 

x = 0.0f; 

y = -3.0F; 


if (errno) 



} 

Đầu ra: 

-2,000000 Nâng lên 3,000000 là -8,000000 

3.000000 nâng lên -,500000 là 0,577350 


0.000000 nâng lên -3,000000 là inf

Description: Splits a double precision floating pointvalue into fractional and 

integer 

parts. 

Include: 

Prototype: double modf(double x, double *pint); 

Arguments: x double precision floating point value 

pint pointer to a stored the integer part 

Return Value: Returns the signed fractional part and pintpoints to the integer 

part. 

Remarks: The absolute value of the fractional part is in the range of 0 

(inclusive) 

to 1 (exclusive). No domainor range error will occur. 

Example: #include /*for modf */ 



{ 

double x,y,n; 

x = 0.707; 

y = modf (x, &n); 

printf("For %f the fraction is %f\n ", x, y); 

printf(" and the integer is %0.f\n\n", n); 

x = -15.2121; 

y = modf (x, &n); 



} 

Output: 

For 0.707000 the fraction is 0.707000 

and the integer is 0 

For -15.212100 the fraction is -0.212100 

and the integer is -15 

dsPIC 

® 


DS51456B-page 354 

modff 


Description: Splits a single precision floating point value into fractional and 

integer 

parts. 

Include: 

Prototype: float modff(float x, float *pint); 



tội lỗi 

Mô tả: Tính hàm lượng giác sin của một độ chính xác kép nổi 


Bao gồm: 

Prototype: tội lỗi kép (double x); 

Đối số: x giá trị mà trả lại sin 

Quay trở lại giá trị: Trả về sin xin radian trong phạm vi của -1 đến 1 bao gồm. 

Bình luận: Một lỗi miền sẽ xảy ra nếu t XIS một NaN hoặc vô cùng. 

Ví dụ: # include / * Tội lỗi * / 




{ 

double x, y; 

errno = 0; 

x = -1,0; 

y = sin (x); 

if (errno) 


printf ("sin của FIS%% f \ n \ n", x, y); 

errno = 0; 

x = 0,0; 

y = sin (x); 

if (errno) 


printf ("sin của FIS%% f \ n \ n", x, y); 

} 

Đầu ra: 

Sin của -1,000000 là -,841471 

Sin của 0.000000 là 0.000000 

dsPIC 

® 



sinf 

Mô tả: Tính hàm lượng giác sin của một độ chính xác đơn nổi 

giá trị điểm.

Arguments: x single precision floating point value 

pint pointer to stored integer part 

Return Value: Returns the signed fractional part and pintpoints to the integer 

part. 

Remarks: The absolute value of the fractional part is in the range of 0 

(inclusive) 

to 1 (exclusive). No domainor range error will occur. 

Example: #include /* for modff */ 



{ 

float x,y,n; 

x = 0.707F; 

y = modff (x, &n); 



x = -15.2121F; 

y = modff (x, &n); 



} 

Output: 

For 0.707000 the fraction is 0.707000 

and the integer is 0 

For -15.212100 the fraction is -0.212100 

and the integer is -15 



pow 

Description: Calculates x raised to the power y. 

Include: 

Prototype: double pow(double x, double y); 

Arguments: x the base 

ythe exponent 

Return Value: Returns xraised to the power y(x^y). 

Remarks: If yis 0 powreturns 1. If xis 0.0 and yis less than 0 powreturns inf 

and a domain error occurs. If the result overflows or underflows, a 

range error occurs. 

Example: #include /* for pow*/ 


Bao gồm: 

Prototype: sinf nổi (float x); 

Đối số: x giá trị mà trả lại sin 

Quay trở lại giá trị: Trả về tội xin radian trong phạm vi của -1 đến 1 bao gồm. 


Ví dụ: # include / * Cho sinf * / 




{ 

float x, y; 

errno = 0; 

x = -1.0F; 

y = sinf (x); 

if (errno) 


printf ("sin của% f% f \ n \ n", x, y); 

errno = 0; 

x = 0.0f; 

y = sinf (x); 

if (errno) 


printf ("sin của% f% f \ n \ n", x, y); 

} 

Đầu ra: 

Sin của -1,000000 là -,841471 

Sin của 0.000000 là 0.000000 



sinh 

Mô tả: Tính hàm sin hyperbol của một độ chính xác gấp đôi nổi 


Bao gồm: 

Prototype: sinh đôi (double x); 

Đối số: x giá trị mà trả lại sin hyperbol 

Quay trở lại giá trị: Trả về sin hyperbol của x 


Ví dụ: # include / * Cho sinh * / 

# include / * Cho printf, perror * /



{ 

double x,y,z; 

errno = 0; 

x = -2.0; 

y = 3.0; 

z = pow (x, y); 

if (errno) 


printf("%f raised to %f is %f\n\n ", x, y, z); 

errno = 0; 

x = 3.0; 

y = -0.5; 

z = pow (x, y); 

if (errno) 



errno = 0; 

x = 4.0; 

y = 0.0; 

z = pow (x, y); 

if (errno) 



errno = 0; 

x = 0.0; 

y = -3.0; 

z = pow (x, y); 

if (errno) 



} 

Output: 

-2.000000 raised to 3.000000 is -8.000000 

3.000000 raised to -0.500000 is 0.577350 

4.000000 raised to 0.000000 is 1.000000 


0.000000 raised to -3.000000 is inf 



{ 

double x, y; 

errno = 0; 

x = -1,5; 

y = sinh (x); 

if (errno) 


printf ("sin hyperbol của% f% f \ n \ n", 

x, y); 

errno = 0; 

x = 0,0; 

y = sinh (x); 

if (errno) 



x, y); 

errno = 0; 

x = 720,0; 

y = sinh (x); 

if (errno) 



x, y); 

} 

Đầu ra: 

Sin hyperbol của -1,500000 là -2,129279 

Sin hyperbol của 0.000000 là 0.000000 


Sin hyperbol của 720.000000 là inf 

dsPIC 

® 



sinhf 

Mô tả: Tính hàm sin hyperbol của một độ chính xác đơn nổi 


Bao gồm:

dsPIC 

® 



powf 

Description: Calculates x raised to the power y. 

Include: 

Prototype: float powf(float x, float y); 

Arguments: xbase 

yexponent 

Return Value: Returns xraised to the power y(x^y). 

Remarks: If yis 0 powfreturns 1. If xis 0.0 and yis less than 0 powfreturns 

infand a domain error occurs. If the result overflows or underflows, a 

range error occurs. 

Example: #include /* for powf */ 




{ 

float x,y,z; 

errno = 0; 

x = -2.0F; 

y = 3.0F; 


if (errno) 


printf("%f raised to %f is%f\n\n ", x, y, z); 

errno = 0; 

x = 3.0F; 

y = -0.5F; 


if (errno) 



errno = 0; 

x = 0.0F; 

y = -3.0F; 


if (errno) 

Prototype: sinhf nổi (float x); 

Đối số: x giá trị mà trả lại sin hyperbol 

Quay trở lại giá trị: Trả về sin hyperbol của x 


Ví dụ: # include / * Cho sinhf * / 




{ 

float x, y; 

errno = 0; 

x = -1.0F; 

y = sinhf (x); 

if (errno) 



x, y); 

errno = 0; 

x = 0.0f; 


if (errno) 



x, y); 

} 

Đầu ra: 

Sin hyperbol của -1,000000 là -1,175201 

Sin hyperbol của 0.000000 là 0.000000 



sqrt 

Mô tả: Tính căn bậc hai của một giá trị chính xác điểm nổi gấp đôi. 

Bao gồm: 

Prototype: sqrt đôi (double x); 

Đối số: xa không âm giá trị dấu chấm 

Quay trở lại giá trị: Trả về căn không negativesquare của x .. 

Ghi chú: Nếu XIS tiêu cực, một lỗi miền xảy ra. 

Ví dụ: # include / * Cho sqrt * / 




} 

Output: 

-2.000000 raised to 3.000000 is -8.000000 

3.000000 raised to -0.500000 is 0.577350 


0.000000 raised to -3.000000 is inf 


sin 


Description: Calculates the trigonometric sine function of a double precision 

floating 

point value. 

Include: 

Prototype: double sin (double x); 

Argument: x value for which to return the sine 

Return Value: Returns the sine of xin radians in the ranges of -1 to 1 inclusive. 

Remarks: A domain error will occur if t xis a NaN or infinity. 

Example: #include /* for sin*/ 




{ 

double x, y; 

errno = 0; 

x = -1.0; 

y = sin (x); 

if (errno) 


printf("The sine of %fis %f\n\n", x, y); 



{ 

double x, y; 

errno = 0; 

x = 0,0; 

y = sqrt (x); 

if (errno) 


printf ("căn bậc hai của% f% f \ n \ n", x, y); 

errno = 0; 

x = 9,5; 

y = sqrt (x); 

if (errno) 



errno = 0; 

x = -25,0; 

y = sqrt (x); 

if (errno) 



} 

Đầu ra: 

Căn bậc hai của 0.000000 là 0.000000 

Căn bậc hai của 9.500000 là 3.082207 


Căn bậc hai của -25,000000 là nan 

dsPIC 

® 


errno = 0; 

x = 0.0; 


sqrtf 


y = sin (x); 

if (errno) 


printf("The sine of %fis %f\n\n", x, y); 

} 

Output: 

Mô tả: Tính căn bậc hai của một giá trị chính xác điểm nổi duy nhất. 

Bao gồm: 

Prototype: sqrtf nổi (float x); 

Đối số: x không âm giá trị dấu chấm 

Quay trở lại giá trị: Trả về căn bậc hai không âm của x. 

Ghi chú: Nếu XIS tiêu cực, một lỗi miền xảy ra.

The sine of -1.000000 is -0.841471 

The sine of 0.000000 is 0.000000 

dsPIC 

® 


DS51456B-page 358 

sinf 


Description: Calculates the trigonometric sine function of a single precision 

floating 

point value. 

Include: 

Prototype: float sinf (float x); 

Argument: x value for which to return the sine 

Return Value: Returns the sin of xin radians in the ranges of -1 to 1 inclusive. 


Example: #include /* for sinf */ 




{ 

float x, y; 

errno = 0; 

x = -1.0F; 

y = sinf (x); 

if (errno) 


printf("The sine of %f is %f\n\n", x, y); 

errno = 0; 

x = 0.0F; 

y = sinf (x); 

if (errno) 


printf("The sine of %f is %f\n\n", x, y); 

} 

Output: 

The sine of -1.000000 is -0.841471 

The sine of 0.000000 is 0.000000 



Ví dụ: # include / * Cho sqrtf * / 




{ 

x đôi; 

errno = 0; 

x = sqrtf (0.0f); 

if (errno) 


printf ("căn bậc hai của 0.0f là% f \ n \ n", x); 

errno = 0; 

x = sqrtf (9.5F); 

if (errno) 


printf ("căn bậc hai của 9.5F là% f \ n \ n", x); 

errno = 0; 

x = sqrtf (-25.0F); 

if (errno) 


printf ("căn bậc hai của -25F là% f \ n", x); 

} 

Đầu ra: 

Căn bậc hai của 0.0f là 0.000000 

Căn bậc hai của 9.5F là 3,082207 


Căn bậc hai của -25F là nan 



tan 

Mô tả: Tính hàm lượng giác tiếp xúc của một độ chính xác kép 


Bao gồm: 

Prototype: đôi tan (double x); 

Đối số: x giá trị mà trả lại tang 

Quay trở lại giá trị: Trả về tang của xin radian. 


Ví dụ: # include / * Cho tan * / 


sinh 

Description: Calculates the hyperbolic sine function of a double precision 

floating 

point value. 

Include: 

Prototype: double sinh (double x); 

Argument: x value for which to return the hyperbolic sine 

Return Value: Returns the hyperbolic sine of x 


Example: #include /* for sinh */ 




{ 

double x, y; 

errno = 0; 

x = -1.5; 

y = sinh (x); 

if (errno) 


printf("The hyperbolic sine of %f is %f\n\n", 

x, y); 

errno = 0; 

x = 0.0; 

y = sinh (x); 

if (errno) 



x, y); 

errno = 0; 

x = 720.0; 

y = sinh (x); 

if (errno) 



x, y); 

} 



{ 

double x, y; 

errno = 0; 

x = -1,0; 

y = tan (x); 

if (errno) 


printf ("tang của% f% f \ n \ n", x, y); 

errno = 0; 

x = 0,0; 

y = tan (x); 

if (errno) 



} 

Đầu ra: 

Tang của -1,000000 là -1,557408 

Tang của 0.000000 là 0.000000 

TANF 

Mô tả: Tính tangentfunction lượng giác của một độ chính xác đơn 


Bao gồm: 

Prototype: TANF nổi (float x); 

Đối số: x giá trị mà trả lại tang 

Quay trở lại giá trị: Trả về tang của x 


Ví dụ: # include / * Cho TANF * / 




{ 

float x, y; 

dsPIC 

® 


Output: 

The hyperbolic sine of -1.500000 is -2.129279 


errno = 0; 


The hyperbolic sine of 0.000000 is 0.000000 


The hyperbolic sine of 720.000000 is inf 

dsPIC 

® 


DS51456B-page 360 

sinhf 


Description: Calculates the hyperbolic sine function of a single precision 

floating 

point value. 

Include: 

Prototype: float sinhf (float x); 

Argument: x value for which to return the hyperbolic sine 

Return Value: Returns the hyperbolic sine of x 


Example: #include /* for sinhf */ 




{ 

float x, y; 

errno = 0; 

x = -1.0F; 


if (errno) 



x, y); 

errno = 0; 

x = 0.0F; 


if (errno) 



x, y); 

} 

Output: 

The hyperbolic sine of -1.000000 is -1.175201 

x = -1.0F; 

y = TANF (x); 

if (errno) 



errno = 0; 

x = 0.0f; 

y = TANF (x); 

if (errno) 


printf ("tang của% f% f \ n", x, y); 

} 

Đầu ra: 

Tang của -1,000000 là -1,557408 

Tang của 0.000000 là 0.000000 

tanh 

Mô tả: Tính hàm tang hyperbol của một độ chính xác gấp đôi nổi 


Bao gồm: 

Prototype: tanh kép (double x); 

Đối số: x giá trị mà trả lại tang hyperbol 

Quay trở lại giá trị: Trả về tang hyperbol của xin các phạm vi của -1 đến 1 bao 

gồm. 

Bình luận: Không có tên miền hoặc phạm vi lỗi sẽ xảy ra. 

Ví dụ: # include / * Cho tanh * / 



{ 

double x, y; 

x = -1,0; 

y = tanh (x); 

printf ("tang hyperbol của% f% f \ n \ n", 

x, y); 

x = 2,0; 

y = tanh (x); 


x, y); 

} 

Đầu ra: 

Tang hyperbol của -1,000000 là -,761594

The hyperbolic sine of 0.000000 is 0.000000 


sqrt 


Description: Calculates the square root of a double precision floating point 

value. 

Include: 

Prototype: double sqrt(double x); 

Argument: x a non-negative floating point value 

Return Value: Returns the non-negativesquare root of x.. 

Remarks: If xis negative, a domain error occurs. 

Example: #include /* for sqrt */ 




{ 

double x, y; 

errno = 0; 

x = 0.0; 

y = sqrt (x); 

if (errno) 


printf("The square root of %f is %f\n\n", x, y); 

errno = 0; 

x = 9.5; 

y = sqrt (x); 

if (errno) 



errno = 0; 

x = -25.0; 

y = sqrt (x); 

if (errno) 



} 

Output: 

The square root of 0.000000 is 0.000000 

The square root of 9.500000 is 3.082207 

Tang of2.000000 hyperbol là 0,964028 

TANF (Tiếp theo) 



tanhf 

Mô tả: Tính hàm tang hyperbol của một độ chính xác đơn nổi 


Bao gồm: 

Prototype: tanhf nổi (float x); 

Đối số: x giá trị mà trả lại tang hyperbol 

Quay trở lại giá trị: Trả về tang hyperbol của xin các phạm vi của -1 đến 1 bao 

gồm. 


Ví dụ: # include / * Cho tanhf * / 



{ 

float x, y; 

x = -1.0F; 

y = tanhf (x); 


x, y); 

x = 0.0f; 



x, y); 

} 

Đầu ra: 

Tang hyperbol của -1,000000 là -,761594 

Tang hyperbol của 0.000000 là 0.000000 

dsPIC 

® 



4.18 PIC30-libs 


Các chức năng sau đây là C chức năng trợ giúp thư viện chuẩn: 

• _exit chấm dứt thực hiện chương trình 

• brk thiết lập kết thúc của không gian dữ liệu của quá trình 

• gần đóng một tập tin 

• lseek di chuyển một con trỏ tập tin vào một vị trí quy định


The square root of -25.000000 is nan 

dsPIC 

® 



sqrtf 

Description: Calculates the square root of a single precision floating point value. 

Include: 

Prototype: float sqrtf(float x); 

Argument: x non-negative floating point value 

Return Value: Returns the non-negative square root of x. 

Remarks: If xis negative, a domain error occurs. 

Example: #include /* for sqrtf */ 




{ 

double x; 

errno = 0; 

x = sqrtf (0.0F); 

if (errno) 


printf("The square root of 0.0F is %f\n\n", x); 

errno = 0; 

x = sqrtf (9.5F); 

if (errno) 


printf("The square root of 9.5F is %f\n\n", x); 

errno = 0; 

x = sqrtf (-25.0F); 

if (errno) 


printf("The square root of -25F is %f\n", x); 

} 

Output: 

The square root of 0.0F is 0.000000 

The square root of 9.5F is 3.082207 


• mở mở một tập tin 

• đọc đọc dữ liệu từ một tập tin 

• sbrk mở rộng không gian dữ liệu của quá trình một tăng cho 

• ghi ghi dữ liệu vào một tập tin 

Các chức năng này được gọi là bởi các chức năng khác trong thư viện C chuẩn 

và phải được 

sửa đổi cho mục tiêu ứng dụng. Các mô-đun đối tượng tương ứng được phân 

phối tại 

các libpic30-omf.aarchive và mã nguồn (cho MPLAB C30) có sẵn trong 

src \ pic30folder. 

Ngoài ra, một số chức năng tiêu chuẩn thư viện C cũng phải được sửa đổi cho 

mục tiêu 

ứng dụng. Đó là: 

• getenv được một giá trị cho một biến môi trường 

• loại bỏ loại bỏ một tập tin 

• đổi tên đổi tên một tập tin hoặc thư mục 

• Hệ thống thực thi một lệnh 

• Thời gian có được thời gian hệ thống 

Mặc dù các chức năng này là một phần của thư viện C chuẩn, các mô-đun đối 

tượng là 

phân bố ở libpic30-omf.aarchive và mã nguồn (cho MPLAB C30) là 

có sẵn trong src \ pic30folder. Những module này không được phân phối như 

một phần của 

libc-omf.a. 

4.18.1 Xây dựng lại thư viện libpic30-omf.a 

Theo mặc định, chức năng trợ giúp được liệt kê trong chương này được viết để 

làm việc với 

sim30simulator. Các tập tin tiêu đề, simio.h, định nghĩa giao diện giữa các thư 

viện 

và giả lập. Nó được cung cấp để bạn có thể xây dựng lại các thư viện và tiếp tục 

sử dụng 

mô phỏng. Tuy nhiên, ứng dụng của bạn không nên sử dụng giao diện này kể từ 

khi mô phỏng 

sẽ không có sẵn cho một ứng dụng nhúng. 

Các chức năng trợ giúp phải được sửa đổi và xây dựng lại cho các ứng dụng 

mục tiêu của bạn. Các 

libpic30-omf.alibrary có thể được xây dựng lại với các tập tin thực thi có tên 

makelib.bat, 

đã được cung cấp với các nguồn trong src \ pic30. Thực hiện các tập tin thực th 

từ 

một cửa sổ lệnh. Hãy chắc chắn bạn đang ở trong src \ pic30directory. Sau đó 

sao chép các mới 

biên soạn tập tin (libpic30-omf.a) vào thư mục lib. 



4.18.2 Chức năng Mô tả

The square root of -25F is nan 



tan 

Description: Calculates the trigonometric tangent function of a double precision 


Include: 

Prototype: double tan (double x); 

Argument: x value for which to return the tangent 

Return Value: Returns the tangent of xin radians. 


Example: #include /* for tan*/ 




{ 

double x, y; 

errno = 0; 

x = -1.0; 

y = tan (x); 

if (errno) 


printf("The tangent of %f is %f\n\n", x, y); 

errno = 0; 

x = 0.0; 

y = tan (x); 

if (errno) 


printf("The tangent of %f is %f\n\n", x, y); 

} 

Output: 

The tangent of -1.000000 is -1.557408 

The tangent of 0.000000 is 0.000000 

tanf 

Description: Calculates the trigonometric tangentfunction of a single precision 

Phần này mô tả các chức năng mà phải được tùy biến cho hoạt động chính xác 

của 

Thư viện C chuẩn trong môi trường mục tiêu của bạn. Phần hành vi mặc định 

mô tả những gì các chức năng nào vì nó isdistributed. Mô tả và nhận xét 

mô tả những gì nó thường nên làm. 

_exit 

Mô tả: Chấm dứt thực hiện chương trình. 

Bao gồm: Không 

Prototype: void _exit (trạng thái int); 

Đối số: trạng thái thoát trạng thái 

Bình luận: Đây là một chức năng trợ giúp gọi bằng lối ra () Tiêu chuẩn Thư việ 

C 

chức năng. 

Hành vi mặc định: Khi phân phối, điều này bừng chức năng thiết bị xuất chuẩn 

và chấm dứt. Các 

tình trạng tham số là giống như được truyền cho xuất cảnh () tiêu chuẩn C 


File: _exit.c 

brk 

Mô tả: Thiết lập kết thúc của không gian dữ liệu của quá trình. 


Nguyên mẫu: int brk (void * endds) 

Đối số: endds con trỏ đến cuối đoạn dữ liệu 

Trở lại giá trị: Trả về "0" nếu thành công, '-1' nếu không. 

Bình luận: brk () được sử dụng để tự động thay đổi số lượng của không gian 

phân bổ cho 

đoạn dữ liệu quá trình kêu gọi của. Sự thay đổi này được thực hiện bằng cách 

đặt lại 

giá trị đột phá của quá trình và phân bổ số tiền thích hợp của 

không gian. Giá trị nghỉ là địa chỉ của địa điểm đầu tiên vượt ra ngoài 

kết thúc của đoạn dữ liệu. Số lượng phân bổ tăng không gian như 

tăng giá trị nghỉ. 

Gian được phân bổ mới chưa được định hình. 

Chức năng trợ giúp này được sử dụng bởi các chức năng thư viện chuẩn C 

malloc (). 

dsPIC 

® 





Include: 

Prototype: float tanf (float x); 

Argument: x value for which to return the tangent 

Hành vi mặc định: Nếu các đối số enddsis không, các chức năng thiết lập các 

biến toàn cầu 

__curbrkto địa chỉ của sự bắt đầu của heap, và trả về số không.

Return Value: Returns the tangent of x 


Example: #include /* for tanf */ 




{ 

float x, y; 

dsPIC 

® 


DS51456B-page 364 

errno = 0; 

x = -1.0F; 

y = tanf (x); 

if (errno) 



printf("The tangent of%f is %f\n\n", x, y); 

errno = 0; 

x = 0.0F; 

y = tanf (x); 

if (errno) 


printf("The tangent of %f is %f\n", x, y); 

} 

Output: 

The tangent of -1.000000 is -1.557408 

The tangent of 0.000000 is 0.000000 

tanh 

Description: Calculates the hyperbolic tangent function of a double precision 

floating 

point value. 

Include: 

Prototype: double tanh (double x); 

Argument: x value for which to return the hyperbolic tangent 

Return Value: Returns the hyperbolic tangent of xin the ranges of -1 to 1 

inclusive. 

Remarks: No domain or range error will occur. 

Example: #include /*for tanh */ 


Nếu các đối số enddsis khác không, và có giá trị ít hơn 

địa chỉ cuối của heap, các chức năng thiết lập các biến toàn cầu 

__curbrkto giá trị của enddsand trả về số không. 

Nếu không, các biến toàn cầu __curbrkis không thay đổi, và 

chức năng trả về -1. 

Đối số enddsmust nằm trong phạm vi đống (xem dữ liệu không gian 

bản đồ bộ nhớ dưới đây.) 

Chú ý rằng, kể từ khi chồng nằm ngay phía trên đống, 

sử dụng brk () hoặc sbrk () có ít ảnh hưởng đến kích thước của động 

bộ nhớ hồ bơi. Các brk () và sbrk () chức năng này được thiết kế chủ yếu 

để sử dụng trong môi trường thời gian chạy mà chồng phát triển và giảm 

đống phát triển đi lên. 

Các mối liên kết phân bổ một khối ofmemory cho đống nếu 

-Wl, - Đống = noption được xác định, nơi mà NIS kích thước heap mong muốn 

trong 

ký tự. Các bắt đầu và kết thúc địa chỉ của heap được báo cáo 

trong các biến _heapand _eheap, tương ứng. 

Đối với MPLAB C30, sử dụng tùy chọn kích thước heap của mối liên kết là 

cách tiêu chuẩn 

kiểm soát kích thước heap, hơn là dựa vào brk () và sbrk (). 

File: brk.c 

gần 

Mô tả: Đóng một tập tin. 


Nguyên mẫu: int gần (int xử lý); 

Đối số: xử lý việc xử lý đề cập đến một tập tin mở 

Trở lại giá trị: Trả về "0" nếu các tập tin được đóng thành công. Một giá trị trở 

lại của '-1' 

cho biết một lỗi. 

Bình luận: chức năng trợ giúp này được gọi là bởi fclose () Tiêu chuẩn Thư việ 

C 

chức năng. 

Hành vi mặc định: Khi phân phối, chức năng tập tin passesthe này xử lý để mô 

phỏng, 

trong đó đưa ra một chặt chẽ trong hệ thống tập tin host. 

File: close.c 

brk (Tiếp theo) 

PSV 

Chồng 

Heap 

biến 

SFR


{ 

double x, y; 

x = -1.0; 

y = tanh (x); 

printf("The hyperbolic tangent of %f is %f\n\n", 

x, y); 

x = 2.0; 

y = tanh (x); 


x, y); 

} 

Output: 

The hyperbolic tangent of -1.000000 is -0.761594 

The hyperbolic tangent of2.000000 is 0.964028 

tanf (Continued) 



tanhf 

Description: Calculates the hyperbolic tangent function of a single precision 

floating 

point value. 

Include: 

Prototype: float tanhf (float x); 

Argument: x value for which to return the hyperbolic tangent 

Return Value: Returns the hyperbolic tangent of xin the ranges of -1 to 1 

inclusive. 


Example: #include /* for tanhf */ 



{ 

float x, y; 

x = -1.0F; 





getenv 

Mô tả: Lấy một giá trị cho một biến môi trường 

Bao gồm: 

Prototype: char * getenv (const char * s); 

Đối số: tên của biến môi trường 

Quay trở lại giá trị: Trả về một con trỏ đến giá trị của biến môi trường nếu thàn 

công; 

nếu không, trả về một con trỏ null. 

Hành vi mặc định: Khi phân phối, chức năng này trả về một con trỏ null. Không 

có hỗ trợ 

cho các biến môi trường. 

File: getenv.c 

lseek 

Mô tả: Di chuyển con trỏ tập tin vào một vị trí quy định. 


Prototype: lseek dài (int xử lý, dài bù đắp, int nguồn gốc); 

Đối số: xử lý đề cập đến một tập tin mở 

bù đắp số ký tự từ gốc 

nguồn gốc vị trí mà từ đó để bắt đầu tìm kiếm. originmay được 

một trong các giá trị sau (theo quy định tại stdio.h): 

SEEK_SET - lúc bắt đầu của tập tin. 

SEEK_CUR - vị trí hiện tại của con trỏ tập tin. 

SEEK_END - Kết thúc tập tin. 

Quay trở lại giá trị: Trả về bù đắp, trong nhân vật, vị trí ofthe mới từ đầu 

của tập tin. Một giá trị trở lại của '-1L' chỉ ra một lỗi. 

Bình luận: chức năng trợ giúp này được gọi bởi các chức năng thư viện chuẩn C 

fgetpos (), ftell (), fseek (), fsetpos, và tua lại (). 

Hành vi mặc định: Khi phân phối, các thông số được truyền đến hệ thống máy 

chủ 

thông qua các mô phỏng. Giá trị trả về là giá trị được trả về bởi máy chủ 

hệ thống tập tin. 

File: lseek.c 

dsPIC 

® 


x, y); 

x = 0.0F; 




mở 

Mô tả: Mở một tập tin. 



x, y); 

} 

Output: 

The hyperbolic tangent of -1.000000 is -0.761594 

The hyperbolic tangent of 0.000000 is 0.000000 

dsPIC 

® 


DS51456B-page 366 

4.18 PIC30-LIBS 


The following functions are standard C library helper functions: 

• _exit terminate program execution 

• brk set the end of the process's data space 

• close close a file 

• lseek move a file pointer to a specified location 

• open open a file 

• read read data from a file 

• sbrk extend the process's data space by a given increment 

• write write data to a file 

These functions are called by other functions in the standard C library and must 

be 

modified for the target application. The corresponding object modules are 

distributed in 

the libpic30-omf.aarchive and the source code (for MPLAB C30) is available in 

the src\pic30folder. 

Additionally, several standard C library functions must also be modified for the 

target 

application. They are: 

• getenv get a value for an environment variable 

• remove remove a file 

• rename rename a file or directory 

• system execute a command 

• time get the system time 

Although these functions are part of the standard C library, the object modules 

are 

distributed in the libpic30-omf.aarchive and the source code (for MPLAB C30) 

is 

available in the src\pic30folder. These modules are not distributed as part of 

libc-omf.a. 

4.18.1 Rebuilding the libpic30-omf.a library 

By default, the helper functions listed in this chapter were written to work with 

the 

Nguyên mẫu: int mở (const char * name, int truy cập, int mode); 

Đối số: tên tên của tập tin sẽ được mở 

phương pháp truy cập truy cập để mở tập tin 


Quay trở lại giá trị: Nếu thành công, hàm trả về một tập tin xử lý, một số 

nguyên dương nhỏ. 

Xử lý này sau đó được sử dụng trên tiếp theo ở mức độ thấp tập tin I / O hoạt 

động. Một 

giá trị trả lại '-1' cho biết một lỗi. 

Bình luận: Việc tiếp cận lá cờ là một sự kết hợp của một ofthe phương pháp tru 

cập sau đây và 

không có hoặc có tiếp cận nhiều hơn vòng loại: 

0 - Mở một tập tin để đọc. 

1 - Mở một tập tin để viết. 

2 - Mở một tập tin cho cả đọc và viết. 

Vòng loại truy cập sau đây phải được hỗ trợ: 

0x0008 - Di chuyển con trỏ tập tin đến cuối tập tin trước khi tất cả các hoạt 

động viết. 

0x0100 - Tạo và mở một tập tin mới cho văn bản. 

0x0200 - Mở tập tin và cắt nó để không dài. 

0x4000 - Mở tập tin trong văn bản (dịch) chế độ. 

0x8000 - Mở tập tin trong hệ nhị phân (chưa dịch) chế độ. 

Tham số chế độ có thể beone những điều sau đây: 

0x0100 - Reading chỉ được cho phép. 

0x0080 - Viết được phép (ngụ ý reading cho phép). 

Chức năng trợ giúp này được gọi bởi các chức năng thư viện chuẩn C 

fopen () và freopen (). 


chủ 


hệ thống tập tin. Nếu hệ thống máy chủ trả về giá trị của '-1', biến toàn cầu 

errno được thiết lập để giá trị của biểu tượng liên tục trong EFOPENdefined 

. 

File: open.c 


đọc 


Mô tả: Đọc dữ liệu từ một tập tin. 


Nguyên mẫu: int read (int xử lý, void * đệm, 

int len); 

Đối số: xử lý xử lý đề cập toan file đã mở

sim30simulator. The header file, simio.h, defines the interface between the 

library 

and the simulator. It is provided so you can rebuild the libraries and continue to 

use the 

simulator. However, your application should not use this interface since the 

simulator 

will not be available to an embedded application. 

The helper functions must be modified and rebuilt for your target application. 

The 

libpic30-omf.alibrary can be rebuild with the batch file named makelib.bat, 

which has been provided with the sources in src\pic30. Execute the batch file 

from 

a command window. Be sure you are in the src\pic30directory. Then copy the 

newly 

compiled file (libpic30-omf.a) into the lib directory. 



4.18.2 Function Descriptions 

This section describes the functions that must be customized for correct 

operation of 

the Standard C Library in your target environment. The default behavior section 

describes what the function does as it isdistributed. The description and remarks 

describe what it typically should do. 

_exit 

Description: Terminate program execution. 

Include: None 

Prototype: void _exit (int status); 

Argument: status exit status 

Remarks: This is a helper function called by the exit()Standard C Library 

function. 

Default Behavior: As distributed, this function flushes stdout and terminates. 

The 

parameter status is the same as that passed to the exit()standard C 

library function. 

File: _exit.c 

brk 

Description: Set the end of the process's data space. 

Include: None 

Prototype: int brk(void *endds) 

Argument: endds pointer to the end of the data segment 

Return Value: Returns ‘0’ if successful, ‘-1’ if not. 

Remarks: brk()is used to dynamically change the amount of space allocated for 

điểm đệm để vị trí lưu trữ để đọc dữ liệu 

len số lượng tối đa của các nhân vật để đọc 

Quay trở lại giá trị: Trả về số charactersread, mà có thể ít hơn lenif 

có ít hơn lencharacters còn lại trong các tập tin hoặc các tập tin được 

mở trong chế độ văn bản, trong trường hợp mỗi vận chuyển trở lại-linefeed mà 

Cặp (CR-LF) được thay thế bằng một nhân vật linefeed duy nhất. Chỉ có 

nhân vật linefeed duy nhất được tính vào giá trị trả về. Các 

thay thế không ảnh hưởng đến con trỏ tập tin. Nếu chức năng cố gắng đọc 

ở cuối của tập tin, nó sẽ trả về "0". Nếu xử lý không hợp lệ, hoặc các tập tin 

không mở cửa 

để đọc, hoặc các tập tin bị khóa, hàm trả về '-1'. 

Bình luận: chức năng trợ giúp này được gọi bởi các chức năng thư viện chuẩn C 

fgetc (), fgets (), fread (), và được (). 


chủ 



File: read.c 

loại bỏ 

Mô tả: Xóa một tập tin. 

Bao gồm: 

Nguyên mẫu: int remove (const char * filename); 

Đối số: file tên tập tin phải được loại bỏ 

Trở lại giá trị: Trả về "0" nếu thành công, "- 1 'nếu không thành công. 


chủ 



File: remove.c 

đổi tên 

Mô tả: Đổi tên một tập tin hoặc thư mục. 

Bao gồm: 

Nguyên mẫu: int đổi tên (const char * oldname, const char 

* Newname); 

Đối số: con trỏ oldname thành tên cũ 

newname con trỏ sang tên mới 

Trở lại giá trị: Trả về "0" nếu nó là thành công. Trên một lỗi, hàm trả về một giá 

trị khác không 

giá trị. 


chủ 

thông qua các mô phỏng. Giá trị trả về là giá trị được trả về bởi máy chủ

the calling process's data segment. The change is made by resetting 

the process's break value and allocating the appropriate amount of 

space. The break value is the address of the first location beyond the 

end of the data segment. The amount of allocated space increases as 

the break value increases. 

Newly allocated space is uninitialized. 

This helper function is used by the Standard C Library function 

malloc(). 

dsPIC 

® 


DS51456B-page 368 


Default Behavior: If the argument enddsis zero, the function sets the global 

variable 

__curbrkto the address of the start of the heap, and returns zero. 

If the argument enddsis non-zero, and has a value less than the 

address of the end of the heap, the function sets the global variable 

__curbrkto the value of enddsand returns zero. 

Otherwise, the global variable __curbrkis unchanged, and the 

function returns -1. 

The argument enddsmust be within the heap range (see data space 

memory map below.) 

Notice that, since the stack is located immediately above the heap, 

using brk()or sbrk()has little effect on the size of the dynamic 

memory pool. The brk()and sbrk()functions are primarily intended 

for use in run-time environments where the stack grows downward and 

the heap grows upward. 

The linker allocates a block ofmemory for the heap if the 

-Wl,--heap=noption is specified, where nis the desired heap size in 

characters. The starting and ending addresses of the heap are reported 

in variables _heapand _eheap, respectively. 

For MPLAB C30, using the linker's heap size option is the standard way 

of controlling heap size, rather than relying on brk()and sbrk(). 

File: brk.c 

close 

Description: Close a file. 

Include: None 

Prototype: int close(int handle); 

Argument: handle handle referring to an opened file 


File: rename.c 

dsPIC 

® 



sbrk 


Mô tả: Mở rộng không gian dữ liệu của quá trình một tăng nhất định. 


Nguyên mẫu: void * sbrk (int incr); 

Đối số: số incr của các nhân vật để tăng / giảm 

Quay trở lại giá trị gia tăng: Quay trở lại sự bắt đầu của không gian mới phân 

bổ, hoặc '-1' lỗi. 

Bình luận: sbrk () cho biết thêm incrcharacters với giá trị phá vỡ và thay đổi 

phân bổ không gian cho phù hợp. incrcan được tiêu cực, trong trường hợp đó 

số lượng không gian được phân bổ được giảm. 

sbrk () được sử dụng để tự động thay đổi số lượng của không gian phân bổ 

cho phân đoạn dữ liệu của quá trình gọi. Sự thay đổi này được thực hiện bởi 

đặt lại giá trị đột phá của quá trình và phân bổ thích hợp 

số lượng không gian. Giá trị nghỉ là địa chỉ của địa điểm đầu tiên 

vượt ra ngoài kết thúc của đoạn dữ liệu. Số lượng không gian được phân bổ 

tăng như tăng giá trị nghỉ. 

Đây là một chức năng trợ giúp gọi bythe Thư viện chuẩn C chức năng 

malloc (). 

Hành vi mặc định: Nếu biến toàn cầu __curbrkis không, chức năng gọi brk () để 

khởi tạo giá trị nghỉ. Nếu brk () trả về -1, do đó, hiện chức năng này. 

Nếu incris không, giá trị hiện tại của __curbrkis biến toàn cầu 

trả lại. 

Nếu incris không, chức năng kiểm tra rằng địa chỉ 

(__curbrk + Incr) ít hơn so với địa chỉ cuối cùng của đống. Nếu đó là 

ít hơn, các biến toàn cầu __curbrkis cập nhật giá trị đó, và 

chức năng trả về giá trị unsigned của __curbrk. 

Nếu không, chức năng trả về -1. 

Xem mô tả các brk (). 

File: sbrk.c 

hệ thống 

Mô tả: Thực hiện một lệnh. 

Bao gồm: 

Nguyên mẫu: int hệ thống (const char * s); 

Đối số: s lệnh được thực thi.

Return Value: Returns ‘0’ if the file is successfully closed. A return value of ‘- 

1’ 

indicates an error. 

Remarks: This helper function is called by the fclose()Standard C Library 

function. 

Default Behavior: As distributed, this function passesthe file handle to the 

simulator, 

which issues a close in the host file system. 

File: close.c 

brk (Continued) 

PSV 

Stack 

Heap 

variables 

SFR 



getenv 

Description: Get a value for an environment variable 

Include: 

Prototype: char *getenv(const char *s); 

Argument: s name of environment variable 

Return Value: Returns a pointer to the value of the environment variable if 

successful; 

otherwise, returns a null pointer. 

Default Behavior: As distributed, this function returns a null pointer. There is no 

support 

for environment variables. 

File: getenv.c 

lseek 

Description: Move a file pointer to a specified location. 

Include: None 

Prototype: long lseek(int handle, long offset, int origin); 

Argument: handle refers to an opened file 

offset the number of characters from the origin 

origin the position from which to start the seek. originmay be 

one of the following values (as defined in stdio.h): 

SEEK_SET – Beginning of file. 

SEEK_CUR – Current position of file pointer. 

SEEK_END – End of file. 

Hành vi mặc định: Khi phân phối, chức năng này hoạt động như còn sơ khai 

hoặc giữ chỗ cho bạn 

chức năng. Nếu sis không phải là NULL, một thông báo lỗi được ghi vào thiết 

bị xuất chuẩn và 

chương trình sẽ thiết lập lại; cách khác, giá trị -1 được trả về. 

File: system.c 



thời gian 

Mô tả: Lấy thời gian hệ thống. 

Bao gồm: 

Nguyên mẫu: thời gian time_t (time_t * timer); 

Điểm hẹn giờ đến một địa điểm lưu trữ cho thời gian: Đối số 

Quay trở lại giá trị: Trả lại thời gian trôi qua trong vài giây. Không có lỗi lại. 

Hành vi mặc định: Khi phân phối, nếu Timer2 không được kích hoạt, nó được 

kích hoạt trong chế độ 32-bit. Các 

giá trị trả về là giá trị hiện tại của 32-bit Timer2 đăng ký. Ngoại trừ trong 

trường hợp rất hiếm, giá trị trả về đây không phải là thời gian trôi qua trong vài 

giây. 

File: time.c 

viết 

Mô tả: Viết dữ liệu vào một tập tin. 


Nguyên mẫu: int write (int xử lý, void * đệm, int 

tính); 

Đối số: xử lý đề cập đến một tập tin mở 

điểm đệm đến vị trí lưu trữ dữ liệu được ghi 

đếm số lượng các ký tự để viết. 

Quay trở lại giá trị: Nếu thành công, viết trả về số ký tự thực sự bằng văn 

bản. Một 

trở về giá trị của '-1'indicates một lỗi. 

Ghi chú: Nếu không gian thực tế còn lại trên đĩa nhỏ hơn kích thước của 

đệm chức năng đang cố gắng để ghi vào đĩa cứng, viết không thành công và 

không 

tuôn ra bất kỳ các nội dung của bộ đệm vào đĩa. Nếu tập tin được mở ra trong 

văn bản 

chế độ, mỗi nhân vật linefeed được thay thế bằng một trở về vận chuyển - 

cặp linefeed ở đầu ra. Việc thay thế không ảnh hưởng đến sự trở lại 

giá trị. 

Đây là một chức năng trợ giúp gọi bằng chức năng thư viện chuẩn C 

fflush (). 


chủ 

Return Value: Returns the offset, in characters, ofthe new position from the

eginning 

of the file. A return value of ‘-1L’ indicates an error. 

Remarks: This helper function is called by the Standard C Library functions 

fgetpos(), ftell(), fseek(), fsetpos, and rewind(). 

Default Behavior: As distributed, the parameters are passed to the host file 

system 

through the simulator. The return value is the value returned by the host 

file system. 

File: lseek.c 

dsPIC 

® 


DS51456B-page 370 

open 

Description: Open a file. 

Include: None 


Prototype: int open(const char *name, int access, int mode); 

Argument: name name of the file to be opened 

access access method to open file 


Return Value: If successful, the function returns a file handle, a small positive 

integer. 

This handle is then used on subsequent low-level file I/O operations. A 

return value of ‘-1’ indicates an error. 

Remarks: The access flag is a union of one ofthe following access methods and 

zero or more access qualifiers: 

0 – Open a file for reading. 

1 – Open a file for writing. 

2 – Open a file for both reading and writing. 

The following access qualifiers must be supported: 

0x0008 – Move file pointer to end of file before every write operation. 

0x0100 – Create and open a new file for writing. 

0x0200 – Open the file and truncate it to zero length. 

0x4000 – Open the file in text (translated) mode. 

0x8000 – Open the file in binary (untranslated) mode. 

The mode parameter may beone of the following: 

0x0100 – Reading only permitted. 

0x0080 – Writing permitted (implies reading permitted). 

This helper function is called by the Standard C Library functions 

fopen()and freopen(). 



File: write.c 

dsPIC 

® 



GHI CHÚ: 

dsPIC 


THƯ VIỆN 



Chương 5 MPLAB C30 Built-in chức năng 


Chương này mô tả MPLAB C30 tích infunctions được cụ thể cho dsPIC 

thiết bị. 

Chức năng được xây dựng trong cung cấp cho các lập trình viên C tiếp cận với 

các nhà khai thác lắp ráp hoặc máy 

hướng dẫn được hiện tại chỉ accessibleusing lắp ráp nội tuyến, nhưng là đủ 

hữu ích mà họ có thể áp dụng cho một loạt các ứng dụng. Chức năng được xây 

dựng trong là 

mã hóa trong các tập tin mã nguồn C cú pháp như các cuộc gọi chức năng, 

nhưng họ được biên dịch để 

mã lắp ráp trực tiếp thực hiện các chức năng, và không liên quan đến chức năng 

cuộc gọi 

hoặc thói quen thư viện. 

Có một số lý do tại sao cung cấp được xây dựng trong các chức năng được ưa 

chuộng hơn 

yêu cầu các lập trình viên sử dụng lắp ráp nội tuyến. Chúng bao gồm những 

điều sau đây: 

1 Cung cấp tích hợp chức năng cho các mục đích cụ thể đơn giản hóa mã hóa. 

2. Một số opitmizations bị vô hiệu hóa khi lắp ráp nội tuyến được sử dụng. Đây 

không phải là 

trường hợp cho xây dựng trong chức năng. 

3. Để được hướng dẫn đăng ký sử dụng máy chuyên dụng, mã hóa lắp ráp nội 

tuyến 

trong khi tránh lỗi giao đăng ký có thể yêu cầu chăm sóc đáng kể. Các 

tích hợp chức năng làm cho quá trình này đơn giản là bạn không cần phải được 

quan tâm 

với các yêu cầu đăng ký riêng cho từng hướng dẫn máy tính cá nhân. 


• Danh sách Chức năng Built-In 

• Được xây dựng trong chức năng thông báo lỗi 

dsPIC


system 

® 





file system. If the host system returns a value of ‘-1’, the global variable 

errno is set to the value of the symbolic constant EFOPENdefined in 

. 

File: open.c 



read 

Description: Read data from a file. 

Include: None 

Prototype: int read(int handle, void * buffer, 

unsigned int len); 

Argument: handle handle referring toan opened file 

buffer points to the storage location for read data 

len the maximum number of characters to read 

Return Value: Returns the number of charactersread, which may be less than 

lenif 

there are fewer than lencharacters left in the file or if the file was 

opened in text mode, in which case each carriage return-linefeed 

(CR-LF) pair is replaced with a single linefeed character. Only the 

single linefeed character is counted in the return value. The 

replacement does not affect the file pointer. If the function tries to read 

at end of file, it returns ‘0’. If the handle is invalid, or the file is not open 

for reading, or the file is locked, the function returns ‘-1’. 

Remarks: This helper function is called by the Standard C Library functions 

fgetc(), fgets(), fread(), and gets(). 


system 


file system. 

File: read.c 

remove 

Description: Remove a file. 

Include: 

Prototype: int remove(const char *filename); 

Argument: filename file to be removed 

Return Value: Returns ‘0’ if successful,‘-1’ if unsuccessful. 


system 

5.2 Xây-IN DANH SÁCH CHỨC NĂNG 

Phần này mô tả các giao diện lập trình để trình biên dịch MPLAB C30 C được 

xây dựng trong 

chức năng. Kể từ khi chức năng này được "xây dựng trong", không có tập tin 

tiêu đề liên quan 

chúng. Tương tự như vậy, không có thiết bị chuyển mạch dòng lệnh liên quan 

đến việc tích hợp 

chức năng - họ luôn có sẵn. Tên chức năng được xây dựng trong được lựa chọn 

như vậy mà 

họ thuộc về không gian tên của trình biên dịch (tất cả đều có __builtin_ tiền tố) 

do đó 

họ sẽ không xung đột với các chức năng hoặc tên biến trong không gian tên của 

lập trình viên. 

__builtin_divsd 

Mô tả: Chức năng tính toán thương num / den. Một ngoại lệ lỗi toán học 

xảy ra nếu denis không. Đối số chức năng được ký kết, như là chức năng 

kết quả. Các tùy chọn dòng lệnh -Wconversionscan được sử dụng để 

phát hiện chuyển đổi tín hiệu không mong muốn. 

Nguyên mẫu: int __builtin_divsd (num dài const, const int den); 

Đối số: num tử số 

mẫu den 

Quay trở lại giá trị: Trả về giá trị số nguyên có chữ ký của các thương num / 

den. 

Assembler 

Điều hành / Máy 

Hướng dẫn: 

div.sd 

__builtin_divud 

Mô tả: Chức năng tính toán thương num / den. Một ngoại lệ lỗi toán học 

xảy ra nếu denis không. Chức năng argumentsare unsigned, như là 

chức năng kết quả. Các tùy chọn dòng lệnh được -Wconversionscan 

được sử dụng để phát hiện các dấu hiệu chuyển đổi bất ngờ. 

Nguyên mẫu: int __builtin_divud (const unsigned 

num dài, const int den); 

Đối số: num tử số 

mẫu den 

Quay trở lại giá trị: Trả về integervalue unsigned của các thương num / den. 

Assembler 


Hướng dẫn:


file system. 

File: remove.c 

rename 

Description: Rename a file or directory. 

Include: 

Prototype: int rename(const char *oldname, const char 

*newname); 

Argument: oldname pointer to the old name 

newname pointer to the new name 

Return Value: Returns ‘0’ if it is successful. On an error, the function returns a 

nonzero 

value. 


system 


file system. 

File: rename.c 

dsPIC 

® 


DS51456B-page 372 

sbrk 


Description: Extend the process's data space by a given increment. 

Include: None 

Prototype: void * sbrk(int incr); 

Argument: incr number of characters to increment/decrement 

Return Value: Return the start of the new space allocated, or ‘-1’ for errors. 

Remarks: sbrk()adds incrcharacters to the break value and changes the 

allocated space accordingly. incrcan be negative, in which case the 

amount of allocated space is decreased. 

sbrk()is used to dynamically change the amount of space allocated 

for the calling process's data segment. The change is made by 

resetting the process's break value and allocating the appropriate 

amount of space. The break value is the address of the first location 

beyond the end of the data segment. The amount of allocated space 

increases as the break value increases. 

This is a helper function called bythe Standard C Library function 

malloc(). 

Default Behavior: If the global variable __curbrkis zero, the function calls 

div.ud 

__builtin_mulss 

Mô tả: Chức năng tính toán p1 p0x sản phẩm. Đối số chức năng là 

ký số nguyên, và kết quả chức năng là một số nguyên dài đã ký kết. Các 

tùy chọn-Wconversionscan dòng lệnh được sử dụng để phát hiện 

chuyển đổi tín hiệu không mong muốn. 

Prototype: ký __builtin_mulss dài (const int ký p0, 

const ký int p1); 

Đối số: p0 nhơn 

p1 nhân 

Quay trở lại giá trị: Trả về giá trị số nguyên dài ký của p1 p0x sản phẩm. 

Assembler 



mul.ss 

MPLAB C30 Built-in chức năng 


__builtin_mulsu 


số nguyên có dấu hiệu hỗn hợp, và kết quả chức năng là một ký dài 

số nguyên. Các tùy chọn-Wconversionscan dòng lệnh được sử dụng để 

phát hiện chuyển đổi tín hiệu không mong muốn. Chức năng này hỗ trợ đầy đủ 

phạm vi giải quyết modesof hướng dẫn, bao gồm cả ngay lập tức 

chế độ cho toán hạng p1. 

Prototype: ký __builtin_mulsu dài (const int ký p0, 

const int p1); 


p1 nhân 


Assembler 



mul.su 

__builtin_mulus 


số nguyên có dấu hiệu hỗn hợp, và kết quả chức năng là một ký dài 

số nguyên. Các tùy chọn-Wconversionscan dòng lệnh được sử dụng để 

phát hiện chuyển đổi tín hiệu không mong muốn. Chức năng này hỗ trợ đầy đủ 

phạm vi giải quyết modesof hướng dẫn.

k()to 

initialize the break value. If brk()returns -1, so does this function. 

If the incris zero, the current value of the global variable __curbrkis 

returned. 

If the incris non-zero, the function checks that the address 

(__curbrk+ incr) is less than the end address of the heap. If it is 

less, the global variable __curbrkis updated to that value, and the 

function returns the unsigned value of __curbrk. 

Otherwise, the function returns -1. 

See the description of brk(). 

File: sbrk.c 

system 

Description: Execute a command. 

Include: 

Prototype: int system(const char *s); 

Argument: s command to be executed. 

Default Behavior: As distributed, this function acts as a stub or placeholder for 

your 

function. If sis not NULL, an error message is written to stdout and the 

program will reset; otherwise, a value of -1 is returned. 

File: system.c 



time 

Description: Get the system time. 

Include: 

Prototype: time_t time(time_t *timer); 

Argument: timer points to a storage location for time 

Return Value: Returns the elapse time in seconds. There is no error return. 

Default Behavior: As distributed, if timer2 is not enabled,it is enabled in 32-bit 

mode. The 

return value is the current value of the 32-bit timer2 register. Except in 

very rare cases, this return value is not the elapsed time in seconds. 

File: time.c 

write 

Description: Write data to a file. 

Include: None 

Prototype: int write(int handle, void *buffer, unsigned int 

count); 

Argument: handle refers to an opened file 

Prototype: ký __builtin_mulus dài (const int p0, 

const ký int p1); 


p1 nhân 


Assembler 



mul.us 

__builtin_muluu 


số nguyên unsigned, và kết quả chức năng là một số nguyên dài không dấu. 

Các tùy chọn-Wconversionscan dòng lệnh được sử dụng để phát hiện 

chuyển đổi tín hiệu không mong muốn. Chức năng này hỗ trợ đầy đủ các 

giải quyết các chế độ của các hướng dẫn, bao gồm cả chế độ ngay lập tức cho 

toán hạng p1. 

Prototype: unsigned __builtin_muluu dài (const int p0, 

const int p1); 


p1 nhân 


Assembler 



mul.uu 

dsPIC 

® 



__builtin_tblpage 

Mô tả: Chức năng trả về số trang bảng của đối tượng mà 

địa chỉ được đưa ra như một tham số. Đối số pmust là địa chỉ 

của một đối tượng trong một dữ liệu EE, PSV hay không gian bộ nhớ thực thi; 

nếu không một thông báo lỗi được sản xuất và biên soạn không. Xem 

các spaceattribute trong MPLAB® 

Hướng dẫn C30 C Compiler của người dùng. 

Nguyên mẫu: int __builtin_tblpage (const void * p); 

Đối số: p địa chỉ đối tượng 

Quay trở lại giá trị: Trả về số trang bảng của đối tượng có địa chỉ được cho là

uffer points to the storage location of data to be written 

count the number of characters to write. 

Return Value: If successful, write returns the number of characters actually 

written. A 

return value of ‘-1’indicates an error. 

Remarks: If the actual space remaining on the disk is less than the size of the 

buffer the function is trying to write to the disk, write fails and does not 

flush any of the buffer's contents to the disk. If the file is opened in text 

mode, each linefeed character is replaced with a carriage return – 

linefeed pair in the output. The replacement does not affect the return 

value. 

This is a helper function called by the Standard C Library function 

fflush(). 


system 


file system. 

File: write.c 

dsPIC 

® 


một tham số. 

Assembler 



tblpage 

__builtin_tbloffset 

Mô tả: Chức năng trả về trang bảng bù đắp của các đối tượng có địa chỉ 

được đưa ra như một tham số. Đối số pmust là địa chỉ của một 

đối tượng trong một dữ liệu EE, PSV hay không gian bộ nhớ thực thi; nếu 

không một 

thông báo lỗi được sản xuất và biên soạn không. Xem không gian 

thuộc tính trong MPLAB® 


Nguyên mẫu: int __builtin_tbloffset (const void * p); 


Quay trở lại giá trị: Trả về số trang bảng offsetof đối tượng có địa chỉ là 

được coi là một tham số. 

Assembler 



tbloffset 

DS51456B-page 374 

NOTES: 

dsPIC 


__builtin_psvpage 

Mô tả: Chức năng trả về số trang PSV của đối tượng có địa chỉ 

được đưa ra như một tham số. Đối số pmust là địa chỉ của một 


LIBRARIES 


Chapter 5. MPLAB C30 Built-in Functions 


This chapter describes the MPLAB C30 built-infunctions that are specific to 

dsPIC 

devices. 

Built-in functions give the C programmer access to assembler operators or 

machine 

instructions that are currently only accessibleusing inline assembly, but are 

sufficiently 

useful that they are applicable to a broad range of applications. Built-in 

functions are 

coded in C source files syntactically like function calls, but they are compiled to 

assembly code that directly implements the function, and do not involve 

function calls 

or library routines. 


không một 




Nguyên mẫu: int __builtin_psvpage (const void * p); 


Quay trở lại giá trị: Trả về số trang PSV của đối tượng có địa chỉ được đưa ra 

như một 

tham số. 

Assembler 



psvpage 

MPLAB C30 Built-in chức năng 


5.3 CHỨC NĂNG THÔNG ĐIỆP LỖI Xây-IN

There are a number of reasons why providing built-in functions is preferable to 

requiring programmers to use inline assembly. They include the following: 

1. Providing built-in functions for specific purposes simplifies coding. 

2. Certain opitmizations are disabled when inline assembly is used. This is not 

the 

case for built-in functions. 

3. For machine instructions that use dedicated registers, coding inline assembly 

while avoiding register allocation errors can require considerable care. The 

built-in functions make this process simpler as you do not need to be concerned 

with the particular register requirements for each individual machine 

instruction. 


• Built-In Function List 

• Built-In Function Error Messages 

dsPIC 

® 


DS51456B-page 376 

5.2 BUILT-IN FUNCTION LIST 


This section describes the programmer interface to the MPLAB C30 C compiler 

built-in 

functions. Since the functions are “built in”, there are no header files associated 

with 

them. Similarly, there are no command-line switches associated with the built-in 

functions – they are always available. The built-in function names are chosen 

such that 

they belong to the compiler's namespace (they all have the prefix __builtin_), so 

they will not conflict with function or variable names in the programmer's 

namespace. 

__builtin_divsd 

Description: The function computes the quotient num/ den. A math error 

exception 

occurs if denis zero. Function arguments are signed, as is the function 

result. The command-line option -Wconversionscan be used to 

detect unexpected sign conversions. 

Prototype: int __builtin_divsd(const long num, const int den); 

Argument: num numerator 

den denominator 

Return Value: Returns the signed integer value of the quotient num/ den. 

Assembler 

Operator / Machine 

Instruction: 

Các thông báo lỗi sau đây được tạo ra khi các chức năng tích hợp được sử dụng 

không chính xác. 

Tham số để __builtin_function () không phải là địa chỉ của một đối tượng trong 

mã, PSV, hoặc phần EEDATA 

Đối số cho các chức năng tích hợp sau đây phải là một địa chỉ đối tượng rõ 

ràng: 

• __builtin_tblpage 

• __builtin_tbloffset 

• __builtin_psvpage 

• __builtin_psvoffset 

Ví dụ, nếu objis đối tượng trong một phần thực thi hoặc chỉ đọc, cú pháp sau 

có giá trị: 

unsigned trang = __builtin_function (& obj); 

__builtin_psvoffset 

Mô tả: Chức năng trả về trang PSV bù đắp của các đối tượng có địa chỉ là 

được coi là một tham số. Đối số pmust là địa chỉ của một 


không một 




Nguyên mẫu: int __builtin_psvoffset (const void * p); 


Quay trở lại giá trị: Trả về số trang PSV offsetof đối tượng có địa chỉ là 

được coi là một tham số. 

Assembler 



psvoffset 

__builtin_return_address 

Mô tả: Chức năng này trả về địa chỉ trả về của hàm hiện tại, hoặc của 

một trong những người gọi của nó. Đối với levelargument một giá trị từ 0 sản 

lượng 

địa chỉ trả về của hàm hiện nay, giá trị sản lượng 1 sự trở lại 

địa chỉ của người gọi của chức năng hiện tại, và vv. Khi mức độ 

vượt quá chiều sâu ngăn xếp hiện tại, 0 sẽ được trả lại. Chức năng này 

chỉ nên được sử dụng với một đối số khác không cho mục đích gỡ lỗi. 

Nguyên mẫu: int __builtin_return_address (const mức int); 

Đối số: mức Số khung để quét lên gọi chồng. 

Quay trở lại giá trị: Trả về địa chỉ trả về của hàm hiện tại, hoặc của một trong 

của nó

div.sd 

__builtin_divud 

Description: The function computes the quotient num/ den. A math error 

exception 

occurs if denis zero. Function argumentsare unsigned, as is the 

function result. The command-line option -Wconversionscan be 

used to detect unexpected sign conversions. 

Prototype: unsigned int __builtin_divud(const unsigned 

người gọi. 

Assembler 



return_address 

dsPIC 

® 


long num, const unsigned int den); 

Argument: num numerator 

den denominator 


GHI CHÚ: 

dsPIC 


Return Value: Returns the unsigned integervalue of the quotient num/ den. 

Assembler 


Instruction: 

div.ud 

__builtin_mulss 

Description: The function computes the product p0x p1. Function arguments are 

signed integers, and the function result is a signed long integer. The 

command-line option-Wconversionscan be used to detect 

unexpected sign conversions. 

Prototype: signed long __builtin_mulss(const signed int p0, 

const signed int p1); 

Argument: p0 multiplicand 

p1 multiplier 

Return Value: Returns the signed long integer value of the product p0x p1. 

Assembler 


Instruction: 

mul.ss 

MPLAB C30 Built-in Functions 


__builtin_mulsu 


integers with mixed signs, and the function result is a signed long 

integer. The command-line option-Wconversionscan be used to 

detect unexpected sign conversions. This function supports the full 

range of addressing modesof the instruction, including immediate 


THƯ VIỆN 


Phụ lục A. ASCII Character Set 

BẢNG A-1: ASCII CHARACTER SET 

Hầu hết các nhân vật quan trọng 

Nhân vật quan trọng nhất 

Hex01234567 

0 NUL DLE Space 0 @ P 'p 

1 SOH DC1! 1 AQ aq 

2 STX DC2 "2 BR br 

3 ETX DC3 # 3 CS cs 

4 EOT DC4 $ 4 DT dt 

5 ENQ NAK 5% EU eu 

6ACKSYN & 6 FV FV 

7BellETB '7 GW GW 

8BSCAN (8 HX hx 

9HTEM) 9 IY iy 

ALFSUB *: JZ jz 

BVTESC +; K [k { 

CFFFS, N ^ n ~ 

FSIUS / O_ Odel? 

dsPIC 

® 


mode for operand p1. 



Prototype: signed long __builtin_mulsu(const signed int p0, 

const unsigned int p1); 


p1 multiplier 


Assembler 


Instruction: 

mul.su 

__builtin_mulus 


integers with mixed signs, and the function result is a signed long 

integer. The command-line option-Wconversionscan be used to 

detect unexpected sign conversions. This function supports the full 

range of addressing modesof the instruction. 

Prototype: signed long __builtin_mulus(const unsigned int p0, 

const signed int p1); 


p1 multiplier 


Assembler 


Instruction: 

mul.us 

__builtin_muluu 


unsigned integers, and the function result is an unsigned long integer. 

The command-line option-Wconversionscan be used to detect 

unexpected sign conversions. This function supports the full range of 

addressing modes of the instruction, including immediate mode for 

operand p1. 

Prototype: unsigned long __builtin_muluu(const unsigned int p0, 

const unsigned int p1); 


p1 multiplier 


Assembler 


Instruction: 

GHI CHÚ: 

dsPIC 


THƯ VIỆN 


Chỉ số 

Biểu tượng 

# xác định ..................... 10, 74, 76, 99, 106, 147, 163, 185 

# nếu ................................................ ........................... 211 

# include ................................................ ....... 10, 74, 194 

%, Phần trăm ...................................... 254, 259, 260, 323 

-, Dash ............................................... .................... 260 

\ F, mẫu thức ăn ............................................. ............ 201 

\ N, dòng mới ............... 201, 225, 235, 240, 251, 252, 256 

\ R, vận chuyển trở lại ............................................. 201 .... 

\ T, ngang Tab ............................................. ....... 201 

\ V, dọc Tab ............................................. .......... 201 

^, Caret ............................................... .................... 260 

__builtin_divsd ................................................. ...... 376 

__builtin_divud ................................................. ...... 376 

__builtin_mulss ................................................. ..... 376 

__builtin_mulsu ................................................. ..... 377 

__builtin_mulus ................................................. ..... 377 

__builtin_muluu ................................................. ..... 377 

__builtin_psvoffset ................................................. 379 

__builtin_psvpage ................................................. . 378 

__builtin_return_address ....................................... 379 

__builtin_tbloffset ................................................. 378 .. 

__builtin_tblpage ................................................. 378 ... 

__FILE__ ................................................. .............. 195 

__LINE__ ................................................. .............. 195 

_exit ................................................. ...................... 367 

_IOFBF ................................................. ..226, 261, 262 

_IOLBF ................................................. ........... 226, 262 

_IONBF ................................................. ..226, 261, 262 

_MathError ................................................. ............ 219 

_NSETJMP ................................................. ........... 214 

Numerics 

0x ................................................. ... 202, 253, 291, 292

mul.uu 

dsPIC 

® 


DS51456B-page 378 

__builtin_tblpage 


Description: The function returns the table page number of the object whose 

address is given as a parameter. The argument pmust be the address 

of an object in an EE data, PSV or executable memory space; 

otherwise an error message is produced and the compilation fails. See 

the spaceattribute in the MPLAB® 

C30 C Compiler User’s Guide. 

Prototype: unsigned int __builtin_tblpage(const void *p); 

Argument: p object address 

Return Value: Returns the table page number of the object whose address is 

given as 

a parameter. 

Assembler 


Instruction: 

tblpage 

__builtin_tbloffset 

Description: The function returns the table page offset of the object whose 

address 

is given as a parameter. The argument pmust be the address of an 

object in an EE data, PSV or executable memory space; otherwise an 

error message is produced and the compilation fails. See the space 

attribute in the MPLAB® 


Prototype: unsigned int __builtin_tbloffset(const void *p); 


Return Value: Returns the table page number offsetof the object whose address 

is 

given as a parameter. 

Assembler 


Instruction: 

tbloffset 

__builtin_psvpage 

Description: The function returns the psv page number of the object whose 

address 

Một 

Chấm dứt bất thường Tín hiệu ................................. 216 

hủy bỏ ................................................. ............... 195, 271 

abs ................................................. ........................ 272 

Giá trị tuyệt đối 

Đôi Floating Point ..................................... 339 

Integer ................................................. ............ 272 

Long Integer ................................................ 282 .... 

Độc Floating Point ....................................... 339 

Giá trị tuyệt đối Chức năng 

abs ................................................. ................. 272 

fabs ................................................. ................ 339 

fabsf ................................................. ............... 339 

phòng thí nghiệm ................................................. ................ 282 

Chế độ truy cập 

................................................. Nhị phân ............. 236 

Văn bản ................................................. ................ 236 

AckI2C ................................................. ................... 184 

acos ................................................. ....................... 325 

acosf ................................................. ...................... 326 

ADC, 10-Bit 

................................................. Bận rộn ............... 102 

Đóng ................................................. .............. 102 

Cấu hình ngắt .......................................... 102 

Vô hiệu hóa ngắt Macro ................................... 107 

Kích hoạt tính năng ngắt Macro ................................... 107 

Ví dụ sử dụng ............................................... 108 

Mở ................................................. .............. 103 

Đọc ................................................. .............. 106 

Thiết lập kênh ................................................ 106 .... 

Thiết lập ngắt PriorityMacro ............................. 107 

Bắt đầu chuyển đổi ............................................. 103 

Dừng lấy mẫu ................................................ . 106 

ADC, 12-Bit 

................................................. Bận rộn ................. 95 

Đóng ................................................. ................ 95 

Cấu hình ngắt ............................................ 95 

Vô hiệu hóa ngắt Macro ................................... 100 

Kích hoạt tính năng ngắt Macro ................................... 100

is given as a parameter. The argument pmust be the address of an 





Prototype: unsigned int __builtin_psvpage(const void *p); 


Return Value: Returns the psv page number of the object whose address is given 

as a 

parameter. 

Assembler 


Instruction: 

psvpage 

MPLAB C30 Built-in Functions 


5.3 BUILT-IN FUNCTION ERROR MESSAGES 

The following error messages are produced when the built-in functions are used 

incorrectly. 

Argument to __builtin_function() is not the address of an object in 

code, psv, or eedata section 

The argument to the following built-in functions must be an explicit object 

address: 

• __builtin_tblpage 

• __builtin_tbloffset 

• __builtin_psvpage 

• __builtin_psvoffset 

For example, if objis object in an executable or read-only section, the following 

syntax 

is valid: 

unsigned page = __builtin_function(&obj); 

__builtin_psvoffset 

Description: The function returns the psv page offset of the object whose 

address is 

given as a parameter. The argument pmust be the address of an 





Prototype: unsigned int __builtin_psvoffset(const void *p); 


Ví dụ sử dụng ............................................... 101 

Mở ................................................. ................ 96 

Đọc ................................................. ................ 99 

Thiết lập kênh ................................................ ...... 99 

Thiết lập ngắt PriorityMacro ............................. 100 

Bắt đầu chuyển đổi ............................................... 96 

Dừng lấy mẫu ................................................ 99 ... 

Cấp phát bộ nhớ ................................................ 284 .... 

calloc ................................................. .............. 278 

Miễn phí ................................................. ................ 281 

realloc ................................................. ............ 287 

Ký tự chữ cái 

Xác định ................................................. ........... 196 

Kiểm tra cho ................................................ ............ 196 

Kí tự 

Xác định ................................................. ........... 196 

Kiểm tra cho ................................................ ............ 196 

AM / PM ............................................... .................... 323 

Nối ................................................. .......... 300, 306 

arccosine 

Đôi Floating Point ...................................... 325 


arcsine 



arctangent 



dsPIC 

® 



arctangent của y / x 



Danh sách tham số .................................. 221, 267, 268, 269 

Thông báo lỗi số học ....................................... 216 

ASCII Character Set ............................................... 381 

asctime ................................................. .................. 318

Return Value: Returns the psv page number offsetof the object whose address is 

given as a parameter. 

Assembler 


Instruction: 

psvoffset 

__builtin_return_address 

Description: This function returns the return address of the current function, or 

of 

one of its callers. For the levelargument, a value of 0 yields the 

return address of the current function, a value of 1 yields the return 

address of the caller of the current function, and so forth. When level 

exceeds the current stack depth, 0 will be returned. This function 

should only be used with a non-zero argument for debugging purposes. 

Prototype: int __builtin_return_address (const int level); 

Argument: level Number of frames to scan up the call stack. 

Return Value: Returns the the return address of the current function, or of one of 

its 

callers. 

Assembler 


Instruction: 

return_address 

dsPIC 

® 


DS51456B-page 380 

NOTES: 

dsPIC 


LIBRARIES 



Appendix A. ASCII Character Set 

TABLE A-1: ASCII CHARACTER SET 

Most Significant Character 

Least Significant Character 

Hex01234567 

0 NUL DLE Space 0 @ P ‘ p 

1 SOH DC1 ! 1 A Q a q 

2 STX DC2 " 2 B R b r 

asin ................................................. ........................ 327 

asinf ................................................. ....................... 327 

khẳng định ................................................. .................... 195 

assert.h ............................................... ................... 195 

Phân Ngăn chặn ........................................ 259 

Asterisk ................................................. ......... 253, 259 

atan ................................................. ....................... 328 

atan2 ................................................. ..................... 329 

atan2f ................................................. .................... 331 

atanf ................................................. ...................... 329 

atexit ................................................. .............. 272, 280 

atof ................................................. ........................ 274 

atoi ................................................. ........................ 275 

atol ................................................. ........................ 275 

B 

BartlettInit ................................................. ................ 26 

Cơ sở ................................................. .............. 291, 292 

10 ............................. 207, 208, 209, 210, 350, 351 

2 ................................................. ..................... 209 

e ................................................. ............. 349, 352 

FLT_RADIX .............. 206, 207, 208, 209, 210, 211 

Nhị phân 

Cơ sở ................................................. ............... 209 

Chế độ ................................................. ...... 236, 264 

Tìm kiếm ................................................. ............ 276 

Suối ................................................. .......... 225 

Bitfields ................................................. .................. 224 

BitReverseComplex ................................................. . 60 

BlackmanInit ................................................. ............ 27 

BORStatReset ................................................. ....... 119 

brk ................................................. ................. 367, 372 

bsearch ................................................. ................. 276 

Dung lượng bộ đệm ................................................ ...... 226, 262 

BufferEmptyDCI ................................................. 150 .... 

Chế độ đệm ................................................ ..... 262 

Đệm, Đệm SeeFile 

BUFSIZ ................................................. ......... 226, 261 

Được xây dựng trong chức năng 

__builtin_divsd ................................................ 376

3 ETX DC3 # 3 C S c s 

4 EOT DC4 $ 4 D T d t 

5 ENQ NAK % 5 E U e u 

6ACKSYN& 6 F V f v 

7BellETB’ 7 G W g w 

8BSCAN( 8 H X h x 

9HTEM) 9 I Y i y 

ALFSUB* : J Z j z 

BVTESC+ ; K [ k { 

CFFFS , < L \ l | 

DCRGS- =M]m} 

ESORS . > N ^ n ~ 

FSIUS/ ?O_ oDEL 

dsPIC 

® 



NOTES: 

dsPIC 


LIBRARIES 


Index 

Symbols 

#define .....................10, 74, 76, 99, 106, 147, 163, 185 

#if ........................................................................... 211 

#include.......................................................10, 74, 194 

%, Percent ...................................... 254, 259, 260, 323 

-, Dash ................................................................... 260 

\f, Form Feed ......................................................... 201 

\n, Newline ...............201, 225, 235, 240, 251, 252, 256 

\r, Carriage Return ................................................. 201 

\t, Horizontal Tab.................................................... 201 

\v, Vertical Tab ....................................................... 201 

^, Caret................................................................... 260 

__builtin_divsd ....................................................... 376 

__builtin_divud ....................................................... 376 

__builtin_mulss ...................................................... 376 

__builtin_mulsu ...................................................... 377 

__builtin_divud ................................................ 376 

__builtin_mulss ............................................... 376 

__builtin_mulsu ............................................... 377 

__builtin_mulus ............................................... 377 

__builtin_muluu ............................................... 377 

__builtin_psvoffset .......................................... 379 

__builtin_psvpage ........................................... 378 

__builtin_return_address ................................ 379 

__builtin_tbloffset ............................................ 378 

__builtin_tblpage ............................................. 378 

BusyADC10 ................................................. ........... 102 

BusyADC12 ................................................. ............. 95 

BusyUartx ................................................. .............. 141 

BusyXLCD ................................................. ............... 75 

C 

C Locale ................................................ ......... 196, 213 

Lịch Thời gian ......................... 317, 319, 320, 322, 324 

calloc ................................................. ............. 278, 281 

THỂ Ngắt 

Cấu hình ................................................. .......... 91 

Vô hiệu hóa Macro ................................................ 92 ... 

Kích hoạt tính năng Macro ................................................ 92 .... 

Đặt ưu tiên Macro .............................................. 92 

CAN, Ví dụ sử dụng ............................................. . 93 

CANxAbortAll ................................................. .......... 81 

CANxGetRXErrorCount ............................................ 81 

CANxGetTXErrorCount ............................................ 82 

CANxInitialize ................................................. .......... 90 

CANxIsBusOff ................................................. ......... 82 

CANxIsRXPassive ................................................. 83 ... 

CANxIsRXReady ................................................. ..... 82 

CANxIsTXPassive ................................................. 83 ... 

CANxIsTXReady ................................................. ..... 84 

CANxRecieveMessage ............................................ 84 

CANxSendMessage ................................................. 85 

CANxSetFilter ................................................. .......... 86 

CANxSetMask ................................................. ......... 86 

CANxSetOperationMode .......................................... 87 

CANxSetOperationModeNoWait .............................. 88

__builtin_mulus ...................................................... 377 

__builtin_muluu...................................................... 377 

__builtin_psvoffset ................................................. 379 

__builtin_psvpage .................................................. 378 

__builtin_return_address ....................................... 379 

__builtin_tbloffset ................................................... 378 

__builtin_tblpage.................................................... 378 

__FILE__ ............................................................... 195 

__LINE__ ............................................................... 195 

_exit ....................................................................... 367 

_IOFBF ...................................................226, 261, 262 

_IOLBF............................................................226, 262 

_IONBF ...................................................226, 261, 262 

_MathError ............................................................. 219 

_NSETJMP ............................................................ 214 

Numerics 

0x .................................................... 202, 253, 291, 292 

A 

Abnormal Termination Signal................................. 216 

abort................................................................195, 271 

abs ......................................................................... 272 

Absolute Value 

Double Floating Point ..................................... 339 

Integer............................................................. 272 

Long Integer.................................................... 282 

Single Floating Point....................................... 339 

Absolute Value Function 

abs .................................................................. 272 

fabs ................................................................. 339 

fabsf ................................................................ 339 

labs ................................................................. 282 

Access Mode 

Binary.............................................................. 236 

Text................................................................. 236 

AckI2C.................................................................... 184 

acos........................................................................ 325 

acosf....................................................................... 326 

ADC, 10-Bit 

Busy ................................................................ 102 

CANxSetRXMode ................................................. 88 .... 

CANxSetTXMode ................................................. 89 .... 

Caret (^) .............................................. .................... 260 

Vận chuyển trở lại ................................................ ...... 201 

ceil ................................................. ......................... 332 

ceilf ................................................. ........................ 333 

trần 



char 

Giá trị tối đa .............................................. 211 

Giá trị tối thiểu ............................................... 211 

Số Bits ............................................... . 211 

CHAR_BIT ................................................. ............. 211 

CHAR_MAX ................................................. .......... 211 

CHAR_MIN ................................................. ............ 211 

Nhân vật mảng ................................................ ...... 260 

Trường hợp bản đồ nhân vật 

Trường hợp thấp hơn nhân vật chữ cái .................. 203 

Trường hợp chữ cái trên nhân vật .................. 204 

Trường hợp bản đồ nhân vật chức năng 

ToLower ................................................. ............ 203 

toupper ................................................. ........... 204 

Xử lý nhân vật, Seectype.h 

Character Input / Output Chức năng 

fgetc ................................................. ............... 233 

fgets ................................................. ............... 235 

fputc ................................................. ............... 239 

fputs ................................................. ............... 239 

getc ................................................. ................ 250 

getchar ................................................. ........... 251 

được ................................................. ................ 251 

putc ................................................. ................ 255 

putchar ................................................. ........... 256 

đặt ................................................. ................ 256 

ungetc ................................................. ............ 265 

Chỉ số 


Kiểm tra nhân vật

Close............................................................... 102 

Configure Interrupt.......................................... 102 

Disable Interrupt Macro................................... 107 

Enable Interrupt Macro ................................... 107 

Example of Use............................................... 108 

Open ............................................................... 103 

Read ............................................................... 106 

Set Channel .................................................... 106 

Set Interrupt PriorityMacro ............................. 107 

Start Conversion ............................................. 103 

Stop Sampling................................................. 106 

ADC, 12-Bit 

Busy .................................................................. 95 

Close................................................................. 95 

Configure Interrupt............................................ 95 

Disable Interrupt Macro................................... 100 

Enable Interrupt Macro ................................... 100 

Example of Use............................................... 101 

Open ................................................................. 96 

Read ................................................................. 99 

Set Channel ...................................................... 99 

Set Interrupt PriorityMacro ............................. 100 

Start Conversion ............................................... 96 

Stop Sampling................................................... 99 

Allocate Memory .................................................... 284 

calloc............................................................... 278 

Free................................................................. 281 

realloc ............................................................. 287 

Alphabetic Character 

Defined............................................................ 196 

Test for ............................................................ 196 

Alphanumeric Character 

Defined............................................................ 196 

Test for ............................................................ 196 

AM/PM ................................................................... 323 

Append........................................................... 300, 306 

arccosine 

Double Floating Point...................................... 325 

Single Floating Point ....................................... 326 

Ký tự chữ cái ...................................... 196 

Kí tự ................................. 196 

Điều khiển nhân vật ........................................... 197 

Chữ số thập phân ................................................ 198 ... 

Nhân vật đồ họa ........................................ 198 

Chữ số thập lục phân ........................................... 202 

Trường hợp thấp hơn nhân vật chữ cái .................. 199 

Nhân vật có thể in ......................................... 200 

Dấu phân cách nhân vật .................................... 200 

Trường hợp chữ cái trên nhân vật .................. 202 

Trắng không gian nhân vật .................................. 201 

Chức năng kiểm tra nhân vật 

isalnum ................................................. .......... 196 

isalpha ................................................. ........... 196 

iscntrl ................................................. ............. 197 

isdigit ................................................. .............. 198 

isgraph ................................................. ........... 198 

islower ................................................. ............ 199 

isprint ................................................. ............. 200 

ispunct ................................................. ........... 200 

isspace ................................................. ........... 201 

isupper ................................................. ........... 202 

isxdigit ................................................. ............ 202 

Nhân vật 

Chữ cái ................................................. ...... 196 

Chữ và số ................................................. . 196 

Kiểm soát ................................................. ........... 197 

Chuyển đổi sang Hạ Trường hợp chữ cái ................. 203 

Chuyển đổi sang Upper Case chữ cái ................. 204 

Chữ số thập phân ................................................ 198 ... 

................................................. Đồ họa ....... 198 

Chữ số thập lục phân ........................................... 202 

Thấp hơn trường hợp chữ cái ................................... 199 

................................................. Có thể in ......... 200 

Dấu chấm câu ................................................. 200 .... 

Trường hợp chữ cái trên ................................... 202 

Trắng-Space ............................................... 201 .... 

Nhân vật phân loại ........................................... 196 

clearerr ................................................. .................. 229

arcsine 



arctangent 



dsPIC 

® 



arctangent of y/x 



Argument List ..................................221, 267, 268, 269 

Arithmetic Error Message....................................... 216 

ASCII Character Set............................................... 381 

asctime ................................................................... 318 

asin......................................................................... 327 

asinf........................................................................ 327 

assert ..................................................................... 195 

assert.h .................................................................. 195 

Assignment Suppression........................................ 259 

Asterisk .......................................................... 253, 259 

atan ........................................................................ 328 

atan2 ...................................................................... 329 

atan2f ..................................................................... 331 

atanf ....................................................................... 329 

atexit............................................................... 272, 280 

atof ......................................................................... 274 

atoi ......................................................................... 275 

atol ......................................................................... 275 

B 

BartlettInit ................................................................. 26 

Base ............................................................... 291, 292 

10 ............................. 207, 208, 209, 210, 350, 351 

2 ...................................................................... 209 

e .............................................................. 349, 352 

FLT_RADIX.............. 206, 207, 208, 209, 210, 211 

Binary 

Lỗi thanh toán bù trừ chỉ số .......................................... 229 

đồng hồ ................................................. ...................... 318 

clock_t ................................................. ............ 317, 318 

CLOCKS_PER_SEC ............................................. 317 

gần ................................................. ...................... 368 

CloseADC10 ................................................. ......... 102 

CloseADC12 ................................................. ........... 95 

CloseCapturex ................................................. ...... 125 

CloseDCI ................................................. ............... 150 

CloseI2C ................................................. ............... 183 

CloseINTx ................................................. ............. 120 

CloseMCPWM ................................................. ....... 171 

CloseOCx ................................................. .............. 131 

CloseQEI ................................................. ............... 166 

CloseSPIx ................................................. ............. 158 

CloseTimerx ................................................. .......... 109 

CloseTimerxx ................................................. ........ 109 

CloseUARTx ................................................. ......... 141 

Định nghĩa phổ biến, Seestddef.h 

So sánh Strings ................................................ 302 .... 

So sánh chức năng ...................................... 276, 286 

Chức năng so sánh 

memcmp ................................................. ........ 295 

strcmp ................................................. ............ 302 

strcoll ................................................. .............. 303 

strncmp ................................................. .......... 308 

strxfrm ................................................. ............ 316 

Tùy chọn trình biên dịch 

-fno-ngắn đôi ............................................ . 225 

-msmart-io .............................................. ......... 225 

Chức năng nối 

strcat ................................................. .............. 300 

strncat ................................................. ............ 306 

ConfigCNPullups ................................................. 122 ... 

ConfigIntADC10 ................................................. 102 .... 

ConfigIntADC12 ................................................. ...... 95 

ConfigIntCANx ................................................. ........ 91 

ConfigIntCapturex ................................................. . 126 

ConfigIntCN ................................................. ........... 122

Base................................................................ 209 

Mode ....................................................... 236, 264 

Search............................................................. 276 

Streams........................................................... 225 

Bitfields................................................................... 224 

BitReverseComplex.................................................. 60 

BlackmanInit............................................................. 27 

BORStatReset........................................................ 119 

brk .................................................................. 367, 372 

bsearch .................................................................. 276 

Buffer Size...................................................... 226, 262 

BufferEmptyDCI ..................................................... 150 

Buffering Modes ..................................................... 262 

Buffering, SeeFile Buffering 

BUFSIZ .......................................................... 226, 261 

Built-In Functions 

__builtin_divsd ................................................ 376 

__builtin_divud ................................................ 376 

__builtin_mulss ............................................... 376 

__builtin_mulsu ............................................... 377 

__builtin_mulus ............................................... 377 

__builtin_muluu............................................... 377 

__builtin_psvoffset .......................................... 379 

__builtin_psvpage ........................................... 378 

__builtin_return_address ................................ 379 

__builtin_tbloffset ............................................ 378 

__builtin_tblpage............................................. 378 

BusyADC10............................................................ 102 

BusyADC12.............................................................. 95 

BusyUartx............................................................... 141 

BusyXLCD................................................................ 75 

C 

C Locale ......................................................... 196, 213 

Calendar Time.........................317, 319, 320, 322, 324 

calloc .............................................................. 278, 281 

CAN Interrupts 

Configure........................................................... 91 

Disable Macro ................................................... 92 

Enable Macro .................................................... 92 

ConfigIntDCI ................................................. .......... 151 

ConfigIntI2C ................................................. .......... 183 

ConfigIntlOCx ................................................. ........ 132 

ConfigIntMCPWM ................................................. . 171 

ConfigIntQEI ................................................. .......... 166 

ConfigIntSpIx ................................................. ......... 158 

ConfigIntTimerx ................................................. ..... 110 

ConfigIntTimerxx ................................................. 111 ... 

ConfigIntUARTx ................................................. 142 .... 

ConfigINTx ................................................. ............ 121 

Điều khiển nhân vật 

Xác định ................................................. ........... 197 

Kiểm tra cho ................................................ ............ 197 

Chuyển điều khiển ................................................ 214 ... 

Chuyển đổi .............................................. 253, 259 , 263 

Chuyển đổi 

Nhân vật để nhân vật multibyte .................... 293 

Ký tự nhiều byte Character rộng ........... 285 

Chuỗi nhiều byte để rộng chuỗi ký tự ....... 285 

String để đôi Floating Point ............... 274, 289 

String để Integer .............................................. 275 

Chuỗi Long Integer ............................. 275, 291 

String để Unsigned LongInteger ..................... 292 

Để Hạ Trường hợp chữ cái nhân vật ............. 203 

Để Upper Case chữ cái nhân vật ............. 204 

Character rộng chuỗi toMultibyte chuỗi ....... 293 

ConvertADC10 ................................................. ...... 103 

ConvertADC12 ................................................. ........ 96 

Chức năng sao chép 

memcpy ................................................. ......... 297 

memmove ................................................. ...... 298 

memset ................................................. .......... 299 

strcpy ................................................. ............. 303 

strncpy ................................................. ........... 309 

cos ................................................. ......................... 333 

cosf ................................................. ........................ 334 

CosFactorInit ................................................. ........... 61 

cosh ................................................. ....................... 335 

coshf ................................................. ...................... 336

Set Priority Macro.............................................. 92 

CAN, Example of Use .............................................. 93 

CANxAbortAll ........................................................... 81 

CANxGetRXErrorCount............................................ 81 

CANxGetTXErrorCount............................................ 82 

CANxInitialize ........................................................... 90 

CANxIsBusOff .......................................................... 82 

CANxIsRXPassive.................................................... 83 

CANxIsRXReady...................................................... 82 

CANxIsTXPassive .................................................... 83 

CANxIsTXReady ...................................................... 84 

CANxRecieveMessage............................................ 84 

CANxSendMessage ................................................. 85 

CANxSetFilter........................................................... 86 

CANxSetMask .......................................................... 86 

CANxSetOperationMode.......................................... 87 

CANxSetOperationModeNoWait .............................. 88 

CANxSetRXMode..................................................... 88 

CANxSetTXMode ..................................................... 89 

Caret (^).................................................................. 260 

Carriage Return...................................................... 201 

ceil .......................................................................... 332 

ceilf ......................................................................... 333 

ceiling 



char 

Maximum Value .............................................. 211 

Minimum Value ............................................... 211 

Number of Bits ................................................ 211 

CHAR_BIT.............................................................. 211 

CHAR_MAX ........................................................... 211 

CHAR_MIN............................................................. 211 

Character Array ...................................................... 260 

Character Case Mapping 

Lower Case Alphabetic Character .................. 203 

Upper Case Alphabetic Character .................. 204 

Character Case Mapping Functions 

tolower............................................................. 203 

cosin 



dsPIC 

® 



crt0, crt1 ............................................... ...................... 8 

ctime ................................................. ...................... 319 

ctype.h ............................................... ..................... 196 

isalnum ................................................. ........... 196 

iscntrl ................................................. .............. 197 

isdigit ................................................. .............. 198 

isgraph ................................................. ........... 198 

islapha ................................................. ............ 196 

islower ................................................. ............ 199 

iSpring ................................................. ............ 200 

ispunct ................................................. ............ 200 

isspace ................................................. ........... 201 

isupper ................................................. ........... 202 

isxdigit ................................................. ............ 202 

ToLower ................................................. ........... 203 

toupper ................................................. ........... 204 

Đối số hiện tại ................................................ 221 ... 

Dịch vụ thông báo khách hàng .................................... 5 

Hỗ trợ khách hàng ................................................ ...... 6 

Chức năng tùy chỉnh .............................................. 281 

D 

Dấu gạch ngang (-) .............................................. .................... 260 

DataRdyDCI ................................................. .......... 151 

DataRdyI2C ................................................. ........... 184 

DataRdySPIx ................................................. ......... 159 

DataRdyUARTx ................................................. ..... 143 

Thời gian ............................................... ......... 322 

Thời gian chức năng, Seetime.h 

Ngày tháng ..................................... 317, 318, 322 

Ngày trong tuần ...................................... 317, 318, 322 

Ngày của năm .............................................. 317, 323 

Daylight Savings Time ............................. 317, 320, 321

toupper ............................................................ 204 

Character Handling, Seectype.h 

Character Input/Output Functions 

fgetc ................................................................ 233 

fgets ................................................................ 235 

fputc ................................................................ 239 

fputs ................................................................ 239 

getc ................................................................. 250 

getchar ............................................................ 251 

gets ................................................................. 251 

putc ................................................................. 255 

putchar ............................................................ 256 

puts ................................................................. 256 

ungetc ............................................................. 265 

Index 


Character Testing 

Alphabetic Character...................................... 196 

Alphanumeric Character ................................. 196 

Control Character ........................................... 197 

Decimal Digit................................................... 198 

Graphical Character........................................ 198 

Hexadecimal Digit........................................... 202 

Lower Case Alphabetic Character .................. 199 

Printable Character ......................................... 200 

Punctuation Character .................................... 200 

Upper Case Alphabetic Character .................. 202 

White-Space Character .................................. 201 

Character Testing Functions 

isalnum ........................................................... 196 

isalpha ............................................................ 196 

iscntrl .............................................................. 197 

isdigit............................................................... 198 

isgraph ............................................................ 198 

islower............................................................. 199 

isprint .............................................................. 200 

ispunct ............................................................ 200 

isspace............................................................ 201 

isupper ............................................................ 202 

DBL_DIG ................................................. ............... 206 

DBL_EPSILON ................................................. ...... 206 

DBL_MANT_DIG ................................................. 206 ... 

DBL_MAX ................................................. ............. 206 

DBL_MAX_10_EXP ............................................... 207 

DBL_MAX_EXP ................................................. 207 .... 

DBL_MIN ................................................. ............... 207 

DBL_MIN_10_EXP ................................................ 207 

DBL_MIN_EXP ................................................. ..... 208 

DCI chức năng 

Đóng DCI ................................................ ........ 150 

Cấu hình DCI ................................................ . 151 

Cấu hình DCI ngắt ................................... 151 

DCI RX đệm trạng ...................................... 151 

DCI TX đệm trạng ...................................... 150 

Ví dụ sử dụng ............................................... 156 

Đọc DCI RX đệm ........................................ 154 

Viết DCI TX đệm ........................................ 154 

DCI Macros 

Vô hiệu hoá DCI ngắt ...................................... 155 

Kích hoạt tính năng ngắt DCI ....................................... 155 

Đặt ưu tiên DCI ngắt ................................. 155 

DCT ................................................. ......................... 61 

DCTIP ................................................. ..................... 63 

Deallocate bộ nhớ ........................................ 281, 287 

lỗi gỡ lỗi lôgic ............................................ 195 

Số thập phân ........................................... 254, 260, 291, 292 

Chữ số thập phân 

Xác định ................................................. ........... 198 

Số ....................................... 206, 208, 209 

Kiểm tra cho ................................................ ............ 198 

Điểm số thập phân ................................................ ......... 253 

Mặc định Handler ................................................ ...... 215 

Chẩn đoán, Seeassert.h 

difftime ................................................. ................... 320 

Chữ số, số thập phân, chữ số SeeDecimal 

Chữ số, thập lục phân, chữ số SeeHexadecimal 

Đầu vào trực tiếp / Chức năng đầu ra 

fread ................................................. ............... 240

isxdigit............................................................. 202 

Characters 

Alphabetic ....................................................... 196 

Alphanumeric .................................................. 196 

Control ............................................................ 197 

Convert to Lower Case Alphabetic ................. 203 

Convert to Upper Case Alphabetic ................. 204 

Decimal Digit................................................... 198 

Graphical ........................................................ 198 

Hexadecimal Digit........................................... 202 

Lower Case Alphabetic ................................... 199 

Printable.......................................................... 200 

Punctuation..................................................... 200 

Upper Case Alphabetic ................................... 202 

White-Space ................................................... 201 

Classifying Characters........................................... 196 

clearerr ................................................................... 229 

Clearing Error Indicator .......................................... 229 

clock ....................................................................... 318 

clock_t.............................................................317, 318 

CLOCKS_PER_SEC ............................................. 317 

close....................................................................... 368 

CloseADC10 .......................................................... 102 

CloseADC12 ............................................................ 95 

CloseCapturex ....................................................... 125 

CloseDCI................................................................ 150 

CloseI2C ................................................................ 183 

CloseINTx .............................................................. 120 

CloseMCPWM........................................................ 171 

CloseOCx............................................................... 131 

CloseQEI................................................................ 166 

CloseSPIx .............................................................. 158 

CloseTimerx ........................................................... 109 

CloseTimerxx ......................................................... 109 

CloseUARTx .......................................................... 141 

Common Definitions, Seestddef.h 

Compare Strings .................................................... 302 

Comparison Function......................................276, 286 

Comparison Functions 

fwrite ................................................. ............... 248 

DisableCNx ................................................. ........... 123 

DisableIntADC ................................................ 100 107 

DisableIntCANx ................................................. ....... 92 

DisableIntDCI ................................................. ........ 155 

DisableInterrupts ................................................. 119 ... 

DisableIntFLTA ................................................. ...... 180 

DisableIntFLTB ................................................. ...... 181 

DisableIntlC1 ................................................. ......... 129 

DisableIntlUxRX ................................................. 147 .... 

DisableIntMCPWM ................................................. 180 

DisableIntMI2C ................................................. ...... 190 

DisableIntOCx ................................................. ....... 139 

DisableIntQEI ................................................. ........ 169 

DisableIntSI2C ................................................. ...... 191 

DisableIntSPIx ................................................. ....... 163 

DisableIntTx ................................................. .......... 115 

DisableIntUxTX ................................................. ..... 148 

DisableINTx ................................................. ........... 124 

div ................................................. .................. 270, 278 

div_t ................................................. ....................... 270 

Chia 

Integer ................................................. ............ 278 

Long Integer ................................................ 283 .... 

Chia Zero ........................................ 216, 219, 278 

Tài liệu 

Giao diện ................................................. ................ 2 

Tài liệu 

Ước ................................................. ....... 3 

Lỗi miền .......................... 205, 325, 326, 327, 329, 

............................ 331, 333, 334, 341, 343, 349, 350, 

............................. 351, 352, 357, 358, 361, 362, 363 

dot ................................................. ......................... 253 

Đôi chính xác dấu chấm động 

Máy Epsilon .............................................. 206 

Exponent tối đa (10 cơ sở) ........................ 207 

Exponent tối đa (cơ sở 2) .......................... 207 

Giá trị tối đa .............................................. 206 

Tối thiểu Exponent (10 cơ sở) ......................... 207

memcmp ......................................................... 295 

strcmp ............................................................. 302 

strcoll............................................................... 303 

strncmp ........................................................... 308 

strxfrm ............................................................. 316 

Compiler Options 

-fno-short-double............................................. 225 

-msmart-io....................................................... 225 

Concatenation Functions 

strcat ............................................................... 300 

strncat ............................................................. 306 

ConfigCNPullups.................................................... 122 

ConfigIntADC10 ..................................................... 102 

ConfigIntADC12 ....................................................... 95 

ConfigIntCANx ......................................................... 91 

ConfigIntCapturex .................................................. 126 

ConfigIntCN............................................................ 122 

ConfigIntDCI........................................................... 151 

ConfigIntI2C ........................................................... 183 

ConfigIntlOCx......................................................... 132 

ConfigIntMCPWM .................................................. 171 

ConfigIntQEI........................................................... 166 

ConfigIntSpIx.......................................................... 158 

ConfigIntTimerx...................................................... 110 

ConfigIntTimerxx .................................................... 111 

ConfigIntUARTx ..................................................... 142 

ConfigINTx ............................................................. 121 

Control Character 

Defined............................................................ 197 

Test for ............................................................ 197 

Control Transfers ................................................... 214 

Conversion ..............................................253, 259, 263 

Convert 

Character to Multibyte Character .................... 293 

Multibyte Character to Wide Character ........... 285 

Multibyte String to Wide Character String....... 285 

String to Double Floating Point ............... 274, 289 

String to Integer .............................................. 275 

String to Long Integer ............................. 275, 291 

Tối thiểu Exponent (cơ sở 2) ........................... 208 


Số chữ số nhị phân .................................. 206 

Số thập phân chữ số ............................... 206 

đôi Loại ................................................ ............ 225 

Chức năng mơ ................................................ ...... 253 

Thư viện DSP ................................................ ............. 9 

dsPIC Thư viện ngoại vi ....................................... 73 

Chỉ số 


E 

EDOM ................................................. ................... 205 

đôm ................................................. ..................... 325 

Bầu dục (...) ............................................ ......... 221, 260 

File nhị phân rỗng ............................................... 236 .... 

Rỗng Text File ............................................... ....... 236 

EnableCNx ................................................. ............ 123 

EnableIntADC ................................................. 100, 107 

EnableIntCANx ................................................. ....... 92 

EnableIntDCI ................................................. ......... 155 

EnableIntFLTA ................................................. ...... 180 

EnableIntFLTB ................................................. ...... 181 

EnableIntlCx ................................................. .......... 129 

EnableIntlUxTX ................................................. ..... 147 

EnableIntMCPWM ................................................. 180 

EnableIntMI2C ................................................. ...... 190 

EnableIntOCx ................................................. ........ 139 

EnableIntQEI ................................................. ......... 169 

EnableIntSI2C ................................................. ....... 191 

EnableIntSPIx ................................................. ....... 163 

EnableIntTx ................................................. ........... 115 

EnableIntUxRX ................................................. ..... 147 

EnableINTx ................................................. ........... 123 

End Of tập tin ............................................... .............. 227 

Chỉ số ................................................. ......... 225 

Tìm kiếm ................................................. ............... 244 

Kiểm tra Đối với ................................................ .......... 231 

Chức năng môi trường 

getenv ................................................. ............ 281

String to Unsigned LongInteger ..................... 292 

To Lower Case Alphabetic Character ............. 203 

To Upper Case Alphabetic Character ............. 204 

Wide Character String toMultibyte String....... 293 

ConvertADC10 ....................................................... 103 

ConvertADC12 ......................................................... 96 

Copying Functions 

memcpy .......................................................... 297 

memmove ....................................................... 298 

memset ........................................................... 299 

strcpy .............................................................. 303 

strncpy ............................................................ 309 

cos.......................................................................... 333 

cosf......................................................................... 334 

CosFactorInit............................................................ 61 

cosh........................................................................ 335 

coshf....................................................................... 336 

cosine 



dsPIC 

® 



crt0, crt1 ..................................................................... 8 

ctime....................................................................... 319 

ctype.h.................................................................... 196 

isalnum............................................................ 196 

iscntrl............................................................... 197 

isdigit............................................................... 198 

isgraph ............................................................ 198 

islapha............................................................. 196 

islower ............................................................. 199 

ispring ............................................................. 200 

ispunct............................................................. 200 

isspace............................................................ 201 

isupper ............................................................ 202 

isxdigit ............................................................. 202 

tolower ............................................................ 203 

Biến môi trường ............................................. 369 

EOF ................................................. ....................... 227 

ERANGE ................................................. ............... 205 

erange ................................................. ................... 325 

errno ................................................. ............... 205, 325 

errno.h ............................................... ...... 205, 325, 370 

EDOM ................................................. ............ 205 

ERANGE ................................................. ........ 205 

errno ................................................. .............. 205 

Mã lỗi ................................................ ..... 205, 305 

Điều kiện lỗi ................................................ ..... 325 

Lỗi Handler ................................................ ......... 278 

Chức năng Xử lý lỗi 

clearerr ................................................. ........... 229 

feof ................................................. ................. 231 

ferror ................................................. .............. 232 

perror ................................................. ............. 252 

Lỗi Chỉ ................................................ ........ 225 

Các chỉ số lỗi 

Thanh toán bù trừ ................................................. ..229, 258 

End Of tập tin ............................................... 229, 235 

Lỗi ................................................. ........ 229, 235 

Kiểm tra Đối với ................................................ .......... 232 

Các thông báo lỗi, xây dựng trong chức năng ........................ 379 

Lỗi tín hiệu ................................................ ............ 215 

Lỗi, Seeerrno.h 

Lỗi, kiểm tra Đối với .............................................. 205 ... 

Ví dụ sử dụng 

ADC, 10-Bit ............................................. ........ 108 

ADC, 12-Bit ............................................. ........ 101 

CAN ................................................. ................. 93 

DCI ................................................. ................. 156 

I2C ................................................. ................. 192 

Input Capture ................................................ 130 .. 

So sánh sản lượng ............................................. 140 

PWM ................................................. .............. 182 

Chức năng QEI ................................................ . 170 

SPI ................................................. ................. 164 

Thời Gian ................................................. ............ 116

toupper ............................................................ 204 

Current Argument................................................... 221 

Customer Notification Service .................................... 5 

Customer Support ...................................................... 6 

Customized Function.............................................. 281 

D 

Dash (-) .................................................................. 260 

DataRdyDCI ........................................................... 151 

DataRdyI2C............................................................ 184 

DataRdySPIx.......................................................... 159 

DataRdyUARTx...................................................... 143 

Date and Time........................................................ 322 

Date and Time Functions, Seetime.h 

Day of the Month.....................................317, 318, 322 

Day of the Week......................................317, 318, 322 

Day of the Year .............................................. 317, 323 

Daylight Savings Time.............................317, 320, 321 

DBL_DIG................................................................ 206 

DBL_EPSILON....................................................... 206 

DBL_MANT_DIG.................................................... 206 

DBL_MAX .............................................................. 206 

DBL_MAX_10_EXP ............................................... 207 

DBL_MAX_EXP ..................................................... 207 

DBL_MIN................................................................ 207 

DBL_MIN_10_EXP ................................................ 207 

DBL_MIN_EXP ...................................................... 208 

DCI Functions 

Close DCI........................................................ 150 

Configure DCI ................................................. 151 

Configure DCI Interrupt................................... 151 

DCI RX Buffer Status ...................................... 151 

DCI TX Buffer Status...................................... 150 

Example of Use............................................... 156 

Read DCI RX Buffer........................................ 154 

Write DCI TX Buffer........................................ 154 

DCI Macros 

Disable DCI Interrupt...................................... 155 

Enable DCI Interrupt....................................... 155 

Set DCI Interrupt Priority ................................. 155 

UART ................................................. ............. 149 

Ngoại lệ Lỗi ................................................ ...... 278 

thoát ........................................... 264, 270, 272, 280, 367 

EXIT_FAILURE ................................................. ..... 270 

EXIT_SUCCESS ................................................. 270 ... 

exp ................................................. ........................ 337 

expf ................................................. ....................... 338 

Chức năng theo cấp số nhân và Logarithmic 

exp ................................................. ................. 337 

expf ................................................. ................ 338 

frexp ................................................. ............... 344 

frexpf ................................................. .............. 345 

ldexp ................................................. .............. 346 

ldexpf ................................................. ............. 347 

đăng nhập ................................................. .................. 349 

log10 ................................................. .............. 350 

log10f ................................................. ............. 351 

logf ................................................. ................. 352 

modf ................................................. ............... 353 

modff ................................................. .............. 354 

hàm mũ 



F 

fabs ................................................. ....................... 339 

fabsf ................................................. ...................... 339 

fclose ................................................. ............. 230, 368 

feof ................................................. ................ 229, 231 

ferror ................................................. .............. 229, 232 

fflush ................................................. .............. 233, 373 

FFTComplex ................................................. ........... 64 

FFTComplexIP ................................................. ........ 66 

fgetc ................................................. .............. 233, 371 

fgetpos ................................................. .......... 234, 369 

fgets ................................................. .............. 235, 371 

Chiều rộng ................................................ ............. 253 

FILE ................................................. ............... 225, 226 

Chức năng truy cập file 

fclose ................................................. .............. 230

DCT.......................................................................... 61 

DCTIP ...................................................................... 63 

Deallocate Memory........................................ 281, 287 

debugging logic errors............................................ 195 

Decimal ...........................................254, 260, 291, 292 

Decimal Digit 

Defined............................................................ 198 

Number Of....................................... 206, 208, 209 

Test for ............................................................ 198 

Decimal Point ......................................................... 253 

Default Handler ...................................................... 215 

Diagnostics, Seeassert.h 

difftime.................................................................... 320 

Digit, Decimal, SeeDecimal Digit 

Digit, Hexadecimal, SeeHexadecimal Digit 

Direct Input/Output Functions 

fread ................................................................ 240 

fwrite................................................................ 248 

DisableCNx ............................................................ 123 

DisableIntADC................................................ 100, 107 

DisableIntCANx ........................................................ 92 

DisableIntDCI ......................................................... 155 

DisableInterrupts .................................................... 119 

DisableIntFLTA....................................................... 180 

DisableIntFLTB....................................................... 181 

DisableIntlC1 .......................................................... 129 

DisableIntlUxRX ..................................................... 147 

DisableIntMCPWM ................................................. 180 

DisableIntMI2C....................................................... 190 

DisableIntOCx ........................................................ 139 

DisableIntQEI ......................................................... 169 

DisableIntSI2C ....................................................... 191 

DisableIntSPIx........................................................ 163 

DisableIntTx ........................................................... 115 

DisableIntUxTX ...................................................... 148 

DisableINTx............................................................ 124 

div................................................................... 270, 278 

div_t........................................................................ 270 

Divide 

fflush ................................................. .............. 233 

fopen ................................................. .............. 236 

freopen ................................................. ........... 242 

setbuf ................................................. ............. 261 

setvbuf ................................................. ........... 262 

Tập tin truy cập chế độ ......................................... 225, 236 

Tập tin bộ nhớ đệm 

Đệm đầy đủ .......................................... 225, 226 

Dòng Buffered ........................................... 225, 226 

Unbuffered .............................................. 225, 226 

Hoạt động tập tin 

Hủy bỏ ................................................. .......... 257 

Đổi tên ................................................. ......... 257 

dsPIC 

® 



Chức năng định vị tập tin 

fgetpos ................................................. ........... 234 

fseek ................................................. .............. 244 

fsetpos ................................................. ........... 245 

ftell ................................................. ................. 247 

tua lại ................................................. ............ 258 

FILENAME_MAX ................................................. 227 ... 

File-Chức vụ Chỉ số ..................... 225, 226, 233, 234, 

.................................................. ... 239, 240, 245, 248 

Bức ảnh, tối đa NumberOpen ............................... 227 

Chức năng lọc ................................................ 38 .... 

FIR ................................................. ................... 41 

FIRDecimate ................................................. 42 .... 

FIRDelayInit ................................................. ..... 43 

FIRInterpDelayInit ............................................. 45 

FIRInterpolate ................................................. 44 .. 

FIRLattice ................................................. ......... 45 

FIRLMS ................................................. ............ 46 

FIRLMSNorm ................................................. 47 ... 

FIRStruct ................................................. .......... 40 

FIRStructInit ................................................. ..... 49 

IIRCanonic ................................................. ....... 50

Integer ............................................................. 278 

Long Integer .................................................... 283 

Divide by Zero ........................................ 216, 219, 278 

Document 

Layout ................................................................. 2 

Documentation 

Conventions ........................................................ 3 

Domain Error .......................... 205, 325, 326, 327, 329, 

............................ 331, 333, 334, 341, 343, 349, 350, 

............................. 351, 352, 357, 358, 361, 362, 363 

dot .......................................................................... 253 

Double Precision Floating Point 

Machine Epsilon.............................................. 206 

Maximum Exponent (base 10) ........................ 207 

Maximum Exponent (base 2) .......................... 207 

Maximum Value .............................................. 206 

Minimum Exponent (base 10) ......................... 207 

Minimum Exponent (base 2) ........................... 208 

Minimum Value ............................................... 207 

Number of Binary Digits .................................. 206 

Number of Decimal Digits ............................... 206 

double Type............................................................ 225 

Dream Function...................................................... 253 

DSP Libraries ............................................................. 9 

dsPIC Peripheral Libraries ....................................... 73 

Index 


E 

EDOM .................................................................... 205 

edom ...................................................................... 325 

Ellipses (...) .....................................................221, 260 

Empty Binary File ................................................... 236 

Empty Text File ...................................................... 236 

EnableCNx ............................................................. 123 

EnableIntADC .................................................100, 107 

EnableIntCANx ........................................................ 92 

EnableIntDCI.......................................................... 155 

EnableIntFLTA ....................................................... 180 

EnableIntFLTB ....................................................... 181 

IIRCanonicInit ................................................. 51 .. 

IIRLattice ................................................. .......... 52 

Mô hình OCTAVE IIRLattice ................................ 56 

IIRLatticeInit ................................................. ..... 53 

IIRTransposed ................................................. . 54 

IIRTransposedInit .............................................. 55 

FIR ................................................. .......................... 41 

FIRDecimate ................................................. ........... 42 

FIRDelayInit ................................................. ............ 43 

FIRInterpDelayInit ................................................. 45 ... 

FIRInterpolate ................................................. ......... 44 

FIRLattice ................................................. ................ 45 

FIRLMS ................................................. ................... 46 

FIRLMSNorm ................................................. .......... 47 

FIRStruct ................................................. ................. 40 

FIRStructInit ................................................. ............ 49 

cờ ................................................. ....................... 253 

float.h ............................................... ...................... 206 

DBL_DIG ................................................. ........ 206 

DBL_EPSILON ............................................... 206 

DBL_MANT_DIG ............................................ 206 

DBL_MAX ................................................. ...... 206 

DBL_MAX_10_EXP ........................................ 207 

DBL_MAX_EXP .............................................. 207 

DBL_MIN ................................................. ....... 207 

DBL_MIN_10_EXP ......................................... 207 

DBL_MIN_EXP ............................................... 208 

FLT_DIG ................................................. ........ 208 

FLT_EPSILON ................................................ 208 

FLT_MANT_DIG ............................................. 208 

FLT_MAX ................................................. ....... 208 

FLT_MAX_10_EXP ......................................... 208 

FLT_MAX_EXP ............................................... 209 

FLT_MIN ................................................. ........ 209 

FLT_MIN_10_EXP .......................................... 209 

FLT_MIN_EXP ................................................ 209 

FLT_RADIX ................................................. 209 .... 

FLT_ROUNDS ................................................ 209 

LDBL_DIG ................................................. ...... 209

EnableIntlCx........................................................... 129 

EnableIntlUxTX ...................................................... 147 

EnableIntMCPWM ................................................. 180 

EnableIntMI2C ....................................................... 190 

EnableIntOCx......................................................... 139 

EnableIntQEI.......................................................... 169 

EnableIntSI2C........................................................ 191 

EnableIntSPIx ........................................................ 163 

EnableIntTx ............................................................ 115 

EnableIntUxRX ...................................................... 147 

EnableINTx ............................................................ 123 

End Of File ............................................................. 227 

Indicator .......................................................... 225 

Seek................................................................ 244 

Test For .......................................................... 231 

Environment Function 

getenv ............................................................. 281 

Environment Variable............................................. 369 

EOF........................................................................ 227 

ERANGE................................................................ 205 

erange.................................................................... 325 

errno................................................................205, 325 

errno.h.....................................................205, 325, 370 

EDOM ............................................................. 205 

ERANGE......................................................... 205 

errno ............................................................... 205 

Error Codes.....................................................205, 305 

Error Conditions ..................................................... 325 

Error Handler ......................................................... 278 

Error Handling Functions 

clearerr............................................................ 229 

feof.................................................................. 231 

ferror ............................................................... 232 

perror .............................................................. 252 

Error Indicator ........................................................ 225 

Error Indicators 

Clearing ...................................................229, 258 

End Of File...............................................229, 235 

Error .........................................................229, 235 

LDBL_EPSILON .............................................. 210 

LDBL_MANT_DIG ........................................... 210 

LDBL_MAX ................................................. 210 .... 

LDBL_MAX_10_EXP ...................................... 210 

LDBL_MAX_EXP ............................................ 210 

LDBL_MIN ................................................. ...... 210 

LDBL_MIN_10_EXP ....................................... 210 

LDBL_MIN_EXP ............................................. 211 

Floating Point 

Giới hạn ................................................. .............. 206 

Không chuyển đổi ................................................ 225 

Các loại, thuộc tính của ....................................... 206 

Floating Point, Seefloat.h 

Floating-Point Lỗi tín hiệu ..................................... 216 

sàn ................................................. ....................... 340 



floorf ................................................. ...................... 340 

FLT_DIG ................................................. ................ 208 

FLT_EPSILON ................................................. ...... 208 

FLT_MANT_DIG ................................................. 208 ... 

FLT_MAX ................................................. .............. 208 

FLT_MAX_10_EXP ................................................ 208 

FLT_MAX_EXP ................................................. ..... 209 

FLT_MIN ................................................. ............... 209 

FLT_MIN_10_EXP ................................................. 209 

FLT_MIN_EXP ................................................. ...... 209 

FLT_RADIX ................................................. ........... 209 

FLT_RADIX chữ số 

Số ....................................... 206, 208, 210 

FLT_ROUNDS ................................................. ...... 209 

................................................. Xả .............. 233, 280 

fmod ................................................. ...................... 341 

fmodf ................................................. ..................... 343 

-fno-ngắn đôi ............................. 206, 207, 208, 225 

fopen ............................................... 225, 236, 262, 370 

FOPEN_MAX ................................................. ........ 227 

Mẫu thức ăn ................................................ .............. 201 

Định dạng Specifiers ........................................... 253, 259

Test For .......................................................... 232 

Error Messages, Built-In Functions ........................ 379 

Error Signal ............................................................ 215 

Errors, Seeerrno.h 

Errors, Testing For ................................................. 205 

Example of Use 

ADC, 10-Bit..................................................... 108 

ADC, 12-Bit..................................................... 101 

CAN .................................................................. 93 

DCI.................................................................. 156 

I2C .................................................................. 192 

Input Capture .................................................. 130 

Output Compare ............................................. 140 

PWM ............................................................... 182 

QEI Functions ................................................. 170 

SPI .................................................................. 164 

Timers ............................................................. 116 

UART .............................................................. 149 

Exception Error ...................................................... 278 

exit........................................... 264, 270, 272, 280, 367 

EXIT_FAILURE ...................................................... 270 

EXIT_SUCCESS.................................................... 270 

exp ......................................................................... 337 

expf ........................................................................ 338 

Exponential and Logarithmic Functions 

exp .................................................................. 337 

expf ................................................................. 338 

frexp ................................................................ 344 

frexpf ............................................................... 345 

ldexp ............................................................... 346 

ldexpf .............................................................. 347 

log ................................................................... 349 

log10 ............................................................... 350 

log10f .............................................................. 351 

logf .................................................................. 352 

modf ................................................................ 353 

modff ............................................................... 354 

exponential function 


Định dạng I / O thói quen .......................................... 225 

Định dạng đầu vào / đầu ra Chức năng 

fprintf ................................................. .............. 238 

fscanf ................................................. .............. 242 

printf ................................................. ............... 253 

scanf ................................................. ............... 259 

sprintf ................................................. ............. 263 

sscanf ................................................. ............. 263 

vfprintf ................................................. ............ 267 

vprintf ................................................. ............. 268 

vsprintf ................................................. ............ 269 

Tiêu đề định dạng 

In ấn ................................................. ........... 263 

Quét ................................................. ........ 263 

fpos_t ................................................. ..................... 226 

fprintf ................................................. ............. 225, 238 

fputc ................................................. ....................... 239 

fputs ................................................. ....................... 239 

Chỉ số 


phần và số mũ chức năng 



Chữ số phần ................................................ ........ 253 

fread ................................................. ............... 240, 371 

................................................. miễn phí ........................ 281 

Miễn phí bộ nhớ ................................................ .......... 281 

freopen ................................................. ... 225, 242, 370 

frexp ................................................. ...................... 344 

frexpf ................................................. ..................... 345 

fscanf ................................................. ............. 225, 242 

fseek ................................................. ...... 244, 265, 369 

fsetpos ................................................. ... 245, 265, 369 

ftell ................................................. ................. 247, 369 

Full Buffering ................................................ ... 261, 262 

Đệm đầy đủ ................................................ ..225, 226 

fwrite ................................................. ..................... 248 

G 

getc ................................................. ....................... 250


F 

fabs ........................................................................ 339 

fabsf ....................................................................... 339 

fclose.............................................................. 230, 368 

feof ................................................................. 229, 231 

ferror............................................................... 229, 232 

fflush............................................................... 233, 373 

FFTComplex ............................................................ 64 

FFTComplexIP ......................................................... 66 

fgetc ............................................................... 233, 371 

fgetpos ........................................................... 234, 369 

fgets ............................................................... 235, 371 

Field Width ............................................................. 253 

FILE................................................................ 225, 226 

File Access Functions 

fclose............................................................... 230 

fflush ............................................................... 233 

fopen ............................................................... 236 

freopen............................................................ 242 

setbuf .............................................................. 261 

setvbuf ............................................................ 262 

File Access Modes......................................... 225, 236 

File Buffering 

Fully Buffered.......................................... 225, 226 

Line Buffered........................................... 225, 226 

Unbuffered .............................................. 225, 226 

File Operations 

Remove........................................................... 257 

Rename .......................................................... 257 

dsPIC 

® 



File Positioning Functions 

fgetpos ............................................................ 234 

fseek ............................................................... 244 

fsetpos ............................................................ 245 

ftell .................................................................. 247 

getchar ................................................. .................. 251 

getcSPIx ................................................. ................ 163 

getcUARTx ................................................. ............ 147 

getenv ................................................. ............ 281, 369 

được ................................................. ................ 251, 371 

getsSPIx ................................................. ................ 162 

getsUARTx ................................................. ............ 146 

GMT ................................................. ...................... 320 

gmtime ................................................. ........... 320, 321 

Nhân vật đồ họa 

Xác định ................................................. .......... 198 

Kiểm tra cho ................................................ ............ 198 

Greenwich Mean Time ........................................... 320 

H 

h sửa đổi lần ................................................ ........ 254, 259 

HammingInit ................................................. ............ 28 

Xử lý 

Mặc định ................................................. ........... 215 

Lỗi ................................................. ............... 278 

Ngắt ................................................. ......... 219 

Lồng ................................................. ........... 214 

Tín hiệu ................................................. ...... 215, 220 

Loại tín hiệu ................................................ ..... 215 

Xử lý 

Tín hiệu ngắt ............................................... 220 

HanningInit ................................................. .............. 28 

Tiêu đề tập tin 

assert.h ............................................... ............ 195 

ctype.h ............................................... ............. 196 

errno.h ............................................. 205, 325, 370 

float.h ............................................... ............... 206 

limits.h ............................................... .............. 211 

locale.h ............................................... ............ 213 

math.h ............................................... .............. 325 

setjmp.h ............................................... ........... 214 

signal.h ............................................... ............ 215 

stdarg.h ............................................... ............ 221 

stddef.h ............................................... ............ 223 

stdio.h ............................................... ....... 225, 371

ewind ............................................................. 258 

FILENAME_MAX.................................................... 227 

File-Position Indicator.....................225, 226, 233, 234, 

.....................................................239, 240, 245, 248 

Files, Maximum NumberOpen............................... 227 

Filtering Functions .................................................... 38 

FIR .................................................................... 41 

FIRDecimate ..................................................... 42 

FIRDelayInit ...................................................... 43 

FIRInterpDelayInit............................................. 45 

FIRInterpolate ................................................... 44 

FIRLattice.......................................................... 45 

FIRLMS............................................................. 46 

FIRLMSNorm .................................................... 47 

FIRStruct........................................................... 40 

FIRStructInit ...................................................... 49 

IIRCanonic ........................................................ 50 

IIRCanonicInit ................................................... 51 

IIRLattice........................................................... 52 

IIRLattice OCTAVE model ................................ 56 

IIRLatticeInit ...................................................... 53 

IIRTransposed .................................................. 54 

IIRTransposedInit.............................................. 55 

FIR ........................................................................... 41 

FIRDecimate ............................................................ 42 

FIRDelayInit ............................................................. 43 

FIRInterpDelayInit .................................................... 45 

FIRInterpolate .......................................................... 44 

FIRLattice................................................................. 45 

FIRLMS .................................................................... 46 

FIRLMSNorm ........................................................... 47 

FIRStruct .................................................................. 40 

FIRStructInit ............................................................. 49 

flags........................................................................ 253 

float.h ..................................................................... 206 

DBL_DIG......................................................... 206 

DBL_EPSILON ............................................... 206 

DBL_MANT_DIG ............................................ 206 

DBL_MAX ....................................................... 206 

stdlib.h ............................................. 270, 369, 372 

string.h ............................................... ............. 294 

time.h ............................................... ....... 317, 373 

Heap ................................................. ...................... 368 

Chức năng trợ giúp ................................................ 366 .... 

Hexadecimal ................................... 254, 260, 291, 292 

Chuyển đổi hệ thập lục phân ....................................... 253 

Chữ số thập lục phân 

Xác định ................................................. ........... 202 

Kiểm tra cho ................................................ ............ 202 

Tab ngang ................................................ ........ 201 

Giờ ................................................. ....... 317, 318, 322 

HUGE_VAL ................................................. ........... 325 

cosin hyperbol 



Chức năng hyperbol 

cosh ................................................. ............... 335 

coshf ................................................. .............. 336 

sinh ................................................. ................ 359 

sinhf ................................................. ............... 360 

tanh ................................................. ................ 364 

tanhf ................................................. ............... 365 

sin hyperbol 



tang hyperbol 



Tôi 

I / O Port Chức năng 

Cấu hình CN Ngắt .................................. 122 

Cấu hình CN Pull-Ups .................................... 122 

Cấu hình INT ................................................ 121 .. 

Vô hiệu hoá INT ................................................ ..... 120 

I / O Port Macros 

Vô hiệu hoá CN Ngắt ...................................... 123 

Vô hiệu hóa ngắt ............................................ 124 

Kích hoạt tính năng ngắt CN ...................................... 123

DBL_MAX_10_EXP ........................................ 207 

DBL_MAX_EXP .............................................. 207 

DBL_MIN ........................................................ 207 

DBL_MIN_10_EXP ......................................... 207 

DBL_MIN_EXP ............................................... 208 

FLT_DIG ......................................................... 208 

FLT_EPSILON ................................................ 208 

FLT_MANT_DIG ............................................. 208 

FLT_MAX........................................................ 208 

FLT_MAX_10_EXP......................................... 208 

FLT_MAX_EXP............................................... 209 

FLT_MIN ......................................................... 209 

FLT_MIN_10_EXP.......................................... 209 

FLT_MIN_EXP................................................ 209 

FLT_RADIX..................................................... 209 

FLT_ROUNDS ................................................ 209 

LDBL_DIG....................................................... 209 

LDBL_EPSILON.............................................. 210 

LDBL_MANT_DIG........................................... 210 

LDBL_MAX ..................................................... 210 

LDBL_MAX_10_EXP ...................................... 210 

LDBL_MAX_EXP ............................................ 210 

LDBL_MIN....................................................... 210 

LDBL_MIN_10_EXP ....................................... 210 

LDBL_MIN_EXP ............................................. 211 

Floating Point 

Limits............................................................... 206 

No Conversion ................................................ 225 

Types, Properties Of....................................... 206 

Floating Point, Seefloat.h 

Floating-Point Error Signal ..................................... 216 

floor ........................................................................ 340 



floorf ....................................................................... 340 

FLT_DIG................................................................. 208 

FLT_EPSILON ....................................................... 208 

FLT_MANT_DIG .................................................... 208 

FLT_MAX ............................................................... 208 

Kích hoạt tính năng ngắt ............................................. 123 

Thiết lập ngắt ưu tiên ...................................... 124 

Chức năng I2C 

Thừa nhận I2C ............................................ 184 

Đóng I2C. .................................................. ..... 183 

Cấu hình I2C ................................................ 187 .. 

Cấu hình I2C ngắt ................................... 183 

Dữ liệu sẵn sàng I2C .............................................. 184 

Ví dụ sử dụng ............................................... 192 

I2C nhàn rỗi ................................................ ............ 184 

Thạc sĩ I2C Nhận Chuỗi ..................................... 185 

Thạc sĩ I2C Đặt chuỗi ...................................... 185 

Thừa nhận không I2C ..................................... 186 

Thầy đọc I2C ............................................. 186 

Đọc Slave I2C ............................................... 189 

I2C Khởi động lại ................................................ ...... 188 

I2C Slave Nhận Chuỗi ....................................... 188 

I2C Slave Đặt chuỗi ........................................ 189 

Bắt đầu I2C ................................................ .......... 190 

Dừng I2C ................................................ .......... 190 

Viết Thạc sĩ I2C. ............................................ 186 

Viết Slave I2C ............................................... 189 

dsPIC 

® 



Macros I2C 

Vô hiệu hoá Thạc sĩ I2C ngắt ........................... 190 

Vô hiệu hoá Slave I2C ngắt ............................. 191 

Kích hoạt tính năng tổng thể I2C ngắt ............................ 190 

Kích hoạt Slave I2C ngắt .............................. 191 

Đặt Thạc sĩ I2C ngắt ưu tiên ...................... 191 

Đặt Slave I2C ngắt ưu tiên ........................ 191 

IdleI2C ................................................. ................... 184 

IFFTComplex ................................................. ........... 67 

IFFTComplexIP ................................................. ....... 69 

Bỏ qua tín hiệu ................................................ .......... 215 

IIRCanonic ................................................. .............. 50 

IIRCanonicInit ................................................. .......... 51

FLT_MAX_10_EXP ................................................ 208 

FLT_MAX_EXP ...................................................... 209 

FLT_MIN ................................................................ 209 

FLT_MIN_10_EXP ................................................. 209 

FLT_MIN_EXP ....................................................... 209 

FLT_RADIX ............................................................ 209 

FLT_RADIX Digit 

Number Of....................................... 206, 208, 210 

FLT_ROUNDS ....................................................... 209 

Flush............................................................... 233, 280 

fmod ....................................................................... 341 

fmodf ...................................................................... 343 

-fno-short-double .............................206, 207, 208, 225 

fopen ...............................................225, 236, 262, 370 

FOPEN_MAX ......................................................... 227 

Form Feed.............................................................. 201 

Format Specifiers ........................................... 253, 259 

Formatted I/O Routines.......................................... 225 

Formatted Input/Output Functions 

fprintf ............................................................... 238 

fscanf............................................................... 242 

printf ................................................................ 253 

scanf................................................................ 259 

sprintf .............................................................. 263 

sscanf.............................................................. 263 

vfprintf ............................................................. 267 

vprintf .............................................................. 268 

vsprintf............................................................. 269 

Formatted Text 

Printing ............................................................ 263 

Scanning ......................................................... 263 

fpos_t...................................................................... 226 

fprintf .............................................................. 225, 238 

fputc........................................................................ 239 

fputs........................................................................ 239 

Index 


fraction and exponent function 


IIRLattice ................................................. ................. 52 

Mô hình OCTAVE IIRLattice ........................................ 56 

IIRLatticeInit ................................................. ............ 53 

IIRTransposed ................................................. ......... 54 

IIRTransposedInit ................................................. 55 .... 

Hướng dẫn tín hiệu bất hợp pháp ......................................... 217 

Giới hạn thực hiện Xác định, Seelimits.h 

Chỉ số 

End Of tập tin .............................................. 225 , 227 

Lỗi ................................................. ....... 225, 232 

Chức vụ ..... 225, 233, 234, 239, 240, 245, 248 tập tin 

Infinity ................................................. .................... 325 

Đầu vào và đầu ra, Seestdio.h 

Input Capture chức năng 

Đóng Input Capture ........................................ 125 

Cấu hình Input Capture .................................. 127 

Cấu hình Input Capture Interrupt ................... 126 

Ví dụ sử dụng ............................................... 130 

Đọc tất cả các đầu vào chụp .................................. 128 

Input Capture Macros 

Vô hiệu hoá Capture Interrupt ................................ 129 

Kích hoạt tính năng Capture Interrupt ................................. 129 

Đặt Capture ngắt ưu tiên .......................... 129 

Định dạng đầu vào ................................................ ......... 225 

Chu kỳ hướng dẫn .................................... 320, 321, 324 

int 

Giá trị tối đa .............................................. 211 


INT_MAX ................................................. ............... 211 

INT_MIN ................................................. ................ 211 

Giới hạn số nguyên ................................................ .......... 211 

Nội bộ Thông báo lỗi ........................................... 305 

Địa chỉ Internet ................................................ ......... 5 

Interrupt Handler ................................................ 219 .... 

Tín hiệu ngắt ................................................ ....... 217 

Xử lý tín hiệu ngắt ........................................ 220 

Gián đoạn tin nhắn ............................................. 217 

Mã thực thi không hợp lệ tin nhắn ......................... 217 

Yêu cầu lưu trữ tin nhắn không hợp lệ ......................... 218


Fraction Digits ........................................................ 253 

fread................................................................240, 371 

free......................................................................... 281 

Free Memory.......................................................... 281 

freopen....................................................225, 242, 370 

frexp ....................................................................... 344 

frexpf ...................................................................... 345 

fscanf ..............................................................225, 242 

fseek .......................................................244, 265, 369 

fsetpos ....................................................245, 265, 369 

ftell ..................................................................247, 369 

Full Buffering...................................................261, 262 

Fully Buffered..................................................225, 226 

fwrite ...................................................................... 248 

G 

getc ........................................................................ 250 

getchar ................................................................... 251 

getcSPIx................................................................. 163 

getcUARTx............................................................. 147 

getenv .............................................................281, 369 

gets .................................................................251, 371 

getsSPIx................................................................. 162 

getsUARTx............................................................. 146 

GMT ....................................................................... 320 

gmtime ............................................................320, 321 

Graphical Character 

Defined ........................................................... 198 

Test for............................................................ 198 

Greenwich Mean Time........................................... 320 

H 

h modifier ........................................................254, 259 

HammingInit............................................................. 28 

Handler 

Default ............................................................ 215 

Error ................................................................ 278 

Interrupt .......................................................... 219 

Nested ............................................................ 214 

Signal.......................................................215, 220 

Inverse cô sin, Seearccosine 

Sine nghịch đảo, Seearcsine 

Tangent nghịch đảo, Seearctangent 

isalnum ................................................. .................. 196 

isBOR ................................................. .................... 117 

iscntrl ................................................. ..................... 197 

isdigit ................................................. ..................... 198 

isgraph ................................................. .................. 198 

islapha ................................................. ................... 196 

islower ................................................. ................... 199 

isLVD ................................................. ..................... 117 

isMCLR ................................................. .................. 118 

isPOR ................................................. .................... 117 

isprint ................................................. ..................... 200 

ispunct ................................................. ................... 200 

isspace ................................................. .................. 201 

isupper ................................................. ................... 202 

isWDTTO ................................................. ............... 118 

isWDTWU ................................................. .............. 118 

isWU ................................................. ...................... 119 

isxdigit ................................................. ................... 202 

J 

jmp_buf ................................................. .................. 214 

Biện minh cho ................................................. .................... 253 

K 

KaiserInit ................................................. ................. 29 

L 

L sửa đổi lần ................................................ ........ 254, 259 

l sửa đổi lần ................................................ ......... 254, 259 

L_tmpnam ................................................. ..... 227, 265 

phòng thí nghiệm ................................................. ........................ 282 

LC_ALL ................................................. ................. 213 

LC_COLLATE ................................................. ....... 213 

LC_CTYPE ................................................. ............ 213 

LC_MONETARY ................................................. 213 ... 

LC_NUMERIC ................................................. ....... 213 

LC_TIME ................................................. ............... 213 

LCD, ngoài ............................................... ............ 74 

................................................. Bận rộn ................. 75

Signal Type..................................................... 215 

Handling 

Interrupt Signal ............................................... 220 

HanningInit............................................................... 28 

Header Files 

assert.h ........................................................... 195 

ctype.h ............................................................ 196 

errno.h .............................................205, 325, 370 

float.h .............................................................. 206 

limits.h............................................................. 211 

locale.h ........................................................... 213 

math.h............................................................. 325 

setjmp.h .......................................................... 214 

signal.h ........................................................... 215 

stdarg.h........................................................... 221 

stddef.h ........................................................... 223 

stdio.h ......................................................225, 371 

stdlib.h .............................................270, 369, 372 

string.h ............................................................ 294 

time.h ...................................................... 317, 373 

Heap....................................................................... 368 

Helper Functions .................................................... 366 

Hexadecimal ...................................254, 260, 291, 292 

Hexadecimal Conversion ....................................... 253 

Hexadecimal Digit 

Defined............................................................ 202 

Test for ............................................................ 202 

Horizontal Tab........................................................ 201 

Hour ........................................................317, 318, 322 

HUGE_VAL ............................................................ 325 

hyperbolic cosine 



Hyperbolic Functions 

cosh ................................................................ 335 

coshf ............................................................... 336 

sinh ................................................................. 359 

sinhf ................................................................ 360 

tanh ................................................................. 364 

Ví dụ sử dụng ............................................... 80 .. 

Mở ................................................. ................ 75 

Đặt chuỗi ................................................ .......... 76 

Địa chỉ đọc ................................................ 77 ... 

Đọc dữ liệu ................................................ ......... 77 

Đặt nhân vật GeneratorAddress ..................... 78 

Thiết lập hiển thị Địa chỉ dữ liệu ................................. 78 

Viết lệnh ................................................ 79 

Viết liệu ................................................ ......... 78 

lconv, cấu trúc ............................................... ............. 213 

LDBL_DIG ................................................. ............. 209 

LDBL_EPSILON ................................................. 210 .... 

LDBL_MANT_DIG ................................................. . 210 

LDBL_MAX ................................................. ............ 210 

LDBL_MAX_10_EXP ............................................. 210 

LDBL_MAX_EXP ................................................. 210 .. 

LDBL_MIN ................................................. ............. 210 

LDBL_MIN_10_EXP ............................................... 210 

LDBL_MIN_EXP ................................................. 211 .... 

ldexp ................................................. ...................... 346 

ldexpf ................................................. ..................... 347 

ldiv ................................................. ................. 270, 283 

ldiv_t ................................................. ...................... 270 

Leap thứ hai ................................................ .. 317, 323 

Trái Canh ............................................... ............... 253 

libpic30, Xây dựng lại ............................................... . 366 

Chỉ số 


Thư viện 

DSP ................................................. ................... 9 

dsPIC ngoại vi ............................................... 73 

Tiêu chuẩn C ................................................ ...... 193 

Tiêu chuẩn C Toán ............................................. 325 

Giới hạn 

Floating Point ................................................ 206 .. 

Integer ................................................. ............ 211 

limits.h ............................................... ..................... 211 

CHAR_BITS ................................................. 211 ... 

CHAR_MAX ................................................. 211 ...

tanhf ................................................................ 365 

hyperbolic sine 



hyperbolic tangent 



I 

I/O Port Functions 

Configure CN Interrupts .................................. 122 

Configure CN Pull-Ups.................................... 122 

Configure INT.................................................. 121 

Disable INT ..................................................... 120 

I/O Port Macros 

Disable CN Interrupts...................................... 123 

Disable Interrupts............................................ 124 

Enable CN Interrupts...................................... 123 

Enable Interrupts............................................. 123 

Set Interrupts Priority ...................................... 124 

I2C Functions 

Acknowledge I2C ............................................ 184 

Close I2C. ....................................................... 183 

Configure I2C.................................................. 187 

Configure I2C Interrupt ................................... 183 

Data Ready I2C .............................................. 184 

Example of Use............................................... 192 

Idle I2C............................................................ 184 

Master I2C Get String ..................................... 185 

Master I2C Put String...................................... 185 

Not Acknowledge I2C..................................... 186 

Read Master I2C............................................. 186 

Read Slave I2C............................................... 189 

Restart I2C...................................................... 188 

Slave I2C Get String ....................................... 188 

Slave I2C Put String........................................ 189 

Start I2C.......................................................... 190 

Stop I2C .......................................................... 190 

Write Master I2C. ............................................ 186 

Write Slave I2C ............................................... 189 

CHAR_MIN ................................................. 211 .... 

INT_MAX. .................................................. ..... 211 

INT_MIN. .................................................. ...... 211 

LLONG_MAX ................................................. . 211 

LLONG_MIN ................................................. 212 .. 

LONG_MAX ................................................. 212 ... 

LONG_MIN. .................................................. 212 .. 

MB_LEN_MAX ................................................ 212 

SCHAR_MAX ................................................. 212 

SCHAR_MIN ................................................. 212 .. 

SHRT_MAX. .................................................. . 212 

SHRT_MIN. .................................................. 212 .. 

UCHAR_MAX ................................................. 213 

UINT_MAX ................................................. ..... 213 

ULLONG_MAX ............................................... 213 

ULONG_MAX. ................................................ 213 

USHRT_MAX ................................................. . 213 

Dòng Buffered ................................................ ... 225, 226 

Dòng Buffering ................................................ ......... 262 

ll sửa đổi lần ................................................ ......... 254, 259 

LLONG_MAX ................................................. ........ 211 

LLONG_MIN ................................................. ......... 212 

chức năng tải mũ 



Giờ địa phương .............................................. 319, 321, 322 

Địa phương, C ............................................... .......... 196, 213 

Địa phương, khác ............................................... .......... 213 

locale.h ............................................... .................... 213 

localeconv ................................................. ............. 213 

Nội địa hóa, Seelocale.h 

localtime ................................................. 0,319, 320, 321 

Xác định vị trí nhân vật ................................................ 301 ... 

đăng nhập ................................................. ......................... 349 

log10 ................................................. ..................... 350 

log10f ................................................. .................... 351 

hàm logarit 


Độc Floating Point ....................................... 351

dsPIC 

® 



I2C Macros 

Disable Master I2C Interrupt ........................... 190 

Disable Slave I2C Interrupt ............................. 191 

Enable Master I2C Interrupt............................ 190 

Enable Slave I2C Interrupt.............................. 191 

Set Master I2C Interrupt Priority...................... 191 

Set Slave I2C Interrupt Priority........................ 191 

IdleI2C.................................................................... 184 

IFFTComplex............................................................ 67 

IFFTComplexIP ........................................................ 69 

Ignore Signal .......................................................... 215 

IIRCanonic ............................................................... 50 

IIRCanonicInit........................................................... 51 

IIRLattice .................................................................. 52 

IIRLattice OCTAVE model........................................ 56 

IIRLatticeInit ............................................................. 53 

IIRTransposed.......................................................... 54 

IIRTransposedInit..................................................... 55 

Illegal Instruction Signal ......................................... 217 

Implementation-Defined Limits, Seelimits.h 

Indicator 

End Of File .............................................. 225, 227 

Error ........................................................ 225, 232 

File Position ..... 225, 233, 234, 239, 240, 245, 248 

Infinity ..................................................................... 325 

Input and Output, Seestdio.h 

Input Capture Functions 

Close Input Capture ........................................ 125 

Configure Input Capture.................................. 127 

Configure Input Capture Interrupt ................... 126 

Example of Use............................................... 130 

Read All Input Captures .................................. 128 

Input Capture Macros 

Disable Capture Interrupt................................ 129 

Enable Capture Interrupt................................. 129 

hàm logarit tự nhiên 



logf ................................................. ........................ 352 

lỗi logic, gỡ lỗi .......................................... 195 

Dài đôi chính xác dấu chấm động 

Máy Epsilon ............................................. 210 



Giá trị tối đa .............................................. 210 

Tối thiểu Exponent (10 cơ sở) ......................... 210 





Loại dài đôi ............................................... ..... 225 

long int 

Giá trị tối đa .............................................. 212 


lâu dài int 

Giá trị tối đa .............................................. 211 


lâu dài int 

Giá trị tối đa .............................................. 213 

unsigned long int 

Giá trị tối đa .............................................. 213 

LONG_MAX ................................................. .......... 212 

LONG_MIN ................................................. ........... 212 

longjmp ................................................. .................. 214 

Thấp hơn trường hợp chữ cái ký tự 

Để chuyển đổi ................................................ ...... 203 

Xác định ................................................. ........... 199 

Kiểm tra cho ................................................ ............ 199 

lseek ................................................. ...................... 369 

M 

Máy Epsilon 


Dài đôi Floating Point ............................. 210 

Độc Floating Point ....................................... 208

Set Capture Interrupt Priority .......................... 129 

Input Formats ......................................................... 225 

Instruction Cycles ....................................320, 321, 324 

int 

Maximum Value .............................................. 211 

Minimum Value ............................................... 211 

INT_MAX................................................................ 211 

INT_MIN................................................................. 211 

Integer Limits.......................................................... 211 

Internal Error Message........................................... 305 

Internet Address ......................................................... 5 

Interrupt Handler .................................................... 219 

Interrupt Signal ....................................................... 217 

Interrupt Signal Handling........................................ 220 

Interruption Message ............................................. 217 

Invalid Executable Code Message ......................... 217 

Invalid Storage Request Message ......................... 218 

Inverse Cosine, Seearccosine 

Inverse Sine, Seearcsine 

Inverse Tangent, Seearctangent 

isalnum................................................................... 196 

isBOR..................................................................... 117 

iscntrl...................................................................... 197 

isdigit ...................................................................... 198 

isgraph ................................................................... 198 

islapha .................................................................... 196 

islower .................................................................... 199 

isLVD...................................................................... 117 

isMCLR................................................................... 118 

isPOR ..................................................................... 117 

isprint...................................................................... 200 

ispunct .................................................................... 200 

isspace ................................................................... 201 

isupper.................................................................... 202 

isWDTTO................................................................ 118 

isWDTWU............................................................... 118 

isWU....................................................................... 119 

isxdigit .................................................................... 202 

J 

Tầm quan trọng ................ 325, 337, 338, 341, 343, 359, 360 

malloc .............................................. 281, 284 , 367, 372 

Lập bản đồ nhân vật ............................................... 196 

MastergetsI2C ................................................. ....... 185 

MasterputsI2C ................................................. ....... 185 

MasterReadI2C ................................................. ..... 186 

MasterWriteI2C ................................................. ..... 186 

Toán ngoại lệ Lỗi ............................................. 278 

math.h ............................................... ..................... 325 

acos. .................................................. ............. 325 

acosf. .................................................. ............ 326 

asin. .................................................. .............. 327 

asinf ................................................. ............... 327 

atan. .................................................. .............. 328 

atan2. .................................................. ............ 329 

atan2f. .................................................. ........... 331 

atanf. .................................................. ............. 329 

ceil ................................................. .................. 332 

ceilf ................................................. ................. 333 

cos ................................................. ................. 333 

cosf ................................................. ................ 334 

cosh ................................................. ............... 335 

coshf ................................................. .............. 336 

exp ................................................. ................. 337 

expf ................................................. ................ 338 

fabs ................................................. ................ 339 

fabsf ................................................. ............... 339 

sàn ................................................. ................ 340 

floorf ................................................. ............... 340 

fmod ................................................. ............... 341 

fmodf ................................................. .............. 343 

dsPIC 

® 



frexp ................................................. ............... 344 

frexpf ................................................. .............. 345 

HUGE_VAL ................................................. 325 .... 

ldexp ................................................. .............. 346

jmp_buf................................................................... 214 

Justify ..................................................................... 253 

K 

KaiserInit .................................................................. 29 

L 

L modifier........................................................ 254, 259 

l modifier ......................................................... 254, 259 

L_tmpnam ...................................................... 227, 265 

labs......................................................................... 282 

LC_ALL .................................................................. 213 

LC_COLLATE ........................................................ 213 

LC_CTYPE............................................................. 213 

LC_MONETARY .................................................... 213 

LC_NUMERIC ........................................................ 213 

LC_TIME ................................................................ 213 

LCD, External ........................................................... 74 

Busy .................................................................. 75 

Example of Use................................................. 80 

Open ................................................................. 75 

Put String .......................................................... 76 

Read Address ................................................... 77 

Read Data ......................................................... 77 

Set Character GeneratorAddress..................... 78 

Set Display Data Address ................................. 78 

Write Command ................................................ 79 

Write Data ......................................................... 78 

lconv, struct ............................................................ 213 

LDBL_DIG .............................................................. 209 

LDBL_EPSILON..................................................... 210 

LDBL_MANT_DIG.................................................. 210 

LDBL_MAX............................................................. 210 

LDBL_MAX_10_EXP ............................................. 210 

LDBL_MAX_EXP ................................................... 210 

LDBL_MIN.............................................................. 210 

LDBL_MIN_10_EXP............................................... 210 

LDBL_MIN_EXP..................................................... 211 

ldexp....................................................................... 346 

ldexpf...................................................................... 347 

ldiv .................................................................. 270, 283 

ldexpf ................................................. ............. 347 

đăng nhập ................................................. .................. 349 

log10 ................................................. .............. 350 

log10f ................................................. ............. 351 

logf ................................................. ................. 352 

modf ................................................. ............... 353 

modff ................................................. .............. 354 

pow ................................................. ................ 355 

powf ................................................. ............... 356 

tội lỗi ................................................. .................. 357 

sinf ................................................. ................. 358 

sinh ................................................. ................ 359 

sinhf ................................................. ............... 360 

sqrt ................................................. ................. 361 

sqrtf ................................................. ................ 362 

tan ................................................. .................. 363 

TANF ................................................. ................. 363 

tanh ................................................. ................ 364 

tanhf ................................................. ............... 365 

Chức năng toán học, Seemath.h 

Chức năng Matrix ................................................ ....... 31 

MatrixAdd ................................................. ................ 33 

MatrixInvert ................................................. ............. 37 

MatrixMultiply ................................................. .......... 34 

MatrixScale ................................................. ............. 35 

MatrixSubtract ................................................. ......... 35 

MatrixTranspose ................................................. ...... 36 

Tối đa 

Ký tự nhiều byte ......................................... 271 

Giá trị tối đa 

Đôi Floating Point Exponent (10 cơ sở) ..... 207 

Đôi Floating Point Exponent (cơ sở 2) ....... 207 

Dài đôi Floating Point Exponent 

(10 cơ sở) .......................................... 210 


(Cơ sở 2) ............................................ 210 

Ký tự nhiều byte ......................................... 212 

rand ................................................. ................ 271 

Độc Floating Point Exponent (10 cơ sở) ....... 208

ldiv_t ....................................................................... 270 

Leap Second .................................................. 317, 323 

Left-Justify .............................................................. 253 

libpic30, Rebuilding ................................................ 366 

Index 


Libraries 

DSP .................................................................... 9 

dsPIC Peripheral............................................... 73 

Standard C...................................................... 193 

Standard C Math............................................. 325 

Limits 

Floating Point.................................................. 206 

Integer............................................................. 211 

limits.h.................................................................... 211 

CHAR_BITS.................................................... 211 

CHAR_MAX.................................................... 211 

CHAR_MIN ..................................................... 211 

INT_MAX. ....................................................... 211 

INT_MIN. ........................................................ 211 

LLONG_MAX.................................................. 211 

LLONG_MIN ................................................... 212 

LONG_MAX.................................................... 212 

LONG_MIN. .................................................... 212 

MB_LEN_MAX................................................ 212 

SCHAR_MAX ................................................. 212 

SCHAR_MIN................................................... 212 

SHRT_MAX. ................................................... 212 

SHRT_MIN. .................................................... 212 

UCHAR_MAX ................................................. 213 

UINT_MAX...................................................... 213 

ULLONG_MAX ............................................... 213 

ULONG_MAX. ................................................ 213 

USHRT_MAX.................................................. 213 

Line Buffered...................................................225, 226 

Line Buffering......................................................... 262 

ll modifier.........................................................254, 259 

LLONG_MAX ......................................................... 211 

LLONG_MIN .......................................................... 212 

Độc Floating Point Exponent (cơ sở 2) ......... 209 

Loại char ................................................ ........ 211 

Loại đôi ................................................ 206 .... 

Kiểu int ................................................ ........... 211 

Loại dài đôi ........................................... 210 

Loại long int ............................................... 212 .... 

Loại dài dài int ............................................ 211 

Loại dài dài int ............................ 213 

Loại dài int .................................... 213 

Loại ngắn int ............................................... 212 ... 

Loại ký char ............................................ 212 

Loại đơn ................................................ ..... 208 

Loại unsigned char ........................................ 213 

Loại int ............................................ 213 

Loại unsigned short int ................................... 213 

MB_CUR_MAX ................................................. ..... 271 

MB_LEN_MAX ................................................. ...... 212 

mblen ................................................. ..................... 285 

mbstowcs ................................................. .............. 285 

mbtowc ................................................. .................. 285 

memchr ................................................. ................. 294 

memcmp ................................................. ................ 295 

memcpy ................................................. ................. 297 

memmove ................................................. .............. 298 

Bộ nhớ 

Phân bổ ................................................. .. 278, 284 

Deallocate ................................................. ...... 281 

Miễn phí ................................................. ................ 281 

Phân bổ lại ................................................. ...... 287 

memset ................................................. .................. 299 

Tin nhắn 

Lỗi số học ............................................... 216 

Ngắt ................................................. .......... 217 

Mã thực thi không hợp lệ ................................. 217 

Yêu cầu lưu trữ không hợp lệ .................................. 218 

Yêu cầu chấm dứt ....................................... 218 

Microchip trang web Internet ....................................... 5 

Giá trị tối thiểu 

Đôi Floating Point Exponent (10 cơ sở) ..... 207

load exponent function 



Local Time ..............................................319, 321, 322 

Locale, C.........................................................196, 213 

Locale, Other ......................................................... 213 

locale.h................................................................... 213 

localeconv .............................................................. 213 

Localization, Seelocale.h 

localtime..................................................319, 320, 321 

Locate Character ................................................... 301 

log .......................................................................... 349 

log10 ...................................................................... 350 

log10f ..................................................................... 351 

logarithm function 



logarithm function, natural 



logf ......................................................................... 352 

logic errors, debugging .......................................... 195 

Long Double Precision Floating Point 

Machine Epsilon ............................................. 210 



Maximum Value .............................................. 210 



Minimum Value ............................................... 210 



long double Type.................................................... 225 

long int 

Maximum Value .............................................. 212 

Minimum Value ............................................... 212 

long long int 

Maximum Value .............................................. 211 

Minimum Value ............................................... 212 

Đôi Floating Point Exponent (cơ sở 2) ....... 208 


(10 cơ sở) ........................................... 210 


(Cơ sở 2) ............................................. 211 

Độc Floating Point Exponent (10 cơ sở) ....... 209 

Độc Floating Point Exponent (cơ sở 2) ......... 209 

Loại char ................................................ ........ 211 

Loại đôi ................................................ 207 .... 

Kiểu int ................................................ ........... 211 

Loại dài đôi ........................................... 210 

Loại long int ............................................... ..... 212 

Loại dài dài int ............................................ 212 

Loại ngắn int ............................................... 212 ... 

Loại ký char ............................................. 212 

Loại đơn ................................................ ..... 209 

Phút ................................................. .... 317, 318, 323 

mktime ................................................. ................... 322 

modf ................................................. ...................... 353 

modff ................................................. ..................... 354 

chức năng mô đun 



Tháng .............................................. 317, 318 , 322, 323 

-msmart-io .............................................. ................ 225 

Nhiều byte nhân vật ................................ 271, 285, 293 

Số lượng tối đa Bytes ............................. 212 

Nhiều byte chuỗi ............................................... 285 , 293 

N 

NaN ................................................. ....................... 325 

Logarithm tự nhiên 



NDEBUG ................................................. ............... 195 

Chức năng Integer gần 

ceil ................................................. .................. 332 

ceilf ................................................. ................. 333 

Chỉ số 


long long unsigned int 

Maximum Value .............................................. 213 

long unsigned int 

Maximum Value .............................................. 213 

LONG_MAX ........................................................... 212 

LONG_MIN ............................................................ 212 

longjmp................................................................... 214 

Lower Case Alphabetic Character 

Convert To ...................................................... 203 

Defined............................................................ 199 

Test for ............................................................ 199 

lseek....................................................................... 369 

M 

Machine Epsilon 


Long Double Floating Point............................. 210 


Magnitude ................325, 337, 338, 341, 343, 359, 360 

malloc..............................................281, 284, 367, 372 

Mapping Characters............................................... 196 

MastergetsI2C........................................................ 185 

MasterputsI2C........................................................ 185 

MasterReadI2C ...................................................... 186 

MasterWriteI2C ...................................................... 186 

Math Exception Error ............................................. 278 

math.h .................................................................... 325 

acos. ............................................................... 325 

acosf. .............................................................. 326 

asin. ................................................................ 327 

asinf ................................................................ 327 

atan. ................................................................ 328 

atan2. .............................................................. 329 

atan2f. ............................................................. 331 

atanf. ............................................................... 329 

ceil................................................................... 332 

ceilf.................................................................. 333 

cos .................................................................. 333 

cosf ................................................................. 334 

cosh ................................................................ 335 

sàn ................................................. ................ 340 

floorf ................................................. ............... 340 

Lồng nhau tín hiệu Handler ........................................... 214 

Xuống dòng .................... 201, 225, 235, 240, 251, 252, 256 

Không có bộ nhớ đệm .................................... 225, 226, 261, 262 

Nhảy không địa phương, Seesetjmp.h 

NotAckI2C ................................................. ............. 186 

NULL ............................... 213, 223, 227, 271, 294, 318 

O 

Mô-đun đối tượng Định dạng ............................................... 7 

Bát phân ................................................ 254 , 260, 291, 292 

Chuyển đổi bát phân ................................................ 253 ... 

offsetof ................................................. .................. 224 

OMF ................................................. .......................... 7 

mở ................................................. ...................... 370 

OpenADC10 ................................................. .......... 103 

OpenADC12 ................................................. ............ 96 

OpenCapturex ................................................. ....... 127 

OpenDCI ................................................. ............... 151 

OpenI2C ................................................. ................ 187 

OpenMCPWM ................................................. ....... 172 

OpenOCx ................................................. .............. 133 

OpenQEI ................................................. ............... 167 

OpenSPIx ................................................. .............. 160 

OpenTimerx ................................................. .......... 111 

OpenTimerxx ................................................. ........ 112 

OpenUART ................................................. ........... 143 

OpenXLCD ................................................. .............. 75 

So sánh sản lượng chức năng 

Đóng So sánh ............................................... 131 

Cấu hình So sánh ........................................ 133 

Cấu hình So sánh ngắt .......................... 132 

Ví dụ sử dụng .............................................. 140 

So sánh là đã đọc Chu kỳ ............................. 136 

So sánh là đã đọc Chu kỳ - chế độ PWM ....... 135 

Set So sánh Chu kỳ ................................ 138 

Đặt so sánh Chu kỳ - chế độ PWM .......... 137 

So sánh sản lượng Macros 

Vô hiệu hoá So sánh ngắt .............................. 139

coshf ............................................................... 336 

exp .................................................................. 337 

expf ................................................................. 338 

fabs ................................................................. 339 

fabsf ................................................................ 339 

floor ................................................................. 340 

floorf ................................................................ 340 

fmod ................................................................ 341 

fmodf ............................................................... 343 

dsPIC 

® 



frexp ................................................................ 344 

frexpf ............................................................... 345 

HUGE_VAL..................................................... 325 

ldexp ............................................................... 346 

ldexpf .............................................................. 347 

log ................................................................... 349 

log10 ............................................................... 350 

log10f .............................................................. 351 

logf .................................................................. 352 

modf ................................................................ 353 

modff ............................................................... 354 

pow ................................................................. 355 

powf ................................................................ 356 

sin ................................................................... 357 

sinf .................................................................. 358 

sinh ................................................................. 359 

sinhf ................................................................ 360 

sqrt .................................................................. 361 

sqrtf ................................................................. 362 

tan ................................................................... 363 

tanf .................................................................. 363 

tanh ................................................................. 364 

tanhf ................................................................ 365 

Mathematical Functions, Seemath.h 

Matrix Functions ....................................................... 31 

MatrixAdd ................................................................. 33 

Kích hoạt tính năng so sánh ngắt .............................. 139 

So sánh thiết lập ưu tiên ngắt ........................ 139 

Định dạng đầu ra ................................................ ...... 225 

Lỗi tràn .............................. 205, 325, 337, 338, 

.................................................. .. 346, 348, 355, 356 

Chồng chéo ........................... 297, 298, 300, 303, 306, 309 

P 

Pad nhân vật ................................................ ...... 253 

Phần trăm ............................................ 254, 259, 260 323 

Thư viện ngoại vi, dsPIC ...................................... 73 

perror ................................................. .................... 252 

pic30-libs ............................................... ................. 366 

_exit ................................................. ............... 367 

brk ................................................. .................. 367 

gần ................................................. .............. 368 

getenv ................................................. ............ 369 

lseek ................................................. .............. 369 

mở ................................................. ............... 370 

đọc ................................................. ................ 371 

loại bỏ ................................................. ........... 371 

đổi tên ................................................. ........... 371 

sbrk ................................................. ................ 372 

hệ thống ................................................. ............ 372 

Hiện ................................................. ................ 373 

viết ................................................. ............... 373 

Thêm Đăng ................................................ ................ 253 

Con trỏ, tạm thời ............................................... . 287 

PORStatReset ................................................. ....... 119 

pow ................................................. ........................ 355 

chức năng điện 



Chức năng suất 

pow ................................................. ................ 355 

powf ................................................. ............... 356 

powf ................................................. ....................... 356 

chính xác ................................................. ................ 253 

Tiền tố ................................................. ..................... 253 

tiền tố ................................................. ..................... 202

MatrixInvert .............................................................. 37 

MatrixMultiply ........................................................... 34 

MatrixScale .............................................................. 35 

MatrixSubtract .......................................................... 35 

MatrixTranspose....................................................... 36 

Maximum 

Multibyte Character......................................... 271 

Maximum Value 

Double Floating Point Exponent (base 10) ..... 207 

Double Floating Point Exponent (base 2) ....... 207 

Long Double Floating Point Exponent 

(base 10) .......................................... 210 


(base 2) ............................................ 210 

Multibyte Character......................................... 212 

rand................................................................. 271 

Single Floating Point Exponent (base 10)....... 208 

Single Floating Point Exponent (base 2)......... 209 

Type char ........................................................ 211 

Type Double.................................................... 206 

Type int ........................................................... 211 

Type Long Double........................................... 210 

Type long int ................................................... 212 

Type long long int............................................ 211 

Type long long unsigned int ............................ 213 

Type long unsigned int.................................... 213 

Type short int .................................................. 212 

Type signed char ............................................ 212 

Type Single ..................................................... 208 

Type unsigned char ........................................ 213 

Type unsigned int............................................ 213 

Type unsigned short int................................... 213 

MB_CUR_MAX ...................................................... 271 

MB_LEN_MAX ....................................................... 212 

mblen...................................................................... 285 

mbstowcs ............................................................... 285 

mbtowc ................................................................... 285 

memchr .................................................................. 294 

memcmp................................................................. 295 

Định dạng In ................................................ .......... 225 

Nhân vật có thể in 

Xác định ................................................. ........... 200 

Kiểm tra cho ................................................ ............ 200 

printf ................................................. .............. 225, 253 

Đồng hồ xử lý mỗi thứ hai ................................ 317 

Thời gian xử lý .............................................. 317, 318 

Pseudo-Random Số .............................. 287, 289 

ptrdiff_t ................................................. .................. 223 

Dấu phân cách nhân vật 

Xác định ................................................. ........... 200 

Kiểm tra cho ................................................ ............ 200 

Đẩy Trở lại ................................................ .......... 265 

putc ................................................. ....................... 255 

putchar ................................................. .................. 256 

putcSPIx ................................................. ................ 163 

putcUARTx ................................................. ............ 147 

putrsXLCD ................................................. ............... 76 

đặt ................................................. ....................... 256 

putsSPIx ................................................. ................ 162 

putsUARTx ................................................. ............ 146 

putsXLCD ................................................. ................ 76 

PverrideMCPWM ................................................. 174 .. 

Chức năng PWM 

Đóng cửa PWM ................................................ ..... 171 

Cấu hình Override .......................................... 174 

Cấu hình PWM ............................................... 172 

Cấu hình PWM ngắt ................................ 171 

Ví dụ sử dụng ............................................... 182 

Thiết lập PWM Dead Thời gian chuyển nhượng .................. 176 

Thiết lập PWM Dead Thời gian thế hệ ................... 177 

Đặt PWM Duty Cycle ...................................... 175 

Thiết lập PWM FaultA. ............................................ 178 

Thiết lập PWM FaultB. ............................................ 179 

PWM Macros 

Vô hiệu hoá FLTA ngắt .................................... 180 

Vô hiệu hoá FLTB ngắt .................................... 181 

Vô hiệu hoá PWM ngắt .................................... 180 

Kích hoạt tính năng ngắt FLTA ..................................... 180

memcpy.................................................................. 297 

memmove............................................................... 298 

Memory 

Allocate ................................................... 278, 284 

Deallocate ....................................................... 281 

Free................................................................. 281 

Reallocate ....................................................... 287 

memset................................................................... 299 

Message 

Arithmetic Error ............................................... 216 

Interrupt........................................................... 217 

Invalid Executable Code ................................. 217 

Invalid Storage Request.................................. 218 

Termination Request....................................... 218 

Microchip Internet Web Site ....................................... 5 

Minimum Value 

Double Floating Point Exponent (base 10) ..... 207 

Double Floating Point Exponent (base 2) ....... 208 


(base 10)........................................... 210 


(base 2)............................................. 211 

Single Floating Point Exponent (base 10) ....... 209 

Single Floating Point Exponent (base 2) ......... 209 

Type char ........................................................ 211 

Type Double.................................................... 207 

Type int ........................................................... 211 

Type Long Double........................................... 210 

Type long int.................................................... 212 

Type long long int............................................ 212 

Type short int .................................................. 212 

Type signed char............................................. 212 

Type Single ..................................................... 209 

Minute..................................................... 317, 318, 323 

mktime.................................................................... 322 

modf ....................................................................... 353 

modff ...................................................................... 354 

modulus function 


Kích hoạt tính năng ngắt FLTB ..................................... 181 

Kích hoạt tính năng ngắt PWM ..................................... 180 

dsPIC 

® 



Đặt ưu tiên FLTA ngắt .............................. 181 

Đặt FLTB ngắt ưu tiên .............................. 181 

Thiết lập PWM ngắt ưu tiên .............................. 180 

Q 

Chức năng QEI 

Đóng QEI ................................................ ........ 166 

Cấu hình QEI ................................................ . 167 

Cấu hình QEI ngắt ................................... 166 

Ví dụ sử dụng ............................................... 170 

Đọc QEI Lượt Chức vụ ................................ 168 

Viết QEI Lượt Chức vụ ................................ 169 

QEI Macros 

Vô hiệu hoá QEI ngắt ...................................... 169 

Kích hoạt tính năng QEI ngắt ....................................... 169 

Đặt ưu tiên QEI ngắt ................................. 169 

qsort ................................................. .............. 276, 286 

Nhanh chóng theo ................................................ .............. 286 

R 

Radix ................................................. ..................... 209 

nâng cao ................................ 215, 216, 217, 218, 219, 220 

rand ................................................. ............... 287, 289 

RAND_MAX ................................................. .. 271, 287 

Phạm vi ................................................. .................... 260 

Phạm vi Lỗi ............................ 205, 291, 292, 335, 336, 

...................... 337, 338, 346, 348, 355, 356, 359, 360 

đọc ................................................. ....................... 371 

ReadADC10 ................................................. .......... 106 

ReadADC12 ................................................. ............ 99 

ReadAddrXLCD ................................................. ...... 77 

ReadCapture ................................................. ......... 128 

ReadDataXLCD ................................................. ...... 77 

ReadDCI ................................................. ............... 154 

ReadDCOCxPWM ................................................. . 135


Month ..............................................317, 318, 322, 323 

-msmart-io .............................................................. 225 

Multibyte Character ................................ 271, 285, 293 

Maximum Number of Bytes............................. 212 

Multibyte String............................................... 285, 293 

N 

NaN ........................................................................ 325 

Natural Logarithm 



NDEBUG ................................................................ 195 

Nearest Integer Functions 

ceil................................................................... 332 

ceilf.................................................................. 333 

Index 


floor ................................................................. 340 

floorf................................................................ 340 

Nested Signal Handler ........................................... 214 

Newline ....................201, 225, 235, 240, 251, 252, 256 

No Buffering .................................... 225, 226, 261, 262 

Non-Local Jumps, Seesetjmp.h 

NotAckI2C.............................................................. 186 

NULL............................... 213, 223, 227, 271, 294, 318 

O 

Object Module Format............................................... 7 

Octal................................................ 254, 260, 291, 292 

Octal Conversion ................................................... 253 

offsetof ................................................................... 224 

OMF ........................................................................... 7 

open ....................................................................... 370 

OpenADC10........................................................... 103 

OpenADC12............................................................. 96 

OpenCapturex........................................................ 127 

OpenDCI ................................................................ 151 

OpenI2C................................................................. 187 

OpenMCPWM........................................................ 172 

OpenOCx ............................................................... 133 

Đọc sách, xuất ............................................ 4 

ReadQEI ................................................. ............... 168 

ReadRegOCx ................................................. ........ 136 

ReadSPIx ................................................. .............. 159 

ReadTimerx ................................................. ........... 113 

ReadTimerxx ................................................. ......... 114 

ReadUARTx ................................................. .......... 145 

realloc ................................................. ............ 281, 287 

Phân bổ lại nhớ ................................................ 287 

Xây dựng lại thư viện libpic30 ................................ 366 

Chức năng đăng ký ..................................... 272, 280 

còn lại 



Chức năng còn lại 

fmod ................................................. ............... 341 

fmodf ................................................. .............. 343 

loại bỏ ................................................. .......... 257, 371 

đổi tên ................................................. .......... 257, 371 

Thiết lập lại ................................................. ............. 271, 293 

Thiết lập lại tập tin con trỏ ............................................... 258 .... 

Thiết lập lại chức năng / Control 

Phát hiện điện áp thấp ......................................... 117 

Master Clear lại ......................................... 118 

Thiết lập lại từ Brown-out ..................................... 117 

Thiết lập lại từ Power-on ...................................... 117 

Wake-up từ Sleep ....................................... 119 

Watchdog Timer hết giờ ............................... 118 

Watchdog Timer Wake-up .............................. 118 

Thiết lập lại / Control Macros 

Vô hiệu hoá tất cả các ngắt ....................................... 119 

Vô hiệu hóa Watchdog Timer ................................. 120 

Kích hoạt tính năng Watchdog Timer .................................. 120 

Thiết lập lại Ban đại diện bit ............................................... 119 .. 

Thiết lập lại POR bit ............................................... 119 .. 

RestartI2C ................................................. ............. 188 

tua lại ................................................. .... 258, 265, 369 

Chế độ làm tròn ................................................ ...... 209 

S

OpenQEI ................................................................ 167 

OpenSPIx............................................................... 160 

OpenTimerx ........................................................... 111 

OpenTimerxx ......................................................... 112 

OpenUART ............................................................ 143 

OpenXLCD............................................................... 75 

Output Compare Functions 

Close Compare............................................... 131 

Configure Compare ........................................ 133 

Configure Compare Interrupt .......................... 132 

Example of Use .............................................. 140 

Read Compare Duty Cycle ............................. 136 

Read Compare Duty Cycle - PWM mode ....... 135 

Set Compare Duty Cycle ................................ 138 

Set Compare Duty Cycle - PWM mode .......... 137 

Output Compare Macros 

Disable Compare Interrupt.............................. 139 

Enable Compare Interrupt .............................. 139 

Set Compare Interrupt Priority ........................ 139 

Output Formats ...................................................... 225 

Overflow Errors .............................. 205, 325, 337, 338, 

.................................................... 346, 348, 355, 356 

Overlap ........................... 297, 298, 300, 303, 306, 309 

P 

Pad Characters ...................................................... 253 

Percent............................................ 254, 259, 260, 323 

Peripheral Libraries, dsPIC ...................................... 73 

perror ..................................................................... 252 

pic30-libs ................................................................ 366 

_exit ................................................................ 367 

brk ................................................................... 367 

close ............................................................... 368 

getenv ............................................................. 369 

lseek ............................................................... 369 

open................................................................ 370 

read................................................................. 371 

remove............................................................ 371 

rename............................................................ 371 

sbrk ................................................................. 372 

sbrk ................................................. ................ 368, 372 

Các định dạng quét ................................................ ......... 225 

scanf ................................................. .............. 225, 259 

SCHAR_MAX ................................................. ........ 212 

SCHAR_MIN ................................................. ......... 212 

Chức năng tìm kiếm 

memchr ................................................. .......... 294 

strchr ................................................. .............. 301 

strcspn ................................................. ............ 304 

strpbrk ................................................. ............ 311 

strrchr ................................................. ............. 312 

strspn ................................................. ............. 313 

strstr ................................................. ............... 314 

strtok ................................................. .............. 315 

Thứ hai ............................................ 317, 318, 320 323 

Hạt giống ................................................. .............. 287, 289 

Tìm kiếm 

Từ lúc bắt đầu của tập tin .................................... 244 

Từ Chức vụ hiện nay ..................................... 244 

Từ End Of File ............................................. 244 

SEEK_CUR ................................................. ... 227, 244 

SEEK_END ................................................. ... 228, 244 

SEEK_SET ................................................. .... 228, 244 

setbuf ................................................. ..... 225, 226, 261 

SetCGRamAddr ................................................. ...... 78 

SetChanADC10 ................................................. ..... 106 

SetChanADC12 ................................................. ....... 99 

SetDCMCPWM ................................................. ..... 175 

SetDCOCxPWM ................................................. 137 .... 

SetDDRamAddr ................................................. ....... 78 

setjmp ................................................. .................... 214 

setjmp.h ............................................... ................... 214 

jmp_buf ................................................. .......... 214 

longjmp ................................................. ........... 214 

setjmp ................................................. ............. 214 

setlocale ................................................. ................ 213 

SetMCPWMDeadTimeAssignment ........................ 176 

SetMCPWMDeadTimeGeneration ......................... 177 

SetMCPWMFaultA ................................................. 178

system............................................................. 372 

time ................................................................. 373 

write ................................................................ 373 

Plus Sign ................................................................ 253 

Pointer, Temporary................................................ 287 

PORStatReset........................................................ 119 

pow......................................................................... 355 

power function 



Power Functions 

pow ................................................................. 355 

powf ................................................................ 356 

powf........................................................................ 356 

precision................................................................. 253 

Prefix ...................................................................... 253 

prefix ...................................................................... 202 

Print Formats.......................................................... 225 

Printable Character 

Defined............................................................ 200 

Test for ............................................................ 200 

printf ............................................................... 225, 253 

Processor Clocks per Second................................ 317 

Processor Time .............................................. 317, 318 

Pseudo-Random Number .............................. 287, 289 

ptrdiff_t ................................................................... 223 

Punctuation Character 

Defined............................................................ 200 

Test for ............................................................ 200 

Pushed Back .......................................................... 265 

putc ........................................................................ 255 

putchar ................................................................... 256 

putcSPIx................................................................. 163 

putcUARTx............................................................. 147 

putrsXLCD................................................................ 76 

puts ........................................................................ 256 

putsSPIx................................................................. 162 

putsUARTx............................................................. 146 

putsXLCD................................................................. 76 

SetMCPWMFaultB ................................................. 179 

SetPointIntUxRX ................................................. 148 ... 

SetPriorityIntADC ........................................... 100, 107 

SetPriorityIntCANx ................................................. 92 .. 

SetPriorityIntDCI ................................................. 155 .... 

SetPriorityIntFLTA ................................................. . 181 

SetPriorityIntFLTB ................................................. . 181 

SetPriorityIntlCx .............................................. 129, 139 

Chỉ số 


SetPriorityIntMCPWM ............................................ 180 

SetPriorityIntMI2C ................................................. . 191 

SetPriorityIntQEI ................................................. 169 ... 

SetPriorityIntSI2C ................................................. . 191 

SetPriorityIntSPIx ................................................. 163 .. 

SetPriorityIntTx ................................................. ..... 116 

SetPriorityIntUxTX ................................................. 148 

SetPriorityIntx ................................................. ........ 124 

SetPulseOCx ................................................. ........ 138 

setvbuf ................................................. ... 225, 226, 262 

ngắn int 

Giá trị tối đa .............................................. 212 


SHRT_MAX ................................................. .......... 212 

SHRT_MIN ................................................. ............ 212 

sig_atomic_t ................................................. .......... 215 

SIG_DFL ................................................. ............... 215 

SIG_ERR ................................................. .............. 215 

SIG_IGN ................................................. ............... 215 

SIGABRT ................................................. .............. 216 

SIGFPE ................................................. ................. 216 

SIGILL ................................................. ................... 217 

SIGINT ................................................. .................. 217 

Tín hiệu 

Chấm dứt bất thường .................................... 216 

Lỗi ................................................. ............... 215 

Floating-Point Lỗi ......................................... 216 

Bỏ qua ................................................. ............. 215 

Hướng dẫn bất hợp pháp ............................................. 217

PverrideMCPWM ................................................... 174 

PWM Functions 

Close PWM ..................................................... 171 

Configure Override.......................................... 174 

Configure PWM............................................... 172 

Configure PWM Interrupt ................................ 171 

Example of Use............................................... 182 

Set PWM Dead Time Assignment .................. 176 

Set PWM Dead Time Generation ................... 177 

Set PWM Duty Cycle ...................................... 175 

Set PWM FaultA. ............................................ 178 

Set PWM FaultB. ............................................ 179 

PWM Macros 

Disable FLTA Interrupt.................................... 180 

Disable FLTB Interrupt.................................... 181 

Disable PWM Interrupt.................................... 180 

Enable FLTA Interrupt..................................... 180 

Enable FLTB Interrupt..................................... 181 

Enable PWM Interrupt..................................... 180 

dsPIC 

® 



Set FLTA Interrupt Priority .............................. 181 

Set FLTB Interrupt Priority .............................. 181 

Set PWM Interrupt Priority .............................. 180 

Q 

QEI Functions 

Close QEI........................................................ 166 

Configure QEI ................................................. 167 

Configure QEI Interrupt................................... 166 

Example of Use............................................... 170 

Read QEI Position Count................................ 168 

Write QEI Position Count ................................ 169 

QEI Macros 

Disable QEI Interrupt ...................................... 169 

Enable QEI Interrupt ....................................... 169 

Set QEI Interrupt Priority ................................. 169 

qsort ............................................................... 276, 286 

Ngắt ................................................. ......... 217 

Báo cáo ................................................. ....... 219 

Yêu cầu chấm dứt ...................................... 218 

tín hiệu ............................................... 216, 217, 218, 220 

Tín hiệu Handler ................................................ 215, 220 

Tín hiệu Handler Loại .............................................. 215 

Xử lý tín hiệu, Seesignal.h 

signal.h ............................................... .................... 215 

nâng cao ................................................. ............... 219 

sig_atomic_t ................................................. 215 ... 

SIG_DFL ................................................. ........ 215 

SIG_ERR ................................................. ....... 215 

SIG_IGN ................................................. ........ 215 

SIGABRT ................................................. ....... 216 

SIGFPE ................................................. .......... 216 

SIGILL ................................................. ............ 217 

SIGINT ................................................. ........... 217 

tín hiệu ................................................. ............. 220 

SIGSEGV ................................................. ....... 218 

SIGTERM ................................................. ...... 218 

ký char 

Giá trị tối đa .............................................. 212 


SIGSEGV ................................................. .............. 218 

SIGTERM ................................................. .............. 218 

sim30 mô phỏng ................................................ ...... 366 

tội lỗi ................................................. ......................... 357 

sin 



sinf ................................................. ........................ 358 

Độc chính xác dấu chấm động 

Máy Epsilon .............................................. 208 



Giá trị tối đa .............................................. 208 

Tối thiểu Exponent (10 cơ sở) ......................... 209 


Giá trị tối thiểu ............................................... 209

Quick Sort .............................................................. 286 

R 

Radix ...................................................................... 209 

raise ................................ 215, 216, 217, 218, 219, 220 

rand ................................................................ 287, 289 

RAND_MAX ................................................... 271, 287 

Range..................................................................... 260 

Range Error............................ 205, 291, 292, 335, 336, 

......................337, 338, 346, 348, 355, 356, 359, 360 

read ........................................................................ 371 

ReadADC10 ........................................................... 106 

ReadADC12 ............................................................. 99 

ReadAddrXLCD ....................................................... 77 

ReadCapture.......................................................... 128 

ReadDataXLCD ....................................................... 77 

ReadDCI ................................................................ 154 

ReadDCOCxPWM.................................................. 135 

Reading, Recommended............................................ 4 

ReadQEI ................................................................ 168 

ReadRegOCx ......................................................... 136 

ReadSPIx ............................................................... 159 

ReadTimerx............................................................ 113 

ReadTimerxx .......................................................... 114 

ReadUARTx ........................................................... 145 

realloc............................................................. 281, 287 

Reallocate Memory ................................................ 287 

Rebuilding the libpic30 library ................................ 366 

Registered Functions..................................... 272, 280 

remainder 



Remainder Functions 

fmod ................................................................ 341 

fmodf ............................................................... 343 

remove ........................................................... 257, 371 

rename ........................................................... 257, 371 

Reset.............................................................. 271, 293 

Reset File Pointer................................................... 258 

Reset/Control Functions 



sinh ................................................. ........................ 359 

sinhf ................................................. ....................... 360 

kích thước ................................................. ........................ 254 

size_t ....................................... 223, 226, 270, 294, 317 

sizeof ....................................... 223, 226, 270, 294, 317 

SlavegetsI2C ................................................. ......... 188 

SlaveputsI2C ................................................. ......... 189 

SlaveReadI2C ................................................. ....... 189 

SlaveWriteI2C ................................................. ....... 189 

Sắp xếp, nhanh ............................................... .............. 286 

Source File Name ............................................... 195 ... 

Nguồn dòng Số .............................................. 195 

Không gian ................................................. .................... 253 

Không gian nhân vật 

Xác định ................................................. ........... 201 

Kiểm tra cho ................................................ ............ 201 

Specifiers ................................................. ...... 253, 259 

Chức năng SPI 

Đóng SPI ................................................ ........ 158 

Cấu hình SPI ................................................ 160 .. 

Cấu hình SPI ngắt ................................... 158 

Ví dụ sử dụng ............................................... 164 

Đọc SPI RX đệm ........................................ 159 

SPI đệm trạng ............................................ 159 

SPI Get nhân vật ........................................... 163 

SPI Nhận Chuỗi ............................................... 162 .. 

SPI Đặt nhân vật ........................................... 163 

SPI Đặt chuỗi ............................................... 162 .. 

Viết SPI TX đệm ......................................... 160 

SPI Macros 

Vô hiệu hóa ngắt SPI ....................................... 163 

Kích hoạt tính năng SPI ngắt ........................................ 163 

Đặt ưu tiên ngắt SPI ................................. 163 

sprintf ................................................. ............ 225, 263 

sqrt ................................................. ........................ 361 

sqrtf ................................................. ....................... 362 

chức năng căn bậc hai

Low Voltage Detect......................................... 117 

Master Clear Reset......................................... 118 

Reset from Brown-out ..................................... 117 

Reset from Power-on...................................... 117 

Wake-up from Sleep ....................................... 119 

Watchdog Timer Time-out............................... 118 

Watchdog Timer Wake-up .............................. 118 

Reset/Control Macros 

Disable All Interrupts ....................................... 119 

Disable Watchdog Timer ................................. 120 

Enable Watchdog Timer.................................. 120 

Reset BOR bit ................................................. 119 

Reset POR bit ................................................. 119 

RestartI2C .............................................................. 188 

rewind..................................................... 258, 265, 369 

Rounding Mode ...................................................... 209 

S 

sbrk................................................................. 368, 372 

Scan Formats ......................................................... 225 

scanf............................................................... 225, 259 

SCHAR_MAX ......................................................... 212 

SCHAR_MIN .......................................................... 212 

Search Functions 

memchr ........................................................... 294 

strchr ............................................................... 301 

strcspn............................................................. 304 

strpbrk ............................................................. 311 

strrchr .............................................................. 312 

strspn .............................................................. 313 

strstr ................................................................ 314 

strtok ............................................................... 315 

Second ............................................317, 318, 320, 323 

Seed ............................................................... 287, 289 

Seek 

From Beginning of File .................................... 244 

From Current Position ..................................... 244 

From End Of File............................................. 244 

SEEK_CUR .................................................... 227, 244 

SEEK_END .................................................... 228, 244 



Chức năng gốc vuông 

sqrt ................................................. ................. 361 

sqrtf ................................................. ................ 362 

srand ................................................. ..................... 289 

sscanf ................................................. ............ 225, 263 

Ngăn xếp ................................................. ..................... 368 

Thư viện chuẩn C ............................................... 193 .. 

Tiêu chuẩn C Locale ............................................... 196 .. 

Chuẩn Lỗi ................................................ 225, 228 

Tiêu chuẩn đầu vào ................................................ 225, 228 

Đầu ra tiêu chuẩn ............................................. 225, 228 

dsPIC 

® 



StartI2C ................................................. ................. 190 

Startup ................................................. ................... 225 

Module, thay thế ............................................... . 8 

Module, tiểu học ............................................... 8 ... 

stdarg.h ............................................... ................... 221 

va_arg ................................................. ............ 221 

va_end ................................................. ........... 223 

va_list ................................................. ............. 221 

va_start ................................................. .......... 223 

stddef.h ............................................... ................... 223 

NULL ................................................. .............. 223 

offsetof ................................................. ........... 224 

ptrdiff_t ................................................. ........... 223 

size_t ................................................. .............. 223 

wchar_t ................................................. .......... 223 

stderr ....................................... 195, 225, 227, 228, 252 

stdin ......................................... 225, 227, 228, 251, 259 

stdio.h ............................................... .............. 225, 371 

_IOFBF ................................................. .......... 226 

_IOLBF ................................................. ........... 226 

_IONBF ................................................. .......... 226 

BUFSIZ ................................................. .......... 226

SEEK_SET..................................................... 228, 244 

setbuf...................................................... 225, 226, 261 

SetCGRamAddr ....................................................... 78 

SetChanADC10...................................................... 106 

SetChanADC12........................................................ 99 

SetDCMCPWM ...................................................... 175 

SetDCOCxPWM..................................................... 137 

SetDDRamAddr........................................................ 78 

setjmp..................................................................... 214 

setjmp.h.................................................................. 214 

jmp_buf ........................................................... 214 

longjmp............................................................ 214 

setjmp.............................................................. 214 

setlocale ................................................................. 213 

SetMCPWMDeadTimeAssignment ........................ 176 

SetMCPWMDeadTimeGeneration ......................... 177 

SetMCPWMFaultA ................................................. 178 

SetMCPWMFaultB ................................................. 179 

SetPointIntUxRX .................................................... 148 

SetPriorityIntADC ........................................... 100, 107 

SetPriorityIntCANx ................................................... 92 

SetPriorityIntDCI..................................................... 155 

SetPriorityIntFLTA .................................................. 181 

SetPriorityIntFLTB .................................................. 181 

SetPriorityIntlCx.............................................. 129, 139 

Index 


SetPriorityIntMCPWM............................................ 180 

SetPriorityIntMI2C.................................................. 191 

SetPriorityIntQEI .................................................... 169 

SetPriorityIntSI2C .................................................. 191 

SetPriorityIntSPIx ................................................... 163 

SetPriorityIntTx ...................................................... 116 

SetPriorityIntUxTX ................................................. 148 

SetPriorityIntx......................................................... 124 

SetPulseOCx ......................................................... 138 

setvbuf ....................................................225, 226, 262 

short int 

Maximum Value .............................................. 212 

clearerr ................................................. ........... 229 

EOF ................................................. ................ 227 

fclose ................................................. .............. 230 

feof ................................................. ................. 231 

ferror ................................................. .............. 232 

fflush ................................................. .............. 233 

fgetc ................................................. ............... 233 

fgetpos ................................................. ........... 234 

fgets ................................................. ............... 235 

FILE ................................................. ............... 226 

FILENAME_MAX ............................................ 227 

fopen ................................................. .............. 236 

FOPEN_MAX ................................................. . 227 

fpos_t ................................................. ............. 226 

fprintf ................................................. .............. 238 

fputc ................................................. ............... 239 

fputs ................................................. ............... 239 

fread ................................................. ............... 240 

freopen ................................................. ........... 242 

fscanf ................................................. ............. 242 

fseek ................................................. .............. 244 

fsetpos ................................................. ........... 245 

ftell ................................................. ................. 247 

fwrite ................................................. .............. 248 

getc ................................................. ................ 250 

getchar ................................................. ........... 251 

được ................................................. ................ 251 

L_tmpnam ................................................. ...... 227 

NULL ................................................. .............. 227 

perror ................................................. ............. 252 

printf ................................................. ............... 253 

putc ................................................. ................ 255 

putchar ................................................. ........... 256 

đặt ................................................. ................ 256 

loại bỏ ................................................. ........... 257 

đổi tên ................................................. ........... 257 

tua lại ................................................. ............ 258 

scanf ................................................. .............. 259 

SEEK_CUR ................................................. 227 ....

Minimum Value ............................................... 212 

SHRT_MAX ........................................................... 212 

SHRT_MIN............................................................. 212 

sig_atomic_t........................................................... 215 

SIG_DFL ................................................................ 215 

SIG_ERR ............................................................... 215 

SIG_IGN ................................................................ 215 

SIGABRT ............................................................... 216 

SIGFPE.................................................................. 216 

SIGILL.................................................................... 217 

SIGINT ................................................................... 217 

Signal 

Abnormal Termination .................................... 216 

Error ................................................................ 215 

Floating-Point Error......................................... 216 

Ignore.............................................................. 215 

Illegal Instruction............................................. 217 

Interrupt .......................................................... 217 

Reporting ........................................................ 219 

Termination Request...................................... 218 

signal............................................... 216, 217, 218, 220 

Signal Handler ................................................215, 220 

Signal Handler Type .............................................. 215 

Signal Handling, Seesignal.h 

signal.h................................................................... 215 

raise ................................................................ 219 

sig_atomic_t.................................................... 215 

SIG_DFL......................................................... 215 

SIG_ERR ........................................................ 215 

SIG_IGN ......................................................... 215 

SIGABRT ........................................................ 216 

SIGFPE........................................................... 216 

SIGILL............................................................. 217 

SIGINT............................................................ 217 

signal .............................................................. 220 

SIGSEGV........................................................ 218 

SIGTERM ....................................................... 218 

signed char 

Maximum Value .............................................. 212 

SEEK_END ................................................. 228 .... 

SEEK_SET ................................................. ..... 228 

setbuf ................................................. ............. 261 

setvbuf ................................................. ............ 262 

size_t ................................................. .............. 226 

sprintf ................................................. ............. 263 

sscanf ................................................. ............. 263 

stderr ................................................. .............. 228 

stdin ................................................. ................ 228 

thiết bị xuất chuẩn ................................................. ............. 228 

TMP_MAX ................................................. ...... 228 

tmpfile ................................................. ............. 264 

tmpnam ................................................. .......... 265 

ungetc ................................................. ............ 265 

vfprintf ................................................. ............ 267 

vprintf ................................................. ............. 268 

vsprintf ................................................. ............ 269 

stdlib.h ............................................... ..... 270, 369, 372 

hủy bỏ ................................................. ............... 271 

abs ................................................. ................. 272 

atexit ................................................. ............... 272 

atof ................................................. ................. 274 

atoi ................................................. ................. 275 

atol ................................................. ................. 275 

bsearch ................................................. .......... 276 

calloc ................................................. .............. 278 

div ................................................. ................... 278 

div_t ................................................. ................ 270 

thoát ................................................. .................. 280 

EXIT_FAILURE ............................................... 270 

EXIT_SUCCESS ............................................. 270 

................................................. miễn phí ................. 281 

getenv ................................................. ............ 281 

phòng thí nghiệm ................................................. ................. 282 

ldiv ................................................. .................. 283 

ldiv_t ................................................. ............... 270 

malloc ................................................. ............. 284 

MB_CUR_MAX ............................................... 271 

mblen ................................................. ............. 285

Minimum Value ............................................... 212 

SIGSEGV............................................................... 218 

SIGTERM............................................................... 218 

sim30 simulator ...................................................... 366 

sin .......................................................................... 357 

sine 



sinf ......................................................................... 358 

Single Precision Floating Point 

Machine Epsilon.............................................. 208 



Maximum Value .............................................. 208 



Minimum Value ............................................... 209 



sinh......................................................................... 359 

sinhf........................................................................ 360 

size......................................................................... 254 

size_t....................................... 223, 226, 270, 294, 317 

sizeof....................................... 223, 226, 270, 294, 317 

SlavegetsI2C.......................................................... 188 

SlaveputsI2C.......................................................... 189 

SlaveReadI2C ........................................................ 189 

SlaveWriteI2C ........................................................ 189 

Sort, Quick ............................................................. 286 

Source File Name .................................................. 195 

Source Line Number .............................................. 195 

Space ..................................................................... 253 

Space Character 

Defined............................................................ 201 

Test for ............................................................ 201 

Specifiers ....................................................... 253, 259 

SPI Functions 

Close SPI ........................................................ 158 

Configure SPI.................................................. 160 

mbstowcs ................................................. ....... 285 

mbtowc ................................................. ........... 285 

NULL ................................................. .............. 271 

qsort ................................................. ............... 286 

rand ................................................. ................ 287 

RAND_MAX ................................................. 271 ... 

realloc ................................................. ............. 287 

size_t ................................................. .............. 270 

srand ................................................. .............. 289 

strtod ................................................. .............. 289 

strtol ................................................. ............... 291 

strtoul ................................................. ............. 292 

hệ thống ................................................. ............ 293 

wchar_t ................................................. ........... 270 

wctomb ................................................. ........... 293 

wxstombs ................................................. ....... 293 

thiết bị xuất chuẩn ....................................... 225, 227, 228, 253, 256 

StopI2C ................................................. ................. 190 

StopSampADC10 ................................................. 106 .. 

StopSampADC12 ................................................. 99 .... 

Chỉ số 


strcat ................................................. ..................... 300 

strchr ................................................. ..................... 301 

strcmp ................................................. ................... 302 

strcoll ................................................. ..................... 303 

strcpy ................................................. .................... 303 

strcspn ................................................. .................. 304 

Suối ................................................. ................. 225 

................................................. Nhị phân ............. 225 

Đệm ................................................. ........ 262 

Đóng ................................................. .... 230, 280 

Mở ................................................. ......... 236 

Đọc Từ ................................................ . 250 

Văn bản ................................................. ................ 225 

Viết Để ................................................ 248, 255 

dột ................................................. .................. 305 

strftime ................................................. .................. 322 

Chuỗi

Configure SPI Interrupt ................................... 158 

Example of Use............................................... 164 

Read SPI RX Buffer ........................................ 159 

SPI Buffer Status ............................................ 159 

SPI Get Character........................................... 163 

SPI Get String ................................................. 162 

SPI Put Character........................................... 163 

SPI Put String ................................................. 162 

Write SPI TX Buffer......................................... 160 

SPI Macros 

Disable SPI Interrupt....................................... 163 

Enable SPI Interrupt........................................ 163 

Set SPI Interrupt Priority ................................. 163 

sprintf ............................................................. 225, 263 

sqrt ......................................................................... 361 

sqrtf ........................................................................ 362 

square root function 



Square Root Functions 

sqrt .................................................................. 361 

sqrtf ................................................................. 362 

srand ...................................................................... 289 

sscanf............................................................. 225, 263 

Stack ...................................................................... 368 

Standard C Library................................................. 193 

Standard C Locale ................................................. 196 

Standard Error................................................ 225, 228 

Standard Input................................................ 225, 228 

Standard Output............................................. 225, 228 

dsPIC 

® 



StartI2C .................................................................. 190 

Startup.................................................................... 225 

Module, Alternate................................................ 8 

Module, Primary .................................................. 8 

stdarg.h .................................................................. 221 

Chiều dài ................................................. ............ 305 

Tìm kiếm ................................................. ........... 314 

Chuyển đổi ................................................. ...... 316 

Chức năng String, Seestring.h 

string.h ............................................... .................... 294 

memchr ................................................. .......... 294 

memcmp ................................................. ........ 295 

memcpy ................................................. ......... 297 

memmove ................................................. ...... 298 

memset ................................................. .......... 299 

NULL ................................................. .............. 294 

size_t ................................................. ............. 294 

strcat ................................................. .............. 300 

strchr ................................................. .............. 301 

strcmp ................................................. ............ 302 

strcoll ................................................. ............. 303 

strcpy ................................................. ............. 303 

strcspn ................................................. ........... 304 

dột ................................................. ........... 305 

strlen ................................................. .............. 305 

strncat ................................................. ............ 306 

strncmp ................................................. .......... 308 

strncpy ................................................. ........... 309 

strpbrk ................................................. ............ 311 

strrchr ................................................. ............. 312 

strspn ................................................. ............. 313 

strstr ................................................. ............... 314 

strtok ................................................. .............. 315 

strxfrm ................................................. ............ 316 

strlen ................................................. ..................... 305 

strncat ................................................. ................... 306 

strncmp ................................................. ................. 308 

strncpy ................................................. .................. 309 

strpbrk ................................................. ................... 311 

strrchr ................................................. .................... 312 

strspn ................................................. .................... 313 

strstr ................................................. ...................... 314 

strtod ................................................. .............. 274, 289 

strtok ................................................. ..................... 315

va_arg ............................................................. 221 

va_end ............................................................ 223 

va_list.............................................................. 221 

va_start ........................................................... 223 

stddef.h .................................................................. 223 

NULL............................................................... 223 

offsetof ............................................................ 224 

ptrdiff_t ............................................................ 223 

size_t............................................................... 223 

wchar_t ........................................................... 223 

stderr ....................................... 195, 225, 227, 228, 252 

stdin......................................... 225, 227, 228, 251, 259 

stdio.h............................................................. 225, 371 

_IOFBF ........................................................... 226 

_IOLBF............................................................ 226 

_IONBF ........................................................... 226 

BUFSIZ ........................................................... 226 

clearerr ............................................................ 229 

EOF................................................................. 227 

fclose............................................................... 230 

feof .................................................................. 231 

ferror ............................................................... 232 

fflush ............................................................... 233 

fgetc ................................................................ 233 

fgetpos ............................................................ 234 

fgets ................................................................ 235 

FILE ................................................................ 226 

FILENAME_MAX ............................................ 227 

fopen ............................................................... 236 

FOPEN_MAX.................................................. 227 

fpos_t .............................................................. 226 

fprintf ............................................................... 238 

fputc ................................................................ 239 

fputs ................................................................ 239 

fread................................................................ 240 

freopen............................................................ 242 

fscanf .............................................................. 242 

fseek ............................................................... 244 

fsetpos ............................................................ 245 

strtol ................................................. ............... 275, 291 

strtoul ................................................. .................... 292 

cấu trúc lconv ................................................ ............. 213 

struct tm ................................................ ................. 317 

strxfrm ................................................. ................... 316 

Chuỗi con ................................................. ............. 315 

Con trỏ trừ ............................................... 223 

Chấm dứt thành công .......................................... 270 

hệ thống ................................................. ........... 293, 372 

T 

Tab ................................................. ........................ 201 

tan ................................................. ......................... 363 

TANF ................................................. ........................ 363 

tiếp tuyến 



tanh ................................................. ....................... 364 

tanhf ................................................. ...................... 365 

Tạm thời 

Tập ................................................. ......... 264, 280 

Tên tập tin ................................................. 227, 265 

Pointer ................................................. ............ 287 

Chấm dứt 

Yêu cầu nhắn ........................................... 218 

Yêu cầu tín hiệu ................................................ 218 

................................................. Thành công ...... 270 

................................................. Không thành công 270 .. 

Chế độ văn bản ................................................ .............. 236 

Văn bản Streams ................................................ .......... 225 

Bọ ve ................................................. ....... 317, 318, 320 

Hiện ................................................. ............... 324, 373 

Thời gian khác biệt ................................................ ...... 320 

Cơ cấu thời gian ................................................ 317, 322 

Time Zone ................................................ .............. 323 

time.h ............................................... .............. 317, 373 

asctime ................................................. ........... 318 

đồng hồ ................................................. ............... 318 

clock_t ................................................. ............ 317 

CLOCKS_PER_SEC ...................................... 317

ftell .................................................................. 247 

fwrite ............................................................... 248 

getc ................................................................. 250 

getchar ............................................................ 251 

gets ................................................................. 251 

L_tmpnam ....................................................... 227 

NULL............................................................... 227 

perror .............................................................. 252 

printf ................................................................ 253 

putc ................................................................. 255 

putchar ............................................................ 256 

puts ................................................................. 256 

remove ............................................................ 257 

rename............................................................ 257 

rewind ............................................................. 258 

scanf ............................................................... 259 

SEEK_CUR..................................................... 227 

SEEK_END ..................................................... 228 

SEEK_SET...................................................... 228 

setbuf .............................................................. 261 

setvbuf............................................................. 262 

size_t............................................................... 226 

sprintf .............................................................. 263 

sscanf.............................................................. 263 

stderr ............................................................... 228 

stdin................................................................. 228 

stdout .............................................................. 228 

TMP_MAX....................................................... 228 

tmpfile.............................................................. 264 

tmpnam ........................................................... 265 

ungetc ............................................................. 265 

vfprintf ............................................................. 267 

vprintf .............................................................. 268 

vsprintf............................................................. 269 

stdlib.h .................................................... 270, 369, 372 

abort ................................................................ 271 

abs .................................................................. 272 

atexit................................................................ 272 

atof .................................................................. 274 

ctime ................................................. .............. 319 

difftime ................................................. ........... 320 

gmtime ................................................. ........... 320 

localtime ................................................. ......... 321 

mktime ................................................. ........... 322 

NULL ................................................. .............. 318 

size_t ................................................. .............. 317 

strftime ................................................. ........... 322 

struct tm ................................................ .......... 317 

Hiện ................................................. ................ 324 

time_t ................................................. ............. 317 

time_t ................................................. ..... 317, 322, 324 

Chức năng hẹn giờ 

Đóng ................................................. .............. 109 

Đóng cửa 32-bit .............................................. ....... 109 

Cấu hình ngắt .......................................... 110 

Cấu hình ngắt 32-bit ................................ 111 

Ví dụ sử dụng ............................................... 116 

Mở ................................................. .............. 111 

Mở cửa 32-bit .............................................. ....... 112 

Đọc ................................................. .............. 113 

Đọc 32-bit .............................................. ....... 114 

Viết ................................................. ............... 114 

Viết 32-bit .............................................. ........ 115 

dsPIC 

® 



Thơi gian Macros 

Vô hiệu hóa ngắt .............................................. 115 

Kích hoạt tính năng ngắt .............................................. 115 

Thiết lập ngắt ưu tiên ........................................ 116 

TMP_MAX ................................................. ............. 228 

tmpfile ................................................. .................... 264 

tmpnam ................................................. ................. 265 

Thẻ ................................................. .................. 315 

ToLower ................................................. ................... 203 

toupper ................................................. .................. 204 

Chuyển điều khiển ............................................... 214

atoi .................................................................. 275 

atol .................................................................. 275 

bsearch ........................................................... 276 

calloc ............................................................... 278 

div.................................................................... 278 

div_t................................................................. 270 

exit................................................................... 280 

EXIT_FAILURE ............................................... 270 

EXIT_SUCCESS............................................. 270 

free .................................................................. 281 

getenv ............................................................. 281 

labs.................................................................. 282 

ldiv................................................................... 283 

ldiv_t................................................................ 270 

malloc.............................................................. 284 

MB_CUR_MAX ............................................... 271 

mblen .............................................................. 285 

mbstowcs ........................................................ 285 

mbtowc............................................................ 285 

NULL ............................................................... 271 

qsort ................................................................ 286 

rand ................................................................. 287 

RAND_MAX .................................................... 271 

realloc.............................................................. 287 

size_t............................................................... 270 

srand ............................................................... 289 

strtod ............................................................... 289 

strtol ................................................................ 291 

strtoul .............................................................. 292 

system............................................................. 293 

wchar_t............................................................ 270 

wctomb............................................................ 293 

wxstombs ........................................................ 293 

stdout.......................................225, 227, 228, 253, 256 

StopI2C .................................................................. 190 

StopSampADC10 ................................................... 106 

StopSampADC12 ..................................................... 99 

Index 


Chuyển đổi chức năng ................................................ 58 

BitReverseComplex .......................................... 60 

CosFactorInit ................................................. 61 .... 

DCT ................................................. .................. 61 

DCTIP ................................................. .............. 63 

FFTComplex ................................................. 64 .... 

FFTComplexIP ................................................. . 66 

IFFTComplex ................................................. 67 ... 

IFFTComplexIP ................................................. 69 

TwidFactorInit ................................................. 70 .. 

Chuyển đổi chuỗi ................................................ ..... 316 

Chức năng lượng giác 

acos ................................................. ............... 325 

acosf ................................................. .............. 326 

asin ................................................. ................ 327 

asinf ................................................. ............... 327 

atan ................................................. ................ 328 

atan2 ................................................. .............. 329 

atan2f ................................................. ............. 331 

atanf ................................................. ............... 329 

cos ................................................. ................. 333 

cosf ................................................. ................ 334 

tội lỗi ................................................. .................. 357 

sinf ................................................. ................. 358 

tan ................................................. .................. 363 

TANF ................................................. ................. 363 

TwidFactorInit ................................................. .......... 70 

gõ ................................................. ............... 254, 260 

U 

Chức năng UART 

Đóng UART. .................................................. . 141 

Cấu hình UART .............................................. 143 

Cấu hình UART ngắt ............................... 142 

Ví dụ sử dụng ............................................... 149 

Đọc UART ................................................ ..... 145 

UART đệm trạng ........................................ 143 

UART Nhận vật ....................................... 147 

Nhận UART chuỗi ............................................. 146 

UART Đặt nhân vật ....................................... 147

strcat ...................................................................... 300 

strchr ...................................................................... 301 

strcmp .................................................................... 302 

strcoll...................................................................... 303 

strcpy ..................................................................... 303 

strcspn ................................................................... 304 

Streams.................................................................. 225 

Binary.............................................................. 225 

Buffering ......................................................... 262 

Closing.....................................................230, 280 

Opening .......................................................... 236 

Reading From ................................................. 250 

Text................................................................. 225 

Writing To ................................................248, 255 

strerror ................................................................... 305 

strftime ................................................................... 322 

String 

Length............................................................. 305 

Search ............................................................ 314 

Transform ....................................................... 316 

String Functions, Seestring.h 

string.h ................................................................... 294 

memchr ........................................................... 294 

memcmp ......................................................... 295 

memcpy .......................................................... 297 

memmove ....................................................... 298 

memset ........................................................... 299 

NULL............................................................... 294 

size_t .............................................................. 294 

strcat ............................................................... 300 

strchr ............................................................... 301 

strcmp ............................................................. 302 

strcoll .............................................................. 303 

strcpy .............................................................. 303 

strcspn ............................................................ 304 

strerror ............................................................ 305 

strlen ............................................................... 305 

strncat ............................................................. 306 

strncmp ........................................................... 308 

UART Đặt chuỗi ............................................. 146 

UART Tình trạng ................................................ 141 ... 

Viết UART ................................................ ..... 145 

UART Macros 

Vô hiệu hoá UART RX ngắt ............................. 147 

Vô hiệu hoá UART TX ngắt ............................. 148 

Kích hoạt tính năng ngắt UART RX .............................. 147 

Kích hoạt tính năng ngắt UART TX .............................. 147 

Đặt ưu tiên UART RX ngắt ....................... 148 

Đặt ưu tiên UART TX ngắt ........................ 148 

UCHAR_MAX ................................................. ........ 213 

UINT_MAX ................................................. ............ 213 

ULLONG_MAX ................................................. ...... 213 

ULONG_MAX ................................................. ........ 213 

Lỗi Van cân bằng .................................... 205, 325, 337, 

............................................. 338, 346, 348 , 355, 356 

ungetc ................................................. .................... 265 

Universal Time Coordinated ................................... 320 

unsigned char 

Giá trị tối đa .............................................. 213 

int 

Giá trị tối đa .............................................. 213 

unsigned short int 

Giá trị tối đa .............................................. 213 

Chấm dứt không thành công ...................................... 270 

Upper Case chữ cái ký tự 

Để chuyển đổi ................................................ ...... 204 

Xác định ................................................. ........... 202 

Kiểm tra cho ................................................ ............ 202 

USHRT_MAX ................................................. ........ 213 

UTC ................................................. ....................... 320 

Các chức năng tiện ích, Seestdlib.h 

V 

va_arg ..................................... 221, 223, 267, 268, 269 

va_end ............................................. 223, 267, 268, 269 

va_list ................................................. .................... 221 

va_start ............................................ 223, 267, 268 , 269 

Danh sách Đối số biến, Seestdarg.h 

Variable Length Danh sách Đối số ...................... 221, 223,

strncpy ............................................................ 309 

strpbrk ............................................................. 311 

strrchr.............................................................. 312 

strspn .............................................................. 313 

strstr ................................................................ 314 

strtok ............................................................... 315 

strxfrm............................................................. 316 

strlen ...................................................................... 305 

strncat .................................................................... 306 

strncmp .................................................................. 308 

strncpy ................................................................... 309 

strpbrk .................................................................... 311 

strrchr ..................................................................... 312 

strspn ..................................................................... 313 

strstr ....................................................................... 314 

strtod ...............................................................274, 289 

strtok ...................................................................... 315 

strtol ................................................................275, 291 

strtoul ..................................................................... 292 

struct lconv ............................................................. 213 

struct tm ................................................................. 317 

strxfrm .................................................................... 316 

Substrings .............................................................. 315 

Subtracting Pointers............................................... 223 

Successful Termination.......................................... 270 

system............................................................ 293, 372 

T 

Tab ......................................................................... 201 

tan .......................................................................... 363 

tanf ......................................................................... 363 

tangent 



tanh ........................................................................ 364 

tanhf ....................................................................... 365 

Temporary 

File .......................................................... 264, 280 

Filename ................................................. 227, 265 

Pointer............................................................. 287 

.................................................. .......... 267, 268, 269 

Chức năng Vector ................................................ ...... 13 

VectorAdd ................................................. ................ 15 

VectorConvolve ................................................. ....... 16 

VectorCopy ................................................. .............. 17 

VectorCorrelate ................................................. ....... 18 

VectorDotProduct ................................................. 19 .... 

VectorMax ................................................. ............... 19 

VectorMin ................................................. ................ 20 

VectorMultiply ................................................. .......... 21 

VectorNegate ................................................. .......... 21 

VectorPower ................................................. ............ 22 

VectorScale ................................................. ............. 23 

VectorSubtract ................................................. ......... 23 

VectorWindow ................................................. ......... 29 

VectorZeroPad ................................................. ........ 24 

VERBOSE_DEBUGGING ...................................... 195 

Vertical Tab ................................................ ............ 201 

vfprintf ................................................. ............ 225, 267 

vprintf ................................................. ............. 225, 268 

vsprintf ................................................. ........... 225, 269 

W 

wchar_t ................................................. .......... 223, 270 

wcstombs ................................................. .............. 293 

wctomb ................................................. .................. 293 

WDTSWDisable ................................................. 120 .... 

WDTSWEnable ................................................. ..... 120 

Tuần ................................................. ..................... 323 

Không gian trắng .................................... 259, 274, 275, 289 

Chỉ số 


Trắng không gian nhân vật 

Xác định ................................................. .......... 201 

Kiểm tra cho ................................................ ............ 201 

................................................. rộng ....................... 270 

Character rộng ............................................... 285 , 293 

Rộng chuỗi ký tự ..................................... 285, 293 

Wide nhân vật Giá trị ............................................ 223 

Chiều rộng ................................................. ..................... 253

Termination 

Request Message ........................................... 218 

Request Signal................................................ 218 

Successful....................................................... 270 

Unsuccessful................................................... 270 

Text Mode .............................................................. 236 

Text Streams.......................................................... 225 

Ticks........................................................317, 318, 320 

time ................................................................ 324, 373 

Time Difference...................................................... 320 

Time Structure................................................ 317, 322 

Time Zone .............................................................. 323 

time.h ............................................................. 317, 373 

asctime............................................................ 318 

clock................................................................ 318 

clock_t............................................................. 317 

CLOCKS_PER_SEC ...................................... 317 

ctime ............................................................... 319 

difftime ............................................................ 320 

gmtime ............................................................ 320 

localtime.......................................................... 321 

mktime ............................................................ 322 

NULL............................................................... 318 

size_t............................................................... 317 

strftime ............................................................ 322 

struct tm .......................................................... 317 

time ................................................................. 324 

time_t .............................................................. 317 

time_t ......................................................317, 322, 324 

Timer Functions 

Close............................................................... 109 

Close 32-bit..................................................... 109 

Configure Interrupt.......................................... 110 

Configure Interrupt 32-bit ................................ 111 

Example of Use............................................... 116 

Open ............................................................... 111 

Open 32-bit ..................................................... 112 

Read ............................................................... 113 

Read 32-bit ..................................................... 114 

chiều rộng ................................................. ............... 253, 259 

Chức năng cửa sổ 

BartlettInit ................................................. ......... 26 

BlackmanInit ................................................. 27 .... 

HammingInit ................................................. ..... 28 

HanningInit ................................................. ....... 28 

KaiserInit ................................................. .......... 29 

VectorWindow ................................................. 29 .. 

viết ................................................. ....................... 373 

WriteCmdXLCD ................................................. ....... 79 

WriteDataXLCD ................................................. ....... 78 

WriteDCI ................................................. ................ 154 

WriteQEI ................................................. ................ 169 

WriteSPIx ................................................. .............. 160 

WriteTimerx ................................................. ........... 114 

WriteTimerxx ................................................. ......... 115 

WriteUARTx ................................................. .......... 145 

Địa chỉ Email ................................................ ........... 5 

Y 

Năm ................................................. ........ 317, 318, 323 

Z 

Không ................................................. ....................... 325 

Zero, chia ......................................... 216, 219, 278 


Châu Mỹ 

Văn phòng công ty 

2355 Tây Chandler Blvd 

Chandler, AZ 85224-6199 

Điện thoại: 480-792-7200 

Fax: 480-792-7277 

Hỗ trợ kỹ thuật: 

http: \\ support.microchip.com 

Địa chỉ Web: 

www.microchip.com 

Atlanta 

Alpharetta, GA 

Điện thoại: 770-640-0034 

Fax: 770-640-0307 

Boston

Write................................................................ 114 

Write 32-bit...................................................... 115 

dsPIC 

® 



Timer Macros 

Disable Interrupt.............................................. 115 

Enable Interrupt .............................................. 115 

Set Interrupt Priority........................................ 116 

TMP_MAX.............................................................. 228 

tmpfile..................................................................... 264 

tmpnam .................................................................. 265 

Tokens ................................................................... 315 

tolower.................................................................... 203 

toupper ................................................................... 204 

Transferring Control ............................................... 214 

Transform Functions................................................ 58 

BitReverseComplex .......................................... 60 

CosFactorInit..................................................... 61 

DCT................................................................... 61 

DCTIP ............................................................... 63 

FFTComplex ..................................................... 64 

FFTComplexIP.................................................. 66 

IFFTComplex .................................................... 67 

IFFTComplexIP................................................. 69 

TwidFactorInit ................................................... 70 

Transform String..................................................... 316 

Trigonometric Functions 

acos ................................................................ 325 

acosf ............................................................... 326 

asin ................................................................. 327 

asinf ................................................................ 327 

atan ................................................................. 328 

atan2 ............................................................... 329 

atan2f .............................................................. 331 

atanf ................................................................ 329 

cos .................................................................. 333 

cosf ................................................................. 334 

Westford, MA 

Điện thoại: 978-692-3848 

Fax: 978-692-3821 

Chicago 

Itasca, IL 

Điện thoại: 630-285-0071 

Fax: 630-285-0075 

Dallas 

Addison, TX 

Điện thoại: 972-818-7423 

Fax: 972-818-2924 

Detroit 

Farmington Hills, MI 

Điện thoại: 248-538-2250 

Fax: 248-538-2260 

Kokomo 

Kokomo, IN 

Điện thoại: 765-864-8360 

Fax: 765-864-8387 

Los Angeles 

Mission Viejo, CA 

Điện thoại: 949-462-9523 

Fax: 949-462-9608 

San Jose 

Mountain View, CA 

Điện thoại: 650-215-1444 

Fax: 650-961-0286 

Toronto 

Mississauga, Ontario, 

Canada 

Điện thoại: 905-673-0699 

Fax: 905-673-6509 

Châu Á / Thái Bình Dương 

Úc - Sydney 

Điện thoại: 61-2-9868-6733 

Fax: 61-2-9868-6755 

Trung Quốc - Bắc Kinh 

Điện thoại: 86-10-8528-2100 

Fax: 86-10-8528-2104

sin ................................................................... 357 

sinf .................................................................. 358 

tan ................................................................... 363 

tanf .................................................................. 363 

TwidFactorInit........................................................... 70 

type ................................................................ 254, 260 

U 

UART Functions 

Close UART. ................................................... 141 

Configure UART.............................................. 143 

Configure UART Interrupt ............................... 142 

Example of Use............................................... 149 

Read UART..................................................... 145 

UART Buffer Status ........................................ 143 

UART Get Character....................................... 147 

UART Get String ............................................. 146 

UART Put Character ....................................... 147 

UART Put String ............................................. 146 

UART Status ................................................... 141 

Write UART..................................................... 145 

UART Macros 

Disable UART RX Interrupt............................. 147 

Disable UART TX Interrupt ............................. 148 

Enable UART RX Interrupt.............................. 147 

Enable UART TX Interrupt .............................. 147 

Set UART RX Interrupt Priority ....................... 148 

Set UART TX Interrupt Priority........................ 148 

UCHAR_MAX......................................................... 213 

UINT_MAX ............................................................. 213 

ULLONG_MAX....................................................... 213 

ULONG_MAX......................................................... 213 

Underflow Errors ....................................205, 325, 337, 

.............................................338, 346, 348, 355, 356 

ungetc..................................................................... 265 

Universal Time Coordinated................................... 320 

unsigned char 

Maximum Value .............................................. 213 

unsigned int 

Maximum Value .............................................. 213 

Trung Quốc - Thành Đô 

Điện thoại: 86-28-8676-6200 

Fax: 86-28-8676-6599 

Trung Quốc - Phúc Châu 

Điện thoại: 86-591-8750-3506 

Fax: 86-591-8750-3521 

Trung Quốc - Hồng Kông 

Điện thoại: 852-2401-1200 

Fax: 852-2401-3431 

Trung Quốc - Thượng Hải 

Điện thoại: 86-21-5407-5533 

Fax: 86-21-5407-5066 

Trung Quốc - Thẩm Dương 

Điện thoại: 86-24-2334-2829 

Fax: 86-24-2334-2393 

Trung Quốc - Thâm Quyến 

Điện thoại: 86-755-8203-2660 

Fax: 86-755-8203-1760 

Trung Quốc - Thuận Đức 

Điện thoại: 86-757-2839-5507 

Fax: 86-757-2839-5571 

Trung Quốc - Thanh Đảo 

Điện thoại: 86-532-502-7355 

Fax: 86-532-502-7205 

Châu Á / Thái Bình Dương 

Ấn Độ - Bangalore 

Điện thoại: 91-80-2229-0061 

Fax: 91-80-2229-0062 

Ấn Độ - New Delhi 

Điện thoại: 91-11-5160-8632 

Fax: 91-11-5160-8632 

Nhật Bản - Kanagawa 

Điện thoại: 81-45-471- 6166 

Fax: 81-45-471-6122 

Hàn Quốc - Seoul 

Điện thoại: 82-2-554-7200 

Fax: 82-2-558-5932 hoặc 

82-2-558-5934 

Singapore

unsigned short int 

Maximum Value .............................................. 213 

Unsuccessful Termination ...................................... 270 

Upper Case Alphabetic Character 

Convert To ...................................................... 204 

Defined............................................................ 202 

Test for ............................................................ 202 

USHRT_MAX ......................................................... 213 

UTC ........................................................................ 320 

Utility Functions, Seestdlib.h 

V 

va_arg .....................................221, 223, 267, 268, 269 

va_end.............................................223, 267, 268, 269 

va_list ..................................................................... 221 

va_start............................................223, 267, 268, 269 

Variable Argument Lists, Seestdarg.h 

Variable Length Argument List ...................... 221, 223, 

............................................................ 267, 268, 269 

Vector Functions ...................................................... 13 

VectorAdd................................................................. 15 

VectorConvolve ........................................................ 16 

VectorCopy............................................................... 17 

VectorCorrelate ........................................................ 18 

VectorDotProduct ..................................................... 19 

VectorMax ................................................................ 19 

VectorMin ................................................................. 20 

VectorMultiply........................................................... 21 

VectorNegate ........................................................... 21 

VectorPower ............................................................. 22 

VectorScale .............................................................. 23 

VectorSubtract.......................................................... 23 

VectorWindow .......................................................... 29 

VectorZeroPad ......................................................... 24 

VERBOSE_DEBUGGING ...................................... 195 

Vertical Tab ............................................................ 201 

Điện thoại: 65-6334-8870 

Fax: 65-6334-8850 

Đài Loan - Cao Hùng 

Điện thoại: 886-7-536-4818 

Fax: 886-7-536-4803 

Đài Loan - Đài Bắc 

Điện thoại: 886-2-2500-6610 

Fax: 886-2-2508-0102 

Đài Loan - Hsinchu 

Điện thoại: 886-3-572-9526 

Fax: 886-3-572-6459 

CHÂU ÂU 

Áo - Weis 

Điện thoại: 43-7242-2244-399 

Fax: 43-7242-2244-393 

Đan Mạch - Ballerup 

Điện thoại: 45-4420-9895 

Fax: 45-4420-9910 

Pháp - Massy 

Điện thoại: 33-1-69-53-63-20 

Fax: 33-1-69-30-90-79 

Đức - Ismaning 

Điện thoại: 49-89-627-144-0 

Fax: 49-89-627-144-44 

Ý - Milan 

Điện thoại: 39-0331-742611 

Fax: 39-0331-466781 

Hà Lan - Drunen 

Điện thoại: 31-416-690399 

Fax: 31-416-690340 

Anh - Berkshire 

Điện thoại: 44-118-921-5869 

Fax: 44-118-921-5820 

WORLDWIDESALES ANDSERVICE 

09/27/04 

vfprintf............................................................. 225, 267 

vprintf.............................................................. 225, 268 

vsprintf............................................................ 225, 269 

W 

Được hỗ trợ bởi 

Dịch

wchar_t........................................................... 223, 270 

wcstombs ............................................................... 293 

wctomb ................................................................... 293 

WDTSWDisable ..................................................... 120 

WDTSWEnable ...................................................... 120 

Week ...................................................................... 323 

White Space ....................................259, 274, 275, 289 

Index 


White-Space Character 

Defined ........................................................... 201 

Test for............................................................ 201 

wide........................................................................ 270 

Wide Character ...............................................285, 293 

Wide Character String.....................................285, 293 

Wide Character Value............................................ 223 

Width...................................................................... 253 

width................................................................253, 259 

Window Functions 

BartlettInit.......................................................... 26 

BlackmanInit ..................................................... 27 

HammingInit...................................................... 28 

HanningInit........................................................ 28 

KaiserInit........................................................... 29 

VectorWindow................................................... 29 

write........................................................................ 373 

WriteCmdXLCD........................................................ 79 

WriteDataXLCD........................................................ 78 

WriteDCI................................................................. 154 

WriteQEI................................................................. 169 

WriteSPIx ............................................................... 160 

WriteTimerx............................................................ 114 

WriteTimerxx .......................................................... 115 

WriteUARTx ........................................................... 145 

WWW Address........................................................... 5 

Y 

Year.........................................................317, 318, 323 

Z 

Zero........................................................................ 325

Zero, divide by.........................................216, 219, 278 

DS51456B-page 400 


AMERICAS 

Corporate Office 

2355 West Chandler Blvd. 

Chandler, AZ 85224-6199 

Tel: 480-792-7200 

Fax: 480-792-7277 

Technical Support: 

http:\\support.microchip.com 

Web Address: 

www.microchip.com 

Atlanta 

Alpharetta, GA 

Tel: 770-640-0034 

Fax: 770-640-0307 

Boston 

Westford, MA 

Tel: 978-692-3848 

Fax: 978-692-3821 

Chicago 

Itasca, IL 

Tel: 630-285-0071 

Fax: 630-285-0075 

Dallas 

Addison, TX 

Tel: 972-818-7423 

Fax: 972-818-2924 

Detroit 

Farmington Hills, MI 

Tel: 248-538-2250 

Fax: 248-538-2260 

Kokomo 

Kokomo, IN 

Tel: 765-864-8360 

Fax: 765-864-8387 

Los Angeles 

Mission Viejo, CA 

Tel: 949-462-9523

Fax: 949-462-9608 

San Jose 

Mountain View, CA 

Tel: 650-215-1444 

Fax: 650-961-0286 

Toronto 

Mississauga, Ontario, 

Canada 

Tel: 905-673-0699 

Fax: 905-673-6509 

ASIA/PACIFIC 

Australia - Sydney 

Tel: 61-2-9868-6733 

Fax: 61-2-9868-6755 

China - Beijing 

Tel: 86-10-8528-2100 

Fax: 86-10-8528-2104 

China - Chengdu 

Tel: 86-28-8676-6200 

Fax: 86-28-8676-6599 

China - Fuzhou 

Tel: 86-591-8750-3506 

Fax: 86-591-8750-3521 

China - Hong Kong SAR 

Tel: 852-2401-1200 

Fax: 852-2401-3431 

China - Shanghai 

Tel: 86-21-5407-5533 

Fax: 86-21-5407-5066 

China - Shenyang 

Tel: 86-24-2334-2829 

Fax: 86-24-2334-2393 

China - Shenzhen 

Tel: 86-755-8203-2660 

Fax: 86-755-8203-1760 

China - Shunde 

Tel: 86-757-2839-5507 

Fax: 86-757-2839-5571 

China - Qingdao

Tel: 86-532-502-7355 

Fax: 86-532-502-7205 

ASIA/PACIFIC 

India - Bangalore 

Tel: 91-80-2229-0061 

Fax: 91-80-2229-0062 

India - New Delhi 

Tel: 91-11-5160-8632 

Fax: 91-11-5160-8632 

Japan - Kanagawa 

Tel: 81-45-471- 6166 

Fax: 81-45-471-6122 

Korea - Seoul 

Tel: 82-2-554-7200 

Fax: 82-2-558-5932 or 

82-2-558-5934 

Singapore 

Tel: 65-6334-8870 

Fax: 65-6334-8850 

Taiwan - Kaohsiung 

Tel: 886-7-536-4818 

Fax: 886-7-536-4803 

Taiwan - Taipei 

Tel: 886-2-2500-6610 

Fax: 886-2-2508-0102 

Taiwan - Hsinchu 

Tel: 886-3-572-9526 

Fax: 886-3-572-6459 

EUROPE 

Austria - Weis 

Tel: 43-7242-2244-399 

Fax: 43-7242-2244-393 

Denmark - Ballerup 

Tel: 45-4420-9895 

Fax: 45-4420-9910 

France - Massy 

Tel: 33-1-69-53-63-20 

Fax: 33-1-69-30-90-79 

Germany - Ismaning

Tel: 49-89-627-144-0 

Fax: 49-89-627-144-44 

Italy - Milan 

Tel: 39-0331-742611 

Fax: 39-0331-466781 

Netherlands - Drunen 

Tel: 31-416-690399 

Fax: 31-416-690340 

England - Berkshire 

Tel: 44-118-921-5869 

Fax: 44-118-921-5820 

WORLDWIDESALES ANDSERVICE 

09/27/04

o_195h4n6al16jb186b1b2qs7fgssa.pdf

Create successful ePaper yourself

Delete template?

Save as template?