diff --git a/README.md b/README.md
new file mode 100644
index 0000000..573dc6e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,15 @@
+# rust-hdl-bsp-step-mxo2-lpc
+
+[![ci icon][]][ci link] [![crates.io icon][]][crates.io link]
+
+`rust-hdl` board support package for STEP-MXO2-LPC
+
+- [x] LED * 8
+- [x] DIP switch * 4
+- [x] Keys * 4
+- [x] 7-segment display * 2
+
+[crates.io link]: https://crates.io/crates/rust-hdl-bsp-step-mxo2-lpc
+[crates.io icon]: https://img.shields.io/crates/v/rust-hdl-bsp-step-mxo2-lpc.svg?style=flat-square
+[ci link]: https://github.com/y5c4l3/rust-hdl-bsp-step-mxo2-lpc
+[ci icon]: https://img.shields.io/github/actions/workflow/status/y5c4l3/rust-hdl-bsp-step-mxo2-lpc/rust.yml?branch=main&style=flat-square
\ No newline at end of file