AVR Libc 日本語

1.7.1

はじめに

最新版のドキュメント(英文)は、いつもhttp://savannah.nongnu.org/projects/avr-libc/から読めます。(訳注：この日本語版は、http://cega.jp/avr-libc-jp/から読めます。)

AVR Libcパッケージは、Atmel AVR 8-bit RISC microcontroller向けの標準 Cライブラリ のサブセットを提供します。さらに、ライブラリは、多くのアプリケーションで必要となる基本的なスタートアップコードを提供します。

このドキュメントには、ライブラリにより提供されるインターフェースやルーチンを単純に記載する以上の豊富な情報があります。私たちは、このドキュメントが新しいAVR開発者に、自由に入手できる開発ツール（binutilsやgcc avr-libc他）を使用して、迅速に理解するために十分な情報を提供できることを望んでいます。

この文章に書かれていない問題で引っかかることに気づいたなら、avr-gccメーリングリストにメッセージを送りたくなるかもしれません。このメーリングリストには、avr-libcの開発者に加えてAVR binutilsやgccポートの多くの開発者も購読しているので、だいたいの問題を解決してもらうことができます。http://lists.nongnu.org/mailman/listinfo/avr-gcc-listからメーリングリストに参加できます。メーリングリストへ投稿する前に、この文章のよくある質問と回答の章を読んでください。

注釈：

もしこの文章やライブラリでバグを見つけたり、改善の要望がある場合は、忘れられることがないようにバグトラックhttps://savannah.nongnu.org/bugs/?group=avr-libcを使ってください。

訳注：

日本語訳で、誤訳・バグを見つけたり改善の要望がある場合は、WEB:http://cega.jp/avrlibcjp、Email：info@cega.jpやtwitter：@cegajpまでご連絡ください。

ライブラリに関する一般的な情報

全体的に、このライブラリを実装する中で、標準規格にできるだけこだわることを目標としています。一般に、ANSI X3.159-1989やISO/IEC 9899:1990("ANSI-C")標準ならびに、これらの後継であるISO/IEC9899:1999("C99")の要素に記述されているCライブラリを参照しています。さらに、AVR特有（プログラムスペース文字列インターフェースのような）の拡張については、IEEE Std 1003.1-1988("POSIX.1")のような他の標準に影響を受けています。

特に明記しない限り、このライブラリ関数は、再入可能であることが保証されていません。特に、ローカル状態を格納する多くの関数（EEPROMアクセスルーチンのようなI/Oレジスタの操作をする関数）は、再入不可であることが知られています。これらの関数が通常と割込の両方で使われると、未定義な動作をします。より詳細な議論についてはFAQを見てください。

サポートデバイス

以下は、ライブラリによって現在サポートされるAVRデバイスのリストです。いくつかの新しいデバイスを実際に対応するのは、ライブラリをコンパイルするときに、これらのデバイスをサポートするコンパイラとアセンブラの能力に依存することに注意してください。

megaAVR Devices:

• atmega103
• atmega128
• atmega1280
• atmega1281
• atmega1284p
• atmega16
• atmega161
• atmega162
• atmega163
• atmega164a
• atmega164p
• atmega165
• atmega165a
• atmega165p
• atmega168
• atmega168a
• atmega168p
• atmega16a
• atmega2560
• atmega2561
• atmega32
• atmega323
• atmega324a
• atmega324p
• atmega324pa
• atmega325
• atmega325a
• atmega325p
• atmega3250
• atmega3250a
• atmega3250p
• atmega328
• atmega328p
• atmega48
• atmega48a
• atmega48p
• atmega64
• atmega640
• atmega644
• atmega644a
• atmega644p
• atmega644pa
• atmega645
• atmega645a
• atmega645p
• atmega6450
• atmega6450a
• atmega6450p
• atmega8
• atmega88
• atmega88a
• atmega88p
• atmega88pa
• atmega8515
• atmega8535

tinyAVR Devices:

• attiny4
• attiny5
• attiny10
• attiny11 [1]
• attiny12 [1]
• attiny13
• attiny13a
• attiny15 [1]
• attiny20
• attiny22
• attiny24
• attiny24a
• attiny25
• attiny26
• attiny261
• attiny261a
• attiny28 [1]
• attiny2313
• attiny2313a
• attiny40
• attiny4313
• attiny43u
• attiny44
• attiny44a
• attiny45
• attiny461
• attiny461a
• attiny48
• attiny84
• attiny84a
• attiny85
• attiny861
• attiny861a
• attiny87
• attiny88

Automotive AVR Devices:

• atmega16m1
• atmega32c1
• atmega32m1
• atmega64c1
• atmega64m1
• attiny167

CAN AVR Devices:

