Top / Products / OpenSSM / Function

/Function

概要 †

　OpenSSMの細かな機能を説明します。組込機器となりますので、回路とファームウェアは密接に絡んでいることもあり、ハードウェア/ソフトウェアを同時に説明します。

　OpenSSMのファームウェアは、RTOS等の OSを使わず独自の環境下(プログラムライブラリ)に構築されています。最初は分かりにくい/理解しにくいと思われるところも多々あると思いますので、各ライブラリの説明ページを設けました。

　RTOSではマルチタスクが使えるため大変便利ですが、OpenSSMでは各タイマ割込をタスク代わりに使っています。また一部の処理では、イベントもどきの概念(あるいは、コルーチンに近い)を導入しています。

Fig.1 アプリケーション層とライブラリ(ドライバ)の関係

開発環境 †

　C言語で開発されています。ごくごく一部に、インラインアセンブラが使用されています。

1. Microchip MPLAB
2. Microchip C Compiler for PIC24

ライブラリについて †

　ライブラリとなる対象は、他のソフトウェアへの流用が可能かどうかという点において決められています。そのハードウェアあるいはアプリケーション固有となる機能の場合は、ライブラリ化されていません。 　ライブラリは、lib〜.c, lib〜.hと、libが接頭辞としてファイル名が決められています。また必ず lib〜.c, lib〜.hとペアでファイルが存在します。場合によっては、外部のテーブルを参照することがあり、その場合は table.hが必要になります。

アプリケーションについて †

　OpenSSMのアプリケーション層に相当する部分は、下記のコードにまとめられています。 　

その他 †

　開発の後半でスタックメモリが足りなくなってしまったので、かなりの関数を inline展開しています。ROMは比較的余裕があるので、実際のところは大したことないですが...

PIC24Fのオーバークロック †

　PIC24Fでは、OSCTUNレジスタを操作することによって、内蔵 FRCのクロックを 8MHz±12%まで変更することができます。また 4倍の PLLを内蔵していますので、標準のクロック 8MHz * 4 = 32MHz (Fcy = 16MHz) を超えてオーバークロック状態で動作させることができます。

　これまで確認したところでは、特に目立った発熱もなく極めて安定して動作しているようです。また大変都合の良いことに、クロックを一番上まで上げた状態 (Fcy = 17.92MHz) だと、UARTのボーレート計算結果がよく、とても使いやすいです (OSCTUN and UART for PIC24F.xls)。

OpenSSMでは、OSC 8.96MHz, Fcy = 17.92MHz, Fcpu = 35.84MHz に設定しています

サンプルコード †

　CLKDIVと OSCTUNレジスタを操作して、CPUクロックを変更します。また、この操作はいつでも実行できます。省電力にさせたいときはクロックを下げるなど、いろいろ使い道があります。

　詳しくは、PIC24Fのデータシートを参照してください

#include <p24FJ64GA002.h>

_CONFIG1(   JTAGEN_OFF &
            GCP_OFF &
            GWRP_OFF &
            BKBUG_OFF &
            WINDIS_OFF &
            COE_OFF &
            ICS_PGx1 &
            FWDTEN_ON &
            WDTPS_PS256) 

_CONFIG2(   IESO_OFF &
            FNOSC_FRCPLL &
            FCKSM_CSDCMD &
            OSCIOFNC_ON &
            IOL1WAY_OFF &
            I2C1SEL_PRI &
            POSCMOD_NONE)

int main(void)
{
    /* Fosc = 8.96MHz, Fcy = 17.92MHz, Core 35.84MHz */
    CLKDIV = 0;
    OSCTUN = 0b0000000000011111;

    while(1){
        ClrWdt();
    }

    return(0);
}

OSCTUNレジスタと CPUクロックの関係 †

8.96MHzのときのボーレート設定一覧 †

　Low MODE / High MODEは、UARTの BRGHレジスタの設定を指しています。詳しくは、PIC24Fのデータシートを参照してください。

RTCドライバについて †

　Microchip PIC24Fの内蔵タイマーを使用した Software RTC ドライバです。起動後のアワーメータ (tick、秒、分、時、日) と時刻 (ミリ秒, 秒、分, 時, 日) をカウントします。tickは、RTCドライバの基準時間単位です。標準では 0.1ミリ秒に設定されています。

