GitLocker: The Coding Marketplace

Description:

hwmon 1.0

Hwmon's Documentation

Authors: bla6 and Guillermo-C-A
Repository:
PyPI url
Install Hwmon
pip install hwmon

New data available
Now you can get information about the GPU and the BIOS of your computer. For more information, read how to use the new features in this README

Motivations to create Hwmon
Hwmon has been created with the intention of replacing Linux libraries and APIs with which to obtain system information without the need to depend on dependencies outside a standard Linux system, i. e. that nothing needs to be installed.
The only requirements for running Hwmon on a system are:

The OS is Linux
Have python 3

Hwmon is also a library developed expressly by and for Python 3 with functions that are easy to understand and operate, which read and synthesize in the same library all the useful information for monitoring a Linux system that can be found in the /ys, /proc and /dev folders. So only the information that the system itself has recorded will be obtained.
Why use Hwmon instead of other library?
As already mentioned, Hwmon does not require any dependencies or programs and is a library created with the standard Python 3 libraries. Which is not the case with other library as they are:

Pysensors
lm-sensors
psutil

Where you need files and programs to be able to work, so if you're missing some of that, it just doesn't work. They are also heavier solutions in terms of file sizes than Hwmon.
Is it really a viable alternative to lm-sensors?
Yes. Hwmon is able to return and print the same information that is obtained when installing and running sensors.

And it even prints the information on the screen in a nice and friendly way so that it is more useful and easy to understand.
What information can I get from Hwmon and where does he get it from?
Hwmon is able to extract:

Information from the sensors available on the computer
Processor information
System memory information
Sent and received packet information
USB devices connected to the computer
Disks connected to the computer

All this information is extracted respectively from the following sites:

/sys/class/hwmon
/proc/cpuinfo y /proc/stat
/proc/meminfo
/proc/net/dev
/dev/input/by-id
/dev/disk/by-id

How to use and call the library?
from hwmon import Hwmon

Sensor information
To access the sensor subclass, the following statement will be executed:
sensors = Hwmon.HW()

Being the functions that interest us in this case: data() and print_data() . Let's see an example of each function:
Print sensors
This function will print all the sensor information of the system in a tabular and nice way.
sensors.print_data()

amdgpu
vddgfx 0.862 v
power1 35.04 w
fan1 1119 RPM
edge 33.0 C
nct6779
AUXTIN3 -28.0 C
in3 3.344 v
fan3 0 RPM
in7 3.472 v
AUXTIN0 -2.5 C
in12 1.68 v
in0 0.568 v
PCH_CPU_TEMP 0.0 C
SMBUSMASTER 0 32.5 C
in4 1.84 v
fan4 0 RPM
in8 3.264 v
AUXTIN1 85.0 C
in13 0.944 v
in1 0.0 v
fan1 0 RPM
PCH_CHIP_CPU_MAX_TEMP 0.0 C
in5 0.84 v
SYSTIN 31.0 C
in10 0.352 v
fan5 0 RPM
in9 0.0 v
AUXTIN2 23.0 C
in14 1.848 v
in2 3.344 v
fan2 1945 RPM
PCH_CHIP_TEMP 0.0 C
in6 1.536 v
CPUTIN 33.0 C
in11 1.056 v
k10temp
Tdie 32.625 C
Tctl 32.625 C

Get data
In case we are interested in getting the information from the sensors instead of printing it on the screen, we will execute the following sentence:
sensors.data()

