Browse Source
Added initial Bootloader, Mac OSX, Windows instructions
Instructions: - Windows virtual serial port - Mac OSX virtual serial port - Mac OSX firmware loading instructions - Initial Mac OSX building instructions - Initial Bootloader make and installation instructions for Linuxsimple
Jacob Alexander
9 years ago
1 changed files with 69 additions and 7 deletions
+ 69
- 7
README
View File
| ---------------------- | |||||
| Linux Building Bootloader | |||||
| ---------------------- | |||||
| *NOTE* Does not apply to Teensy based builds. | |||||
| From this directory. | |||||
| cd Bootloader | |||||
| mkdir build | |||||
| cd build | |||||
| cmake .. | |||||
| make | |||||
| Example output: | |||||
| TODO | |||||
| ---------------------- | |||||
| Linux Loading Bootloader | |||||
| ---------------------- | |||||
| *NOTE* Does not apply to Teensy based builds. | |||||
| It's recommended to use an SWD-type flasher like a Bus Pirate. | |||||
| TODO | |||||
| (Guidelines here https://github.com/mchck/mchck/wiki/Getting-Started) | |||||
| ---------------------- | ---------------------- | ||||
| Windows Building | Windows Building | ||||
| ---------------------- | ---------------------- | ||||
| From this directory. | From this directory. | ||||
| mkdir build | mkdir build | ||||
| cd build | cd build | ||||
| wincmake -G "Unix Makefiles" .. | |||||
| wincmake .. | |||||
| make | make | ||||
| Mac OS X Building | Mac OS X Building | ||||
| ---------------------- | ---------------------- | ||||
| From this directory. | |||||
| mkdir build | |||||
| cd build | |||||
| cmake .. | |||||
| make | |||||
| Example output: | |||||
| TODO | TODO | ||||
| Mac OS X Loading Firmware | Mac OS X Loading Firmware | ||||
| ---------------------- | ---------------------- | ||||
| TODO | |||||
| First place the keyboard into re-flash mode. | |||||
| This can be done either by pressing the re-flash button on the PCB/Teensy. | |||||
| Or by entering the Kiibohd Virtual Serial Port and using the 'reload' command. | |||||
| The 'load' script that is created during the build can load the firmware over USB. | |||||
| To load the newly built firmware: | |||||
| ./load | |||||
| Make sure the Teensy Virtual Serial Port driver is installed. | Make sure the Teensy Virtual Serial Port driver is installed. | ||||
| If possible use screen (as part of Cygwin). | If possible use screen (as part of Cygwin). | ||||
| Check which COM port the virtual serial port has been assigned to: | |||||
| Device Manager->Ports (COM & LPT)->Teensy USB Serial | |||||
| In brackets it will say which COM port (e.g. COM3) | |||||
| putty works well when using DTR/DSR or RTS/CTS flow control. | |||||
| Connection type: Serial | |||||
| Serial line: <Your COM port, e.g. COM3> | |||||
| Speed: (doesn't matter, it's auto-negotiated) | |||||
| screen /dev/ttyS3 | |||||
| Under Category->Connections->Serial | |||||
| Flow control: DTR/DSR | |||||
| If stuff is hard to read (you have a dumb colour scheme): | |||||
| Category->Window->Colours->Use system colur | |||||
| That seems to make text at least readable (I use a custom colour scheme that makes each colour easy to see -HaaTa). | |||||
| Unfortunately, screen for Cygwin seems to be broken for serial ports, but you can try it... | |||||
| screen /dev/ttyS2 | |||||
| (Might be a different file, ttyS0, ttyACM0, ttyUSB0, etc.) | (Might be a different file, ttyS0, ttyACM0, ttyUSB0, etc.) | ||||
| Gnu screen doesn't seem to echo all the characters (it works though). | Gnu screen doesn't seem to echo all the characters (it works though). | ||||
| I believe it's a problem with stty, but I don't know how to fix it... | I believe it's a problem with stty, but I don't know how to fix it... | ||||
| putty works well when using DTR/DSR or RTS/CTS flow control. | |||||
| ---------- | ---------- | ||||
| | Mac OS X | | | Mac OS X | | ||||
| ---------- | ---------- | ||||
| TODO (What is the usual device name). screen if possible. | |||||
| I recommend screen (can be installed via Macports). | |||||
| screen /dev/tty.<usb something> |