This repository is the RCKid mark II. Unlike the first version, the mark II attempts to mimic the olden handheld consoles more closely by using a much simpler main chip (RP2040 vs RPi Zero) and replaceable cartridges that can extend the handheld with both new software and hardware.
This also means that the chip is seriously "underpowered" for most tasks mark I handled with ease, such as playing videos and emulating old games. Mark II puts much more emphasis on own content creation and fun (at least for me) by recreating the feel of old consoles for the programmers as well.
This readme is intended for those who wish to develop their own cartridges for RCKid. When applicable, links will be put here for user guides, etc.
Please note that this is my toy project and as such will likely move veeeery slowly as its requirements in almost every department exceed my current capabilities (and when mistakes appear, probably my buget as well since the main PCB must be machine-assembled).
After cloning the repository, run the setup.sh file:
git clone [email protected]:rc-kid/rckid
cd rckid
bash setup.sh
This should install all necessary packages, including platformio and 3rd party libraries used by RCKid.
I'm building RCKid on Ubuntu 22.04 WSL, which is the only "officially" supported distribution, other linux flavours should work equally well, but the package manager commands must be updated.
Building all cartridges that are part of this repo is then as easy as running the following:
mkdir build
cd build
cmake ..
cmake --build .
The various cartridges will then be available under the build/cartridges folder and its subfolders in the UF2 format.
Alternatively, several parts of the RCKid library can also build locally on your dev machine for easier debugging and testing. To do so, run the following from RCKid's root folder:
mkdir build-mock
cd build-mock
cmake .. -DARCH=MOCK
cmake --build .
Be careful, for debugging under WSL, read the following bug for now (installing gdb from the PPA as suggested in the discussion works for now)
TODO
The repository consists of various frameworks, libraries and executables for different architectures. The most important ones are:
platformcontains header only very low level hardware abstraction layer unifying all the platforms used (RP2040, ATTiny, ESP8266, etc.). The platform framework supports basic gpio operations, cpu features and i2c/spi communication. The platform framework is independent of RCKid and can be used in other projects as well, seeplatform/README.mdfor more details.toolsvarious utilities for RCKid's development and setup, such as asset generation, firmware flashing, etc.libscontains copies of 3rd party libraries used as part of the SDKassetscontains visual assets for the SDKcommoncontains source files that are common to multiple RCKid projects, such as configuration, bootloaders, radio libraries, etc.rckid/avrcontains code for the AVR chip inside RCKid that takes care of power management and input/otputrckid/librckidcontains the bulk of the SDKrckid/platformcontains an RCkid's specific additions to the RP2040 platformcartridgecontains the cartridges built for the RCKid. Each cartridge has its own image that can be flashedbase-stationis the code for ESP8266 based NRF to WiFi base station through which NRF enabled rckids can connect to the internethardwarecontains schematics, PCB layout files and 3D models for the device and cartridges
-
Debug mode, activated when normal mode is entered while the select button is pressed
-
the oscillator is slow to start, see https://forums.raspberrypi.com/viewtopic.php?t=317631
==========
That said, I am hopeful, that over time, the following will be possible:
-
music player
-
own games (2d platformers, etc.)
-
video player (not generic formats, but special preencoded videos tailodr toward the meagre processing power and memory of RP2040)
-
games emulator (I am hoping at least C64 or Gameboy, having GBC would be epic)
-
walkie talkie (like v1)
-
remote controller (like v1)
-
internet connectivity via either a WiFi to NRF beacon, or a dedicated ESP8266 cartridge (the later is more portable, but will drain battery)
-
screw inserts (https://www.prusa3d.com/product/threaded-inserts-m2-short-100-pcs/)
-
hole height 4mm, 3.2mm diameter and 1.3mm wall thickness around, this makes the actual structure thickness at least 1.6 + 1.3 = 2.9, which sort of barely fits, but ok:)
RCKid mk II is an RP2040 (the chip that powers RPi Pico) handheld device that can be used to play own games, emulate some very old consoles, play music and video files and act as a walkie-talkie or remote controller with the RCKid mk I protocol.
To resemble the handheld game consoles of the past, RCKid mk II uses swappable cartridges that can extend its functionality. At minimum, the cartridge must provide the flash chip for the RP2040 inside, but extra power, I2C, SPI and 4 GPIO pins are provided for HW expansion.
The device consts of the RP2040 itself, a 2.8" 8bit 8080 display, audio in & out, accelerometer and other sensors.
The default cartridge
This is an initial repository for my new project, RP2040 based smaller RCKid with actual cartridges for real nostalgia feel. The project should be relatively cheap, easy to build and its parts should be plentiful. The emphasis this time is not on emulation, but on creating own games and getting smart with the cartridges like in the olden days.
!! Can preorder parts at JLCPCB to ensure they are available to me when I want to assemble them
The device itself will contain the basic necessary hardware, including:
- 2.8" screen
- RP2040
- SD card for memory
- audio outputs (headphones & mono speaker)
- microphone
- battery & charger (https://www.tme.eu/cz/details/accu-lp503759_cl/akumulatory/cellevia-batteries/l503759/)
- sensors (accel, photo, ...)
- rumbler
total stackup is 11mm
- 1mm plexiglass cover
- 3mm display & buttons & room for top
- 1mm main PCB
- 5mm battery
- 1mm bottom
This should be a nice IPS screen with smaller margins for minimal footprint. Also seems to have all the required, including the tearing effect synchronization. Alternatively any non-IPS ILI9341 or ST7789 screen with the same pinout should be compatible as well at the expense of the display's active area not being centered perfectly
Driven in 8080 8bit mode by the RP2040.
Attached to the RP2040, uses the SPI interface. Contains the
-
12 8080 8bit display
-
4 SD card SPI
-
1 microphone
-
2 audio out
-
2 I2C (cartridge connector)
-
4 SPI (cartridge connector & SRAM)
-
4 GPIO (cartridge connector)
-
free: 1 pin (used as CS for the SRAM chip)
Using the smaller xx16 part as they are more readily available
- 2 I2C
- 7 (3x4 matrix) buttons (11 buttons - 4 dpad, A, B, Sel, Start, VolUp, VolDown, HOME) - 1 free
- 1 backlight
- 3 power, VBATT sense, charging sense
- 2 neopixel power + neopixel
- 2 headphones, speaker on
Cartridges and the device connect via a single row of 20 precision (SIP connector, single row) pins with 2.54mm spacing. The connector will provide the following interfaces:
- QSPI for flash memory (6 pins)
- SPI (4)
- I2C (2)
- GPIO (4)
- GND (2)
- VBATT (1)
- 3V3 (1)
At a minimum, the cartridge must provide the QSPI flash for the RP2040. The design should allow for the inclusion of NRF24L01P and LoRa modules and IR sensors/diodes as well so that different cartridges can be created by populating different components:
- base cartridge (flash only)
- connected cartridge (flash + NRF/LoRA)
- IR remote (flash + IR)
Optional cartridges in next generation would include:
- camera (SPI models only with buffer)
- WiFi connected cartridge (ESP8266 or some such)
- many screws necessary for the 3D printed parts to fit
- order plexiglass covers (https://plasticexpress.cz/), fairly cheap
- don't use battery sense pin on AVR (either VCC if not charging, or show charging when charging) (saves 1pin)
- BQ25895 or when used this, we can read voltage & charging current for better visualization (saves 2 pins)
- rename the pins in the cartridge connector
- INA3221 can tell me charging, VBUS and VSYS all at once. Maybe worth a try?
- can then use smaller I2C charger w/o the status
Faryra (Epic Powerful Inspiring Dramatic Uplifting Motivational Emotional Cinematic Heroic Battle Adventure Building Hybrid Action Orchestral Trailer Music) by Audiorezout is licensed under a Attribution-NonCommercial 4.0 International License.