I2C OLED 128x64

OLED scherm voor gebruik met BBC Microbit

Nederlandstalige versie

Die interne kode is Nederlandstalig

makecode I2C OLED 128x64 extension for micro:bit.

Part of the drive base on fizban99's microbit OLED driver:
https://github.com/fizban99/microbit_ssd1306

Author: shaoziyang
Date: 2018.Mar

Add extension

open your microbit makecode project, in Extension, paste

https://github.com/makecode-extensions/OLED12864_I2C

to search box then search, and click to add.

Basic usage

let item = 0
OLED12864_I2C.init(60)
OLED12864_I2C.rect(0, 0, 60, 30, 1)
OLED12864_I2C.showString(0, 0, "Hello!", 1)
OLED12864_I2C.showString(0, 1, "1234567890", 0)
item = 0
basic.forever(() => {
    OLED12864_I2C.showNumber(0, 3, item, 1)
    item += 1
    basic.pause(1000)
}) 

API

• init(addr: number)
  initialize OLED module. addr: OLED I2C address, it maybe 60 or 61, depend on hardware, default is 60.

• zoom(d: boolean = true)
  set zoom mode. In zoom mode, it will show in double size.
  d: mode

  • true, zoom mode.
  • false, normal mode.

• on()
  turn on OLED.

• off()
  turn off OLED.

• clear()
  clear all content in OLED.

• draw()
  force redraw the content.

• invert(d: boolean = true)
  show in invert mode.

• pixel(x: number, y: number, color: number = 1)
  set a pixel in OLED.

  • x, X alis position, 0 - 63 in zoom mode, 0 - 127 in normal mode.
  • y, Y alis position, 0 - 31 in zoom mode, 0 - 63 in normal mode.
  • color, draw color, it can be 1 or 0.

• showString(x: number, y: number, s: string, color: number = 1)
  show a text at specified position.

  • x, X alis position, 0 - 11 in zoom mode, 0 - 23 in normal mode.
  • y, Y alis position, 0 - 3 in zoom mode, 0 - 7 in normal mode.
  • s, the text will be show
  • color, draw color, it can be 1 or 0.

• showNumber(x: number, y: number, num: number, color: number = 1)
  show a number at specified position.

  • x, X alis position, 0 - 11 in zoom mode, 0 - 23 in normal mode.
  • y, Y alis position, 0 - 3 in zoom mode, 0 - 7 in normal mode.
  • num, the number will be show
  • color, draw color, it can be 1 or 0.

• hline(x: number, y: number, len: number, color: number = 1)
  draw a horizontal line.

  • (x, y), start point
  • len, length of the line
  • color, draw color, it can be 1 or 0.

• vline(x: number, y: number, len: number, color: number = 1)
  draw a vertical line.

  • (x, y), start point
  • len, length of the line
  • color, draw color, it can be 1 or 0.

• rect(x1: number, y1: number, x2: number, y2: number, color: number = 1)
  draw a rectangle.

  • (x1, y1), start point
  • (x2, y2), end point
  • color, draw color, it can be 1 or 0.

Demo

License

MIT

Copyright (c) 2018, microbit/micropython Chinese community

Supported targets

• for PXT/microbit

From microbit/micropython Chinese community