{'amdgpu': {'vddgfx': '0.862 v',
'power1': '34.169 w',
'fan1': '1120 RPM',
'edge': '33.0 C'},
'nct6779': {'AUXTIN3': '-28.0 C',
'in3': '3.344 v',
'fan3': '0 RPM',
'in7': '3.472 v',
'AUXTIN0': '-2.5 C',
'in12': '1.68 v',
'in0': '0.568 v',
'PCH_CPU_TEMP': '0.0 C',
'SMBUSMASTER 0': '32.5 C',
'in4': '1.84 v',
'fan4': '0 RPM',
'in8': '3.264 v',
'AUXTIN1': '85.0 C',
'in13': '0.944 v',
'in1': '0.0 v',
'fan1': '0 RPM',
'PCH_CHIP_CPU_MAX_TEMP': '0.0 C',
'in5': '0.84 v',
'SYSTIN': '31.0 C',
'in10': '0.352 v',
'fan5': '0 RPM',
'in9': '0.0 v',
'AUXTIN2': '23.0 C',
'in14': '1.848 v',
'in2': '3.344 v',
'fan2': '1945 RPM',
'PCH_CHIP_TEMP': '0.0 C',
'in6': '1.536 v',
'CPUTIN': '33.0 C',
'in11': '1.056 v'},
'k10temp': {'Tdie': '32.625 C', 'Tctl': '32.625 C'}}

Processor information
To access the processor subclass, the following sentence will be executed
cpu = Hwmon.CPU()

Being the functions that interest us in this case: data() and print_data(). Let's see an example of each function:
Print information
This function will print all the information of the system processor in a tabular and nice way.
cpu.print_data()

Name AMD Ryzen 5 1400 Quad-Core Processor
CPU_usage 14.32
cores 4
threads 8
Average_MHz 1449.3

Get data
In case we are interested in obtaining the information from the processor instead of printing it on the screen, we will execute the following sentence:
cpu.data()

{'Name': 'AMD Ryzen 5 1400 Quad-Core Processor',
'CPU_usage': 14.32,
'cores': '4',
'threads': '8',
'Average_MHz': 1719.68}

Memory information
To access the system memory subclass, the following sentence will be executed:
memory = Hwmon.MEM()

Being the functions that interest us in this case: data() and print_data() . Let's see an example of each function:
Print information
This function will print in a tabular and nice way all the information in the system memory.
memory.print_data()

MemTotal 7.768MB
MemFree 2.569MB
MemAvailable 4.349MB
Buffers 156.973KB
Cached 1.850MB
SwapCached 0B
Active 3.608MB
Inactive 1.012MB
Active(anon) 2.576MB
Inactive(anon) 116.551KB
Active(file) 1.032MB
Inactive(file) 919.520KB
Unevictable 32.0B
Mlocked 32.0B
SwapTotal 2.000MB
SwapFree 2.000MB
Dirty 960.0B
Writeback 0B
AnonPages 2.617MB
Mapped 683.496KB
Shmem 118.547KB
KReclaimable 122.035KB
Slab 270.754KB
SReclaimable 122.035KB
SUnreclaim 148.719KB
KernelStack 24.109KB
PageTables 70.258KB
NFS_Unstable 0B
Bounce 0B
WritebackTmp 0B
CommitLimit 5.884MB
Committed_AS 11.335MB
VmallocTotal 32.000GB
VmallocUsed 40.414KB
VmallocChunk 0B
Percpu 14.250KB
HardwareCorrupted 0B
AnonHugePages 0B
ShmemHugePages 0B
ShmemPmdMapped 0B
CmaTotal 0B
CmaFree 0B
HugePages_Total 0B
HugePages_Free 0B
HugePages_Rsvd 0B
HugePages_Surp 0B
Hugepagesize 2.000KB
Hugetlb 0B
DirectMap4k 447.266KB
DirectMap2M 6.498MB
DirectMap1G 2.000MB

Get data
In case we are interested in obtaining the information from memory instead of printing it out on the screen, we will execute the following sentence:
memory.data()

