inky

Bertinta

Perpustakaan Python untuk Inky Phat, Inky What dan Inky Impression Display E-Paper untuk Raspberry Pi.

Phat tinta

Inky Phat adalah tampilan e-paper 250x122 piksel, tersedia dalam warna merah/hitam/putih, kuning/hitam/putih dan hitam/putih. Ini bagus untuk senilai nama dan menampilkan informasi frekuensi yang sangat rendah seperti kalender harian atau ikhtisar cuaca.

Inky apa

Inky, apa yang disediakan layar e-paper 400x300 piksel yang tersedia dalam warna merah/hitam/putih, kuning/hitam/putih dan hitam/putih. Ada banyak resolusi untuk daftar tugas harian yang terperinci, ramalan cuaca multi-hari, jadwal bus, dan banyak lagi.

Kesan bertinta

Kesan Inky adalah garis tampilan Eink 7 warna yang agung, tersedia dalam 4 "(640 x 400 piksel) 5,7" (600 x 448 piksel) dan 7,3 "(800 x 480 piksel) rasa. Mereka dikemas dengan warna yang kuat dan sempurna untuk menampilkan grafik yang mengejutkan atau banyak data.

Instalasi

Kami akan merekomendasikan menggunakan pustaka ini dengan kutu buku Raspberry Pi Os atau lebih baru. Itu membutuhkan Python ≥3.7.

Instalasi penuh (disarankan):

Kami telah membuat skrip instalasi mudah yang akan menginstal semua prasyarat dan membuat Anda bangun dan berjalan dengan upaya minimal. Untuk menjalankannya, nyalakan terminal yang akan Anda temukan di menu -> Aksesori -> Terminal di desktop Raspberry Pi Anda, seperti yang diilustrasikan di bawah ini:

Di jendela terminal baru Ketik perintah persis seperti yang terlihat di bawah ini (periksa kesalahan ketik) dan ikuti instruksi di layar:

git clone https://github.com/pimoroni/inky
cd inky
./install.sh

Catatan Perpustakaan akan diinstal di lingkungan virtual "Pimoroni", Anda harus mengaktifkannya untuk menjalankan contoh:

 source ~/.virtualenvs/pimoroni/bin/activate

Perkembangan:

Jika Anda ingin berkontribusi, atau suka hidup di tepi kursi Anda dengan memiliki kode terbaru, Anda dapat menginstal versi pengembangan seperti itu:

git clone https://github.com/pimoroni/inky
cd inky
./install.sh --unstable

Instal perpustakaan yang stabil dari PYPI dan konfigurasikan secara manual

• Siapkan lingkungan virtual: python3 -m venv --system-site-packages $HOME/.virtualenvs/pimoroni
• Beralih ke lingkungan virtual: source ~/.virtualenvs/pimoroni/bin/activate
• Instal Perpustakaan: pip install inky

Ini tidak akan membuat perubahan konfigurasi, jadi Anda mungkin juga perlu mengaktifkan:

• i2c: sudo raspi-config nonint do_i2c 0
• SPI: sudo raspi-config nonint do_spi 0

Anda secara opsional dapat menjalankan sudo raspi-config atau grafis raspberry pi configuration ui untuk mengaktifkan antarmuka.

Selain itu, Anda mungkin perlu menonaktifkan chip-chip yang terpilih untuk menghindari kesalahan:

 Woah there, some pins we need are in use!
  ️   Chip Select: (line 8, GPIO8) currently claimed by spi0 CS0

Ini membutuhkan penambahan dtoverlay=spi0-0cs ke /boot/firmware/config.txt .

Penggunaan

Perpustakaan harus dijalankan dengan Python 3.

Pengaturan Otomatis

Inky dapat mencoba mengidentifikasi papan Anda secara otomatis (dari informasi yang disimpan di EEPROM -nya) dan mengaturnya. Ini adalah cara termudah untuk bekerja dengan tampilan inky baru -baru ini.

 from inky . auto import auto
display = auto ()

Anda kemudian bisa mendapatkan warna dan resolusi dari papan:

 display . colour
display . resolution 

Pengaturan manual

Jika Anda memiliki tinta yang lebih tua tanpa EEPROM, Anda dapat menentukan jenisnya secara manual. Perpustakaan Inky berisi modul untuk phat dan apa, muatkan phat inky sebagai berikut:

 from inky import InkyPHAT

Anda kemudian harus memilih warna Anda, salah satu dari 'merah', 'kuning' atau 'hitam' dan instantiate kelas:

 display = InkyPHAT ( 'red' )

Jika Anda menggunakan apa yang Anda perlukan untuk memuat kelas Inkywhat dari perpustakaan inky seperti:

 from inky import InkyWHAT
display = InkyWHAT ( 'red' )

Setelah Anda menginisialisasi inky, hanya ada tiga metode yang perlu Anda khawatirkan:

Atur gambar

Atur gambar PIL, array numpy atau daftar ke buffer internal Inky. Dimensi gambar harus cocok dengan dimensi phat atau apa yang Anda gunakan.

 display . set_image ( image )

Anda harus menggunakan PIL untuk membuat gambar. PIL menyediakan modul ImageDraw yang memungkinkan Anda untuk menggambar teks, garis, dan bentuk di atas gambar Anda. Lihat: https://pillow.readthedocs.io/en/stable/reference/imagedraw.html

Setel perbatasan

Atur warna perbatasan Anda phat atau apa.

 display . set_border ( colour )

colour harus menjadi salah satu dari inky.RED , inky.YELLOW , inky.WHITE atau inky.BLACK dengan warna yang tersedia tergantung pada jenis tampilan Anda.

Perbarui tampilan

Setelah Anda menyiapkan dan mengatur gambar Anda, dan memilih warna perbatasan, Anda dapat memperbarui tampilan E-ink Anda dengan:

 display . show ()

Bermigrasi

Jika Anda memigrasikan kode dari perpustakaan inkyphat lama, Anda akan menemukan bahwa banyak fungsi manipulasi gambar dan gambar telah dihapus dari Inky. Fungsi -fungsi ini selalu disediakan oleh PIL, dan pendekatan yang disarankan adalah menggunakan PIL untuk membuat dan menyiapkan gambar Anda sebelum mengaturnya ke Inky dengan set_image() .