• at90can32
• at90can64
• at90can128

LCD AVR Devices:

• atmega169
• atmega169a
• atmega169p
• atmega169pa
• atmega329
• atmega329a
• atmega329p
• atmega329pa
• atmega3290
• atmega3290a
• atmega3290p
• atmega649
• atmega649a
• atmega6490
• atmega6490a
• atmega6490p
• atmega649p

Lighting AVR Devices:

• at90pwm1
• at90pwm2
• at90pwm2b
• at90pwm216
• at90pwm3
• at90pwm3b
• at90pwm316
• at90pwm81

Smart Battery AVR Devices:

• atmega8hva
• atmega16hva
• atmega16hva2
• atmega16hvb
• atmega16hvbrevb
• atmega32hvb
• atmega32hvbrevb
• atmega64hve
• atmega406

USB AVR Devices:

• at90usb82
• at90usb162
• at90usb646
• at90usb647
• at90usb1286
• at90usb1287
• atmega8u2
• atmega16u2
• atmega16u4
• atmega32u2
• atmega32u4
• atmega32u6

XMEGA Devices:

• atxmega16a4
• atxmega16d4
• atxmega32a4
• atxmega32d4
• atxmega64a1
• atxmega64a1u
• atxmega64a3
• atxmega64d3
• atxmega128a1
• atxmega128a1u
• atxmega128a3
• atxmega128d3
• atxmega192a3
• atxmega192d3
• atxmega256a3
• atxmega256a3b
• atxmega256d3

その他の Devices:

• at94K [2]
• at76c711 [3]
• at43usb320
• at43usb355
• at86rf401
• at90scr100
• ata6289
• m3000 [4]

クラシック AVR Devices:

• at90s1200 [1]
• at90s2313
• at90s2323
• at90s2333
• at90s2343
• at90s4414
• at90s4433
• at90s4434
• at90s8515
• at90c8534
• at90s8535

注釈：

[1] アセンブラのみ。これらは、RAMベースのスタックが無いため、これらのデバイスへC言語でプログラムすることを直接サポートしません。しかし、これらをCでプログラム出来る可能性があります。そのためには、FAQを参照してください。

注釈：

[2] at94Kデバイスは、FPGAとAVRマイクロコントローラの組合せです。 [TRoth-2002/11/12: これらのサポートレベルには自信がありません。詳細な情報は歓迎です。]

注釈：

[3] at76c711は、AVRコアを使用したUSBと高速シリアルインタフェースをブリッジするチップです。

注釈：

[4] m3000は、Intelligent Motion Systems（IMS）/ Schneider Electricを用いたモーター・コントローラAVR ASICです。

avr-libc License

avr-libcは、以下の許可条件が満たされるならば、自由に使用でき、再配布することができます。（訳注：ライセンスの日本語訳は、Open Source Group JapanのBSDライセンスを参考にしてください。翻訳版も以下の許可条件に基づき、自由に使用でき、変更・再配布することができます。）

Portions of avr-libc are Copyright (c) 1999-2010
Werner Boellmann,
Dean Camera,
Pieter Conradie,
Brian Dean,
Keith Gudger,
Wouter van Gulik,
Bjoern Haase,
Steinar Haugen,
Peter Jansen,
Reinhard Jessich,
Magnus Johansson,
Harald Kipp,
Carlos Lamas,
Cliff Lawson,
Artur Lipowski,
Marek Michalkiewicz,
Todd C. Miller,
Rich Neswold,
Colin O'Flynn,
Bob Paddock,
Andrey Pashchenko,
Reiner Patommel,
Florin-Viorel Petrov,
Alexander Popov,
Michael Rickman,
Theodore A. Roth,
Juergen Schilling,
Philip Soeberg,
Anatoly Sokolov,
Nils Kristian Strom,
Michael Stumpf,
Stefan Swanepoel,
Helmut Wallner,
Eric B. Weddington,
Joerg Wunsch,
Dmitry Xmelkov,
Atmel Corporation,
egnite Software GmbH,
The Regents of the University of California. 
All rights reserved.

   Redistribution and use in source and binary forms, with or without
   modification, are permitted provided that the following conditions are met:

   * Redistributions of source code must retain the above copyright
     notice, this list of conditions and the following disclaimer.

   * Redistributions in binary form must reproduce the above copyright
     notice, this list of conditions and the following disclaimer in
     the documentation and/or other materials provided with the
     distribution.

   * Neither the name of the copyright holders nor the names of
     contributors may be used to endorse or promote products derived
     from this software without specific prior written permission.

   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
   AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
   IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
   ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
   LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
   CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
   SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
   INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
   CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
   ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
   POSSIBILITY OF SUCH DAMAGE.