{'MemTotal': '7.768MB',
'MemFree': '2.569MB',
'MemAvailable': '4.349MB',
'Buffers': '156.980KB',
'Cached': '1.850MB',
'SwapCached': '0B',
'Active': '3.608MB',
'Inactive': '1.012MB',
'Active(anon)': '2.576MB',
'Inactive(anon)': '116.551KB',
'Active(file)': '1.032MB',
'Inactive(file)': '919.520KB',
'Unevictable': '32.0B',
'Mlocked': '32.0B',
'SwapTotal': '2.000MB',
'SwapFree': '2.000MB',
'Dirty': '964.0B',
'Writeback': '0B',
'AnonPages': '2.616MB',
'Mapped': '683.496KB',
'Shmem': '118.547KB',
'KReclaimable': '122.035KB',
'Slab': '270.754KB',
'SReclaimable': '122.035KB',
'SUnreclaim': '148.719KB',
'KernelStack': '24.109KB',
'PageTables': '70.258KB',
'NFS_Unstable': '0B',
'Bounce': '0B',
'WritebackTmp': '0B',
'CommitLimit': '5.884MB',
'Committed_AS': '11.335MB',
'VmallocTotal': '32.000GB',
'VmallocUsed': '40.414KB',
'VmallocChunk': '0B',
'Percpu': '14.250KB',
'HardwareCorrupted': '0B',
'AnonHugePages': '0B',
'ShmemHugePages': '0B',
'ShmemPmdMapped': '0B',
'CmaTotal': '0B',
'CmaFree': '0B',
'HugePages_Total': '0B',
'HugePages_Free': '0B',
'HugePages_Rsvd': '0B',
'HugePages_Surp': '0B',
'Hugepagesize': '2.000KB',
'Hugetlb': '0B',
'DirectMap4k': '447.266KB',
'DirectMap2M': '6.498MB',
'DirectMap1G': '2.000MB'}

Network information
To access the network subclass, the following sentence will be executed:
net = Hwmon.NET()

Being the functions that interest us in this case: data() and print_data() . Let's see an example of each function:
Print information
This function will print in a tabular and nice way all the information of the system network.
net.print_data()

lo
receive
bytes 7593337
packets 14478
errs 0
drop 0
fifo 0
frame 0
compressed 0
multicast 0
transmit
bytes 14478
packets 0
errs 0
drop 0
fifo 0
colls 0
carrier 0
enp37s0
receive
bytes 1279460566
packets 864808
errs 0
drop 0
fifo 0
frame 0
compressed 0
multicast 507
transmit
bytes 362337
packets 0
errs 0
drop 0
fifo 0
colls 0
carrier 0
docker0
receive
bytes 0
packets 0
errs 0
drop 0
fifo 0
frame 0
compressed 0
multicast 0
transmit
bytes 0
packets 0
errs 0
drop 0
fifo 0
colls 0
carrier 0

Get data
In case we are interested in getting the information from the network instead of printing it on the screen, we will execute the following sentence:
net.data()

{' lo': {'receive': {'bytes': 7605359,
'packets': 14503,
'errs': 0,
'drop': 0,
'fifo': 0,
'frame': 0,
'compressed': 0,
'multicast': 0},
'transmit': {'bytes': 14503,
'packets': 0,
'errs': 0,
'drop': 0,
'fifo': 0,
'colls': 0,
'carrier': 0}},
'enp37s0': {'receive': {'bytes': 1279460566,
'packets': 864808,
'errs': 0,
'drop': 0,
'fifo': 0,
'frame': 0,
'compressed': 0,
'multicast': 507},
'transmit': {'bytes': 362337,
'packets': 0,
'errs': 0,
'drop': 0,
'fifo': 0,
'colls': 0,
'carrier': 0}},
'docker0': {'receive': {'bytes': 0,
'packets': 0,
'errs': 0,
'drop': 0,
'fifo': 0,
'frame': 0,
'compressed': 0,
'multicast': 0},
'transmit': {'bytes': 0,
'packets': 0,
'errs': 0,
'drop': 0,
'fifo': 0,
'colls': 0,
'carrier': 0}}}

USB devices information
To access the USB subclass, the following sentence will be executed:
usb = Hwmon.USB()

Being the functions that interest us in this case: data() and print_data() . Let's see an example of each function:
Print information
This function will print in a tabular and nice way all the information of the USBs in the system.
usb.print_data()

