
SCLF Gripper Test bench
Tknika-SCLF/sclf-gripper
Deskargatu eta instalatu Antigravity bere webgune ofizialetik. VSCode/Windsurf-en fork bat da eta modu berean funtzionatzen du.

Deskargatu eta instalatu Antigravity bere webgune ofizialetik. VSCode/Windsurf-en fork bat da eta modu berean funtzionatzen du.
SCLF Gripper is an open-source printed circuit board by Tknika-SCLF, from the Tknika-SCLF/sclf-gripper repository on GitHub. It is a 4-layer board of 67.4 × 67.4 mm with 78 parts on 92 nets, routed with 1,112 tracks and 160 vias.
It is built around the STM32G474CEU6, MAX3485ED and DRV8316CRRGFR, with the MT6701QT-STD, XC6206P332MR and TSA002A3512A02 among its other parts. Its parts include 33 capacitors, 18 resistors, 6 diodes, 5 ICs and 3 connectors. It belongs with the STM32 boards of this library.
Tknikaren SCLF Gripper-erako motor kontrolagailuaren firmwarea. STM32G474CEU6 · SimpleFOC · PlatformIO · Antigravity IDE Lizentzia: CC BY-SA 4.0
⚠️ GARRANTZITSUA: Proiektu honekin lanean hasi aurretik, mesedez irakurri beti
TASKS.mdfitxategia. Bertan aurkituko duzu proiektuaren uneko egoera zehatza eta garatzaileen arteko hurrengo urratsak zeintzuk diren.
Ingurunea konfiguratuta baduzu dagoeneko:
# 1. Konpilatu
pio run
# 2. Flasheatu (ST-Link konektatuta)
pio run --target upload
# 3. Serie-monitorea (Gripper-aren USB-C PC-ra)
pio device monitor --baud 115200Deskargatu eta instalatu Antigravity bere webgune ofizialetik. VSCode/Windsurf-en fork bat da eta modu berean funtzionatzen du.
⚠️ PlatformIO ez dago Open VSX-en (Antigravity-ren marketplace-a). Bi hedapenak eskuz instalatu behar dira
.vsixfitxategietatik.
2a. Joan hona: https://github.com/microsoft/vscode-cpptools/releases/latest
Deskargatu zure sistema eragileari dagokion fitxategia:
| Sistema | Deskargatu beharreko fitxategia |
|---|---|
| Windows (64-bit) | cpptools-windows-x64.vsix |
| macOS (Apple Silicon) | cpptools-macOS-arm64.vsix |
| macOS (Intel) | cpptools-macOS-x64.vsix |
| Linux (64-bit) | cpptools-linux-x64.vsix |
2b. Antigravity-n: Hedapenak / Extensions (Ctrl+Shift+X) → ··· ikonoa (hiru puntu) → Install from VSIX → hautatu deskargatutako .vsix fitxategia.
3a. Joan hona: https://github.com/platformio/platformio-vscode-ide/releases/latest
Ireki azken bertsioaren "Assets" atala eta deskargatu fitxategia (adibidez: platformio-ide-3.3.3.vsix).
3b. Antigravity-n: Hedapenak / Extensions (Ctrl+Shift+X) → ··· → Install from VSIX → hautatu deskargatutako .vsix fitxategia.
3c. Berrabiarazi Antigravity. PlatformIOk bere mendekotasunak automatikoki instalatuko ditu lehenengo aldian (2-5 minutu har ditzake).
⚠️ Ohar garrantzitsua: PlatformIOren instalazioa Antigravity-n ez dago ofizialki onartuta. Konpilazio edo igoera (upload) arazoak badituzu, kontsultatu Arazoen Konponbidea atala dokumentu honen amaieran.
💡 Zer da Open VSX? Kode irekiko luzapenen erregistro alternatiboa da (Eclipse Foundation-ek kudeatua). Antigravity-k eta VSCodium-ek ofizialki erabiltzen duten biltegia da, Microsoft-en murrizketak ekiditeko, eta segurua da.
4a. Joan hona: https://open-vsx.org/extension/marus25/cortex-debug
Eskuin aldean dagoen "Version" goitibeherako menuan, hautatu "Pre-release" jartzen EZ duen azken bertsio egonkorra (adibidez: 1.12.1). Ondoren, sakatu azpian agertzen den DOWNLOAD botoi morean .vsix fitxategia eskuratzeko.
4b. Instalatu aurrekoak bezala (Install from VSIX).
4c. OpenOCD konfiguratzea:
💡 Albiste ona: Ez duzu ezer deskargatu edo instalatu behar! PlatformIO-k automatikoki deskargatzen du OpenOCD lehenengo aldiz proiektua konpilatzen edo plakan kargatzen duzunean. Bere kokapena hau izaten da Windows-en:
C:\Users\ZURE_ERABILTZAILEA\.platformio\packages\tool-openocd\bin\openocd.exe
(Cortex-Debug-ek errorea ematen badu OpenOCD ez duela aurkitzen esanez, joan Antigravity-ren ezarpenetara eta ezarri ibilbide hori cortex-debug.openocdPath aukeran).
Proiektua klonatzeko Git instalatuta izan behar duzu.
5a. Joan hona: https://git-scm.com/downloads
5b. Deskargatu eta instalatu zure sistema eragilearen bertsioa (lehenetsitako aukerak mantendu ditzakezu instalazioan).
# Klonatu edo kopiatu firmwarearen karpeta
# Ireki Antigravity erro karpetan (platformio.ini dagoen lekuan)Antigravity-n: File → Open Folder → hautatu SCLF_Gripper_firmware/ karpeta.
PlatformIOk automatikoki detektatuko du platformio.ini eta honako hauek deskargatuko ditu:
ststm32framework-arduinoststm32toolchain-gccarmnoneeabiSimpleFOC liburutegiaAntigravity-ren beheko barran, egin klik PlatformIOren ✓ (Build) ikonoan, edo terminaletik:
pio runEspero den emaitza:
[SUCCESS] Took X.XX seconds
RAM: [= ] X.X% (used XXXX bytes from 131072 bytes)
Flash: [= ] X.X% (used XXXXX bytes from 524288 bytes)Konpilatzen ez badu → ikusi Arazoen Konponbidea.
Konektatu ST-Link SCLF Gripper-aren SWD atakara:
| Pin ST-Link | Pad Gripper | Seinalea |
|---|---|---|
| SWDIO | DIO | PA13 |
| SWCLK | CLK | PA14 |
| RST | RST | PG10 |
| GND | GND | — |
| 3.3V | 3V3 | (STM32 soilik elikatzen du, ez encoderra ez driverra) |
⚠️ Elikadura:
- ST-Link-aren 3.3V pina nahikoa da STM32 flasheatzeko eta encoderra (MT6701) elikatzeko. Bera bakarrik probatu dezakezu 24V konektatu gabe.
- BAINA DRV8316 driverrak eta motorrak 24V kanpokoa behar dute. Test osoetarako (motorra mugitu), beti konektatu 24V elikadura.
Flasheatu:
pio run --target uploadEspero den emaitza: [SUCCESS] eta D4 LEDa (PC6) keinuka hasiko da.
Test konplexuak egin aurretik, egiaztatu STM32 abiarazten dela:
build_src_filter platformio.ini-n:
build_src_filter = +<../examples/fase0_led_heartbeat>pio run --target upload erabiliz.build_src_filter Fase 1.1-era itzuli nahi duzunean.⚠️ Baldintzak: ST-Link-aren 3.3V konektatuta izatea nahikoa da encoderra elikatzeko. Ez da 24V behar fase honetarako.
fase1_1_mt6701_test-eko firmware-ak D4 LEDa diagnostiko bisual modura erabiltzen du (Serial gabe):
build_src_filter horrela dagoela platformio.ini-n:
build_src_filter = +<../examples/fase1_1_mt6701_test> +<encoder/>pio run --target upload| LED portaera | Esanahia |
|---|---|
| 3 keinu azkar abiaraztean | setup() ondo amaituta |
| LED motela (700ms, ~0.7Hz) | Motorra lehen erdibiraketan (0°-180°) |
| LED azkarra (80ms, ~6Hz) | Motorra bigarren erdibiraketan (180°-360°) |
| Motorra biratzean aldatzen da ✅ | MT6701 encoderrak funtzionatzen du! |
| Beti azkar aldaketarik gabe | SPI-k 0xFFFF bueltatzen du → encoderrak elikadurarik ez |
✅ LEDak motorra biratzean aldatzen badu, Fase 1.1 gaindituta dago.
✅ EGOERA: Ondo funtzionatzen du. Firmwareak
SystemClock_Configbloke bat daukamain.cpp-n STM32G4-ren USB periferikorako behar den HSI48 osziladorea gaitzeko.
pio device monitor --baud 115200MT6701 Raw (con o sin 24V): X edo biratzean aldatzen den balio bat).examples/)Proiektu honen firmware garapena fase ezberdinetan banatuta dago (ikusi TASKS.md). Fase bakoitzean idatzitako kode-probak (test standalone-ak) examples/ karpetaren barruan gordetzen dira.
Hardware berria muntatzen baduzu edo sentsore zehatz bat probatu nahi baduzu:
examples/ karpetan eta aukeratu fasea (adib. phase1_1_mt6701_test, phase1_2_drv_spi, phase1_4_rs485_ping, phase3_2_rs485_control edo phase3_3_ur_rs485).README.md fitxategia argibide zehatzak ikusteko.
main.cpp fitxategia eta ordezkatu zure probako src/main.cpp fitxategiarekin (edo erabili dagokion ingurunea platformio.ini-n).pio run --target upload).Antigravity-n barneratuta dagoen IA laguntzailearekin lan egiteko:
Irakurri testuinguru-fitxategi hauek lagundu aurretik:
- AGENT.md (hardwarea, pinak, arkitektura)
- MEMORY.md (uneko egoera, kalibratutako parametroak)
- TASKS.md (orain lantzen ari naizen zeregina)
- RULES.md (sortutako kodeak errespetatu behar dituen arauak)TASKS.md-tik.SCLF_Gripper_firmware/
│
├── src/
│ ├── main.cpp ← Sarrera puntua. 0 FASEA: smoke test
│ ├── config/
│ │ └── pins.h ← Pin GUZTIAK. Eskematikoarekin egiaztatuta.
│ ├── encoder/
│ │ ├── MT6701.h ← Encoder-aren APIa (eskeletoa prest)
│ │ └── MT6701.cpp ← 1.1 FASEAN inplementatu
│ ├── motor/
│ │ ├── DRV8316.h ← Gate driver-aren APIa (eskeletoa prest)
│ │ └── DRV8316.cpp ← 1.2 FASEAN inplementatu
│ ├── comms/
│ │ ├── RS485.h ← RS-485 APIa
│ │ └── RS485.cpp ← RS-485 inplementazioa
│ └── faults/
│ ├── FaultManager.h ← Akats kudeatzailearen APIa (eskeletoa prest)
│ └── FaultManager.cpp ← 6 FASEAN inplementatu
│
├── lib/ ← Bertako liburutegiak
├── test/ ← PlatformIO Unity testak (8 FASEA)
│
├── examples/
│ ├── phase0_led_heartbeat/ ← 0 Fasea: LED keinua menpekotasunik gabeProiektu hau berezibila eta antolatua izateko garatu da:
main.cpp ("Zuzendaria"): FOC kontrol-begizta eta hasierako konfigurazioa soilik ditu. Ez da kode nahaspilatuz betetzen..cpp espezifikoak ("Musikariak"): Txip bakoitzak bere artxibo dedikatua dauka bere funtzio jakingarriagoetarako (adibidez MT6701.cpp posizioa zuzenean irakurtzeko erroreak kontrolatuz, edo DRV8316.cpp tenperatura edo zirkuitulabur kasuez informatzeko).main.cpp-ak oinarrizko aginduak ematen ditu, eta modulu bakoitzak badaki bere tresna zehazki nola erabili, etorkizuneko hardware aldaketak izugarri erraztuz.Antigravity barruan proiektu hau garatzean, Arau Zorrotzak (RULES.md) ezarrita daude:
delay(), HAL_Delay edo while() begizta infiniturik FOC exekuzioan. SimpleFOC-ek mikroren %100 erabiltzea eskatzen du korrontea denbora errealean kalkulatzeko. Mikroa "lotaratzeak" motorra edo driverra segundo batean erretzea ekar dezake.foc-hardware-setup Tresna (Skill): Kodea garatzen hasi aurretik, gure IA laguntzaileak badu tresna espezifiko bat KiCad-eko eskema elektrikoak zuzenean irakurtzeko (.kicad_sch) eta pins.h fitxategi ezin hobea sortzeko, inolako giza-akatsik gabe. Zure laguna da, erabili proiektuaren azken pinen zehaztapenak egiaztatzeko!pio run # Konpilatu
pio run --target upload # Konpilatu eta flasheatu (ST-Link)
pio run --target upload_dfu # USB DFU bidez flasheatu (BOOT + RST)
pio device monitor # Serie-monitorea (USB VCP, 115200 baud)
pio test # Test unitarioak exekutatu
pio run --target clean # Konpilazio-artefaktuak garbitu
pio lib install "Simple FOC" # Eskuz instalatu liburutegia
pio pkg update # Plataforma eta liburutegiak eguneratuST-Link erabilgarririk ez baduzu, USB DFU bidez flashea dezakezu:
upload_protocol = dfu fitxategian platformio.ini.pio run --target upload.💡 Oharra ST-Link gabe DFU erabiltzearen inguruan (PA9 pina): Ohiko STM32etan (F1/F4), USB kablea konektatuta dagoela nabaritzeko (VBUS sensing)
PA9pina erabiltzen da. Gure diseinuan, ordea,PA9pina motorraren B fasera (DRV8316) konektatuta dago (PIN_BH). Baina ez larritu! STM32G4 familiak VBUS sentsorea hardware bidez desgaituta dauka bere Bootloader nagusian (AN2606). Hori dela eta, DFU moduak primeran funtzionatuko du soilikPA11etaPA12datu-pinak erabiliz, hardware aldaketen beharrik gabe.⚠️ KONTUZ Arazketa (Debugging) egiteko orduan: Kontuan izan USB DFU metodoa "itsu-itsuan pentsatua" dela: kodearen irudia (
.bin) mikroaren memorian kargatzeko soilik balio du. Garapen-fasean zaudenean eta SimpleFOC motorraren ezusteko portaera bat ikertu behar duzunean, ezinbestekoa da ST-Link (edo SWD) bat erabiltzea. ST-Link batek zuzenean ARM Cortex muinera konektatzen zaituPA13/PA14bidez, eta aukera ematen dizu kodea pausatzeko (Breakpoints), aldagaien balioak denbora errealean irakurtzeko eta exekuzioa lerroz lerro aztertzeko VS Code-n. USB-ak ezin du horrelakorik egin.
# STM32 plataforma berrinstalatu
pio platform install ststm32
# Garbitu eta berriro konpilatu
pio run --target clean && pio runopenocd -f interface/stlink.cfg -f target/stm32g4x.cfg terminalean.ls /dev/ttyACM* erabiliz.-DUSBCON flag-ekin (berez aktibatuta proiektu honetan) USB CDC possesses setup() baino lehenago hasieratzen du. main.cpp-ren amaieran HSI48 aktibatzen duen SystemClock_Config(void) funtzioa falta bada, firmwarea blokeatu egiten da.examples/fase0_led_heartbeat (LED soilik, menpekotasunik gabe). Horrek ere funtzionatzen ez badu → elikadura edo kableatu arazoa.Ctrl+C erabiliz eta exekutatu pio device monitor berriro.Arduino.h edo STM32 header-ak aurkitzenCtrl+Shift+P → "C/C++: Reset IntelliSense Database".pio run --target upload exekutatzen barne terminaletik, PlatformIOko
UI botoiaren ordez.PlatformIOk batzuetan Microsoft-en hedapena instalatzea exijitzen du, nahiz eta eskuz instalatuta izan. Arazoa konpontzeko:
%USERPROFILE%\.antigravity\extensions\ (Windows) edo ~/.antigravity/extensions/ (Linux/macOS).platformio.platformio-ide-... izeneko karpetan.package.json fitxategia testu-editore batekin."extensionDependencies": ["ms-vscode.cpptools"] lerroa."extensionDependencies": []| Osagaia | Zatia | Datasheet-a |
|---|---|---|
| MCU | STM32G474CEU6 | ST.com |
| Gate Driver | DRV8316CRRGFR | TI.com |
| Encoder | MT6701QT | Magntek |
| RS-485 | MAX3485 | Analog |
| SimpleFOC | v2.x | docs.simplefoc.com |
Tknikak diseinatua — Licensed under CC BY-SA 4.0
| Qty | Value | Footprint | References |
|---|---|---|---|
| 10 | 100nF | Capacitor_SMD:C_0402_1005Metric | C4, C27, C30, C34, C36, C38, C42, C43, C47, C48 |
| 7 | 330 | Resistor_SMD:R_0402_1005Metric | R17, R22, R23, R24, R26, R31, R33 |
| 6 | 10uF | Capacitor_SMD:C_0805_2012Metric | C44, C45, C46, C52, C56, C57 |
| 6 | 1uF | Capacitor_SMD:C_0402_1005Metric | C23, C25, C26, C37, C40, C41 |
| 4 | 10k | Resistor_SMD:R_0402_1005Metric | R9, R21, R28, R32 |
| 4 | 5,1k | Resistor_SMD:R_0402_1005Metric | R2, R3, R16, R25 |
| 3 | 22pF | Capacitor_SMD:C_0402_1005Metric | C31, C32, C33 |
| 2 | 100k | Resistor_SMD:R_0402_1005Metric | R19, R20 |
| 2 | 100nF | Capacitor_SMD:C_0603_1608Metric | C3, C13 |
| 2 | 10pF | Capacitor_SMD:C_0402_1005Metric | C28, C29 |
| 2 | 22uF | Capacitor_SMD:C_0603_1608Metric | C35, C54 |
| 2 | LED | LED_SMD:LED_0603_1608Metric | D2, D4 |
| 2 | TSA002A3512A02 | USB:SW-SMD_BZCN_TSA002A35XXX | SW1, SW2 |
| 1 | 10uF-50V | Capacitor_SMD:C_1210_3225Metric | C1 |
| 1 | 120 | Resistor_SMD:R_0402_1005Metric | R10 |
| 1 | 1N4148WS | Diode_SMD:D_SOD-323_HandSoldering | D3 |
| 1 | 22uF-50V | Capacitor_SMD:C_2220_5750Metric | C2 |
| 1 | 3V3 | TestPoint:TestPoint_Pad_D1.0mm | TP2 |
| 1 | 47uH | Inductor_SMD:L_Changjiang_FTC303015D | L1 |
| 1 | AO3401A | Package_TO_SOT_SMD:SOT-23 | Q1 |
| 1 | BLM31PG330SN1 | Inductor_SMD:L_1206_3216Metric | L2 |
| 1 | BZT52B5V1S | Diode_SMD:D_SOD-323 | D1 |
| 1 | Conn_01x03 | Aimar:PinHeader_1x03_P2.54mm_Vertical_Center | J2 |
| 1 | Conn_01x05 | Aimar:PogoPinPads_1x05_P2.54mm | J1 |
| 1 | Coupling_02x05_Odd_Even | Aimar:Coupling_Conn_2x05_P2.54mm | J3 |
| 1 | Crystal_GND24 | Crystal:Crystal_SMD_Abracon_ABM8AIG-4Pin_3.2x2.5mm | X1 |
| 1 | DRV8316CRRGFR | USB:VQFN-40_L7.0-W5.0-P0.50-BL-EP5.7 | U1 |
| 1 | D_Schottky | Diode_SMD:D_SMC | D6 |
| 1 | Fuse | Fuse:Fuse_1206_3216Metric_Pad1.42x1.75mm_HandSolder | F1 |
| 1 | GND | TestPoint:TestPoint_Pad_D1.0mm | TP1 |
| 1 | LOGO | Aimar:QR | G |
| 1 | MAX3485 | Package_SO:SOIC-8_3.9x4.9mm_P1.27mm | U4 |
| 1 | MT6701QT | Package_DFN_QFN:QFN-16-1EP_3x3mm_P0.5mm_EP1.7x1.7mm | U8 |
| 1 | SMAJ33CA | Diode_SMD:D_SMA | D5 |
| 1 | STM32G474CEU6 | Package_DFN_QFN:QFN-48-1EP_7x7mm_P0.5mm_EP5.6x5.6mm | U9 |
| 1 | TYPE-C 16PIN 2MD(073) | USB:USB-C-SMD_TYPE-C-6PIN-2MD-073 | USB1 |
| 1 | VIN | TestPoint:TestPoint_Pad_D1.0mm | TP3 |
| 1 | XC6206P332MR | Package_TO_SOT_SMD:SOT-23-3 | U10 |
The 77 most common of 78 parts.

