hpet_example - HPET sample Application のバックアップ(No.6)

バックアップ一覧
差分を表示
現在との差分を表示
ソースを表示
hpet_example - HPET sample Application へ行く。

hpet_example †

HPET (High Precision Event Timer) ドライバ /drivers/char/hpet.c の動作を理解するために、実際に動かすアプリケーション・プログラム hpet_example.tar.gz を使います。このプログラムは /Documentation/timers/hpet_example.c を修正して作成してあります。/Documentation/timers/hpet.txt で hpet_example.c について概要が書かれています。情報量は多く有りません。ioctl() API の仕様詳細は書かれていません。

↑

ioctl API †

↑

HPET driver's APIs †

↑

Interrupt On - HPET_IE_ON †

SYNOPSIS
```
int ioctl(int fd, HPET_IE_ON);
```
PRECONDITION
- Set interrupt frequency by HPET_IRQFREQ.
- Enable or disable periodic interrupt by HPET_EPI or HPET_DPI.
DESCRIPTION
Enable timer interrupt assigned to file descriptor fd. When the timer interrupts processor, file descriptor fd becomes ready with event (POLLIN | POLLRDNORM) and also raise signal if set file status O_ASYNC and valid signal or process group number to fd.
RETURN VALUE
- 0 Success
- -1 Error
ERRORS
- EBADF Invalid file descriptor fd.
- EIO It occurs one of following conditions.
  - Invalid interrupt frequency.
  - Interrupt frequency has not been set.
  - Can't request IRQ handler. It may chipset or BIOS bug.
- EBUSY
  - Already enabled interrupt.

↑

Interrupt Off - HPET_IE_OFF †

SYNOPSIS
```
int ioctl(int fd, HPET_IE_OFF);
```
DESCRIPTION
Disable timer interrupt assigned to file descriptor fd.
RETURN VALUE
- 0 Success
- -1 Error
ERRORS
- EBADF Invalid file descriptor fd.

↑

Get Information - HPET_INFO †

SYNOPSIS

struct hpet_info {
	unsigned long  hi_ireqfreq; /* Period or time in Hz */
	unsigned long  hi_flags;    /* Information: 0x0: Not supported periodic int., 0x10: Supported periodic int. */
	unsigned short hi_hpet;     /* HPET device number, [0..TheNumberOfHPETDevicesInPlatform-1] */
	unsigned short hi_timer;    /* Timer number in HPET device, [0..31] */
};
int ioctl(int fd, HPET_INFO, /* out */ hpet_info *info);

DESCRIPTION
Get timer information assigned to file descriptor fd. ioctl call with HPET_INFO stores timer information to *info. This ioctl call fills hpet_info members as follows.
member description
hi_ireqfreq
hi_flags
hi_hpet
hi_timer

member	description
hi_ireqfreq
hi_flags
hi_hpet
hi_timer

↑

Enable hardware periodic interrupt - HPET_EPI †

SYNOPSIS
```
int ioctl(int fd, HPET_EPI);
```
DESCRIPTION
Enable hardware implemented periodic interrupt at timer assigned to file descriptor fd, and disable software assisted periodic interrupt. Call HPET_EPI ioctl() before enable interrupt HPET_IE_ON.

↑

Disable hardware periodic interrupt - HPET_DPI †

SYNOPSIS
```
int ioctl(int fd, HPET_DPI);
```
DESCRIPTION
Disable hardware implemented periodic interrupt at timer assigned to file descriptor fd, and enable software assisted periodic interrupt. Call HPET_DPI ioctl() before enable interrupt HPET_IE_ON.
When using HPET timer with HPET_DPI (disabling hardware periodic interrupt), HPET driver updates interrupt time in interrupt handler. So timer interrupts periodically and interrupt period includes software response time delay.

↑

Set Interrupt Frequency in Hz - HPET_IRQFREQ †

SYNOPSIS

int ioctl(int fd, HPET_IRQFREQ, unsigned long frequency);

↑

File System API's †

To see more details refer to man 2 fcntl.

↑

F_GETOWN, F_GETOWN_EX †

↑

F_SETOWN, F_SETOWN_EX †

↑

F_GETFL †

int fcntl(int fd, F_GETFL);

↑

F_SETFL †

SYNOPSIS
```
int fcntl(int fd, F_SETFL, int flags);
```

DESCRIPTION
To raise signal on timer event, let flags be ORed with O_ASYNC, see following pseudo code pice.

-
|
-
|
!
|
-
|
!
!

{       int     flags;
        flags = fcltl(fd, F_GETFL);
        if (flags < 0) {
                /* error handling. */
        }
        flags |= O_ASYNC;
        if (fcntl(fd, F_SETFL, flags) != 0) {
                /* error handling. */
        }
}

↑

F_GETSIG †

SYNOPSIS
```
int fcntl(int fd, F_GETSIG);
```
DESCRIPTION
Get the signal number will be raised on timer event.

↑

F_SETSIG †

SYNOPSIS

int fcntl(int fd, F_SETSIG, int signal);

DESCRIPTION
Set the signal number will be raised on timer event.