1 files changed, 20 insertions, 0 deletions

diff --git a/embassy-time-driver/README.md b/embassy-time-driver/README.md
new file mode 100644
index 000000000..74a5b7876
--- /dev/null
+++ b/embassy-time-driver/README.md
@@ -0,0 +1,20 @@
+# embassy-time-driver
+
+
+This crate contains the driver trait necessary for adding [`embassy-time`](https://crates.io/crates/embassy-time) support
+for a new hardware platform.
+
+If you want to *use* `embassy-time` with already made drivers, you should depend on the main `embassy-time` crate, not on this crate.
+
+If you are writing a driver, you  should depend only on this crate, not on the main `embassy-time` crate.
+This will allow your driver to continue working for newer `embassy-time` major versions, without needing an update,
+if the driver trait has not had breaking changes.
+
+## How it works
+
+`embassy-time` module is backed by a global "time driver" specified at build time.
+Only one driver can be active in a program.
+
+All methods and structs transparently call into the active driver. This makes it
+possible for libraries to use `embassy-time` in a driver-agnostic way without
+requiring generic parameters.