1 files changed, 133 insertions, 1 deletions

diff --git a/_ont/ont-fs-com-gpon-onu-stick-with-mac.md b/_ont/ont-fs-com-gpon-onu-stick-with-mac.md
index b5e0527..669ba96 100644
--- a/_ont/ont-fs-com-gpon-onu-stick-with-mac.md
+++ b/_ont/ont-fs-com-gpon-onu-stick-with-mac.md
@@ -262,6 +262,138 @@ When image1 is committed:
 | mtd4 | 006d8077 | 00010000  | "rootfs"      |
 | mtd5 | 00410000 | 00010000  | "rootfs_data" |
 
+## EEPROM (I2C slave simulated EEPROM)
+The FS GPON-ONU-34-20BI does not have a physical EEPROM, the Falcon SOC emulates an EEPROM by exposing it on the I2C interface as required by the SFF-8472 specification.
+
+On the I2C interface there will be two memories of 256 bytes each at the addresses `1010000X (A0h)` and `1010001X (A2h)`, however in reality the memory available from the emulated EEPROM will be 640 bytes each but only the first 256 bytes will be exposed in the I2C interface.
+
+The FS GPON-ONU-34-20BI stores the content of the emulated EEPROM in U-Boot env variables to restore it after a reboot:
+
+- `EEPROM0 (A0h)` stored in U-Boot env variable `sfp_a0_low_128`
+- `EEPROM1 (A2h)` stored in U-Boot env variable `sfp_a2_info`
+
+### EEPROM0 layout
+
+| address   | size     | name                              | default value                                                                                           | description                                                         |
+| --------- | -------- | --------------------------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
+|           |          | **BASE ID FIELDS (SFF-8472)**     |                                                                                                         |                                                                     |
+| 0         | 1        | Identifier                        | `0x03` (SFP)                                                                                            | Type of transceiver                                                 |
+| 1         | 1        | Ext identifier                    | `0x04` (MOD_DEF 4)                                                                                      | Additional information about the transceiver                        |
+| 2         | 1        | Connector                         | `0x01` (SC)                                                                                             | Type of media connector                                             |
+| 3-10      | 8        | Transceiver                       | `0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00`                                                               | Code for optical compatibility                                      |
+| 11        | 1        | Encoding                          | `0x03` (NRZ)                                                                                            | High speed serial encoding algorithm                                |
+| 12        | 1        | Signaling Rate, Nominal           | `0x0C` (1.244Gbps)                                                                                      | Nominal signaling rate                                              |
+| 13        | 1        | Rate Identifier                   | `0x00` (Not used)                                                                                       | Type of rate select functionality                                   |
+| 14        | 1        | Length (SMF,km)                   | `0x14` (20 km)                                                                                          | Link length supported for single-mode fiber, units of km            |
+| 15        | 1        | Length (SMF)                      | `0xC8` (200 x 100m)                                                                                     | Link length supported for single-mode fiber, units of 100 m         |
+| 16        | 1        | Length (50 um, OM2)               | `0x00` (No support)                                                                                     | Link length supported for 50 um OM2 fiber, units of 10 m            |
+| 17        | 1        | Length (62.5 um, OM1)             | `0x00` (No support)                                                                                     | Link length supported for 62.5 um OM1 fiber, units of 10 m          |
+| 18        | 1        | Length copper cable               | `0x00` (No support)                                                                                     | Link length supported for copper or direct attach cable, units of m |
+| 19        | 1        | Length (50 um, OM3)               | `0x00` (No support)                                                                                     | Link length supported for 50 um OM3 fiber, units of 10 m            |
+| 20-35     | 16       | Vendor name                       | `0x46 0x53 0x20 0x20 0x20 0x20 0x20 0x20 0x20 0x20 0x20 0x20 0x20 0x20 0x20 0x20` (FS)                  | SFP vendor name (ASCII)                                             |
+| 36        | 1        | Transceiver                       | `0x00` (No support)                                                                                     | Code for optical compatibility                                      |
+| 37-39     | 3        | Vendor OUI                        | `0x00 0x00 0x00` (No specified)                                                                         | SFP vendor IEEE company ID                                          |
+| 40-55     | 16       | Vendor PN                         | `0x47 0x50 0x4F 0x4E 0x2D 0x4F 0x4E 0x55 0x2D 0x33 0x34 0x2D 0x32 0x30 0x42 0x49` (GPON-ONU-34-20BI)    | Part number provided by SFP vendor (ASCII)                          |
+| 56-59     | 4        | Vendor rev                        | `0x30 0x31 0x20 0x20` (01)                                                                              | Revision level for part number provided by vendor (ASCII)           |
+| 60-61     | 2        | Wavelength                        | `0x05 0x1E` (1310nm TX)                                                                                 | Laser wavelength                                                    |
+| 62        | 1        | Fibre Channel Speed 2             | `0x00` (No support)                                                                                     | Transceiver's Fibre Channel speed capabilities                      |
+| 63        | 1        | CC_BASE                           |                                                                                                         | Check code for Base ID Fields (addresses 0 to 62)                   |
+|           |          | **EXTENDED ID FIELDS (SFF-8472)** |                                                                                                         |                                                                     |
+| 64-65     | 2        | Options                           | `0x00 0x1A` (TX DISABLE, TX FAULT, RX LOS)                                                              | Indicates which optional transceiver signals are implemented        |
+| 66        | 1        | Signaling Rate, max               | `0x00` (No specified)                                                                                   | Upper signaling rate margin, units of %                             |
+| 67        | 1        | Signaling Rate, min               | `0x00` (No specified)                                                                                   | Lower signaling rate margin, units of %                             |
+| 68-83     | 16       | Vendor SN                         | Unique in each SFP                                                                                      | Serial number provided by vendor (ASCII)                            |
+| 84-91     | 8        | Date code                         | Unique in each SFP                                                                                      | Vendor's manufacturing date code                                    |
+| 92        | 1        | Diagnostic Monitoring Type        | `0x68` (Digital diagnostic, Internally calibrated, Received average power type)                         | Indicates which type of diagnostic monitoring is implemented        |
+| 93        | 1        | Enhanced Options                  | `0xF0` (Alarm/warning flags, soft TX_DISABLE control, soft TX_FAULT monitoring, soft RX_LOS monitoring) | Indicates which optional enhanced features are implemented          |
+| 94        | 1        | SFF-8472 Compliance               | `0x05` (Rev 11.0 of SFF-8472)                                                                           | Indicates which revision of SFF-8472 the transceiver complies with  |
+| 95        | 1        | CC_EXT                            |                                                                                                         | Check code for the Extended ID Fields (addresses 64 to 94)          |
+|           |          | **VENDOR SPECIFIC FIELDS**        |                                                                                                         |                                                                     |
+| 96-127    | 32       | Vendor data                       | `0x20 0x20 0x20...` (Not used)                                                                          | Vendor specifc data (ASCII)                                         |
+| 128-255   | 128      | Reserved                          | `0x00 0x00 0x00...`                                                                                     | Reserved                                                            |
+|           |          | **EXTRA EEPROM FIELDS**           |                                                                                                         | **Not exposed to I2C interface**                                    |
+| 256-639   | 384      | Reserved                          | `0x00 0x00 0x00...`                                                                                     | Reserved                                                            |
+
+
+### EEPROM1 layout
+
+| address   | size     | name                              | default value                                                                               | description                                                         |
+| --------- | -------- | --------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
+|           |          | **DIAGNOSTIC AND CONTROL FIELDS** |                                                                                             |                                                                     |
+| 0-1       | 2        | Temp High Alarm                   | `0x5F 0x00` (95℃)                                                                          |                                                                     |
+| 2-3       | 2        | Temp Low Alarm                    | `0xCE 0x00` (-50℃)                                                                         |                                                                     |
+| 4-5       | 2        | Temp High Warning                 | `0x5A 0x00` (90℃)                                                                          |                                                                     |
+| 6-7       | 2        | Temp Low Warning                  | `0xD3 0x00` (-45℃)                                                                         |                                                                     |
+| 8-9       | 2        | Voltage High Alarm                | `0x8C 0xA0` (3.6V)                                                                          |                                                                     |
+| 10-11     | 2        | Voltage Low Alarm                 | `0x75 0x30` (3.0V)                                                                          |                                                                     |
+| 12-13     | 2        | Voltage High Warning              | `0x88 0xB8` (3.5V)                                                                          |                                                                     |
+| 14-15     | 2        | Voltage Low Warning               | `0x79 0x18` (3.1V)                                                                          |                                                                     |
+| 16-17     | 2        | Bias High Alarm                   | `0xAF 0xC8` (90mA)                                                                          |                                                                     |
+| 18-19     | 2        | Bias Low Alarm                    | `0x00 0x00` (0mA)                                                                           |                                                                     |
+| 20-21     | 2        | Bias High Warning                 | `0x88 0xB8` (70mA)                                                                          |                                                                     |
+| 22-23     | 2        | Bias Low Warning                  | `0x00 0x00` (0mA)                                                                           |                                                                     |
+| 24-25     | 2        | TX Power High Alarm               | `0xF6 0x77` (8dBm)                                                                          | Value expressed in watts subunits                                   |
+| 26-27     | 2        | TX Power Low Alarm                | `0x15 0xF7` (-2.5dBm)                                                                       | Value expressed in watts subunits                                   |
+| 28-29     | 2        | TX Power High Warning             | `0xC3 0xC6` (7dBm)                                                                          | Value expressed in watts subunits                                   |
+| 30-31     | 2        | TX Power Low Warning              | `0x1B 0xA7` (-1.5dBm)                                                                       | Value expressed in watts subunits                                   |
+| 32-33     | 2        | RX Power High Alarm               | `0x0C 0x5A` (-5dBm)                                                                         | Value expressed in watts subunits                                   |
+| 34-35     | 2        | RX Power Low Alarm                | `0x00 0x08` (-31dBm)                                                                        | Value expressed in watts subunits                                   |
+| 36-37     | 2        | RX Power High Warning             | `0x09 0xCF` (-6dBm)                                                                         | Value expressed in watts subunits                                   |
+| 38-39     | 2        | RX Power Low Warning              | `0x00 0x0A` (-30dBm)                                                                        | Value expressed in watts subunits                                   |
+| 40-45     | 6        | MAC address                       | Unique in each SFP                                                                          | Contains the mac address of the SFP, it could also be empty         |
+| 46-55     | 10       | Reserved                          | `0x00 0x00 0x00...`                                                                         | Reserved                                                            |
+| 56-59     | 4        | RX_PWR(4) Calibration             | `0x00 0x00 0x00 0x00`                                                                       | 4th order RSSI calibration coefficient                              |
+| 60-63     | 4        | RX_PWR(3) Calibration             | `0x00 0x00 0x00 0x00`                                                                       | 3rd order RSSI calibration coefficient                              |
+| 64-67     | 4        | RX_PWR(2) Calibration             | `0x00 0x00 0x00 0x00`                                                                       | 2nd order RSSI calibration coefficient                              |
+| 68-71     | 4        | RX_PWR(1) Calibration             | `0x3F 0x80 0x00 0x00`                                                                       | 1st order RSSI calibration coefficient                              |
+| 72-75     | 4        | RX_PWR(0) Calibration             | `0x00 0x00 0x00 0x00`                                                                       | 0th order RSSI calibration coefficient                              |
+| 76-77     | 2        | TX_I(Slope) Calibration           | `0x01 0x00`                                                                                 | Slope for Bias calibration                                          |
+| 78-79     | 2        | TX_I(Offset) Calibration          | `0x00 0x00`                                                                                 | Offset for Bias calibration                                         |
+| 80-81     | 2        | TX_PWR(Slope) Calibration         | `0x01 0x00`                                                                                 | Slope for TX Power calibration                                      |
+| 82-83     | 2        | TX_PWR(Offset) Calibration        | `0x00 0x00`                                                                                 | Offset for TX Power calibration                                     |
+| 84-85     | 2        | T(Slope) Calibration              | `0x01 0x00`                                                                                 | Slope for Temperature calibration                                   |
+| 86-87     | 2        | T(Offset) Calibration             | `0x00 0x00`                                                                                 | Offset for Temperature calibration, in units of 256ths °C           |
+| 88-89     | 2        | V(Slope) Calibration              | `0x01 0x00`                                                                                 | Slope for VCC calibration                                           |
+| 90-91     | 2        | V(Offset) Calibration             | `0x00 0x00`                                                                                 | Offset for VCC calibration                                          |
+| 92-94     | 3        | Reserved                          | `0x00 0x00 0x00`                                                                            | Reserved                                                            |
+| 95        | 1        | CC_DMI                            |                                                                                             | Check code for Base Diagnostic Fields (addresses 0 to 94)           |
+| 96        | 1        | Temperature MSB                   |                                                                                             | Internally measured module temperature                              |
+| 97        | 1        | Temperature LSB                   |                                                                                             |                                                                     |
+| 98        | 1        | Vcc MSB                           |                                                                                             | Internally measured supply voltage in transceiver                   |
+| 99        | 1        | Vcc LSB                           |                                                                                             |                                                                     |
+| 100       | 1        | TX Bias MSB                       |                                                                                             | Internally measured TX Bias Current                                 |
+| 101       | 1        | TX Bias LSB                       |                                                                                             |                                                                     |
+| 102       | 1        | TX Power MSB                      |                                                                                             | Measured TX output power                                            |
+| 103       | 1        | TX Power LSB                      |                                                                                             |                                                                     |
+| 104       | 1        | RX Power MSB                      |                                                                                             | Measured RX input power                                             |
+| 105       | 1        | RX Power LSB                      |                                                                                             |                                                                     |
+| 106-109   | 4        | Optional Diagnostics              | `0xFF 0xFF 0xFF 0xFF` (No support)                                                          | Monitor Data for Optional Laser temperature and TEC current         |
+| 110       | 1        | Status/Control                    | `0x82` (Soft TX disable, disable laser, digital TX fault, digital RX LOS, power&data ready) | Optional Status and Control Bits                                    |
+| 111       | 1        | Reserved                          | `0x00`                                                                                      | Reserved                                                            |
+| 112-113   | 2        | Alarm Flags                       | `0x01 0x40`                                                                                 | Diagnostic Alarm Flag Status Bits                                   |
+| 114       | 1        | Tx Input EQ control               | `0xFF` (No support)                                                                         | Tx Input equalization level control                                 |
+| 115       | 1        | Rx Out Emphasis control           | `0xFF` (No support)                                                                         | Rx Output emphasis level control                                    |
+| 116-117   | 2        | Warning Flags                     | `0x01 0x40`                                                                                 | Diagnostic Warning Flag Status Bits                                 |
+| 118-119   | 2        | Ext Status/Control                | `0x00 0x00` (No support)                                                                    | Extended module control and status bytes                            |
+|           |          | **GENERAL USE FIELDS**            |                                                                                             |                                                                     |
+| 120-126   | 7        | Vendor Specific                   | `0x70 0x00 0x00 0x00 0x00 0x00 0x00`                                                        | Vendor specific memory addresses                                    |
+| 127       | 1        | Table Select                      | `0x00`                                                                                      | Optional Page Select                                                |
+|           |          | **USER WRITABLE EEPROM**          |                                                                                             |                                                                     |
+| 128-190   | 63       | Reserved                          | `0xFF 0xFF 0xFF...`                                                                         | Reserved                                                            |
+| 191-214   | 24       | GPON LOID or PLOAM                | Depends on the configuration of the SFP                                                     | GPON Logical ONU ID or PLOAM, depends on `GPON LOID/PLOAM switch`   |
+| 215-231   | 17       | GPON LPWD                         | Depends on the configuration of the SFP                                                     | GPON Logical Password                                               |
+| 232       | 1        | GPON LOID/PLOAM switch            | Depends on the configuration of the SFP                                                     | `0x01` to enable LOID, `0x02` to enable PLOAM                       |
+| 233-240   | 8        | GPON SN                           | Unique in each SFP                                                                          | GPON Serial Number (ME 256)                                         |
+| 241-247   | 7        | Reserved                          | `0xFF 0xFF 0xFF...`                                                                         | Reserved                                                            |
+| 248-255   | 8        | Vendor Control                    | `0xFF 0xFF 0xFF...` (Not used)                                                              | Vendor specific control functions                                   |
+|           |          | **EXTRA EEPROM FIELDS**           |                                                                                             | **Not exposed to I2C interface**                                    |
+| 256-511   | 256      | Unknown vendor specific           |                                                                                             | Probably not used in current SFPs                                   |
+| 512-531   | 20       | GPON Equipment ID                 |                                                                                             | GPON Equipment ID (ME 257), may not work in some firmwares          |
+| 532-535   | 4        | GPON Vendor ID                    |                                                                                             | GPON Vendor ID (ME 256 and more), may not work in some firmware     |
+| 536-639   | 104      | Reserved                          |                                                                                             | Reserved                                                            |
+
+{% include alert.html content="For more information, see the SFF-8472 Rev 11.0 specification." alert="Info" icon="svg-info" color="blue" %}
+
 ## List of firmwares and files
 - [6BA1896SPLQA13 MTD0/U-Boot](https://mega.nz/file/wptjyYiS#Xj3cijX2bN0FexsZr1Wn7iRG0Wy4Z8vX0NyNBd1kBWo){: .btn } md5hash: 992b31a67c644aa68cf7f9caf956b1f9
 - [6BA1896SPLQA13 MTD2/Image0](https://mega.nz/file/1kUlUbgQ#ANS9qH6wCggYshsQ3STD6gxmR_3TL-5MXfdCl5s50Nk){: .btn } md5hash: 5d46a9acc3c5ba8710887aa32b82aeb4
@@ -274,4 +406,4 @@ When image1 is committed:
 - [FS.com](https://www.fs.com/it/products/133619.html)
 - [General setting of lantiq](https://forum.fibra.click/d/23881-ma5671a-e-vodafone-25-gbps/64)
 - [Usage GPON module SFP in Spain](https://forum.mikrotik.com/viewtopic.php?t=116364&start=300)
-- [SourcePhotonics SPS-34-24T-HP-TDFO Datasheet](https://www.sourcephotonics.com/wp-content/uploads/2017/08/DS-8085-02_SPS-34-24T-HP-TDFO.pdf)
\ No newline at end of file
+- [SourcePhotonics SPS-34-24T-HP-TDFO Datasheet](https://www.sourcephotonics.com/wp-content/uploads/2017/08/DS-8085-02_SPS-34-24T-HP-TDFO.pdf)