Lua機能

• コルーチン操作

• OS機能

• デバッグライブラリ

res, data1, data2, data3, ... = fa.i2c(table)
res, string = fa.i2c(table)
res, data, ctrl = fa.i2c{mode = "getpio"}

引数

table

以下のフィールドがあります。

mode

string。I ²C操作の属性。

freq

string。I ²Cクロック周波数（単位：kHz）。設定可能な値は、 "45"、 "100"、 "189"、 "400"の4つ。省略時は "100"が設定されます。

timeout

number。スレーブ応答のタイムアウト時間（単位：msec）。省略時は 10が設定されます。

address

number。接続デバイスのスレーブアドレスを指定します。

direction

string。データの方向を指定します。設定可能な値は "read"と "write"です。 "read"を指定した場合、接続デバイスからデータを読み出します。 "write"を指定した場合、接続デバイスへデータを送ります。

data

string or number。送信データを設定します。string形式で指定した場合は、設定したデータを全て送ります。number形式で指定した場合は 0～ 255までの値を設定できます。 "setpio" の場合、0または1でPIOの出力を指定します。
4.00.03 Null文字のサポートしました。

bytes

number。受信データサイズを指定します。省略時には 1が設定されます。

type

string。受信データ形式を指定します。設定可能な値は "binary"、 "string"です。省略時には、 "binary"が設定されます。

ctrl 4.00.03

number。PIOの方向を指定します。0のとき入力、1のとき出力となります。

	デバイス初期化	スタートコンディションの送信	リスタートコンディションの送信	接続デバイスからデータ読み出し	接続デバイスへデータ書き込み	ストップコンディションを送信し、コネクションを閉じる	4.00.03 PIO設定	4.00.03 PIO取得
mode	"init"	"start"	"restart"	"read"	"write"	"stop"	"setpio"	"getpio"
freq	省略可	不要	不要	不要	不要	不要	不要	不要
timeout	省略可	不要	不要	不要	不要	不要	不要	不要
address	不要	必須	必須	不要	不要	不要	不要	不要
direction	不要	必須	必須	不要	不要	不要	不要	不要
data	不要	不要	不要	不要	必須	不要	必須	不要
bytes	不要	不要	不要	省略可	省略可	不要	不要	不要
type	不要	不要	不要	省略可	不要	不要	不要	不要
ctrl	不要	不要	不要	不要	不要	不要	必須	不要

備考

ビット割当

• CMD: SCL
• D0: SDA

SCL/SDAはプルアップしてください。
CLKはプルダウンしてください。
4.00.03 "setpio" / "getpio" ではD1が使用できます。

複数バイト送信

バイナリデータを複数バイト送信したい場合は、データ書き込みを続けて実行することで、複数バイト送信することができます。

戻り値

res

string。成功時は "OK"を返します。失敗時はそれ以外の文字列を返します。

data1, data2, data3, ...

number。 0～ 255までの値が格納されます。接続デバイスからデータ読み出し、 type = "binary"指定時のみ使用します。

string

string。受信データが格納されます。接続デバイスからデータ読み出し、 type = "string"指定時のみ使用します。

data 4.00.03

number。PIOの取得値が格納されます。 type = "getpio"指定時のみ使用します。

control 4.00.03

number。PIOの方向設定値が格納されます。 0 のとき入力、 1 のとき出力となります。 type = "getpio"指定時のみ使用します。

例

res = fa.i2c{mode = "init", freq = "100"}
res = fa.i2c{mode = "start", address = 50, direction = "write"}
res = fa.i2c{mode = "restart", address = 50, direction = "read"}
res, data1, data2, data3, ... = fa.i2c{mode = "read", type = "binary"}
res, string = fa.i2c{mode = "read", type = "string"}
res = fa.i2c{mode = "write", data = 0}
res = fa.i2c{mode = "stop"}

アドレス50のスレーブから5バイト読み出す

res = fa.i2c{mode = "init", freq = "100"}
res = fa.i2c{mode = "start", address = 50, direction = "read"}
res, r0, r1, r2, r3, r4, r5 = fa.i2c{mode = "read", bytes = 5, type = "binary"}
res = fa.i2c{mode = "stop"}

アドレス50のスレーブに0を書き込んでから1バイト読み出す

res = fa.i2c{mode = "init", freq = "100"}
res = fa.i2c{mode = "start", address = 50, direction = "write"}
res = fa.i2c{mode = "write", data = 0}
res = fa.i2c{mode = "restart", address = 50, direction = "read"}
res, data = fa.i2c{mode = "read", bytes = 1, type = "binary"}
fa.i2c{mode = "stop"}

PIOの操作 4.00.03

res = fa.i2c {mode ="init", freq="100"}
res = fa.i2c {mode ="setpio", data=1, ctrl=1} -- 出力High
res = fa.i2c {mode ="setpio", data=0, ctrl=1} -- 出力Low
                         