usb-Logitech_Gaming_Mouse_G300-mouse
usb-CHICONY_USB_Keyboard
usb-Logitech_Gaming_Mouse_G300
usb-Logitech_Gaming_Mouse_G300-if01

Get data
In case we are interested in getting the information from the sensors instead of printing it on the screen, we will execute the following sentence:
usb.data()

['usb-Logitech_Gaming_Mouse_G300-mouse',
'usb-CHICONY_USB_Keyboard',
'usb-Logitech_Gaming_Mouse_G300',
'usb-Logitech_Gaming_Mouse_G300-if01']

Disks information
To access the subclass of the disks, the following sentence will be executed:
disk = Hwmon.DISK()

Being the functions that interest us in this case: data() and print_data() . Let's see an example of each function:
Print information
This function will print in a tabular and nice way all the information of the disks in the system.
disk.print_data()

wwn-0x50014ee202380e97
ata-WDC_WD3200BEVT-22ZCT0_WD-WXEY08F45384
wwn-0x500080dc007530e0
ata-TOSHIBA-TL100_27NB51GCKSZU
wwn-0x50014ee20b769657
ata-WDC_WD20EZRX-22D8PB0_WD-WCC4M1ZJ83JD

Get data
In case we are interested in getting the information from the sensors instead of printing it on the screen, we will execute the following sentence:
disk.data()

['wwn-0x500080dc007530e0',
'ata-WDC_WD3200BEVT-22ZCT0_WD-WXEY08F45384',
'ata-TOSHIBA-TL100_27NB51GCKSZU',
'wwn-0x50014ee202380e97',
'wwn-0x50014ee20b769657',
'ata-WDC_WD20EZRX-22D8PB0_WD-WCC4M1ZJ83JD']

GPU information
To access the GPU subclass, the following statement will be executed:
gpu = Hwmon.GPU()

Being the functions that interest us in this case: data() and print_data() . Let's see an example of each function:
Print information
This function will print all the information of the GPU in a tabular and nice way.
gpu.print_data()

amdgpudrmfb
Resolution 1680x1050p
gpu_busy_percent 0 %
mem_info_vram_used 361.31MB
current_link_width 16
mem_info_vis_vram_used 46.77MB
mem_info_vis_vram_total 256.00MB
current_link_speed 8 GT/s
mem_busy_percent 19 %
mem_info_gtt_used 52.29MB
mem_info_vram_total 8.00GB
vbios_version 113-C9403100_101
mem_info_gtt_total 5.83GB

Get data
In case we are interested in getting the information from the gpu instead of printing it on the screen, we will execute the following sentence:
gpu.data()

{'amdgpudrmfb':
{'Resolution': '1680x1050p',
'gpu_busy_percent': '0 %',
'mem_info_vram_used': '367.23MB',
'current_link_width': '16',
'mem_info_vis_vram_used': '46.77MB',
'mem_info_vis_vram_total': '256.00MB',
'current_link_speed': '8 GT/s',
'mem_busy_percent': '19 %',
'mem_info_gtt_used': '56.88MB',
'mem_info_vram_total': '8.00GB',
'vbios_version': '113-C9403100_101',
'mem_info_gtt_total': '5.83GB'}}

BIOS information
To access the BIOS subclass, the following statement will be executed:
bios = Hwmon.BIOS()

Being the functions that interest us in this case: data() and print_data() . Let's see an example of each function:
Print information
This function will print all the information of the GPU in a tabular and nice way.
bios.print_data()

bios_date 12/20/2018
bios_version P5.50
board_vendor ASRock
chassis_type 3
bios_vendor American Megatrends Inc.
board_asset_tag
board_version
board_name AB350M-HDV

Get data
In case we are interested in getting the information from the gpu instead of printing it on the screen, we will execute the following sentence:
bios.data()

{'bios_date': '12/20/2018',
'bios_version': 'P5.50',
'board_vendor': 'ASRock',
'chassis_type': '3',
'bios_vendor': 'American Megatrends Inc.',
'board_asset_tag': '',
'board_version': '',
'board_name': 'AB350M-HDV'}