CLUE Step Counter with ST LSM6DS33

2022-02-22 | By Adafruit Industries

License: See Original Project Wearables

Courtesy of Adafruit

Guide by Liz Clark

Overview

You can clue into your daily step count with the CLUE board! Pair it ‎with a wearable case and you have a DIY step counter. A lot of step ‎counters require an app to see your data, but with this project you ‎can see your daily steps without any fears about your data security.‎

board_1

How It Works

The CLUE's on-board accelerometer has a built-in pedometer. With ‎the CircuitPython CLUE and LSM6DS33 libraries, you can access the ‎pedometer to count your steps with just a few lines of code.‎

In addition to monitoring your total step count, you can also track ‎your progress towards your step goal and see how many steps per ‎hour you're taking. To keep your battery life going strong, you can ‎also adjust the CLUE's display brightness using the A and B buttons ‎on either side of the screen.‎

display_2

Parts

Adafruit CLUE - nRF52840 Express with Bluetooth LE
Breadboard-friendly SPDT Slide Switch
Lithium Ion Polymer Battery Ideal For Feathers - 3.7V 400mAh‎
Fully Reversible Pink/Purple USB A to micro B Cable - 1m long‎

Project Video

CircuitPython on CLUE

CircuitPython is a derivative of MicroPython designed to simplify ‎experimentation and education on low-cost microcontrollers. It ‎makes it easier than ever to get prototyping by requiring no upfront ‎desktop software downloads. Simply copy and edit files on ‎the CIRCUITPY flash drive to iterate.‎

The following instructions will show you how to install CircuitPython. ‎If you've already installed CircuitPython but are looking to update it ‎or reinstall it, the same steps work for that as well!‎

Set up CircuitPython Quick Start!‎

Follow this quick step-by-step for super-fast Python power :)‎

Download the latest version of CircuitPython for CLUE from ‎circuitpython.org

Click the link above to download the latest version of CircuitPython ‎for the CLUE.‎

Download and save it to your desktop (or wherever is handy).‎

link_3

Plug your CLUE into your computer using a known-good USB cable.‎

A lot of people end up using charge-only USB cables and it is very frustrating! So make sure you ‎have a USB cable you know is good for data sync.‎

Double-click the Reset button on the top (magenta arrow) on your board, and you will see the NeoPixel ‎RGB LED (green arrow) turn green. If it turns red, check the USB cable, try another USB port, ‎etc. Note: The little red LED next to the USB connector will pulse red. That's ok!‎

If double-clicking doesn't work the first time, try again. Sometimes it can take a few tries to get the ‎rhythm right!‎

clue_4

You will see a new disk drive appear called CLUEBOOT.‎

Drag the adafruit-circuitpython-clue-etc.uf2 file to CLUEBOOT.‎

drive_5

drive_6

The LED will flash. Then, the CLUEBOOT drive will disappear, and a new disk drive ‎called CIRCUITPY will appear.‎

If this is the first time, you're installing CircuitPython or you're doing a completely fresh install after ‎erasing the filesystem, you will have two files - boot_out.txt, and code.py, and one folder - lib on ‎your CIRCUITPY drive.‎

If CircuitPython was already installed, the files present before reloading CircuitPython should still be ‎present on your CIRCUITPY drive. Loading CircuitPython will not create new files if there was ‎already a CircuitPython filesystem present.‎

That's it, you're done! :)‎

disk_7

CLUE CircuitPython Libraries

The CLUE is packed full of features like a display and a ton of sensors. ‎Now that you have CircuitPython installed on your CLUE, you'll need ‎to install a base set of CircuitPython libraries to use the features of ‎the board with CircuitPython.‎

Follow these steps to get the necessary libraries installed.‎

Installing CircuitPython Libraries ‎on your CLUE

If you do not already have a lib folder on your CIRCUITPY drive, ‎create one now.‎

Then, download the CircuitPython library bundle that matches your ‎version of CircuitPython from CircuitPython.org.‎

Download the latest library bundle from circuitpython.org

The bundle downloads as a .zip file. Extract the file. Open the ‎resulting folder.‎

bundle_8

Open the lib folder found within.‎

lib_9

Once inside, you'll find a lengthy list of folders and .mpy files. To install a CircuitPython library, you ‎drag the file or folder from the bundle lib folder to the lib folder on your CIRCUITPY drive.‎

