Lazurite IDEの機能拡張方法

LazuriteIDEにライブラリを登録する

1. LazuriteIDEのフォルダの中身はこのようになっています。
デフォルトでは、c:\LazuriteIDEです。

 

2. 共通的に使用する関数は、librariesのフォルダに保存すれば共通関数として利用することが出来ます。そのlibrariesに保存するファイルの規則は次の通りです。

フォルダ名
         +-- ソースファイル
         +-- ヘッダファイル
         +--キーワードファイル

この時、フォルダ名、ソースファイル名、ヘッダファイル名は同じにする必要があります。
たとえば、フォルダ名はAAAとすると、ソースファイルはAAA.C、ヘッダファイルはAAA.hにする必要があります。

ファイルの中身はこちらからダウンロードしてください。

 

3. LazuriteIDEのlibrariesフォルダに"aaa"のフォルダを移動します。

 

4. LazuriteIDEを起動します。右側の欄にライブラリ名が表示されますので、それをチェックします。

これで完成です。

5. 豆知識

ヘッダファイルはこのような内容になっています。

#ifndef _AAA_H_                   // <==この行
#define _AAA_H_                // <==この行

extern void led_init(unsigned char pin);
extern void led(bool on);

#endif // _AAA_H_                // <==この行

ヘッダファイルの赤字の行は(先頭の2行と最後の1行)は、「1回しかビルドしないでください」という意味があります。externによる外部関数の宣言だけであれば問題ないのですが、typedefなどを変数名の指定を行い、2個所からヘッダファイルを読み出すと名前がダブっているというエラーが発生することがあります。これらの記述があると問題が発生しなくなります。

 

LazuriteIDEで自分用のビルドファイルを作成する

LazuriteIDEは、ユーザ自身で所有している環境のソフトウエアをビルドすることが可能です。

Lazurite SubGHz rev2のボードを使用するとき、このボード用のビルド環境は、

hardware\lazurite_subghz2.bpf

に情報が記載されています。ファイルを開くと、次のようになっています。

# MCU BOARD PROJECT FILE # FILE NAME: lazurite.pref MCUBOARD_NAME=LAZURITE Sub-GHz Rev2 MANUFACTURER_NAME=LAPIS DESCRIPTION_NAME=LAZURITE Sub-GHz Rev2 CTRL_DRIVER=bin\\lazurite_ft232_ctrl.exe OPTION_NAME=LAZURITE Basic OPTION_BUILD=hardware\\lazurite_subghz\\build\\lazurite.bld OPTION_HEADER=hardware\\lazurite_subghz\\lazurite\\lazurite.h OPTION_NAME=LAZURITE Basic(WatchDogTimer) OPTION_BUILD=hardware\\lazurite_subghz\\build\\lazurite_wdt.bld OPTION_HEADER=hardware\\lazurite_subghz\\lazurite\\lazurite.h OPTION_NAME=LAZURITE Sub-GHz OPTION_BUILD=hardware\\lazurite_subghz\\build\\lazurite_SubGHz.bld OPTION_HEADER=hardware\\lazurite_subghz\\lazurite\\lazurite.h OPTION_NAME=LAZURITE Sub-GHz(WatchDogTimer) OPTION_BUILD=hardware\\lazurite_subghz\\build\\lazurite_SubGHz_wdt.bld OPTION_HEADER=hardware\\lazurite_subghz\\lazurite\\lazurite.h OPTION_NAME=LAZURITE Sub-GHz Sniffer OPTION_BUILD=hardware\\lazurite_subghz\\build\\lazurite_SubGHz_sniffer.bld OPTION_HEADER=hardware\\lazurite_subghz\\lazurite\\lazurite.h

・ヘッダ情報

以下の４行はボードの認証やプログラムの転送に使用するパラメータなので変更しないでください。
MCUBOARD_NAME=LAZURITE Sub-GHz Rev2
MANUFACTURER_NAME=LAPIS
DESCRIPTION_NAME=LAZURITE Sub-GHz Rev2
CTRL_DRIVER=bin\\lazurite_ft232_ctrl.exe

・ビルド環境

OPTION_NAME=オプションの名前
　　LazuriteIDEの選択画面で選択できるオプションの名称になります。
　　変更するときは、新たな名称を付けてください。
OPTION_BUILD=ビルドファイル
　　ビルドするファイル、サーチするフォルダ、コンパイルオプションなどが記載されているフォルダです。
OPTION_HEADER=ソースコード用のヘッダファイル
 　　作成するプログラムにincludeされるファイルです。