仕様　 †

ソースコード †

1. librtc.c
2. librtc.h
3. table.c
4. table.h
5. types.h

回路図 †

　ありません。内部タイマーを使用しているのみで、ソフトウェアだけで動きます。

サンプルコード †

#include <p24FJ64GA002.h>

#include "librtc.h"

_CONFIG1(   JTAGEN_OFF &
            GCP_OFF &
            GWRP_OFF &
            BKBUG_OFF &
            WINDIS_OFF &
            COE_OFF &
            ICS_PGx1 &
            FWDTEN_ON &
            WDTPS_PS256) 

_CONFIG2(   IESO_OFF &
            FNOSC_FRCPLL &
            FCKSM_CSDCMD &
            OSCIOFNC_ON &
            IOL1WAY_OFF &
            I2C1SEL_PRI &
            POSCMOD_NONE)

int main(void)
{
    unsigned int tick;

    /* Fosc = 8.96MHz, Fcy = 17.92MHz, Core 35.84MHz */
    CLKDIV = 0;
    OSCTUN = 0b0000000000011111;
    SRbits.IPL = 0;

    /* ポートの入出力モード設定 */
    /*          FEDCBA9876543210 */
    TRISA   = 0b0000000000000011;
    TRISB   = 0b0000111101100001;

    RTC_init();

    /* メインループ */
    tick = rtc.tick;
    while(1){
        ClrWdt();

        /* 100ms経過したら処理を行う */
        if(RTC_get_ticks(tick, rtc.tick) > 1000){
            /* 何かさせる */
        }
    }

    return(0);
}

分解能の変更方法 †

　標準では、1 tickの時間は 0.1ミリ秒ですが、下記のマクロを変更することで分解能を任意に変更できます。分解能を下げる (0.1ミリ秒より大きくする) と CPU負荷が下がり、分解能を上げる (0.1ミリ秒より小さくする) と CPU負荷も上がります。また、アワーメータの計算を正しく行うために、_T1Interrupt()関数内の時刻計算処理を修正してください。

　CPUクロックを動的に変更する場合は、RTC_init_timer()を適宜呼び出して PR1を初期化してください。

---

void __attribute__((interrupt, auto_psv)) _T1Interrupt(void)
{
    IFS0bits.T1IF = 0;

    /* tick is 0.1ms */
    rtc.tick++;
    if(rtc.tick % 10 != 0) return;

    /* ミリ秒 */
    rtc.msec++;
    rtc.msec = rtc.msec % 1000;
    if(rtc.msec != 0) return;

    /* 秒 */
    rtc.secmeter++;
    rtc.sec++;
    rtc.sec = rtc.sec % 60;
    if(rtc.sec != 0) return;

    /* 分 */
    rtc.minmeter++;
    rtc.min++;
    rtc.min = rtc.min % 60;
    if(rtc.min != 0) return;

    /* 時 */
    rtc.hourmeter++;
    rtc.hour++;
    rtc.hour = rtc.hour % 24;
    if(rtc.hour != 0) return;

    /* 日 */
    rtc.day++;

    return;
}

void RTC_init_timer(void)
{
    PR1 = cpu_fcy[ OSCTUN ] / 10000;        /* 0.1ミリ秒 */
    return;
}

---

void __attribute__((interrupt, auto_psv)) _T1Interrupt(void)
{
    IFS0bits.T1IF = 0;

    /* tick is 1ms */
    rtc.tick++;

    /* ミリ秒 */
    rtc.msec++;
    rtc.msec = rtc.msec % 1000;
    if(rtc.msec != 0) return;

    /* 秒 */
    rtc.secmeter++;
    rtc.sec++;
    rtc.sec = rtc.sec % 60;
    if(rtc.sec != 0) return;

    /* 分 */
    rtc.minmeter++;
    rtc.min++;
    rtc.min = rtc.min % 60;
    if(rtc.min != 0) return;

    /* 時 */
    rtc.hourmeter++;
    rtc.hour++;
    rtc.hour = rtc.hour % 24;
    if(rtc.hour != 0) return;

    /* 日 */
    rtc.day++;

    return;
}

