Annotation of nono/vm/rtc.h, revision 1.1.1.14

1.1       root        1: //
                      2: // nono
1.1.1.3   root        3: // Copyright (C) 2020 nono project
                      4: // Licensed under nono-license.txt
1.1       root        5: //
                      6: 
1.1.1.9   root        7: //
                      8: // RTC の共通部分
                      9: //
                     10: 
1.1       root       11: #pragma once
                     12: 
                     13: #include "device.h"
1.1.1.9   root       14: #include <sys/time.h>
1.1       root       15: 
1.1.1.10  root       16: class Syncer;
                     17: 
1.1       root       18: class RTCDevice : public IODevice
                     19: {
1.1.1.3   root       20:        using inherited = IODevice;
1.1       root       21: 
                     22:  public:
1.1.1.10  root       23:        RTCDevice();
1.1.1.11  root       24:        ~RTCDevice() override;
1.1       root       25: 
1.1.1.7   root       26:        bool Init() override;
1.1       root       27: 
1.1.1.9   root       28:        virtual void StartTime();
                     29: 
                     30:        // 電源 OFF 時の実時間でのクロック入力。
                     31:        // 次回のクロック発生までの時間間隔を返す。
                     32:        uint64 ClockIn_PowerOff();
1.1.1.7   root       33: 
                     34:        // 現在の日付時刻を返す。
                     35:        // ここで取得できる値は機種によらず共通のフォーマットだが、
                     36:        // 値は範囲外の状態になる可能性が常にあることに注意。
                     37:        //
                     38:        // RP5C15 の場合、1つのレジスタが10進数一桁ごとを扱っているため、特に
                     39:        // ゲストプログラムが月の更新するしようとするときに一時的に範囲外の
                     40:        // 状態になることが避けられない。
                     41:        // 例えば、もともと12月31日だったものを9月30日に変更する場合、
                     42:        // 上の桁から更新したら(M10,M1,D10,D1)
                     43:        //  12/31 -> 02/31 -> 09/31 -> 09/31 -> 09/30
                     44:        // 下の桁から更新したら(D1,D10,M1,M10)
                     45:        //  12/31 -> 12/30 -> 12/30 -> 19/30 -> 09/30
                     46:        // このように、2/31, 9/31, 19/30 などが中間状態として発生する。
                     47:        virtual uint GetSec() const = 0;        // 秒(0-59)
                     48:        virtual uint GetMin() const = 0;        // 分(0-59)
                     49:        virtual uint GetHour() const = 0;       // 時(0-23)
                     50:        virtual uint GetWday() const = 0;       // 曜日(0-6、0が日曜)
                     51:        virtual uint GetMday() const = 0;       // 日(1-31)
                     52:        virtual uint GetMon() const = 0;        // 月(1-12)
                     53:        virtual uint GetYear() const = 0;       // 年(西暦)
                     54:        virtual uint GetLeap() const = 0;       // うるう年カウンタ(0-3、0がうるう年)
1.1       root       55: 
                     56:  protected:
1.1.1.9   root       57:        // 32Hz クロック入力。
                     58:        // clock-sync の設定に応じて、実時間または仮想時間で
                     59:        // 32Hz ごとに呼ばれて、これが RTC の時計を進める処理をするところ。
                     60:        void ClockIn();
                     61: 
1.1.1.7   root       62:        // 仮想 RTC のクロック出力
1.1       root       63: 
1.1.1.7   root       64:        // 継承クラス向けに 32Hz で呼び出される。
1.1.1.9   root       65:        virtual void Tick32Hz();
1.1       root       66: 
1.1.1.7   root       67:        // 継承クラス向けに 2Hz で呼び出される。
                     68:        // タイミングは、0/32秒目と 16/32秒目。
1.1.1.9   root       69:        virtual void Tick2Hz();
1.1.1.7   root       70: 
                     71:        // 継承クラス向けに 1Hz で呼び出される。
                     72:        // タイミングは、0/32秒目。
                     73:        // この関数から秒カウンタ更新をすること。
1.1.1.9   root       74:        virtual void Tick1Hz();
1.1.1.7   root       75: 
                     76:        // 秒をカウントアップし、秒以上の繰り上がりを処理する。
                     77:        void CountUpSec();
                     78:        // 分をカウントアップし、分以上の繰り上がりを処理する。
                     79:        // RP5C15 の ADJUST 機能を実現するために秒と分離。
                     80:        void CountUpMin();
                     81: 
                     82:        virtual void SetSec(uint v) = 0;
                     83:        virtual void SetMin(uint v) = 0;
                     84:        virtual void SetHour(uint v) = 0;
                     85:        virtual void SetWday(uint v) = 0;
                     86:        virtual void SetMday(uint v) = 0;
                     87:        virtual void SetMon(uint v) = 0;
                     88:        virtual void SetYear(uint v) = 0;
                     89:        virtual void SetLeap(uint v) = 0;
                     90: 
                     91:        // 32Hz でカウントアップする内部カウンタ
                     92:        uint64 cnt {};
                     93: 
                     94:        // 年エポック。システムに依存。
                     95:        uint year_epoch {};
                     96: 
                     97:        // 時刻設定時に localtime を使う場合は true
                     98:        bool use_localtime {};
                     99: 
                    100:        // レジスタとして読める値を定数にすることで、仮想マシン状態を
                    101:        // 常に同じ状態にするためのパフォーマンス測定用フラグ。
                    102:        // なお NVRAM 部分は影響されない。
                    103:        bool force_fixed {};
                    104: 
1.1.1.9   root      105:        // RTC の入力クロックが実時間の場合は true
                    106:        // 仮想時間の場合は false
                    107:        bool sync_rt {};
                    108: 
                    109:        // 設定で指定された日付時刻
                    110:        struct tm rtc_tm {};
                    111: 
1.1.1.7   root      112:        // 曜日文字列 (0 = "Sun", ...)
                    113:        // MK48T02 の誤運用にも対応するため 0..7 の範囲をとる。
                    114:        static const char * const wdays[8];
                    115: 
                    116:  private:
                    117:        // デバッグオプションの日付時刻文字列を解析する。
                    118:        bool ParseDate(const std::string& str, int *y, int *m, int *d, int *w);
                    119:        bool ParseTime(const std::string& str, int *h, int *m, int *s);
1.1       root      120: 
1.1.1.7   root      121:        // 現在の月の最終日を返す (月の繰り上がり処理用)
1.1.1.12  root      122:        uint GetLastMday() const;
1.1.1.9   root      123: 
                    124:        // イベントコールバック
1.1.1.14! root      125:        void Callback(Event *);
1.1.1.9   root      126: 
                    127:        // イベント間隔
                    128:        const uint period = 31.25_msec;
                    129: 
                    130:        // システムクロックが刻んでいる時刻
                    131:        uint64 stime {};
                    132: 
1.1.1.10  root      133:        Syncer *syncer {};
                    134: 
1.1.1.9   root      135:        // RTC クロック入力
1.1.1.14! root      136:        Event *event {};
1.1       root      137: };
                    138: 
1.1.1.10  root      139: static inline RTCDevice *GetRTCDevice() {
                    140:        return Object::GetObject<RTCDevice>(OBJ_RTC);
                    141: }

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.