The OpenJBOD Software is a Python-based software package for managing an OpenJBOD baseboard.
- MicroPython v1.23.0 or greater, compiled with W5500 support. (Ideally, also with 16 MB flash support, most versions only have 2MB support compiled into them.
Tip
A specific MicroPython binary file can be found by going to the Actions section of openjbod/micropython, where it can be downloaded by clicking the latest build and grabbing the firmware.uf2 file from the artifacts.
- An OpenJBOD RP2040 baseboard
All files and folders in this repo (except documentation) should be uploaded to the board after installing. Contents of the gzstatic folder should be gzipped before being copied to the board.
For CLI tools:
For GUI tools:
- Thonny can show local and remote file systems by enabling it in View -> Files. Navigate to the directory on your computer with the files, right click each file and folder, and select "Upload to '/'".
After copying the files, you can unplug the board and plug it into an ATX power supply, after which it will start the boot process and pick up an IP.
Tip
The default username and password for the board's web UI is admin:openjbod!
For current TODO items, see the TODO label in the Issues on this repository.
For development, it is suggested to use a dev environment like Thonny or VS Code with the MicroPico extension.
Important files are:
main.py- Contains core logic for configuring, starting and the general operation of the board.helpers.py- Contains helper functions, so as to not clog up main.py with (unnecessary) ugly code or repeated functions.emc2301/- This directory contains the basic EMC2301 driver. This is the class we use to interface with the fan controller.emc2301_regs.pycontains the register addresses of the EMC2301 for quick reference.
Webpage templates are stored in the templates/ and gzstatic/ directories, these are unique because:
gzstatic/- Any request invoked to/static/<path>goes to the gzstatic directory. This is a good place to put gzipped static resources that will not change. Such as the about page, the CSS, images, etc. Please note that gzipped pages cannot be rendered as templates. For the sake of ease of development, the files in gzstatic are NOT gzipped in this repo. Before pushing them to your board, ensure they are gzipped or they will fail to load!templates/- These are the templates with variables. utemplate, the library used for templating, uses a very Jinja-like syntax. For exact examples, please see miguelgrinberg's examples.
This software uses a bunch of cool projects that are making this all possible, they include: