diff --git a/README.md b/README.md
index 30ff5ab..aa61cf7 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # bsb_io
-Simole python module to interact with BlackSwift GPIO. Based on articles by BlackSwift developers: [on wiki](http://www.black-swift.ru/wiki/index.php?title=%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0_%D1%81_GPIO) and [on habrahabr](habrahabr.ru/company/blackswift/blog/247925/).
-This module uses "direct gpio access" method. 
+Simple python module to interact with BlackSwift GPIO. Based on articles by BlackSwift developers: [on wiki](http://www.black-swift.ru/wiki/index.php?title=%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0_%D1%81_GPIO) and [on habrahabr](http://habrahabr.ru/company/blackswift/blog/247925/).
+This module uses _fast_ "direct gpio register access" method. 
 
 ##Installing
 1. Download .ipk from releases tab or build it for yourself (see section below)
@@ -14,7 +14,30 @@ This module uses "direct gpio access" method.
 4. Run `make` if you want to build whole distribution or `make package/bsb_io/install` to build only bsb_io
 5. Locate .ipk in `bin/ar71xx/packages/base/`
 
-**N.B.** This module is built can with Cython 0.11 (Used by current OpenWrt BarrierBreaker Buildroot). If version of Cython in your Buildroot is higher, you would probably need to change `setup.py`.
+**N.B.** This module can be built with Cython 0.11 (Used by current OpenWrt BarrierBreaker Buildroot). If version of Cython in your Buildroot is higher, you would probably need to change `setup.py`.
+
+##Usage
+There is only one class `Pin`. It's constructor accepts GPIO number.
+You can change GPIO direction (input or output) by calling `.setDirection(dir)` methon. `dir` is one of 1, 0.
+You can read and write GPIO using `value`  property.
+
+This code toggles GPIO1 every 2 seconds:
+```
+import time
+from bsb_io import Pin
+
+p1 = Pin(1)
+v = 1
+while True:
+    if v==1:
+        v = 0
+        print "[OFF]\r"
+    else:
+        v = 1
+        print "[ON ]\r"
+    p1.value = v
+    time.sleep(2)
+```
 
 ##TODO
 * Implement simple, yet configurable soft PWM.