cachepc-linux

Fork of AMDESE/linux with modifications for CachePC side-channel attack
git clone https://git.sinitax.com/sinitax/cachepc-linux
Log | Files | Refs | README | LICENSE | sfeed.txt

w1_ds2423.rst (2425B)


      1Kernel driver w1_ds2423
      2=======================
      3
      4Supported chips:
      5
      6  * Maxim DS2423 based counter devices.
      7
      8supported family codes:
      9
     10        ===============	====
     11	W1_THERM_DS2423	0x1D
     12        ===============	====
     13
     14Author: Mika Laitio <lamikr@pilppa.org>
     15
     16Description
     17-----------
     18
     19Support is provided through the sysfs w1_slave file. Each opening and
     20read sequence of w1_slave file initiates the read of counters and ram
     21available in DS2423 pages 12 - 15.
     22
     23Result of each page is provided as an ASCII output where each counter
     24value and associated ram buffer is outpputed to own line.
     25
     26Each lines will contain the values of 42 bytes read from the counter and
     27memory page along the crc=YES or NO for indicating whether the read operation
     28was successful and CRC matched.
     29If the operation was successful, there is also in the end of each line
     30a counter value expressed as an integer after c=
     31
     32Meaning of 42 bytes represented is following:
     33
     34 - 1 byte from ram page
     35 - 4 bytes for the counter value
     36 - 4 zero bytes
     37 - 2 bytes for crc16 which was calculated from the data read since the previous crc bytes
     38 - 31 remaining bytes from the ram page
     39 - crc=YES/NO indicating whether read was ok and crc matched
     40 - c=<int> current counter value
     41
     42example from the successful read::
     43
     44  00 02 00 00 00 00 00 00 00 6d 38 00 ff ff 00 00 fe ff 00 00 ff ff 00 00 ff ff 00 00 ff ff 00 00 ff ff 00 00 ff ff 00 00 ff ff crc=YES c=2
     45  00 02 00 00 00 00 00 00 00 e0 1f 00 ff ff 00 00 ff ff 00 00 ff ff 00 00 ff ff 00 00 ff ff 00 00 ff ff 00 00 ff ff 00 00 ff ff crc=YES c=2
     46  00 29 c6 5d 18 00 00 00 00 04 37 00 ff ff 00 00 ff ff 00 00 ff ff 00 00 ff ff 00 00 ff ff 00 00 ff ff 00 00 ff ff 00 00 ff ff crc=YES c=408798761
     47  00 05 00 00 00 00 00 00 00 8d 39 ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff crc=YES c=5
     48
     49example from the read with crc errors::
     50
     51  00 02 00 00 00 00 00 00 00 6d 38 00 ff ff 00 00 fe ff 00 00 ff ff 00 00 ff ff 00 00 ff ff 00 00 ff ff 00 00 ff ff 00 00 ff ff crc=YES c=2
     52  00 02 00 00 22 00 00 00 00 e0 1f 00 ff ff 00 00 ff ff 00 00 ff ff 00 00 ff ff 00 00 ff ff 00 00 ff ff 00 00 ff ff 00 00 ff ff crc=NO
     53  00 e1 61 5d 19 00 00 00 00 df 0b 00 ff ff 00 00 ff ff 00 00 ff ff 00 00 ff ff 00 00 ff ff 00 00 ff ff 00 00 ff ff 00 00 ff ff crc=NO
     54  00 05 00 00 20 00 00 00 00 8d 39 ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff crc=NO