~mmach/netext73/lm-sensors

« back to all changes in this revision

Viewing changes to prog/dump/isaset.8

  • Committer: mmach
  • Date: 2020-02-05 20:28:34 UTC
  • Revision ID: netbit73@gmail.com-20200205202834-zc3sla47j9e700w5
3.6

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.TH ISASET 8 "April 2011"
 
2
.SH "NAME"
 
3
isaset \- set ISA registers
 
4
 
 
5
.SH SYNOPSIS
 
6
.B isaset
 
7
.RB [ -y ]
 
8
.RB [ -W | -L ]
 
9
.I addrreg
 
10
.I datareg
 
11
.I address
 
12
.I value
 
13
.RI [ mask ]
 
14
#for I2C-like access
 
15
.br
 
16
.B isaset
 
17
.B -f
 
18
.RB [ -y ]
 
19
.RB [ -W | -L ]
 
20
.I address
 
21
.I value
 
22
.RI [ mask ]
 
23
#for flat address space
 
24
 
 
25
.SH DESCRIPTION
 
26
isaset is a small helper program to set registers visible through the ISA
 
27
bus.
 
28
 
 
29
.SH OPTIONS
 
30
.TP
 
31
.B -f
 
32
Enable flat address space mode.
 
33
.TP
 
34
.B -y
 
35
Disable interactive mode. By default, isaset will wait for a confirmation
 
36
from the user before messing with the ISA bus. When this flag is used, it
 
37
will perform the operation directly. This is mainly meant to be used in
 
38
scripts.
 
39
.TP
 
40
.B -W
 
41
Perform a 16-bit write.
 
42
.TP
 
43
.B -L
 
44
Perform a 32-bit write.
 
45
 
 
46
.SH OPTIONS (I2C-like access mode)
 
47
Four options must be provided to isaset. \fIaddrreg\fR contains the
 
48
ISA address of the address register for the chip to probe; \fIdatareg\fR
 
49
contains the address of the data register. Both addresses are integers between
 
50
0x0000 and 0x3FFF. Usually, if the chip's base address is 0x0nn0, the
 
51
address register is at 0x0nn5 and the data register is at 0x0nn6. The most
 
52
common base address for hardware monitoring chips is 0x0290.
 
53
For Super-I/O chips, address register is typically at 0x2E with data
 
54
register at 0x2F.
 
55
The \fIaddress\fR and \fIvalue\fR parameters are two integers between
 
56
0x00 and 0xFF. isaset will write value \fIvalue\fR to address \fIaddress\fR.
 
57
An optional \fImask\fR can be provided as a fifth parameter, preserving
 
58
unmasked bits at the written location.
 
59
 
 
60
.SH OPTIONS (flat address space mode)
 
61
In flat mode, two parameters must
 
62
be provided. \fIaddress\fR contains the ISA address of the register to
 
63
write to; it is an integer between 0x0000 and 0xFFFF. Basically, it is
 
64
the sum of the chip's base address and the chip register's address. isaset
 
65
will write value \fIvalue\fR at this address.
 
66
An optional \fImask\fR can be provided as a third parameter, preserving
 
67
unmasked bits at the written location.
 
68
 
 
69
.SH WARNING
 
70
Poking around in ISA data space is extremely dangerous.
 
71
Running isaset with random parameters can cause system
 
72
crashes, data loss, and worse!  Be extremely careful when using
 
73
this program.
 
74
 
 
75
.SH SEE ALSO
 
76
i2cset(8), isadump(8)
 
77
 
 
78
.SH AUTHOR
 
79
Mark D. Studebaker, and the lm_sensors group
 
80
(https://hwmon.wiki.kernel.org/lm_sensors)
 
81
.PP
 
82
This manual page was shamelessly ripped from the i2cset and isadump manual
 
83
pages by Jean Delvare.