res = fa.i2c {mode ="setpio", data=0, ctrl=0} -- 入力
res, data, ctrl = fa.i2c {mode="getpio"}

result, filelist, time = fa.search(type, path, searchtime)

引数

type

string。検索タイプ。file固定。

• file：ファイルの検索

path

string。検索対象のディレクトリ。

searchtime

number。検索対象更新日時。-1またはFAT形式の日時を指定する。

• -1を指定した場合、更新日時が最新のファイルを検索する。
• -1以外を指定した場合、以下の両方を検索する。
  • 指定された更新日時と一致するファイル
  • 指定された更新日時より新しいファイルのうち最も古いファイル（指定された日時の次に新しいファイル）
• FAT形式の日時について
  • 32ビットの整数値で、上位16ビットが日付、下位16ビットが時刻。
  • 日付と時刻は、 command.cgiのop=100を実行した際に取得できる値と同じフォーマット。

戻り値

result

number。ステータス。

1	正常終了
-1	ファイルリストの作成時にオーバーフロー searchtimeに-1を指定した場合、「更新日時が最新のファイル」のリスト作成で文字列バッファのオーバーフロー searchtimeに-1以外を指定した場合、「指定された更新日時より新しいファイルのうち最も古いファイル」のリスト作成で文字列バッファのオーバーフロー
-2	ファイルリストの作成時にオーバーフロー(searchtimeに-1以外を指定した場合のみ返す可能性がある) 「指定された更新日時と一致するファイル」のリスト作成で文字列バッファのオーバーフロー
-3	ディレクトリオープンエラー
-4	ディレクトリリードエラー

filelist

string。カンマ区切りのファイルリスト。

• 条件に一致するファイルのリストをカンマ区切りの文字列で返す。
• searchtimeに-1以外を指定した場合、 「指定された更新日時と一致するファイル」のリストと「指定された更新日時より新しいファイルのうち最も古いファイル」のリストを連結した文字列を返す。
• 該当ファイルがない場合は、""(空文字列)を返す。
• オーバーフロー以外のエラーの場合はnilを返す。

time

number。検索結果日時。

• searchtimeに-1を指定した場合、「更新日時が最新のファイル」の更新日時を返す。
• searchtimeに-1以外を指定した場合、 「指定された更新日時より新しいファイルのうち最も古いファイル」の更新日時を返す。
• 条件に一致するファイルがない場合は0を返す。
• オーバーフロー以外のエラーの場合はnilを返す。

備考

• ファイルリストの作成時に512文字を超えた場合はバッファオーバーフローとなり、リストは途中で打ち切られる。
• 検索するディレクトリの深さは3階層まで。

例

"/DCIM" から最新のファイルを検索する。

local result, filelist, time = fa.search("file", "/DCIM", -1)
if result ~= 1 then
  print("error: ", result)
end
if filelist ~= nil then
  for f in string.gmatch(filelist, '(.-),') do
      print(f)
  end
end
if time ~= nil then
  print(string.format("time: 0x%08x", time))
end

“DCIM”から更新日時が 2017/06/01 12:34:56 であるファイルと、その日時より新しいファイルのうち最も古いファイルを検索する。

local result, filelist, time = fa.search("file", "/DCIM", 0x4ac1645c)
if result ~= 1 then
  print("error: ", result)
end
if filelist ~= nil then
  for f in string.gmatch(filelist, '(.-),') do
      print(f)
  end
end
if time ~= nil then
  print(string.format("time: 0x%08x", time))
end

参考

FAT形式の日時変換例

文字列の日時をFAT形式に変換する

local function StringToFatDateTime(datetime_str)
  local pattern = '(%d+)/(%d+)/(%d+)%s+(%d+):(%d+):(%d+)'
  local year,month,day,hour,min,sec = string.match(datetime_str, pattern)
  year = year - 1980
  sec = bit32.rshift(sec, 1)
  local date_fat = bit32.bor(bit32.lshift(year, 9),
                             bit32.lshift(month, 5),
                             day)
  local time_fat = bit32.bor(bit32.lshift(hour, 11),
                             bit32.lshift(min, 5),
                             sec)
  local datetime_fat = bit32.bor(bit32.lshift(date_fat, 16),
                                 time_fat)
  return datetime_fat
end

FAT形式の日時を文字列に変換する

local function FatDateTimeToString(datetime_fat)
  local function getbits(x, from, to)
      local mask = bit32.lshift(1, to - from + 1) - 1
      local shifted = bit32.rshift(x, from)
      return bit32.band(shifted, mask)
  end
  local fatdate = bit32.rshift(datetime_fat, 16)
  local day = getbits(fatdate, 0, 4)
  local month = getbits(fatdate, 5, 8)
  local year = getbits(fatdate, 9, 15) + 1980

  local fattime = getbits(datetime_fat, 0, 15)
  local sec = getbits(fattime, 0, 4) * 2
  local min = getbits(fattime, 5, 10)
  local hour = getbits(fattime, 11, 15)

  return string.format('%02d/%02d/%02d %02d:%02d:%02d', year, month, day, hour, min, sec)