folders_10

Copy the following folders and files from the bundle lib folder to the lib folder on your ‎CIRCUITPY drive:‎

adafruit_apds9960
adafruit_bmp280.mpy
adafruit_bus_device
adafruit_clue.mpy
adafruit_display_shapes
adafruit_display_text
adafruit_lis3mdl.mpy
adafruit_lsm6ds
adafruit_register
adafruit_sht31d.mpy
adafruit_slideshow.mpy
neopixel.mpy

Your lib folder should look like the image on the left. These libraries will let you run the demos in the ‎CLUE guide.‎

demo_11

Coding the CLUE Step Counter

coding_12

Additional Libraries

Once you've finished setting up your CLUE, add these additional ‎libraries to the lib folder:‎

adafruit_bitmap_font
adafruit_progressbar
simpleio.mpy

Then, you can click on the Download: Project Zip link above the code ‎to download the code file, fonts folder and bitmap background ‎image.‎

Code

Click on "Copy Code" and then paste it into the Mu editor to save to ‎your CLUE as code.py or copy the code file from the Project Zip ‎folder to the CLUE's CIRCUITPY drive.‎

‎Download Project Bundle

Copy Code

import time
import board
import displayio
from adafruit_clue import clue
from simpleio import map_range
from adafruit_bitmap_font import bitmap_font
from adafruit_lsm6ds.lsm6ds33 import LSM6DS33
from adafruit_lsm6ds import Rate, AccelRange
from adafruit_progressbar.progressbar import ProgressBar
from adafruit_display_text.label import Label

#  turns off onboard NeoPixel to conserve battery
clue.pixel.brightness = (0.0)

#  accessing the Clue's accelerometer
sensor = LSM6DS33(board.I2C())

#  step goal
step_goal = 10000

#  onboard button states
a_state = False
b_state = False

#  array to adjust screen brightness
bright_level = [0, 0.5, 1]

countdown = 0 #  variable for the step goal progress bar
clock = 0 #  variable used to keep track of time for the steps per hour counter
clock_count = 0 #  holds the number of hours that the step counter has been running
clock_check = 0 #  holds the result of the clock divided by 3600 seconds (1 hour)
last_step = 0 #  state used to properly counter steps
mono = time.monotonic() #  time.monotonic() device
mode = 1 #  state used to track screen brightness
steps_log = 0 #  holds total steps to check for steps per hour
steps_remaining = 0 #  holds the remaining steps needed to reach the step goal
sph = 0 #  holds steps per hour

#  variables to hold file locations for background and fonts
clue_bgBMP = "/clue_bgBMP.bmp"
small_font = "/fonts/Roboto-Medium-16.bdf"
med_font = "/fonts/Roboto-Bold-24.bdf"
big_font = "/fonts/Roboto-Black-48.bdf"

#  glyphs for fonts
glyphs = b'0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ-,.: '

#  loading bitmap fonts
small_font = bitmap_font.load_font(small_font)
small_font.load_glyphs(glyphs)
med_font = bitmap_font.load_font(med_font)
med_font.load_glyphs(glyphs)
big_font = bitmap_font.load_font(big_font)
big_font.load_glyphs(glyphs)

#  creating display and default brightness
clue_display = board.DISPLAY
clue_display.brightness = 0.5

#  graphics group
clueGroup = displayio.Group()

#  loading bitmap background
# CircuitPython 6 & 7 compatible
clue_bg = displayio.OnDiskBitmap(open(clue_bgBMP, "rb"))
clue_tilegrid = displayio.TileGrid(
    clue_bg, pixel_shader=getattr(clue_bg, 'pixel_shader', displayio.ColorConverter())
)
clueGroup.append(clue_tilegrid)

# # CircuitPython 7+ compatible
# clue_bg = displayio.OnDiskBitmap(clue_bgBMP)
# clue_tilegrid = displayio.TileGrid(clue_bg, pixel_shader=clue_bg.pixel_shader)
# clueGroup.append(clue_tilegrid)

#  creating the ProgressBar object
bar_group = displayio.Group()
prog_bar = ProgressBar(1, 1, 239, 25, bar_color=0x652f8f)
bar_group.append(prog_bar)

clueGroup.append(bar_group)

#  text for step goal
steps_countdown = Label(small_font, text='%d Steps Remaining' % step_goal, color=clue.WHITE)
steps_countdown.x = 55
steps_countdown.y = 12

