自作ライブラリの勉強中に出たエラーの理由と対処法が知りたいです。（Arduino）

Question

#やりたいこと
自作ライブラリのメソッドを使う実験として、LEDを常時点灯させるメソッドを作りました。
4回のLチカ後に、常時点灯させることが目標です。

#実際のコード
まずはinoファイルから

#include <Arduino.h>
#include <FlashLib.h>

void setup(){
  pinMode(13,OUTPUT);
}

void loop(){
  for (int i = 1; i<=4; i++){
    digitalWrite(13,HIGH);
    delay(100);
    digitalWrite(13,LOW);
    delay(100);
  }
  flash();  
}

次に、ソースファイル（.cpp）

#include "Arduino.h"
#include "FlashLib.h"

void flash(){
  digitalWrite(13,HIGH);
  delay(5000);//追加しました
}

最後に、ヘッダファイル（.h）

#ifndef _FlashLib_h
#define _FlashLib_h

#include "Arduino.h"//追加しました
void flash();

#endif

これらのスケッチを実行すると以下のようなエラーを吐きます。

libraries\lib_test\FlashLib.cpp.o (symbol from plugin): In function `flash()':

(.text+0x0): multiple definition of `flash()'

sketch\FlashLib.cpp.o (symbol from plugin):(.text+0x0): first defined here

collect2.exe: error: ld returned 1 exit status

exit status 1
ボードArduino Unoに対するコンパイル時にエラーが発生しました。

#考えたこと
１．エラーの３行目にsketch\FlashLib.cpp.oとあることから、実際には.cppではなく.oである
→しかし、エクスプローラの画面では拡張子が.cppとなっている

２．ArduinoIDEがライブラリとして認識していない
→librariesに入れた他、ライブラリを追加として表示される

３．メソッドの書き方が間違っている
→void flash(void)
returnはなし。として記述もしました。
しかし、初心者日曜プログラマーなのでメソッドの書き方がおかしいことは否めない・・・

４．ヘッダファイルとソースファイルを書いたタブの順番により読み込み順序が逆になることからくるエラー
→そんなばかな・・・というかどうやって変えるねん！！

といった状況で解決方法が全然わかりません。
解決方法を伝授してくださると幸いです。よろしくおねがいします。

※2/28、16時現在一部追加しました

Answer 1

自作のライブラリを恐らく「lib_test.zip」で追加されたのだと思いますが、それとは別に、FlashLib.cppファイルを普通に追加していませんか？

以下のエラーはライブラリ中のlibraries\lib_test\FlashLib.cpp.oをリンクしようとすることで報告されているものであり、

`libraries\lib_test\FlashLib.cpp.o (symbol from plugin): In function `flash()':`

(.text+0x0): multiple definition of `flash()'

flashが最初に定義(first defined here)されているのは、sketch\FlashLib.cpp と報告されています。

sketch\FlashLib.cpp.o (symbol from plugin):(.text+0x0): first defined here

今いちど、Arduinoプロジェクトのファイル構成を確認してみてください。

---

** 追記しました：**

改めてこちらでも確認してみましたが、問題なくコンパイル～ビルドできます。以下の手順で再度試してみてください。Arduino 1.8.5/ Windows 10 です。

※混乱を避けるため、既に配置済みのライブラリ「Arduino/libraries/lib_test/」は削除しておいてください。

尚、#includeの部分などコードの一部を整理しています。

１．Arduino IDEの「ファイル」メニューから「新規ファイル」でスケッチを作成し、保存する。

// Arduino/sketch_feb28a/sketch_feb28a.ino

#include <Arduino.h>
#include <FlashLib.h>

void setup(){
  pinMode(13,OUTPUT);
}

void loop(){
  for (int i = 1; i<=4; i++){
    digitalWrite(13,HIGH);
    delay(100);
    digitalWrite(13,LOW);
    delay(100);
  }
  flash();  
}

２．次の2つのファイルを「lib_test.zip」の名前でZIPファイルにする。
1つ目、hファイル。

// Arduino/libraries/lib_test/FlashLib.h

#ifndef _FlashLib_h
#define _FlashLib_h

void flash(void);

#endif

2つ目、cppファイル。

// Arduino/libraries/lib_test/FlashLib.cpp

#include <Arduino.h>
#include <FlashLib.h>

void flash(void){
  digitalWrite(13,HIGH);
  delay(5000);//追加しました
}

３．「スケッチ」メニューの「ライブラリをインクルード」→「ZIP形式のライブラリをインクルード」で、lib_test.zipを指定して取り込む。

４．「スケッチ」メニューの「検証・コンパイル」を実行する。～ビルド終了。

Comments

[arumiti_1221]

ご回答ありがとうございます

フォルダtest_libからcppとhを取り除いてlibrariesに移動したところ以下のエラーが表示されました
C:\Users\takaki\AppData\Local\Temp\ccFsQnvZ.ltrans0.ltrans.o: In function `loop':

