- API Documentation: Provides details about the library's functions. It's essential to get acquainted with these to effectively utilize the library.
- Programming Guide: Explains the design of the library and offers guidance on how to use it. Please read the files in the programming guide section to gain a comprehensive understanding.
This repository contains the Realtek Unmanaged Switch Library Version 1.3.12.
- Staying Updated: If you're using or have a newer version of this library, please contact me on github to discuss updating this repository.
- Original Library Files: For those who need them, the original library files are included in the
api_sourcefolder.
If You Want to Use this library outside of Arduino (esp-idf, Atmel, and others) just edit the smi.c. At the start, write and read functions, change the digital read, digital write, and pinMode to your needs, and erase the #include "Arduino".
I have developed a C++ library with classes to enhance the usability of this library. The enhanced library is designed to be more user-friendly and intuitive. It also provides additional features and functions.
- Find the Enhanced Library Here: Realtek Unmanaged Switch Class Wrapper for Arduino
In addition to the main library, there's a EEPROM file designed for the RTL8367S IC. In my experience, initializing the switch with this EEPROM file before using the library for further configuration proves to be more effective because you dont need to initialize with your IC (you will need to wait about 3 seconds to initialize to make the configurations). This file is just 4KB in size, making it compatible with smaller EEPROMs like the 24C04 or larger. Although I'm currently using a 24C32 due to availability, the 24C04 is more than sufficient to store the EEPROM file. Please read the RTL8367S datasheet, this IC use the pin EEPROM_MOD/LAN4LED0 to select the eeprom size, if low - eeprom size less or equal to 16kb (24C02 - 24C16), high - eeprom size greater than 16kb (24C32 - 24C256).
To change the sda and sck pins, you have to include the smi.c file and change the RTK_I2C_SCK_PIN and RTK_I2C_SDA_PIN variables. You can also change the I2C speed by changing the RTK_I2C_DELAY variable (this delay is microseconds, so 1000 = 1ms). The default pins are 1 and 2, and the default speed is 1 between each bit.
If you're using c++, you need the extern "C" declaration to include the library files. You can also use the enhanced library, which is more user-friendly, intuitive and provides additional features and functions.
extern "C" {
#include "smi.c"
#include "port.h"
}
My heartfelt thanks go to the entire community and all contributors. Your invaluable support and feedback played a crucial role in the development of this library, making it a useful resource for Arduino enthusiasts.
- Origin of Realtek Files: This project builds upon the foundational work found in the repository Realtek_switch_hacking. The original library files provided there served as a key resource in the creation of this library.