void RTC_init_timer(void)
{
    PR1 = cpu_fcy[ OSCTUN ] /  1000;        /* 1ミリ秒 */
    return;
}

シリアル通信ドライバについて †

　Microchip PIC24Fの UARTに Software FIFOを実装したシリアル ドライバ>です。 シリアルドライバは、PIC24Fのハードウェア UART 割込 (_U1TXInterrupt, _U2TXInterrupt, _U1RXInterrupt, _U2RXInterrupt) から呼ばれます。また、 2チャンネルの UARTに対して、送信/受信バッファサイズを任意に設定できます。

UARTxは、UART1またはUART2と置き換えてください

仕様 †

基板 †

ファームウェア †

ソースコード †

1. libuart.c
2. libuart.h
3. table.c
4. table.h
5. types.h

回路図 †

　PIC24Fの場合は、TXD/RXDをそれぞれ RPピンへ接続します。その後、ファームウェア側で RPピンに TXD/RXDの機能を設定します。したがって、RPピンであればどこに接続してもよく、非常に回路が組みやすくなっています。

　たとえば、ファームウェア書き換え用コネクタ (ICSP)の PGD/PGCピンに対して TXD/RXDを割り当て、デバッグ時のみシリアル通信を行うといったことが非常に簡単にできます。

回路を変更するとき †

　回路によって TX/RXのピンを変更する場合は、UARTx_init()関数内を変更してください。

バッファサイズの変更するとき †

　libuart.hのマクロを変更してからコンパイルします。

#define UART1_TX_BUFFER_SIZE           128
#define UART1_RX_BUFFER_SIZE           128
#define UART2_TX_BUFFER_SIZE            50
#define UART2_RX_BUFFER_SIZE            70

サンプルコード †

　送信/受信のサンプルソースコードです。回路図は、OpenSSM Rev.A を想定しています。

#include <p24FJ64GA002.h>

#include "table.h"
#include "libuart.h"

_CONFIG1(   JTAGEN_OFF &
            GCP_OFF &
            GWRP_OFF &
            BKBUG_OFF &
            WINDIS_OFF &
            COE_OFF &
            ICS_PGx1 &
            FWDTEN_ON &
            WDTPS_PS256) 

_CONFIG2(   IESO_OFF &
            FNOSC_FRCPLL &
            FCKSM_CSDCMD &
            OSCIOFNC_ON &
            IOL1WAY_OFF &
            I2C1SEL_PRI &
            POSCMOD_NONE) 

int main(void)
{
    int buf;

    /* Fosc = 8.96MHz, Fcy = 17.92MHz, Core 35.84MHz */
    CLKDIV = 0;
    OSCTUN = 0b0000000000011111;
    SRbits.IPL = 0;

    TRISA   = 0b0000000000000011;
    TRISB   = 0b0000111101100001;

    UART1_init(115200);
    UART2_init(  4800);

    /* 送信受信をループバック. エコー */
    while(1){
        ClrWdt();

        if((buf = UART1_getch()) > 0){
            UART1_putch(buf);
        }

        if((buf = UART2_getch()) > 0){
            UART2_putch(buf);
        }
    }

    return(0);
}

