====== PyFPlug ======
このソフトウェアは、富士通BSC製のF-PLUG (http://www.bsc.fujitsu.com/services/f-plug/) を
Pythonから操作するツールとライブラリです。

  * 最新版 ZIPアーカイブ: http://www.sunaga-lab.com/hgrepos/pyfplug/archive/tip.zip
  * レポジトリURL: http://www.sunaga-lab.com/hgrepos/pyfplug


====== Licence ======
  * Copyright (c) 2014 SUNAGA Takahiro
  * This software is released under the MIT License, see LICENSE.

====== 使用方法と注意 ======
  * 十分に注意し自己責任で使用してください。
    * (実装していませんが) どうやらファームウェア更新のコマンドなどもあるらしく使用できなくなる可能性もあるようです
  * pySerial が必要です。
    * Debian 7の場合、「apt-get install python-serial」でインストールできます
  * 事前にF-Plugとペアリングさせ、/dev/rfcommX が使用可能な状態になっていることが必要です。

===== 動作環境 =====
動作確認した環境は以下のとおりです。

  * Debian 7
  * Python 2.7.3

====== マニュアル ======
  * ここには簡単なマニュアルのみ記述します
  * 詳細はソースを参照してください

===== pyfplug.py - Python module =====
  * PythonからF-PLUGを操作するためのモジュールです
  * 使用例:
<code python>
import pyfplug
dev = pyfplug.FPlugDevice('/dev/rfcomm0')
print dev.get_temperature()     # 現在の温度を取得
print dev.get_power_realtime()  # 現在の消費電力値を取得
dev.led_on()                    # LEDを点灯
dev.led_off()                   # LEDを消灯
</code>

===== fplugctl - CLI Tool =====
  * コマンドラインからF-PLUGを操作するためのツールです
<code>
fplugctl [-d /dev/rfcommX] <コマンド>
コマンド: 
    init                デバイスの初期化
    settime             F-PLUGのデバイス時間をホスト時間へ合わせる
    led on              LED 点灯
    led off             LED 消灯
    get acc [n]         積算消費電力値を取得 (nを指定するとn時間前の値を取得)
    get <key1> ...      各種現在値を表示
        temperature     温度 (℃)
        humidity        湿度 (％)
        illuminance     照度
        power           消費電力値 (W)
</code>

===== fpdc - 定期的な値取得のためのツール =====
  * 積算電力値を取得するツールです
  * fpdc_config.conf を作成して使用します
  * cronなどで1分おきにfpdc_collect.shを実行することで、一時間おきの値ログと、一分ごとに現在値を保存しておくことができます
  * 現在値を保存し、fpdc_getval.shで値を得ることで、多数からの参照時にアクセスの競合を起こさず値が得られます

===== 参考 =====
  * F-PLUG - http://www.bsc.fujitsu.com/services/f-plug/
  * F-PLUG メッセージ一覧 - http://www.bsc.fujitsu.com/services/f-plug/downloads/message.html