コンパイル方法

使用している C コンパイラは Raisonance 社製のもので、ST Toolset の ST Visual Develop (STVD) 環境から実行しています。 Ride7 環境や、Cosmic 社製のコンパイラには対応していません。

ZIP フォーマットで圧縮してあるアーカイブファイルを解凍すると、「FMmelody」フォルダが作られます。

 \FMmelody 
   |
   +-- readme.txt
   |
   +-- index.htm
   |
   +-- \inc      : インクルードファイルフォルダ
   |     |
   |     +-- *.h : ヘッダファイル
   |
   +-- \src      : ソースファイルフォルダ
   |     |
   |     +-- *.c : C ソースファイル
   |
   +-- \prj                     : プロジェクトファイルフォルダ
   |     |
   |     +-- \Cosmic            : Cosmic コンパイラ用 (空)
   |     |
   |     +-- \Raisonance        : Raisonance コンパイラ用
   |           |
   |           +-- FMmelody.stw : ワークスペースファイル
   |           |
   |           +-- fmmelody.stp : プロジェクトファイル
   |           |
   |           +-- FMmelody.*   : その他のファイル
   |           |
   |           +-- \Debug             : オブジェクトフォルダ (Debug config 用)
   |                 |
   |                 +-- *.o          : オブジェクトファイル
   |                 |
   |                 +-- fmmelody.elf : elf オブジェクトファイル
   |                 |
   |                 +-- FMMELODY.HEX : HEX ファイル
   |                 |
   |                 +-- FMMELODY.*   : その他のファイル
   |
   +-- \html       : html ドキュメントフォルダ
   |     |
   |     +-- *.htm : html ファイル
   |
   +-- \img        : 画像ファイルフォルダ
   |     |
   |     +-- *.jpg : JPEG ファイル
   |     |
   |     +-- *.pdf : PDF ファイル
   |
   +-- \css        : スタイルシートファイルフォルダ
         |
         +-- *.css : CSS ファイル

コンパイルは、まず、STVD を立ち上げ、

メニューバー / File / Open Workspace...

を実行して現れるダイアログで、

＜解凍したフォルダ＞\FMmelody\prj\Raisonance\FMmelody.stw

を選択します。

あるいは、「FMmelody.stw」を「STVD」に「ドラッグ・アンド・ドロップ」しても OK です。

ワークスペースおよびプロジェクトが読み込まれれば、

メニューバー / Build / Rebuild All

を実行すればコンパイルできます。

コンパイルがエラーになる場合は、ツールチェインのパスの設定が正しいかどうか確認してみて下さい。　具体的には、

メニューバー / Project / Settings...

で開くダイアログの「General」のタブで、Toolset Info / Root Path の項目をコンパイラをインストールしたパス、「・・・\Ride」に修正すれば OK です。

また、STmicro のファームウェア・ライブラリのインクルード・ファイルだけを利用しているので、インクルード・パスの設定を確かめ、必要なら追加してください。

ファームウェア・ライブラリは「UM0834.zip」を STmicro の Web サイトからダウンロードし、解凍すれば、中に含まれています。

あるいは、Raisonance のコンパイラ・パッケージの中にも、少し古いバージョンのファイルが含まれています。

デフォルトでは、

C:\Program Files\Raisonance\Ride\Examples\STM8\STM8SFWLib\library\inc

です。

Raisonance の無償版コンパイラは、インストール直後の状態では、

ひとつのソースファイルをコンパイルしてできるオブジェクト・サイズは 1 KB まで
リンク後のオブジェクト・サイズは 4 KB まで

という制限がかかっています。

ライセンス認証を行うと、コードサイズ制限が 16 KB まで緩和されますが、「FMmelody」は「素」の 1 KB / 4 KB 制限のある状態でもコンパイルでき、コードサイズは 2.3 KB 程度なので、まだまだ余裕があります。

ライブラリ本体を利用しようとすると、1 KB / 4 KB の制限に引っかかるので、「定義」部分だけを利用し、実際の設定は「自前」で行っています。