コンパイルの確認はしていません (^^;

参考文献 †

1. Hyper Operating System (ITRON仕様OS) Ver.3 ソースコード (HOS-H8h Ver0.07)*1

ビデオドライバについて †

　Microchip PIC24Fの SPIとタイマー割込を使用した Software ビデオ (NTSC) ドライバと文字表示を行うためのフォントドライバです。

　ビデオドライバは、モニタ出力 (通常の NTSC出力) とスーパーインポーズ出力に対応しています。スーパーインポーズ出力を行う場合は、外部のビデオ信号が必要となります。PIC24F内蔵の割り込みを使っているため非常に高速に描画することができ、フォアグラウンドの処理を邪魔しません (まさに OpenSSMが良い例でしょう)。また省電力機能にも対応しており、ビデオ表示を行いながら動的に CPUクロックを上げる/下げることもできます。

　フォントドライバは、FONTX2の半角文字フォントに対応しています。これまでいろいろな方が作成したフォントを、そのまま ROMに入れることができます。また、どんな変態フォントサイズ(^^; でも表示できます。

仕様 †

基板 †

ファームウェア †

ソースコード †

1. libvideo.c
2. libvideo.h
3. libfontx2.c
4. libfontx2.h
5. table.c
6. table.h
7. types.h

回路図 †

　OpenSSM Rev.Aの回路図から、ビデオ信号に関する部分を抜粋しました。次のポイントに注意してください.

1. 抵抗は、なるべく高精度品(±1%程度)を選定してください
2. ダイオード D1は、Vref = 0.7V品を選定してください
3. 電源は、+3.3V (VDD) と +5Vの 2つ必要です
4. ビデオ出力とスーパーインポーズの回路は独立しています。どちらか1つだけ使うことも出来ます

ビデオ出力の概要 †

スーパーインポーズの概要 †

グラフの描き方 / グラフ関数の使い方 †

メータの描き方 / メータ関数の使い方 †

トラッカーの描き方 / トラッカー関数の使い方 †

フォントの変更のしかた †

参考文献 †

1. 後閑哲也, C言語ではじめる PIC24F活用ガイドブック, 技術評論社, 2007.
2. トランジスタ技術SPECIAL No.52 ビデオ信号処理の徹底研究, CQ出版, 1996.

OBD-II Harness Drawing †

　OpenSSMと自動車を接続する OBD-IIケーブルのハーネス図面です。

　市販の Ehternetケーブルを流用して、OBD-IIのケーブルとしています。

ハーネス図 †

ハーネス図のライセンスを確認する

完成品 †

ハーネス図の描き方 †

　カスタムケーブルを扱う/業者へ製造してもらう場合には、ハーネス図 (ケーブル加工図面、ケーブル加工の指図書) が必要となります。

世の中には、ハーネス図の描き方を解説した本がないんですよね...　完全にノウハウの世界です。誰か本を書かせてくれないかな〜 (^^;;

図面に描きいれる内容 †

　一般にハーネス図には、下記を入れます。

1. コネクタとケーブルの模式図
   機械図面ではないので、鳥瞰図でなくとも良い。
2. 結線図 (ネットリスト)
3. 部品表 (メーカ名, 型番, 使用数量)
4. 縮尺
5. 加工公差
6. 図番, 型番,
7. 改訂履歴
8. 設計, 製図, 検図, 承認等の責任の所在
9. 著作権保護、図面の取扱上の注意
10. RoHS対応の有無

すみません。OpenSSMのハーネス図は、かなり簡略化して描いてあります...

バグ †

　OpenSSM開発中に見つけた ECUや Microchip PIC24F Series に関するバグをメモしておきます。すべて再現性がありますので、参考になると思います

もしかしたら Errataなどに書いてあるかもしれませんが... (^^;

ECU †

ACCオフのあとも通信できることがある †

　通常は ACC電源をオフにすると ECUと通信できなくなるが、通信したまま ACC電源をオフにすると、ごく希にそのまま ECUと通信できることがある。

再度、エンジンを始動するまでその状態が続く

恐らく ECUのバグ (^^;

PIC24F †

割り込みルーチンに関して †

　低レベル優先度の割り込み関数実行中に上位優先度の割り込み関数が呼ばれると、低レベル優先度の割り込み関数がその後実行されなくなる。この現象は、ほかの割り込み関数でも多発する。

　問題を解決するために、割込関数が呼ばれた直後に割込フラグを解除する。

OCxCONに関しては、毎回初期化しないといけない. こっちは仕様!?

• OK

  void __attribute__((interrupt, auto_psv)) _OC4Interrupt(void)
  {
      IFS1bits.OC4IF = 0;
  
      CVRCONbits.CVR = dac >> 4;
      OC4CON = 0b0000000000000001;
      return;
  }

• NG

  void __attribute__((interrupt, auto_psv)) _OC4Interrupt(void)
  {
      CVRCONbits.CVR = dac >> 4;
      OC4CON = 0b0000000000000001;
  
      IFS1bits.OC4IF = 0;
      return;
  }

PukiWiki 1.4.7 Copyright © 2001-2006 PukiWiki Developers Team. License is GPL.
Based on "PukiWiki" 1.3 by yu-ji.
Skin "GS2" is designed by yiza.
Powered by PHP 5.4.29. HTML convert time: 0.330 sec.