Lua機能

fa.i2c(table)

引数

modeに指定する文字列により、その後の引数が変化します。

備考

ビット割当

• CMD: SCL
• D0: SDA

SCL/SDAはプルアップしてください。
CLKはプルダウンしてください。

書式

res = fa.i2c{ mode = "init" [, freq = frequency, timeout = tout]}

引数

freq（省略可）

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

timeout（省略可）

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

戻り値

OK

成功

書式

res = fa.i2c{ mode = "start", address = slvaddr, direction = datadirection }

引数

address

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

direction

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

戻り値

OK

成功

それ以外の文字列

失敗

書式

res = fa.i2c{ mode = "restart", address = slvaddr, direction = datadirection }

引数

address

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

direction

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

戻り値

OK

成功

それ以外の文字列

失敗

書式

    res, data1, data2, data3, ... = fa.i2c{ mode = "read" [, type = "binary", bytes = len]}
    res, string = fa.i2c{ mode = "read" [, type = "string", bytes = len]}

引数

type（省略可）

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

bytes（省略可）

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

戻り値

OK

成功

それ以外の文字列

失敗

data1, data2, data3, ...　（type = binary指定時）

number形式で0～255までの値が格納されます。

string （type = string指定時）

string形式で受信データが格納されます。

書式

res = fa.i2c{ mode = "write", data = writedata}

引数

data

送信データを設定します。strings形式で指定した場合は、設定したデータを全て送ります。number形式で指定した場合は0～255までの値を設定できます。

bytes（省略可）

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

戻り値

OK

成功

それ以外の文字列

失敗

備考

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

書式

res = fa.i2c{ mode = "stop" }

引数

なし

戻り値

OK

成功

それ以外の文字列

失敗

例

アドレス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"}

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