#  text for steps
text_steps = Label(big_font, text="0     ", color=0xe90e8b)
text_steps.x = 45
text_steps.y = 70

#  text for steps per hour
text_sph = Label(med_font, text=" -- ", color=0x29abe2)
text_sph.x = 8
text_sph.y = 195

#  adding all text to the display group
clueGroup.append(text_sph)
clueGroup.append(steps_countdown)
clueGroup.append(text_steps)

#  sending display group to the display at startup
clue_display.show(clueGroup)

#  setting up the accelerometer and pedometer
sensor.accelerometer_range = AccelRange.RANGE_2G
sensor.accelerometer_data_rate = Rate.RATE_26_HZ
sensor.gyro_data_rate = Rate.RATE_SHUTDOWN
sensor.pedometer_enable = True

while True:

    #  button debouncing
    if not clue.button_a and not a_state:
        a_state = True
    if not clue.button_b and not b_state:
        b_state = True

    #  setting up steps to hold step count
    steps = sensor.pedometer_steps

    #  creating the data for the ProgressBar
    countdown = map_range(steps, 0, step_goal, 0.0, 1.0)

    #  actual counting of the steps
    #  if a step is taken:
    if abs(steps-last_step) > 1:
        step_time = time.monotonic()
        #  updates last_step
        last_step = steps
        #  updates the display
        text_steps.text = '%d' % steps
        clock = step_time - mono

        #  logging steps per hour
        if clock > 3600:
            #  gets number of hours to add to total
            clock_check = clock / 3600
            #  logs the step count as of that hour
            steps_log = steps
            #  adds the hours to get a new hours total
            clock_count += round(clock_check)
            #  divides steps by hours to get steps per hour
            sph = steps_log / clock_count
            #  adds the sph to the display
            text_sph.text = '%d' % sph
            #  resets clock to count to the next hour again
            clock = 0
            mono = time.monotonic()

        #  adjusting countdown to step goal
        prog_bar.progress = float(countdown)

    #  displaying countdown to step goal
    if step_goal - steps > 0:
        steps_remaining = step_goal - steps
        steps_countdown.text = '%d Steps Remaining' % steps_remaining
    else:
        steps_countdown.text = 'Steps Goal Met!'

    #  adjusting screen brightness, a button decreases brightness
    if clue.button_a and a_state:
        mode -= 1
        a_state = False
        if mode < 0:
            mode = 0
            clue_display.brightness = bright_level[mode]
        else:
            clue_display.brightness = bright_level[mode]
    #  b button increases brightness
    if clue.button_b and b_state:
        mode += 1
        b_state = False
        if mode > 2:
            mode = 2
            clue_display.brightness = bright_level[mode]
        else:
            clue_display.brightness = bright_level[mode]

    time.sleep(0.001)

View on GitHub

Fonts and Background Bitmap

In addition to the lib folder, for this project you'll also have ‎a fonts folder. The fonts folder contains the three bitmap fonts that ‎are used for text displayed on the CLUE's display.

Roboto-Medium-16.bdf
Roboto-Bold-24.bdf
Roboto-Black-48.bdf‎

There is also a bitmap image for the background of the CLUE's ‎display. This image file, called clue_bgBMP.bmp, will also be stored ‎on the CLUE. ‎

Copy the fonts folder and the clue_bgBMP.bmp bitmap image file ‎from the Project Zip folder to the CLUE's CIRCUITPY drive.‎

fonts_13

Your CLUE CIRCUITPY drive should look like this after you load the ‎libraries, fonts, bitmap and code below:‎

libraries_14

CircuitPython Code Walkthrough

Setup

The CircuitPython code begins by importing the libraries.‎

Download File

Copy Code

import time
import board
import displayio
from adafruit_clue import clue
from simpleio import map_range
from adafruit_bitmap_font import bitmap_font
from adafruit_lsm6ds import LSM6DS33, Rate, AccelRange
from adafruit_progressbar import ProgressBar
from adafruit_display_text.label import Label

After the libraries are imported, the on-board NeoPixel is turned off. ‎This is done in an effort to conserve battery life.‎

CLUE Step Counter with ST LSM6DS33

2022-02-22 | By Adafruit Industries

信息

帮助

联系我们

关注我们