Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tinkertanker/pxt-oled-ssd1306
Tinkercademy MakeCode package for using the SSD1306 OLED controller with micro:bit
https://github.com/tinkertanker/pxt-oled-ssd1306
Last synced: 3 months ago
JSON representation
Tinkercademy MakeCode package for using the SSD1306 OLED controller with micro:bit
- Host: GitHub
- URL: https://github.com/tinkertanker/pxt-oled-ssd1306
- Owner: tinkertanker
- License: mit
- Created: 2017-03-29T06:41:16.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2021-02-23T17:46:00.000Z (over 3 years ago)
- Last Synced: 2024-04-05T14:04:25.878Z (3 months ago)
- Language: TypeScript
- Homepage:
- Size: 204 KB
- Stars: 24
- Watchers: 10
- Forks: 45
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Lists
- awesome-microbit-zh - SSD1306 - SSD1306 OLED 屏幕的pxt驱动, 基于Adafruit Arduino库. (编程 / JavaScript 和 MakeCode)
README
# SSD1306 OLED MakeCode Package [](https://travis-ci.org/Tinkertanker/pxt-oled-ssd1306)
This is the MakeCode Package for SSD1306 OLED controller, based on the Adafruit Arduino library available [here](https://github.com/adafruit/Adafruit_SSD1306).
## Hardware Setup
1. Insert the OLED display into the I2C ports on the break out board.
## Blocks
### Initialize OLED Display
Initializes the OLED display.
Sets up the OLED display and prepares it for use by the micro:bit.
```sig
OLED.init(64, 128);
```
This block must be placed before any of the ``show`` blocks.
### Show String Without Newline
Displays a string on the OLED module without a newline.
```sig
OLED.showString1("hello, micro:bit!")
```
The ``init`` block must be placed before this.
### Show String With Newline
Displays a string on the OLED module with a newline.
```sig
OLED.showString2("hello, micro:bit!")
```
The ``init`` block must be placed before this.
### Show Number Without newline
Displays a number on the OLED module without a newline.
```sig
OLED.showNumber1(123)
```
The ``init`` block must be placed before this.
### Show Number With Newline
Displays a number on the OLED module with a newline.
```sig
OLED.showNumber2(123)
```
The ``init`` block must be placed before this.
### Clear Display
Clears the display.
```sig
OLED.clear()
```
The ``init`` block must be placed before this.
### Draw Outlined Rectangle
Displays an outline of a rectangle.
```sig
OLED.drawRectangle(x,y,w,h)
```
The ``init`` block must be placed before this.
### Draw Outlined Circle
Displays an outline of a circle.
```sig
OLED.drawCircle(x,y,r)
```
The ``init`` block must be placed before this.
### Draw Line
Displays a line.
```sig
OLED.drawLine(x1,y1,x2,y2)
```
The ``init`` block must be placed before this.
### Progress bar
Displays a progress bar with a specified percentage of progress.
```sig
OLED.drawLoadingBar(percent)
```
The ``init`` block must be placed before this.
## Example: Counter
The following code is a simple counter that displays an increasing number every second.
```blocks
OLED.init(64, 128)
let item = 0
basic.forever(() => {
basic.pause(1000)
item += 1
OLED.showNumber(item)
})
```
## Supported targets
* for PXT/microbit
## Footnotes
1. Datasheet https://cdn-shop.adafruit.com/datasheets/SSD1306.pdf