search

DavidGriffith / bluebox-avr

Bluebox firmware for AVR microcontrollers (moved to https://gitlab.com/DavidGriffith/bluebox-avr)
GNU General Public License v3.0
2 stars 1 forks source link

readme

This project has moved to https://gitlab.com/DavidGriffith/bluebox-avr

Bluebox AVR

Bluebox AVR implements a bluebox (see https://en.wikipedia.org/wiki/Blue_box) on AVR microcontrollers (currently only the ATtiny85). This project is roughly a reimplementation of the PIC-based bluebox at http://projectmf.org/bluebox.html.

The hardware for this bluebox is found at https://github.com/DavidGriffith/bluebox-esquire

Description

Currently only 13 keys are supported. These are arranged in a 3 x 4 rectangle with the 13th key appearing at the very top by itself. That one is reserved for playing the 2600hz tone. The rest are as a standard telephone keypad.

Operation

There are currently five tone modes:

  1. MF: These emit MF tones 0 through 9 with KP and ST -- a standard bluebox.

  2. DTMF: Standard DTMF dialing tones

  3. Redbox:
    US Nickel US dime US quarter
    Canada nickel Canada dime Canada quarter
    UK 10 pence UK 50 pence .
    . . .

  4. Greenbox (the first two rows have a 2600hz wink.
    The next two rows have a 900hz + 1500hz wink):
    Coin collect Coin return Ringback
    Operator attach Operator release Op release and coin collect
    Coin collect Coin return Ringback
    Operator attach Operator release Op release and coin collect

  5. 2600hz pulse: Emits 2600hz pulses according to the number as on a rotary dial (0 is 10 pulses). This mode predates MF tones. This was how John Draper (aka Cap'n Crunch) and Joe Engressia Jr. (aka Joybubbles) were able to phreak using a whistled 2600hz tone.

Mode is selected by holding down the key corresponding to the mode's number while switching the unit on. A 1700hz tone will play to let you know that you've switched modes. To set the startup mode, hold the 2600hz key while turning the unit on. This will cause a 1700hz tone to play. Then press a key for the mode you want to set as the startup mode. Two tones will then play to let you know that your desired mode has been saved to memory. Similarly, you can toggle the tone length of MF and DTMF tones between 75 milliseconds and 120 milliseconds by holding the hash key (#).

Building and Installing

Building the bluebox firmware requires GCC-AVR, preferably in a Linux or BSD environment. To write the firmware to a completed board, you will need AVRDUDE. Both of these tools are usually available in Linux and BSD software repositories. You will also need an AVR programming device. Ladyada's USBtinyISP (https://www.adafruit.com/product/46) is inexpensive, easy to use, and will do the job nicely.

Typing "make" will show you a list of build targets:

This Makefile has no default rule. Use one of the following:
make hex ........ to build bluebox.hex
make program .... to flash fuses and firmware
make eeprom ..... to extract EEPROM data from .elf file and program the device with it.
make fuse ....... to flash the fuses
make flash ...... to flash the firmware (use this on metaboard)
make clean ...... to delete objects and hex file