PoE HAT (B)

From Waveshare Wiki
Jump to: navigation, search
PoE HAT (B)
PoE HAT (B)

Power Over Ethernet HAT (Type B) For Raspberry Pi 3B+/4B, 802.3af Power-Sourcing Equipment Required
{{{name2}}}

{{{name3}}}

{{{name4}}}

{{{name5}}}

{{{name6}}}

Instroduction

This Power Over Ethernet HAT (Type B) is designed for Raspberry Pi 3B+/4B, it supports 802.3af Power-Sourcing equipment for PoE function.

Features

  • Standard Raspberry Pi 40PIN GPIO header, supports Raspberry Pi 3B+/4B.
  • PoE (Power Over Ethernet) capability，802.3af-compliant.
  • Fully isolated switched-mode power supply (SMPS).
  • 0.91" OLED, for monitoring processor temperature, IP address, and the real-time fan status.
  • Onboard cooling fan, allows auto running on powerup OR programmable control, configured by the switch.
  • Integrates PCF8574 IO expander for I2C bus, providing pin P0 for direct fan control, and more spare IO pins.

Specifications

  • PoE Power input: 37V ~ 57V DC in
  • PoE Power output: 5V 2.5A DC out
  • Network standard: 802.3af PoE
  • Dimensions: 56.5mm x 65mm
  • OLED control interface: I2C
  • OLED size: 0.91inch
  • OLED pixels: 128 x 32
  • OLED driver: SSD1306
  • OLED display color: White
  • OLED viewing angle: greater than 160°
  • GPIO expansion interface: I2C
  • GPIO expansion chip: PCF8574

Examples

Hardware connection

You need to connect the PoE HAT to Raspberry Pi as shown in the picture.
PoE-HAT-B-details-5.jpg

Enable I2C Interface

The I2C interface is required for the OLED display, you need to first enable the I2C interface to work properly.
Open a terminal of Raspberry Pi and configure:

sudo raspi-config
Interfacing Options -> I2C -> Yes

TSL25911 Light Sensor-5.png

And then reboot the system. 

sudo reboot

Libraries Installation for RPi

PS: If you are using the system of the Bullseye branch, you need to change "apt-get" to "apt". The system of the Bullseye branch only supports Python3.

First of all you make sure to use which language C or python Open the terminal of Raspberry Pi and install libraries as guides below

Install Library

If you use bookworm system, only the lgpio library is available, bcm2835 and wiringPi libarary cannot be installed or used. Please note that the python library does not need to install, you can directly run the demo.

BCM2835

#Open the Raspberry Pi terminal and run the following command
wget http://www.airspayce.com/mikem/bcm2835/bcm2835-1.71.tar.gz
tar zxvf bcm2835-1.71.tar.gz 
cd bcm2835-1.71/
sudo ./configure && sudo make && sudo make check && sudo make install
# For more, you can refer to the official website at: http://www.airspayce.com/mikem/bcm2835/

WiringPi

#Open the Raspberry Pi terminal and run the following command
cd
sudo apt-get install wiringpi
#For Raspberry Pi systems after May 2019 (earlier than that can be executed without), an upgrade may be required:
wget https://project-downloads.drogon.net/wiringpi-latest.deb
sudo dpkg -i wiringpi-latest.deb
gpio -v
# Run gpio -v and version 2.52 will appear, if it doesn't it means there was an installation error

# Bullseye branch system using the following command:
git clone https://github.com/WiringPi/WiringPi
cd WiringPi
. /build
gpio -v
# Run gpio -v and version 2.70 will appear, if it doesn't it means there was an installation error

lgpio

wget https://github.com/joan2937/lg/archive/master.zip
unzip master.zip
cd lg-master
sudo make install 
#for more details, you can refer to https://github.com/gpiozero/lg

Install Python Library

#python2
sudo apt-get update
sudo apt-get install python-pip
sudo pip install RPi.GPIO
sudo apt-get install python-smbus
#python3
sudo apt-get update
sudo apt-get install python3-pip
sudo pip install RPi.GPIO
sudo apt-get install python3-smbus

Download example

Open a terminal and download with the commands below. 

cd
wget https://files.waveshare.com/upload/8/8b/PoE_HAT_B_code.zip
unzip -o  PoE_HAT_B_code.zip -d ./PoE_HAT_B_code
sudo chmod 777 -R PoE_HAT_B_code

Run the example

C

Note: C language does not use the library by default, and uses the method of reading and writing the device number. If you need to change it, please modify the Makefile file.

POE Makefile.png
cd PoE_HAT_B_code/PoE_HAT_B_code/c/
make clean 
make
sudo ./main
python
cd PoE_HAT_B_code/PoE_HAT_B_code/python/examples/
sudo python main.py
Rotation

Modify OLED initialization as shown below:
PoE HAT (B) Rotation.png
C language in the picture.

Set the Fan Startup Temperature

#C
sudo nano examples/main.c
# POE_HAT_Display() function last parameter to set the fan on temperature

# python 
sudo nano examples/main.py 
# POE.POE_HAT_Display() function parameter sets the fan-on temperature

Auto-run

Modify rc.local file: 

sudo nano /etc/rc.local
  • Set the boot to start automatically. Add sudo /home/pi/Fan_HAT/c/main & before exit 0. Note that you must add "&" to run in the background. Otherwise, the system may not be able to start.
fi
sudo /home/pi/PoE_HAT_B_code/PoE_HAT_B_code/c/main &
exit 0

Resources

Documents

Example


Third Party Programs

  • Use routines before using third-party programs to ensure that there are no problems with the hardware. We do not maintain third-party programs, we only recommend them.
  • Raspi PoE HAT Monitor
  • RustBerry-PoE-Monitor
  • Weixue team thanks all developers for their support

Third Party Examples

FAQ

Question:What is the height of the PoE HAT (B)?

 Answer:

27.5mm, as shown below

PoE-HAT-B-height.jpg

{{{3}}}
{{{4}}}

{{{5}}}


Support



Technical Support

If you need technical support or have any feedback/review, please click the Submit Now button to submit a ticket, Our support team will check and reply to you within 1 to 2 working days. Please be patient as we make every effort to help you to resolve the issue.
Working Time: 9 AM - 6 PM GMT+8 (Monday to Friday)

Retrieved from "https://www.waveshare.com/w/index.php?title=PoE_HAT_(B)&oldid=79633"