S-35710の概要と、S-35710用OSS-ECALの提供についてご紹介いたします。S-35710は、ABLIC製のウェイクアップ・タイマIC（1s～194日）です。
MCUインタフェース：I2C、GPIO
ご注意：実際の設計などの前には、必ず最新版Datasheetをご参照くださいますようお願いいたします。
S-35710
概要
ウェイクアップタイマICは、定期的にシステムをウェイクアップすることでシステムの間欠動作を可能とします。 S-35710シリーズは、タイマ値と内部レジスタに書き込みした値を比較し、値が一致したときにウェイクアップ信号 (割り込み信号) を出力します。 S-35710シリーズのタイマは、24ビットのバイナリアップカウンタです。 ユーザは、2ワイヤシリアルインタフェースを介し、内部レジスタのデータ値を自由に設定できます。したがって、ウェイクアップ信号 (割り込み信号) 発生までの時間を自由に設定可能です。
特徴
- ウェイクアップ機能 (アラーム割り込み機能) : 1秒 ~ 194日 (およそ半年) まで1秒単位で設定可能
- 低消費電流 : 0.2 μA typ. (水晶振動子 : CL = 6.0 pF、VDD = 3.0 V、Ta = +25°C)
- 広動作電圧範囲：1.8 V ~ 5.5 V
- 2ワイヤ (I2C-bus) によるCPUインタフェース
- 32.768 kHz水晶発振回路内蔵
- 動作温度範囲：Ta = −40°C ~ +85°C
- 鉛フリー (Sn 100%)、ハロゲンフリー
用途
- IoT通信機器
- 監視機器
- セキュリティ機器
- 電池駆動システム
- エナジーハーべスティングシステム
OSS-ECAL仕様
API関数
OSS-ECALのAPI関数は、基本的に定周期Thread（TASK）から関数コールされることを前提としています。
etSTS oS35710_CLEAR( void )
oS35710_CLEAR関数は、/RST端子をLowとして、タイムレジスタおよびウェイクアップタイムレジスタをゼロクリアするAPI関数です。
- /RST端子 Low とする
- 438ms経過するまで待機する（待機中は戻り値eSTS_EXE）
備考：
438ms経過時間は、本API関数をコールするThread周期から計算するので、THREAD_OSS_ECAL_PERIOD[ms]にThread周期を設定してください。
/RST端子はLowのままとなります。Wake-up時間カウントアップする場合は、oS35710関数のコマンドeCMD_COUNTUPまたはoS35710_COUNTUP関数を実行してください。
| 戻り値 | etSTS | OSS-ECALステータスコード | |
| eSTS_FIN | 正常終了 | ||
| eSTS_EXE | 実行中 | ||
| eSTS_ERR_I2C_OBJECT | I2Cオブジェクト選択エラー | ||
| eSTS_ERR_OTHERS_RUN | 他のコンポーネントが処理実行中 | ||
| eSTS_ERR_HAL_OTHERS_RUN | 他のアプリケーションがHAL実行中 | ||
| eSTS_ERR_HAL_I2C | HAL I2Cエラー |
etSTS oS35710_COUNTUP( void )
oS35710_COUNTUP関数は、/RST端子をHiとして、タイムレジスタをカウントアップするAPI関数です。
- /RST端子 Hi とする
- 438ms経過するまで待機する（待機中は戻り値eSTS_EXE）
備考：
438ms経過時間は、本API関数をコールするThread周期から計算するので、THREAD_OSS_ECAL_PERIOD[ms]にThread周期を設定してください。/RST端子はHiのままとなります。
| 戻り値 | etSTS | OSS-ECALステータスコード | |
| eSTS_FIN | 正常終了 | ||
| eSTS_EXE | 実行中 | ||
| eSTS_ERR_I2C_OBJECT | I2Cオブジェクト選択エラー | ||
| eSTS_ERR_OTHERS_RUN | 他のコンポーネントが処理実行中 | ||
| eSTS_ERR_HAL_OTHERS_RUN | 他のアプリケーションがHAL実行中 | ||
| eSTS_ERR_HAL_I2C | HAL I2Cエラー |
etSTS oS35710_WRITE_WUR( uint32 wut )
oS35710_WRITE_WUR関数は、ウェイクアップタイムレジスタにwutの値（24bit）を書き込むAPI関数です。
- ウェイクアップタイムレジスタにwutの値（24bit）を書き込む
備考：
ライトモード時（/RST端子 Hi）に行ってください。
| 戻り値 | etSTS | OSS-ECALステータスコード | |
| eSTS_FIN | 正常終了 | ||
| eSTS_ERR_I2C_OBJECT | I2Cオブジェクト選択エラー | ||
| eSTS_ERR_OTHERS_RUN | 他のコンポーネントが処理実行中 | ||
| eSTS_ERR_HAL_OTHERS_RUN | 他のアプリケーションがHAL実行中 | ||
| eSTS_ERR_HAL_I2C | HAL I2Cエラー | ||
| 引数 IN | uint32 wut | Wake-upタイム [s] | 24bit |
etSTS oS35710_READ_WUR( stS35710_O* rlt )
oS35710_READ_WUR関数は、ウェイクアップタイムレジスタ（24bit）の値を読み込み、rlt.wakeup_regに保存するAPI関数です。
- ウェイクアップタイムレジスタ（24bit）の値を読み込み、rlt.wakeup_regに保存する
備考：
ライトモード時（/RST端子 Hi）時に行ってください。
| 戻り値 | etSTS | OSS-ECALステータスコード | |
| eSTS_FIN | 正常終了 | ||
| eSTS_ERR_I2C_OBJECT | I2Cオブジェクト選択エラー | ||
| eSTS_ERR_OTHERS_RUN | 他のコンポーネントが処理実行中 | ||
| eSTS_ERR_HAL_OTHERS_RUN | 他のアプリケーションがHAL実行中 | ||
| eSTS_ERR_HAL_I2C | HAL I2Cエラー | ||
| 引数 OUT | stS35710_O* rlt | S-35710からの受信データ | |
| uint32 timer_reg | Time register 値[s]（未更新） | ||
| uint32 wakeup_reg | Wake-up time register 値[s] |
etSTS oS35710_READ_TR( stS35710M_O* rlt )
oS35710_READ_TR関数は、タイムレジスタ（24bit）の値を読み込み、rlt.timer_regに保存するAPI関数です。
- タイムレジスタ（24bit）の値を読み込み、rlt.timer_regに保存する
備考：
| 戻り値 | etSTS | OSS-ECALステータスコード | |
| eSTS_FIN | 正常終了 | ||
| eSTS_ERR_I2C_OBJECT | I2Cオブジェクト選択エラー | ||
| eSTS_ERR_OTHERS_RUN | 他のコンポーネントが処理実行中 | ||
| eSTS_ERR_HAL_OTHERS_RUN | 他のアプリケーションがHAL実行中 | ||
| eSTS_ERR_HAL_I2C | HAL I2Cエラー | ||
| 引数 OUT | stS35710_O* rlt | S-35710からの受信データ | |
| uint32 timer_reg | Time register 値[s] | ||
| uint32 wakeup_reg | Wake-up time register 値[s]（未更新） |
etSTS oS35710_DIAG_WUR( uint32 wut )
oS35710_DIAG_WUR関数は、ウェイクアップタイムレジスタの書込み診断するAPI関数です。
- /RST端子 Hi とする
- 438ms経過するまで待機する（待機中は戻り値eSTS_EXE）
- ウェイクアップタイムレジスタにwutの値（24bit）を書き込む
- ウェイクアップタイムレジスタ（24bit）の値を読み込む
- wutとウェイクアップタイムレジスタ値の比較結果を戻り値として返す
True … eSTS_FIN
False … eSTS_ERR_DIAG
備考：
438ms経過時間は、本API関数をコールするThread周期から計算するので、THREAD_OSS_ECAL_PERIOD[ms]にThread周期を設定してください。
| 戻り値 | etSTS | OSS-ECALステータスコード | |
| eSTS_FIN | 正常終了 | ||
| eSTS_EXE | 実行中 | ||
| eSTS_ERR_DIAG | ウェイクアップタイムレジスタの書込み診断NG | ||
| eSTS_ERR_I2C_OBJECT | I2Cオブジェクト選択エラー | ||
| eSTS_ERR_OTHERS_RUN | 他のコンポーネントが処理実行中 | ||
| eSTS_ERR_HAL_OTHERS_RUN | 他のアプリケーションがHAL実行中 | ||
| eSTS_ERR_HAL_I2C | HAL I2Cエラー | ||
| 引数 IN | uint32 wut | Wake-upタイム [s] | 24bit |
etSTS oS35710_DIAG_TR( void )
oS35710_DIAG_TR関数は、タイムレジスタのカウントアップを診断するAPI関数です。
- /RST端子 Hi とする
- S35710_DIAG_TIME[s]経過するまで待機する（待機中は戻り値eSTS_EXE）
- タイムレジスタ（24bit）の値を読み込む
- S35710_DIAG_TIME[s]とタイムレジスタ値の比較結果を戻り値として返す
True … eSTS_FIN
False … eSTS_ERR_DIAG
備考：
S35710_DIAG_TIME[s]は、1以上の値を設定してください。
S35710_DIAG_TIME[s]経過時間は、本API関数をコールするThread周期から計算するので、THREAD_OSS_ECAL_PERIOD[ms]にThread周期を設定してください。
| 戻り値 | etSTS | OSS-ECALステータスコード | |
| eSTS_FIN | 正常終了 | ||
| eSTS_EXE | 実行中 | ||
| eSTS_ERR_DIAG | タイムレジスタのカウントアップ診断NG | ||
| eSTS_ERR_I2C_OBJECT | I2Cオブジェクト選択エラー | ||
| eSTS_ERR_OTHERS_RUN | 他のコンポーネントが処理実行中 | ||
| eSTS_ERR_HAL_OTHERS_RUN | 他のアプリケーションがHAL実行中 | ||
| eSTS_ERR_HAL_I2C | HAL I2Cエラー |
etSTS oS35710_DIAG_CLEAR( uint32 wut )
oS35710_DIAG_CLEAR関数は、タイムレジスタおよびウェイクアップタイムレジスタのゼロクリア診断するAPI関数です。
- /RST端子 Hi とする
- S35710_DIAG_TIME[s]経過するまで待機する（待機中は戻り値eSTS_EXE）
- ウェイクアップタイムレジスタにwutの値（24bit）を書き込む
- /RST端子 Low とする
- 438ms経過するまで待機する（待機中は戻り値eSTS_EXE）
- タイムレジスタ（24bit）の値を読み込む
- /RST端子 Hi とする
- S35710_DIAG_TIME[s]経過するまで待機する（待機中は戻り値eSTS_EXE）
- ウェイクアップタイムレジスタ（24bit）の値を読み込む
- タイムレジスタ値とウェイクアップタイムレジスタ値のゼロチェック結果を戻り値として返す
True … eSTS_FIN
False … eSTS_ERR_DIAG
備考：
S35710_DIAG_TIME[s]および438ms経過時間は、本API関数をコールするThread周期から計算するので、THREAD_OSS_ECAL_PERIOD[ms]にThread周期を設定してください。
| 戻り値 | etSTS | OSS-ECALステータスコード | |
| eSTS_FIN | 正常終了 | ||
| eSTS_EXE | 実行中 | ||
| eSTS_ERR_DIAG | ウェイクアップタイムレジスタのゼロクリア診断NG | ||
| eSTS_ERR_I2C_OBJECT | I2Cオブジェクト選択エラー | ||
| eSTS_ERR_OTHERS_RUN | 他コンポーネント実行中エラー | ||
| eSTS_ERR_HAL_OTHERS_RUN | 他アプリケーションでHAL実行中 | ||
| eSTS_ERR_HAL_I2C | HAL I2Cエラー | ||
| 引数 IN | uint32 wut | Wake-upタイム [s] | 24bit |
ご注意
S-3571のINT端子出力は、別途対応してください。
HALサポート
OSS-ECALのHAL対応は、次の通りです。（順次拡大中）尚、同じHALであってもVerやMCU、開発環境が異なると動作が合わない場合がありますので、ご注意ください。
| メーカ | SDK/IDE ツール | HAL名称 | Ver | HALNAME | Support |
|---|---|---|---|---|---|
| Arduino | Arduino IDE | Arduino | 1.8.6 | ARDUINO | X |
| Arm | Keil MDK v6 | Mbed OS | 6.17.0 | MBED | X |
| Debian | – | GNU/Linux | 10.3 | Linux | X |
| Infineon | ModusToolbox | mtb-hal-cat1 | 2.4.3 | ModusToolbox | X |
| NXP | MCUXpresso SDK | SDK_2.x_EVKB-IMXRT1050 | 2.16 | iMXRT1051B1052B | – |
| Renesas | Synergy Software Package | HAL | 2.6.0 | SSP | X |
| STMicroelectronics | STM32Cube | STM32CubeF4 | V1.28.1 | STM32F4 | X |
開発環境
OSS-ECAL開発時のMCUおよび開発環境は、次の通りです。
| HALNAME | メーカ | 開発ボード | MCU | IDE |
|---|---|---|---|---|
| ARDUINO | Arduino | 1.Mega 2560 Rev3 2.Arduino Pro Mini 3.3V | ATmega2560 ATmega328P | Arduino IDE 2.3.3 |
| MBED | STMicroelectronics | STM32 Nucleo-64 boards | STM32F401RETx | Arm Keil Studio Cloud |
| Linux | BeagleBoard | BeagleBone Black | TI AM335x | – |
| ModusToolbox | Infineon | CY8CPROTO-063-BLE PSoC 6 BLE Prototyping Kit | CYBLE-416045-02 | ModusToolbox |
| iMXRT1051B1052B | NXP | IMXRT1050-EVKB | i.MX RT1050 | MCUXpresso IDE |
| SSP | Renesas | S7G2 SK | R7FS7G27H3A01CFC | e² studio for Renesas Synergy |
| STM32F4 | STMicroelectronics | STM32 Nucleo-64 boards | STM32F401RETx | STM32CubeIDE |
File構成
| フォルダ* | ファイル | 概要 |
|---|---|---|
| S35710_HALNAME_VERSION/sample | sample.c (.cpp) | サンプル・アプリケーション・プログラム |
| sample.h | サンプル・アプリケーション・ヘッダ | |
| S35710_HALNAME_VERSION | oS35710.c (.cpp) | S-35710用OSS-ECALプログラム |
| oS35710.h | S-35710用OSS-ECALヘッダ | |
| S35710_ARDUINO.ino | Arduino用サンプル・アプリケーション・プログラム | |
| oss_ecal.h | OSS-ECAL 共通ヘッダ | |
| user_setting.c (.cpp) | ユーザ設定定数・テーブル | |
| user_setting.h | ユーザ設定ヘッダ | |
| oHAL_i2c_stm32f4.c | STM32Cube FW_F4用HALプログラム | |
| oHAL_i2c_stm32f4.h | STM32Cube FW_F4用HALヘッダ | |
| readme.md | Readme | |
| OSS-ECAL Terms of Use.txt | OSS-ECAL利用条件 |
* HALNAMEはHAL対応表を参照してください。
OSS-ECAL ダウンロード
OSS-ECALのダウンロードは、英語版OSS-ECALサイトからお願いいたします。なお、ダウンロードを行う際は、英語版OSS-ECALサイトにログインしてから操作してください。
組込み方法
ユーザプログラムに複数のOSS-ECAL（同じMCU機能の電子部品）を組み込む方法
ユーザプログラムに複数のOSS-ECAL（異なるMCU機能の電子部品）を組み込む方法
注意事項
サンプル版OSS-ECALは、優先順位の異なるThread（Task）や割込みで用いることを前提としていません。下記の例のような使い方はしないでください。
例）同じADCグループに各センサーが割り当てられ、優先順位が異なる処理でOSS-ECAL APIを実行すると、正しい値を取得できない場合があります。
ADC Gr0 Ch0 温度センサ AD22100A 100ms周期 Thread（優先順位低）で温度取込み
ADC Gr0 Ch1 圧力センサ MPX5999D イベント割込み（優先順位高）で圧力取込み