Tknika-SCLF/sclf-gripper
Deskargatu eta instalatu Antigravity bere webgune ofizialetik. VSCode/Windsurf-en fork bat da eta modu berean funtzionatzen du.

clawntl/BLDC-Driver
BLDC Driver with STM32G431 and DRV8316

BarbourSmith/Maslow-Mini-Control-Board
A third KiCad project that puts both existing boards on one PCB:

HeyPCB/knuckle
35 mm round FOC driver for a GBM2804 gimbal motor that answers on the Open Duck Mini's servo bus as an STS3215. 6-layer KiCad 10 board plus printed standoff, cover and horn adapter.

ssbingo/samba-solar-track
Samba Solar Track – Solarnachführung mit Sturmschutz: Handbuch, Platine und Gehäuse für den Nachbau (10,1-Zoll-Version)

zinedkahitaf-lang/AKD-SAFE-SourceControl
Infrastructure-Based Active Engineering Safety Platform. Move the safety burden from the worker to the hazard. Engineering prototype - not a certified safety device.



ss1-ops/robotic-arm-5-digit-manipulator
BCN3D Moveo 6-DOF arm + custom Aero Hand gripper. ROS 2 Jazzy, ESP32-S3 micro-ROS, vision pick-and-place, full hardware/firmware/software stack.
It measures 67.4 × 67.4 mm and has 4 copper layers, 1.6 mm thick.
78 parts, built around the STM32G474CEU6, MAX3485ED, DRV8316CRRGFR and MT6701QT-STD. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.
From the Tknika-SCLF/sclf-gripper repository on GitHub, at the commit this page was made from: the board is hardware/SCLF_Gripper.kicad_pcb and its schematic hardware/SCLF_Gripper.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Its repository states no licence, so its author keeps all rights: ask Tknika-SCLF before reusing the design.