Skip to content
じゅん edited this page Jun 4, 2023 · 18 revisions

Welcome to the LrTMAX wiki!

What’s this?

LrTMAX is USB MIDI controller associated with Adobe Lightroom Classic & MIDI2LR .
LrTMAX photo

How this work?

LrTMAX act as MIDI controller in Lightroom system. LrTMAX has 8 buttons and 8 rotator dial, Once LrTMAX connects to PC/Mac, Then push button / rotate dial,
LrTMAX sends MIDI event assigned with buttons/dials.
LrTMAX expanded from LrE-6 6 to 8 dials.

Due to the nature of the embedded system,
this project does not explain individual development software as if it has learned how to use it.

How to define function assignments?

At This moment, MIDI channel definitions are in program source code. Details are described on “key_code.c”.
In future releases, definitions are set by PC/Mac.
(but,maybe not to do.)

How to build?

LrTMAX has made from 2 elements.

1. Print Circuit Board(PCB)

LrTMAX is embedded hardware project, that needs STM32 Micro-controller on board.
Repository contains PCB board gerber files and panel dimensions,
You can order Acril panel on manufacturing service(such as elecrow/seeed fusion etc.).
Using this gerber files and schematics And solder other electric components. Bills of Materials is placed on same folder with Gerber.

LrTMAX board

from LrTMAX board, that uses 4 layer pcb design. many of pcb manufacturers still expensive for 4 layer design, but JLCPCB services 4 layer PCB manufacturing with few extra fee.
If you not have confidence with soldering, You can order to assemble
all surface mount parts on board with PCB order.

2. Microcontroller firmware.

Firmware works on STM32 micro-controller, Watching whether buttons/dials are pushed and moved, Sending MIDI events to PC/Mac via USB...

What Equipments is needed?

1. STMicroelectronics 'ST-Link/V2' programmer debugger.

Used for programming STM32 chip.(key definitions also)
It's enough with cheap ST-V2 clones.

2. PC/Mac (development platform)

LrTMAX uses STMicroelectonics STM32CubeIDE
Download and install.
Of course Usable with PC/Mac running Lightroom.

3. type C(or MicroB) USB cable

USB type A/C - type C(or MicroB) cable
Please use fit on your PC/Mac.

4. PC/Mac installed Lightroom and MIDI2LR

MIDI events are sent by LrTMAX,converted into Lightroom edits/adjustments by MIDI2LR.

Building firmware from source

Now LrTMAX has only MIDI build.
After cloning this repository,Open project in STM32CubeIDE then Build.

About BOM

Almost of parts in BOM can buy at AliExpress .

About OLED module

Parts are generally sold in Aliexpress 0.91 inch OLED SSD1306 128x32 module.
(Please be careful, Do not buy module mounted on PCB board, Please choose like this...)
SSD1306 OLED 0.91in.

About Rotary Encoder

Due to height limitation, LrTMAX uses low profile rotary encoder parts (I call '9.5KQ'). It has little difference with rotary encoder generally sold as EC11 type.
Main difference is relation of pulse wave form and encoder click stop.
EC11 encoder returns both A,B signals to 'HH' state in every click stop.
But, 9.5KQ type of encoders A,B signals no return to 'HH' state,
It alters both 'HH' state and 'LL' state at every click stop.(see /Documents/Roatary_Encoder_Comparison.pdf in detail.)
Detect of rotation in firmware routines is differ EC11 and 9.5KQ.
LrTMAX uses and firmware implements for 9.5KQ, But if you want to use EC11 encoder on your board,
EC11 detection of rotation firmware routine is in brother LrE-6 repo., you can easily port to LrTMAX.

About CPU

BOM specifies STM32F072C8T6(64Kbytes Flash),But You can use STM32F072CBT6(128Kbytes Flash).

Licence

There's several Licences so many sources comes from.

Given and modified from CureMIDI

CC BY

Given and modified from stm32-ssd1306

MIT license

STM32 HAL driver

(in /Drivers/ folder)
BSD 3 clause Licence

USB Middleware from STMicro

(in /Middleware/ST/ folder)
SLA0044

Others, I wrote

BSD 3 Clause Licence

Links

STM32CubeIDE

https://www.st.com/en/development-tools/stm32cubeide.html

USB Device Class Definition for MIDI Devices

https://usb.org/sites/default/files/midi10.pdf

Special Thanks

5ちゃんねる デジカメ板 Lighroomスレのみなさん