C:\Users\takaki\作業部屋\プログラム\Arduino\lib_test/lib_test.ino:15: undefined reference to `lflash()'

collect2.exe: error: ld returned 1 exit status

exit status 1
ボードArduino Unoに対するコンパイル時にエラーが発生しました。

なぜloop()でもエラーが発生してしまったのでしょうか？
ご教授お願いします

flash()はlflash()に変更しました

[dodox86]

何か色々と手順を間違えているのだと思います。ライブラリとしてはlibrariesフォルダー下のものを使うはずで、*.inoと同じフォルダーにFFlashLib.cpp と FlashLib.hがあるのはおかしいですよね。それでリンク時に重複エラーになってしまうのではないでしょうか。flash()をlflash()に名前を変えてもエラーになるのですよね。

[dodox86]

ライブラリにした手順が間違っているのではないですか。手順を質問文に追記してください。

[dodox86]

ちなみに今度のエラーは最初のエラーとは違って、「リンク時にlflash()が見つからない」と言うものです。最初のは「リンク時にflash()が重複している」です。

[arumiti_1221]

lib_testフォルダに.ino、.h、.cppがすべて入っていたり、librariesに.inoファイルや色々ダブって生成されていることが問題のようでした

解決しました！ありがとうございます！

Answer 2

私自身は Arduino を持っていないので実際に試したわけではないということはお断りしておきます。

拡張子が .o のファイルはオブジェクトファイルです。 C では原則として各コンパイル単位 (拡張子が .c のソースファイル) ごとにコンパイルして最後に結合 (リンク) するという手順が取られ、各コンパイル単位をコンパイルしたファイルが .o です。 エラーメッセージが .o のファイルを示しているということはオブジェクトファイルを処理するときに出たエラー、すなわちリンク時のエラーであることが推察されます。

flash という名前の関数は標準ライブラリが提供している関数に有ります。 それと同じ名前が複数定義されている、つまり multiple definition というエラーです。

自分が定義する名前として flash を避けることで対処可能なはずです。

Comments

[arumiti_1221]

ご回答ありがとうございます

lib_testフォルダ内にtest.ino、FlashLib.cpp、FlashLib.hがあり、librariesフォルダ内にもlib_testが入ってました。
取り除いたところ、エラーとして

```error
lib_test:2:10: fatal error: FlashLib.h: No such file or directory

compilation terminated.

exit status 1
FlashLib.h: No such file or directory
```
が表示されております…

flash()はlflash()に変更しました
ありがとうございます

Answer 3

そもそも「ライブラリ」という言葉を若干勘違いしているように思います。

厳密にそうでなければいけないというわけではありませんが、ライブラリというのは主に「いろいろなプログラムで使えるパーツ」を意図してパッケージにするものです。
Arduinoでは(何か所かにある)librariesディレクトリ以下にライブラリ名のディレクトリを作成して、そこにライブラリ名.hのファイルがあればライブラリとして認識してIDEの[スケッチ]メニューから取り込めるようですね。

一方、IDEのタブに書くのはライブラリじゃなくてソースファイルを分割したもの、でしょう。今回の、特定のプログラムの一部を整理して見やすいように、管理しやすいように切り分けたもの、です。

この両方をごっちゃにして、しかも両方に同じ内容を記述してしまったのでしょうか。