Watch the demo video by clicking the image above ☝️
senfOS™ (Made in Germany) is powered by the Raspberry Pico 2W and Waveshare OLED 1.3 module. It features a small built-in http server with a small lightweight-filesystem to host html websites. Website visitors are able to send messages directly to your screen. It can connect to Wi-Fi networks or if no WiFi network is provided, it will automatically create a Wi-Fi hotspot that you can use to connect to and view the website.
Interesting for developers:
- Built-in http client to fetch content and display on the OLED driver
- Modified OLED library (minor changes)
- Control library for the on-board WiFi-led
- and more features will be added step-by-step.
Made in Germany. Built with C/C++, PicoSDK and Waveshare library.
- Using an GPIO extender board to connect sensors and modules and output them on the example website
- Extend libs/myhttp to also support POST requests (currently only GET works) for specific API requests
- Integrating a tiny LLM to monitor the hardware/software in case of failure or to fulfill small tasks
- Extending support for an eInk paper module from Waveshare
- Redesign the example page to make it look more appealing
- Implement HTTPS for webserver
- Dynamic DNS feature to update the DNS using a free DynDNS service
- Raspberry Pico W 2
- Waveshare OLED 1.3" Display
- Raspberry Pi USB Micro Cable
- TP-Link M7350 LTE/4G Router
- Ja!mobil SIM card
Solder the pins like shown in the picture:
After you've soldered the pins, mount the display like this:
As you can see the usb micro port is on the right side parallely aligning with "Pico-OLED-1.3" of the oled driver.
Install VS Code and the VS Code Extension for Raspberry Pico (use the official extension from above). Create a first project using the Pico Extension (on the left side bar you can see the extension, click on that) and create a new C++ project.
After you clicked "New C/C++ Project", type a project name and select all "Features" like shown above. Also select "Generate C++ code", "Enable C++ RTTI", "Enable C++ Exceptions".
Select everything like in the pictures shown above, then click on "Create". It can take up to 15 minutes until everything is downloaded. Let it finish downloading (it will install PicoSDK and CMake)!
Download the project using git:
git clone https://github.com/qubit999/senfOS.gitAfter that you can instead import a project, select this project source code and import it. Import the project folder "os_".
Now you're ready to play around and build.
You might want to set your own Wi-Fi Network, you can do this by editing the file "settings.h" and set your own Wi-Fi network and password. Currently it only supports WPA2-PSK Network but you can edit the file "libs/mywifi/mywifi.cpp" and replace this parameter "CYW43_AUTH_WPA2_AES_PSK" in line 28 with any WiFi encryption setting you like. Just type "CYW43_AUTH" and Visual Code suggests a few different options.
#define SSID "FRITZBOX 1234"
#define PASSWORD "01234567890ABC"
#define APN "internet.t-d1.de" // APN for German T-Mobile SIM card, will be implemented later
#define HOTSPOT_NAME "senf-hotspot"
#define HOTSPOT_PASS "mittelscharf"
// HTTP SERVER PORT can be changed in ./myhttpserver/lwipopts.h => line 57
// The HTTP Server serves the same files for HOTSPOT MODE and WI-FI MODEYou can also set a different hotspot name and passwort.
If you want to host your own html files, you can add your files to "./myhttpserver/fs" but bear in mind, you would also need to change the code of "./myhttpserver/myhttpserver.cpp". If you simply want to host a single page, you can just replace the "index.html" file.
The default port of the http server is set to "9999". If you plan to change it, you can do so by editing ./myhttpserver/lwipopts.h => line 57.
If you want to use a SIM card for hosting your server, you need to change APN settings of your LTE Router to point to an APN which gives you a public IPv4 address. In Germany you can only use "Telekom Network" to get a free public IPv4 address and you need to set the APN to "internet.t-d1.de".
After that you need to set up port forwarding. If you use the TP-Link 4G LTE Router, you can't use the external port "80" since this port is reserved for the Router Web Interface but you can set any other port you like. Set the internal port to "9999" (or the port you specified in line 57 of ./myhttpserver/lwipopts.h) and the external port to "9999" for example. Your website will be accessible with the external port, as an example "http://83.123.70.19:9999" (but only http protocol, https is not implemented yet). Change to your default WiFi network before you browse the website.
Connect the Micro USB cable to your MacBook. Hold down the bootselect button while plugging the Raspberry Pico in. A volume will pop up in Finder (make sure you see that Volume).
When you open the Raspberry Pico extension, you need to click "Clean CMake", then "Configure CMake" and "Run Project". It will start flashing and automatically reboot the Pico. There will be also an UF2 image inside the /build directory. The build directory will be automatically created when you hit "Clean CMake".
Finish. Have fun.
I haven't decided yet. As of now: Please use this project only for non-commercial purposes. No warranty or liability at all. Don't remove the boot screen (it's advertisement).
If you use this project and you want to support the development, please buy me a coffee.
email for business: [email protected]
Open an issue on GitHub.