查看“0002 MPS2280-PoE(SSD expansion board with PoE Ethernet Power Supply)”的源代码

[[0002 MPS2280-PoE（带PoE 以太网供电的SSD扩展板）|切换语言为中文]]

== '''Keywords:''' ==
2280, PoE, LCD screen

== '''I. Introduction''' ==
The MPS2280-PoE is a PoE-powered SSD expansion board designed for the Raspberry Pi 5, featuring voltage and current monitoring functions. It supports SSDs in sizes 2230, 2242, and 2280. The system can boot from the SSD, or from a TF card with the SSD used only for storage.

== '''II. Hardware Resources''' ==
http://www.mcuzone.com/wiki/0002_MPS2280iPoE/MPS2280iPoE_34.jpg

== '''III. System flashing and configuration''' ==

=== 1. Boot from a TF card ===
At this time, the SSD is used for storage purposes only. Use the Raspberry Pi Imager to write the image, select the Raspberry Pi 5 device, and use the image 2024-07-04-raspios-bookworm-arm64.img.xz (Raspberry Pi OS) or ubuntu-24.04-preinstalled-desktop-arm64+raspi.img.xz (Ubuntu system) for this document.

http://www.mcuzone.com/wiki/0002_MPS2280iPoE/EN/MPS2280iPoE_en_01.png

balenaEtcher can also be used to flash the image.

http://www.mcuzone.com/wiki/0002_MPS2280iPoE/EN/MPS2280iPoE_en_02.png

=== 2. Boot from the SSD ===
You need to remove the SSD from the expansion board, insert it into an M.2 (PCIe protocol) to USB card reader, connect it to the PC, and use the same method as flashing an image to a TF card to flash the system image to the SSD. Then remove the SSD, and reinsert it into the expansion board.

== '''IV. Demonstration of Voltage and Current Monitoring Function(INA219)(Only support MPS2280i-PoE)''' ==

=== 1. Enable I<sup>2</sup>C ===

==== Method 1: Using the command line. ====
Input <code>sudo raspi-config</code> in the Raspberry Pi OS's terminal，Select the corresponding options according to the picture below:

http://www.mcuzone.com/wiki/0002_MPS2280iPoE/MPS2280iPoE_03.png

http://www.mcuzone.com/wiki/0002_MPS2280iPoE/MPS2280iPoE_04.png

http://www.mcuzone.com/wiki/0002_MPS2280iPoE/MPS2280iPoE_05.png

http://www.mcuzone.com/wiki/0002_MPS2280iPoE/MPS2280iPoE_06.png

http://www.mcuzone.com/wiki/0002_MPS2280iPoE/MPS2280iPoE_07.png

Enable the I<sup>2</sup>C in sequence, then restart the Raspberry Pi.

==== Method 2: Using the GUI. ====
http://www.mcuzone.com/wiki/0002_MPS2280iPoE/MPS2280iPoE_08.png

http://www.mcuzone.com/wiki/0002_MPS2280iPoE/MPS2280iPoE_09.png

Enable the I<sup>2</sup>C in sequence, then restart the Raspberry Pi.

=== 2. Run a Python script to measure voltage and current. ===
After the system restarts, copy the python script (INA219.py) which provided by our company into the Raspberry Pi operating system. Execute the file using the command <code>python INA219.py</code> to monitor voltage and current in real-time.

Download address for python script (need decompression)：

http://www.mcuzone.com/wiki/0002_MPS2280iPoE/INA219.zip

http://www.mcuzone.com/wiki/0002_MPS2280iPoE/MPS2280iPoE_10.png

== '''V. Demonstration of OLED screen usage(Only support MPS2280i-PoE)''' ==

=== 1. Demonstration of OLED Screen usage on the Raspberry Pi OS ===
1) Confirm that the Raspberry Pi's I<sup>2</sup>C is enabled and the LCD screen is recognized at 0x3c.

http://www.mcuzone.com/wiki/0002_MPS2280iPoE/MPS2280iPoE_11.png

2) Copy the source package into the Raspberry Pi system and unzip it:

<code>sudo tar -jxvf oled-in219-src.tar.bz2</code>

Download address for the source package:

http://www.mcuzone.com/wiki/0002_MPS2280iPoE/oled-in219-src.tar.bz2

http://www.mcuzone.com/wiki/0002_MPS2280iPoE/MPS2280iPoE_12.png

3) Install dependency files：<code>sudo apt-get install libconfig-dev libconfig++-dev -y</code>

http://www.mcuzone.com/wiki/0002_MPS2280iPoE/MPS2280iPoE_13.png

4) Enter the oled-in219-src directory and execute the commands <code>sudo make clean</code> and <code>sudo make in sequence</code>. After a successful compilation, an executable file named "oled" will be generated.

http://www.mcuzone.com/wiki/0002_MPS2280iPoE/MPS2280iPoE_14.png

5) Run <code>./oled -D</code> after Compilation:

http://www.mcuzone.com/wiki/0002_MPS2280iPoE/MPS2280iPoE_15.png

At the same time, the corresponding display will also be output on the OLED screen of the expansion board.

http://www.mcuzone.com/wiki/0002_MPS2280iPoE/MPS2280iPoE_16.png

=== 2. Demonstration of OLED Screen usage on the Ubuntu system ===
1) Confirm that the Raspberry Pi's I<sup>2</sup>C is enabled and the LCD screen is recognized at 0x3c.

Ubuntu system requires the installation of I<sup>2</sup>C tools manually.(<code>sudo apt install i2c-tools</code>)。

http://www.mcuzone.com/wiki/0002_MPS2280iPoE/MPS2280iPoE_17.png

2) Copy the source package into the Raspberry Pi system and unzip it:

<code>sudo tar -jxvf oled-in219-src.tar.bz2</code>

Download address for the source package:

http://www.mcuzone.com/wiki/0002_MPS2280iPoE/oled-in219-src.tar.bz2

http://www.mcuzone.com/wiki/0002_MPS2280iPoE/MPS2280iPoE_18.png

3) Install dependency files：<code>sudo apt-get install libconfig-dev libconfig++-dev -y</code>

http://www.mcuzone.com/wiki/0002_MPS2280iPoE/MPS2280iPoE_19.png

4) Enter the oled-in219-src directory, then execute the following steps:

<code>sudo apt install make</code>

<code>sudo apt install gcc</code>

<code>sudo make clean</code>

<code>sudo make</code>

After a successful compilation, an executable file named "oled" will be generated.

http://www.mcuzone.com/wiki/0002_MPS2280iPoE/MPS2280iPoE_20.png

Run <code>./oled -D</code> after Compilation:

http://www.mcuzone.com/wiki/0002_MPS2280iPoE/MPS2280iPoE_21.png

At the same time, the corresponding display will also be output on the OLED screen of the expansion board. 

http://www.mcuzone.com/wiki/0002_MPS2280iPoE/MPS2280iPoE_16.png

== '''VI. POE function introduction''' ==

== '''VII. POE output test (Only for MPS2280i-PoE)''' ==

=== 7.1 Hardware connection ===
The MPS2280i-PoE expansion board supports POE input and ensures support for 5V4.5A output. We insert the POE output Ethernet port into the Raspberry Pi's built-in RJ45 Ethernet port, and the load is plugged into the USB-Type C port on the expansion board, thus completing the hardware connections.

=== 7.2 View output status ===
Turn on the PoE power supply, and enter the Raspberry Pi OS. The output monitoring software used here is the Python script from Chapter 4 (INA219.py). Following the method described in Chapter 3, navigate to the directory where INA219.py is located and enter <code>python INA219.py</code>. Then, you will be able to see the current output status.

http://www.mcuzone.com/wiki/0002_MPS2280iPoE/MPS2280iPoE_31.jpg

We turn on each load one by one, and we can see that the output voltage stabilizes at around 5.2V. The output current continuously increases, eventually reaching around 4.7A, which meets the rated 5V 4.5A output standard.

http://www.mcuzone.com/wiki/0002_MPS2280iPoE/MPS2280iPoE_32.jpg

{{Contact_Us_icon}}