・ビルドファイルの詳細
# Build option file # INCPATH: file path of include file # PRJSRC: Source file # CMPOPT: Compile option # ASMOPT: ASM option # PRNDIR: PRN file output directories # LNKOPT: Link options # PRJLIB: Project libraries ###### Include Path INCPATH=hardware\\lazurite_subghz INCPATH=hardware\\lazurite_subghz\\lazurite INCPATH=hardware\\lazurite_subghz\\lazurite INCPATH=hardware\\lazurite_subghz\\ml620q504 INCPATH=hardware\\lazurite_subghz\\ml620q504\\clock INCPATH=hardware\\lazurite_subghz\\ml620q504\\common INCPATH=hardware\\lazurite_subghz\\ml620q504\\irq INCPATH=hardware\\lazurite_subghz\\ml620q504\\lp INCPATH=hardware\\lazurite_subghz\\ml620q504\\mcu_small INCPATH=hardware\\lazurite_subghz\\ml620q504\\wdt INCPATH=hardware\\lazurite_subghz\\SUB_GHZ\\ INCPATH=hardware\\lazurite_subghz\\SUB_GHZ\\CTI\\api INCPATH=hardware\\lazurite_subghz\\SUB_GHZ\\CTI\\core INCPATH=hardware\\lazurite_subghz\\SUB_GHZ\\CTI\\hwif INCPATH=hardware\\lazurite_subghz\\SUB_GHZ\\CTI\\others ###### Compiling source files PRJSRC=bin\\U8Dev\\Startup\\Src\\\ml620504f.asm PRJSRC=hardware\\lazurite_subghz\\main.c PRJSRC=hardware\\lazurite_subghz\\lazurite\\flash.c PRJSRC=hardware\\lazurite_subghz\\lazurite\\analogio.c PRJSRC=hardware\\lazurite_subghz\\lazurite\\print.c PRJSRC=hardware\\lazurite_subghz\\lazurite\\digitalio.c PRJSRC=hardware\\lazurite_subghz\\lazurite\\lazurite_system.c PRJSRC=hardware\\lazurite_subghz\\lazurite\\serial.c PRJSRC=hardware\\lazurite_subghz\\lazurite\\tone.c PRJSRC=hardware\\lazurite_subghz\\lazurite\\WInterrupts.c PRJSRC=hardware\\lazurite_subghz\\lazurite\\wiring_shift.c PRJSRC=hardware\\lazurite_subghz\\lazurite\\WMath.c PRJSRC=hardware\\lazurite_subghz\\ml620q504\\driver_adc.c PRJSRC=hardware\\lazurite_subghz\\ml620q504\\driver_extirq.c PRJSRC=hardware\\lazurite_subghz\\ml620q504\\driver_gpio.c PRJSRC=hardware\\lazurite_subghz\\ml620q504\\driver_i2c.c PRJSRC=hardware\\lazurite_subghz\\ml620q504\\driver_irq.c PRJSRC=hardware\\lazurite_subghz\\ml620q504\\driver_timer.c PRJSRC=hardware\\lazurite_subghz\\ml620q504\\driver_tmout.c PRJSRC=hardware\\lazurite_subghz\\ml620q504\\driver_uart.c PRJSRC=hardware\\lazurite_subghz\\ml620q504\\driver_flash.c PRJSRC=hardware\\lazurite_subghz\\ml620q504\\lp\\lp_manage.c PRJSRC=hardware\\lazurite_subghz\\ml620q504\\wdt\\wdt.c PRJSRC=hardware\\lazurite_subghz\\SUB_GHZ\\subghz_api.c PRJSRC=hardware\\lazurite_subghz\\SUB_GHZ\\CTI\\api\\bp3596.c PRJSRC=hardware\\lazurite_subghz\\SUB_GHZ\\CTI\\core\\ml7396.c PRJSRC=hardware\\lazurite_subghz\\SUB_GHZ\\CTI\\hwif\\hal_lazurite.c PRJSRC=hardware\\lazurite_subghz\\SUB_GHZ\\CTI\\hwif\\ml7396_hwif_hal.c PRJSRC=hardware\\lazurite_subghz\\SUB_GHZ\\CTI\\hwif\\spi0.c PRJSRC=hardware\\lazurite_subghz\\SUB_GHZ\\CTI\\hwif\\wire0.c ###### Compiling option CMPOPT=/TML620504F CMPOPT=/MS CMPOPT=/near CMPOPT=/SD CMPOPT=/SL65 CMPOPT=/Ot CMPOPT=/Oa CMPOPT=/SS512 CMPOPT=/W3 CMPOPT=/Lv CMPOPT=/D_ML620Q504 CMPOPT=/DLAZURITE_IDE CMPOPT=/DSUBGHZ OBJDIR=obj\\ ASMOPT=/MS ASMOPT=/DN ASMOPT=/CD ASMOPT=/SD ASMOPT=/SL66 ASMOPT=/WRPEAST ASMOPT=/L ASMOPT=/S ASMOPT=/R ASMOPT=/SF ASMOPT=/PL60 ASMOPT=/PW79 ASMOPT=/T8 ASMOPT=/NE PRNDIR=_prn\\ LNKOPT=/STACK(512) LNKOPT=/D LNKOPT=/SD LNKOPT=/S LNKOPT=/CC PRJLIB=bin\\u8dev\\Lib\\LU8100SW.lib PRJLIB=bin\\u8dev\\Lib\\LONGU8.lib PRJLIB=bin\\u8dev\\Lib\\DOUBLEU8.LIB PRJLIB=bin\\u8dev\\Lib\\FLOATU8.LIB PRJLIB=bin\\u8dev\\Lib\\LU8100LW.lib PRJLIB=bin\\u8dev\\Lib\\muldivu8.lib

 

ＩNCPATH	ヘッダファイルを探すフォルダを指定してください
PRJSRC	ビルドするソースファイルを指定してください
CMPOPT	CCU8用のオプションです。詳細は、「LazuriteIDE\bin\U8Dev\Doc」を参照してください。
ASMOPT	RASU8用のオプションです。詳細は、「LazuriteIDE\bin\U8Dev\Doc」を参照してください。
LNKOPT	RLU8用のオプションです。詳細は、「LazuriteIDE\bin\U8Dev\Doc」を参照してください。