end

result = fa.control("time"[, savetime])

引数

第1引数は"time"固定。

savetime

number。保存する日時。FAT形式で指定する。

• savetime引数ありの場合、指定された日時を保存する。
• savetime引数なしの場合、保存された日時を取得する。
• FAT形式の日時について
  • 32ビットの整数値で、上位16ビットが日付、下位16ビットが時刻。
  • 日付と時刻は、 command.cgiのop=100を実行した際に取得できる値と同じフォーマット。

戻り値

result

number。取得した日時。

• savetime引数ありの場合、指定された日時そのものを返す。
• savetime引数なしの場合、保存された日時を返す。
  • 日時が保存されていない場合は、-1を返す。
• エラーの場合は nil を返す。

例

"2017/06/01 12:34:56" を保存する。

result = fa.control("time", 0x4ac1645c)

保存された日時を取得する。

result = fa.control("time")
if result ~= nil then
  print(string.format("time: 0x%08x", result))
end

result = fa.control("fioget")

引数

第1引数は"fioget"固定。

戻り値

result

number。現在の無線LANの状態。

• 1：無線LANはOn。
• 0：無線LANはOff。

result = fa.control("fioset", enable)

引数

第1引数は"fioset"固定。

enable

number。1 または 0を指定。

• 1：無線LANをOnにする。モードやSSIDなどの設定はCONFIGファイルの内容が適用される。
• 0：無線LANをOffにする。

戻り値

result

number。現在の無線LANの状態。

• 1：無線LANはOn。
• 0：無線LANはOff。

cnt,tbl = fa.ConnectedSTA()

戻り値

cnt

接続しているステーションの個数を返却する。

Tbl

取得したクライアントのテーブルを返却する。cntが0に場合nilを返却する。

例

AP起動時に何台接続しているか確認する。

local cnt, tbl = fa.ConnectedSTA()
print(cnt,tbl)
for i,t in ipairs(tbl) do 
  for k,v in pairs(t) do
  print(k,v)
   end
end

結果

　　　1       table: 856B1C
　　　mac     40:48:0f:7b:37:92
　　　ip      192.168.0.11

result = fa.watchdog("start", cycle)

引数

戻り値

result

number。

1

タイマー開始。

0

タイマー待ち時間未設定。

備考

WatchDogとは、システムが機能し続けていることを確認するためのタイマーのことです。WatchDogのタイマーをスタートした後システムに異常事態が起こり、WatchDogのタイマーをリセットできなかった場合FlashAirを再起動させます。

使用例

result = fa.watchdog("stop")

引数

戻り値

result

number。

0

タイマー停止。

result = fa.watchdog("event")

引数

戻り値

result

number。

1

タイマー再始動。

0

watchdogをスタートしていない（タイマー待ち時間未設定）。

result = fa.watchdog("status")

引数

戻り値

result

number。

0以上

watchdogタイマー発動までの残り時間。

0

発動までの残り時間が１秒未満。

-1

watchdogタイマー待機中。

fa.control("hid_set_pass", password)

引数

第1引数は"hid_set_pass"固定。

password

string。パスワード。

戻り値

ret = fa.control("hid_change_pass", old_password, new_password)

引数

第1引数は"hid_change_pass"固定。

old_password

string。設定済みパスワード。

new_password

string。新規パスワード。

戻り値

ret

number。

0

成功。

1

設定エラー。

-1

パスワード長エラー。

fa.control("hid_store",　filename,　password)

引数

第1引数は"hid_store"固定。

filename

string。保存するスクリプト。

password

string。パスワード。

戻り値

例

fa.control("hid_store", "test.lua", "12345678")

保存したファイルをCONFIGで指定する

LUA_RUN_SCRIPT=H:filename
LUA_SD_EVNET=H:filename

fa.control("hid_get", filename , dstfilename, password)

引数

第1引数は"hid_get"固定。

filename

string。保存しているスクリプト。

dstfilename

string。コピー先ファイル名。

password

string。パスワード。

戻り値

例

fa.control("hid_get", "h:sys.lua", "tmp/option.lua", "mysecret")

fa.control("hid_clear")

引数

第1引数は"hid_clear"固定。

戻り値

ret = fa.control("hid_hash", string)

引数

第1引数は"hid_change_pass"固定。

string

string。設定文字列。

戻り値

ret

string。ハッシュ値。

"p" --1stパーティション（省略化）
"s" --2ndパーティション
"h" --秘匿領域

例

local file = io.open("s:\flashair.log", "a")