{"id":19517343,"url":"https://github.com/saornek/kimberlina","last_synced_at":"2026-05-01T20:33:05.777Z","repository":{"id":187865866,"uuid":"464579221","full_name":"saornek/Kimberlina","owner":"saornek","description":"Kimberlina is a tournament battle bot inspired by Star Wars IG- 227 Hailfire – Class Droid. You can read more information on Kimberlina in the Mag Pi 116 Issue","archived":false,"fork":false,"pushed_at":"2023-10-14T16:38:11.000Z","size":5293,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-26T00:12:10.800Z","etag":null,"topics":["battlebot","bluetooth","kimberlina","micropython","raspberry-pi"],"latest_commit_sha":null,"homepage":"http://www.selinoid.com/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/saornek.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"MIT-LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-02-28T17:28:11.000Z","updated_at":"2023-11-25T15:22:14.000Z","dependencies_parsed_at":"2023-08-12T13:28:31.712Z","dependency_job_id":"474a7915-ae45-4526-9fdf-9782623fb2ea","html_url":"https://github.com/saornek/Kimberlina","commit_stats":null,"previous_names":["saornek/kimberlina"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/saornek/Kimberlina","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saornek%2FKimberlina","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saornek%2FKimberlina/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saornek%2FKimberlina/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saornek%2FKimberlina/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/saornek","download_url":"https://codeload.github.com/saornek/Kimberlina/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saornek%2FKimberlina/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32512665,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-30T13:12:12.517Z","status":"online","status_checked_at":"2026-05-01T02:00:05.856Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["battlebot","bluetooth","kimberlina","micropython","raspberry-pi"],"created_at":"2024-11-11T00:02:38.521Z","updated_at":"2026-05-01T20:33:05.753Z","avatar_url":"https://github.com/saornek.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kimberlina\n![Kimberlina](http://www.selinoid.com/wp-content/uploads/2021/09/Kimberlina_No_Background-300x300.png)\n\nKimberlina is a tournament battle bot inspired by Star Wars IG- 227 Hailfire – Class Droid. You can read more information on Kimberlina in the [Mag Pi 116 Issue](https://magpi.raspberrypi.com/issues/116)\n\n## Software\nPlease keep the [main.py](https://github.com/saornek/Kimberlina/blob/main/main.py) with the main.py name for it to be able to start on boot. \n\n### Software Explanation\nFirst we will need to import to required libraries.\n```sh\nfrom machine import Pin,UART,PWM\nfrom time import sleep\n```\n---\nSecondly, we need to configure the bluetooth port and the pins for the motors and servos.\nTo configure the bluetooth port:\n```sh\n#The baud rate might be setup different in your bluetooth module or the other devices code please change accordingly.\nuart = UART(0,9600) \n```\n\nTo configure the motor ports:\n```sh\nleftMotorFront = Pin(10, Pin.OUT) #For Left Motor Forward Movement\nleftMotorBack = Pin(11, Pin.OUT) #For Left Motor Backward Movement\nrightMotorFront = Pin(12, Pin.OUT) #For Right Motor Forward Movement\nrightMotorBack = Pin(13, Pin.OUT) #For Right Motor Backward Movement\n\nservoFlip = PWM(Pin(14))\nservoPush = PWM(Pin(15))\n```\n---\nThirdly, we need to adjust the servo settings.\nWe set up three constants which are in nanoseconds indicating the min position and the max position. These numbers might change according to your servo type and placement.\n```sh\nMIN = 1000000\nMAX = 2000000\n```\n\nWe then set its initial frequency to 50. \n```sh\nservoFlip.freq(50)\nservoFlip.duty_ns(MIN)\nservoPush.freq(50)\nservoPush.duty_ns(MIN)\n```\n---\n\nLastly, we await for the commands from the app to start the motors.\n```sh\nwhile True:\n    if uart.any():\n        command = uart.readline()\n        if 'a' in command: #Forward Button\n            leftMotorFront.high()\n            rightMotorFront.high()\n```          \n\n\n## Hardware\n### Parts You Need\n* Raspberry Pi Pico\n* HC-05 Bluetooth Module\n* L298N DC Motor Driver\n* Step-Down Voltage Regulator\n* 3001HB Servo (x2)\n* 12v 125RPM DC Motor (x2)\n* Ball Caster (x2)\n* PLA Filament\n* Tough PLA and PLA Filament\n* 9mm steel bearing balls\n\n### Connections\n![alt text](https://github.com/saornek/Kimberlina/blob/main/KimberlinaCircuit.jpg)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaornek%2Fkimberlina","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsaornek%2Fkimberlina","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaornek%2Fkimberlina/lists"}