blob: 4a9f86a61162ab730b4e363ef8091235ed6767df (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
|
# BCM5719 Firmware Reimplementation
## Introduction
This library contains a clean-room reimplementation of the BCM5719 firmware based on the [Ortega](https://github.com/hlandau/ortega/blob/master/rtg-spec.md) specification.
The firmware has been tested on the [Talos II](https://wiki.raptorcs.com/wiki/Talos_II) by [Raptor Computer Systems](https://www.raptorcs.com/).
**Note: This firmware is currently in development. Flashing the firmware to a network card can result in a bricked device when either an external programmer is required, or the external flash must be temporarily disabled during boot-up.**
## Requirements
This repository depends on a number of external tools
- Customized LLVM/Clang compiler for MIPS firmware
- CMake 3.5.1+
- Linux (utilities)
- Clang Format (optional)
- Flexelint/PCLint+ (optional)
- IPXact generator (optional)
### Required Compiler
Due to limitations in the MIPS CPU, this firmware requires a custom compiler to function properly.
The custom compuler can be built using the following steps:
```bash
git clone https://github.com/meklort/llvm-project.git -b meklort-7.0.1
cd llvm-project
mkdir build
cd build
cmake ../llvm -G Ninja -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=~/llvm-bcm5719 -DLLVM_ENABLE_PROJECTS="lld;clang"
ninja
ninja install
```
## Status
- Libraries:
- MII Library: Done
- NVRAM Library: Done
- Stage1/Stage2
- Implementation: Functional
- Testing: Minimal, WIP
- VPD: Started, not functional
- WOL: Not started
- APE
- NCSI Handler: In Progress (functional for TX/RX passthrough)
- Clear Initial State: Done
- Select Package: Partial
- Deselect Package: Partial
- Enable Channel: Partial
- Disable Channel: Partial
- Reset Channel: Partial
- Enable Channel TX: Partial
- Disable Channel TX: Partial
- AEN Enable: Partial
- Set Link: Partial
- Get Link Status: Stubbed
- Set VLAN Filter: Not Implemented
- Enable VLAN: Not Implemented
- Disable VLAN: Stubbed
- Set MAC Address: Initial implementation
- Enable Broadcast Filter: Stubbed
- Disable Bradcast Filter: Not Implemented
- Enable Global Multicast Filtering: Not Implemented
- Disable Global Multicast Filtering: Not Implemented
- Set NCSI Flow Control: Not Implemented
- Get Version ID: Not Implemented
- Get Capabilities: Not Implemented
- Get Parameters: Not Implemented
- Get Controller Packet Stats: Not Implemented
- Get NCSI Stats: Not Implemented
- Get NCSI Passthrough Stats: Not Implemented
- OEM Command: Not Implemented
- BMC <-> Network Communication: Functional
- TX Passthrough: Working
- RX Passthrough: Working
- Utilities
- Firmware tool: Functional
- Register tool: Functional
- APE Tool: In progress
## Compiling
To compile the firmware, the following command sequence can be used:
```bash
mkdir build
cd build
cmake .. -G Ninja
cmake --build .
```
## Usage
Before proceeding, the Linux driver must be unloaded. On the Talos II, this can be done as root with the following:
```bash
echo 0004:01:00.0 > /sys/bus/pci/devices/0004:01:00.0/driver/unbind
echo 0004:01:00.1 > /sys/bus/pci/devices/0004:01:00.1/driver/unbind
```
### Backup Firmware
Before proceeding, the original firmware should be backed up.
```bash
cd build
sudo ./utils/bcmflash/bcmflash -t hardware -b binary
```
This will result in a firmware image, firmware.fw, bing stored in the current directory.
### Stage 1 - MIPS Firmware
After compilation, the MIPS firmware is ready to be uploaded to the NIC.
```bash
cd build
sudo ./utils/bcmflash/bcmflash -t hardware -1 stage1/stage1.bin
```
### APE Firmware (BMC/NCSI communication)
The APE firmware can be tested by loading it into ram using the following sequence:
```base
cd build
sudo ./utils/bcmregtool/bcmregtool --apeboot=ape/ape.bin
```
|
