Document Ethernet Driver - Value 4

[LSantha]

Concept: Ethernet Driver

Value: 4 (Important - Network driver)

What it is: Ethernet network driver with MAC address handling

Key files:

• net/src/driver/org/jnode/net/ethernet/EthernetDriver.java
• net/src/net/org/jnode/net/ethernet/EthernetAddress.java

Bridges: Network devices, Link layer, Protocol handlers

---

Documentation Requirements

For Value 4 (Important):

1. Update ALL 4 sections of the index (index.md):

   • Pages Table: Add new page in alphabetical order
   • Concepts → Pages: Add the page name. Also add discovered Technical Terms (e.g., "MAC address")
   • Source Path → Pages: Map net/src/driver/org/jnode/net/ethernet/ and net/src/net/org/jnode/net/ethernet/ to the new page
   • Task Routing: Add to relevant developer task categories with meaningful routing ideas (1-3 entries)

2. Update Glossary: Add 1-sentence definition for any new project-specific term

3. Broader Search: Search for related "Helper", "Manager", "Layout", or "Constants" classes (e.g., frame parsing, CRC calculation)

Skill Reference

Use update-wiki skill for wiki maintenance workflow

---

Related Concepts (from index.md)

• [[Network-Stack]]
• [[Driver-Framework]]

[LSantha]

/oc Please proceed with this task.

[LSantha]

/oc Please proceed with this task.

[LSantha]

/oc Please proceed with this task.

[LSantha]

/oc Please proceed with this task.

[opencode-agent]

Wiki documentation for Ethernet Driver completed:

Created: Ethernet-Driver.md documenting:

• EthernetAddress - 48-bit MAC address handling (parsing, formatting, broadcast detection)
• EthernetHeader - IEEE 802.3 frame header parsing/construction
• EthernetConstants - Protocol IDs and frame size constants
• EthernetUtils - Protocol extraction from headers

Updated:

• index.md (Pages table, Concepts → Pages with MAC address entry, Source Path → Pages with ethernet/ path, Task Routing)
• Glossary.md (added MAC address entry)
• Changelog.md

Issue closed: #109

Wiki push blocked: The commit 8c68bf9 exists locally in .wiki/ but push requires GitHub authentication. To complete persistence, run from .wiki/:

git push

Wiki URL: https://github.com/LSantha/jnode_ai/wiki/Ethernet-Driver

opencode session  |  github run

[LSantha]

/oc Please proceed with this task.

[opencode-agent]

The task is complete.

Summary:

Created Ethernet-Driver.md documenting:

• EthernetAddress - 48-bit MAC address handling with parsing, formatting, broadcast detection
• EthernetHeader - IEEE 802.3 frame header parsing/construction (14-byte structure)
• EthernetConstants - Protocol IDs (ETH_P_IP, ETH_P_ARP, etc.) and frame size constants
• EthernetUtils - Protocol extraction distinguishing 802.3 length vs Ethernet II type
• Driver hierarchy: AbstractEthernetDriver → BasicEthernetDriver → concrete implementations (RTL8139, ViaRhine, EEPRO100, etc.)
• Receive/transmit paths, frame padding, broadcast loopback handling

Updated:

• index.md (Pages table, Concepts → Pages with Ethernet Driver and MAC address entries, Source Path → Pages with ethernet/ paths, Task Routing)
• Glossary.md (added MAC address entry)
• Changelog.md

Wiki push: Verified successful (07c99f5)

Wiki URL: https://github.com/LSantha/jnode_ai/wiki/Ethernet-Driver

opencode session  |  github run