C Objective-C
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.gitignore
Makefile
README.md
chconf.h
gdisp_lld_board.h
gfxconf.h
ginput_lld_mouse_board.h
halconf.h
main.c
mcuconf.h
unlocker.c
unlocker.h

README.md

GFX-unlocker

Simple screen unlocker known from Android smartphones.

Written for µGFX (http://ugfx.org) framework running on ChibiOS/RT RTOS (http://chibios.org). Provided example was tested with Embest DM-STF4BB board and DM-LCD35RT LCD display but should work on any supported hardware. Along with project source files there are two board files for Embest board included: gdisp_lld_board.h and gdisp_lld_mouse_board.h.

Unlocker (displayUnlocker function) is intended to start before any other real action happens. Demo uses thread-based delays (gfxSleepMilliseconds), so make sure no unwanted thread can take control while unlocker waits.

There is a function (displayUnlockerSetup) that provides configuration possibility. It displays the same unlocker which allows you to draw pattern that will be stored and used in later unlockings.

The unlock pattern must be stored as one-dimensional array of uint8_t's, thus matrix size must not exceed 15x16. Unlock pattern is a sequence of ring numbers. Rings are numbered from 1, from left to right, starting with topmost row. Below there is an example of each ring number for 3x3 matrix.

[1] [2] [3]

[4] [5] [6]

[7] [8] [9]

In this demo there is displayUnlockerSetup run first, so after restart you have to draw pattern you want to unlock screen with. If you comment this out, make sure to initialize secret_sequence correctly.

This is the order of unlock movements between each ring in demo setup. The sequence from 1 to 7 shows the pattern to follow in order to unlock app.

(1) (5) (.)
 |   | \
(2) (6) (4)
   X   /
(7) (3) (.)

Hardcoded in main.c unlocking sequence is: 1, 4, 8, 6, 2, 5, 7, 0, 0.