https://github.com/doodlewind/react-ssd1306

📟 A React Renderer for SSD1306 OLED chip on Raspberry Pi.
https://github.com/doodlewind/react-ssd1306

c-module demo quickjs raspberry-pi react-native react-renderer ssd1306 tutorial

Last synced: about 10 hours ago
JSON representation

📟 A React Renderer for SSD1306 OLED chip on Raspberry Pi.

• Host: GitHub
• URL: https://github.com/doodlewind/react-ssd1306
• Owner: doodlewind
• Created: 2019-10-31T23:18:40.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2022-10-07T15:24:20.000Z (over 2 years ago)
• Last Synced: 2025-01-14T12:12:43.660Z (8 days ago)
• Topics: c-module, demo, quickjs, raspberry-pi, react-native, react-renderer, ssd1306, tutorial
• Language: C
• Homepage: https://github.com/doodlewind/react-ssd1306/blob/master/docs/tutorial.md
• Size: 89.8 KB
• Stars: 375
• Watchers: 9
• Forks: 25
• Open Issues: 3
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-react-renderer - react-ssd1306 - A React Renderer for SSD1306 OLED chip on Raspberry Pi. (Hardware)

README

        
# React SSD1306

A React Renderer for SSD1306 OLED chip on Raspberry Pi

![](./docs/demo.jpg)

For those who doesn't have the device, a canvas-based web emulator is also included!

## Introduction

This project demonstrates how to:

* Use React together with [QuickJS](https://bellard.org/quickjs/) on Raspberry Pi.

* Develop basic C module for QuickJS.

* Build a custom "**native & dynamic**" renderer for React.

Checkout the [Tutorial](./docs/tutorial.md), or my [Chinese blog post](https://ewind.us/2019/react-ssd1306) for details. 

## Getting Started

This project is originally designed to work on Raspberry Pi, but a web emulator is also available and works out of the box. Notice that no matter you run it on web or native, the whole React-related codebase is exactly the same.

### Web Approach

You can try out the reconciler example, even if you don't have a Raspberry Pi. In this way only Node.js and [ParcelJS](https://parceljs.org/) are required:

``` bash

cd react-ssd1306/app

parcel src/index.html

```

Then just open `https://localhost:1234` to see the emulator.

### Native Approach

Connect the chip, make sure you have QuickJS and Node.js installed on your Raspberry Pi, with I2C interface enabled. Few extra packages are also required:

``` bash

sudo apt-get install i2c-tools libi2c-dev

```

> Node.js is only required for JS module bundling and package management here.

Init the project:

``` bash

cd react-ssd1306/app

npm install && cd ..

npm run build # build JS and C modules

npm start # start the compiled binary

```

## Usage

Simply edit `./app/index.js` as main entrance:

``` js

import './polyfill.js'

import React from 'react'

import { SSD1306Renderer, Text, Pixel } from './renderer.js'

class App extends React.Component {

  constructor () {

    super()

    this.state = { hello: 'Hello React!', p: 0 }

  }

  render () {

    const { hello, p } = this.state

    return (

      

        {hello}

        Hello QuickJS!

        

      

    )

  }

  componentDidMount () {

    // XXX: Emulate event driven update

    setTimeout(() => this.setState({ hello: 'Hello Pi!', p: 42 }), 2000)

    setTimeout(() => this.setState({ hello: '', p: -1 }), 4000)

  }

}

SSD1306Renderer.render()

```

## License

MIT