Source Code and Bug Tracking – Tinkerforge

- Getting Started
  - Primer
  - Tutorials
  - FAQ
- Hardware
  - Bricks
  - Bricklets
  - Master Extensions
  - Power Supplies
  - Accessories
  - Timeline
- Software
  - Brick Daemon (brickd)
  - Brick Viewer (brickv)
  - API Bindings
  - Firmwares and Plugins
  - Device Identifier
  - Source Code and Bug Tracking
    - Where and How do I report Bugs?
  - Programming Interface
- Starter Kits
  - Weather Station
  - Hardware Hacking
  - Server Room Monitoring
  - Blinkenlights
  - Internet of Things
  - Camera Slider
- Embedded Boards
  - Raspberry Pi
- Specifications
  - Technical Data
  - TCP/IP Protocol
  - Modbus Protocol
  - Wireshark Dissector

# Source Code and Bug Tracking

Every product that is released by Tinkerforge is Open Source. The firmware source as well as the hardware design files for all Bricks and Bricklets are available. Additionally the source code for all tools, such as the Brick Daemon, the Brick Viewer and the generators for the language bindings is available.

This means you can use all of the Tinkerforge hardware and software as a starting point for your own project, extend or modify it. Furthermore you can help us in the development effort and most importantly report bugs.

To make it easy for the community to commit patches and report bugs, all of the Tinkerforge projects are hosted on GitHub.

If you don't know git, you can find information here. Our projects can be cloned with:

    git clone git://github.com/Tinkerforge/PROJECT.git

Below is a list of the Tinkerforge project repositories and corresponding bug tracker.

| Repository | Bug Tracking
--- | --- | ---
Tools |  |
Brick Daemon | brickd.git | Report Bug
Brick Viewer | brickv.git | Report Bug
Brick Bootloader | brickboot.git | Report Bug
Brick Library | bricklib.git | Report Bug
Bricklet Library | brickletlib.git | Report Bug
API Generator | generators.git | Report Bug
KiCad Libraries | kicad-libraries.git | Report Bug
Bricks |  |
DC | dc-brick.git | Report Bug
Debug | debug-brick.git | Report Bug
IMU | imu-brick.git | Report Bug
Master | master-brick.git | Report Bug
RED | red-brick.git | Report Bug
Servo | servo-brick.git | Report Bug
Stepper | stepper-brick.git | Report Bug
Bricklets |  |
Ambient Light | ambient-light-bricklet.git | Report Bug
Analog In | analog-in-bricklet.git | Report Bug
Analog Out | analog-out-bricklet.git | Report Bug
Barometer | barometer-bricklet.git | Report Bug
Breakout | breakout-bricklet.git | Report Bug
Color | color-bricklet.git | Report Bug
Current12 | current12-bricklet.git | Report Bug
Current25 | current25-bricklet.git | Report Bug
Distance IR | distance-ir-bricklet.git | Report Bug
Distance US | distance-us-bricklet.git | Report Bug
Dual Button | dual-button-bricklet.git | Report Bug
Dual Relay | dual-relay-bricklet.git | Report Bug
GPS | gps-bricklet.git | Report Bug
Hall Effect | hall-effect-bricklet.git | Report Bug
Humidity | humidity-bricklet.git | Report Bug
Industrial Digital In 4 | industrial-digital-in-4-bricklet.git | Report Bug
Industrial Digital Out 4 | industrial-digital-out-4-bricklet.git | Report Bug
Industrial Dual 0-20mA | industrial-dual-0-20ma-bricklet.git | Report Bug
Industrial Quad Relay | industrial-quad-relay-bricklet.git | Report Bug
IO-16 | io16-bricklet.git | Report Bug
IO-4 | io4-bricklet.git | Report Bug
Joystick | joystick-bricklet.git | Report Bug
LCD 16x2 | lcd-16x2-bricklet.git | Report Bug
LCD 20x4 | lcd-20x4-bricklet.git | Report Bug
LED Strip | led-strip-bricklet.git | Report Bug
Line | line-bricklet.git | Report Bug
Linear Poti | linear-poti-bricklet.git | Report Bug
Moisture | moisture-bricklet.git | Report Bug
Motion Detector | motion-detector-bricklet.git | Report Bug
Multi Touch | multi-touch-bricklet.git | Report Bug
NFC/RFID | nfc-rfid-bricklet.git | Report Bug
Piezo Buzzer | piezo-buzzer-bricklet.git | Report Bug
Piezo Speaker | piezo-speaker-bricklet.git | Report Bug
PTC | ptc-bricklet.git | Report Bug
Remote Switch | remote-switch-bricklet.git | Report Bug
Rotary Encoder | rotary-encoder-bricklet.git | Report Bug
Rotary Poti | rotary-poti-bricklet.git | Report Bug
Segment Display 4x7 | segment-display-4x7-bricklet.git | Report Bug
Solid State Relay | solid-state-relay-bricklet.git | Report Bug
Sound Intensity | sound-intensity-bricklet.git | Report Bug
Temperature | temperature-bricklet.git | Report Bug
Temperature IR | temperature-ir-bricklet.git | Report Bug
Tilt | tilt-bricklet.git | Report Bug
Voltage | voltage-bricklet.git | Report Bug
Voltage/Current | voltage-current-bricklet.git | Report Bug
Master Extensions |  |
Chibi | chibi-extension.git | Report Bug
Ethernet | ethernet-extension.git | Report Bug
RS485 | rs485-extension.git | Report Bug
WIFI | wifi-extension.git | Report Bug
Power Supplies |  |
Step-Down | step-down-powersupply.git | Report Bug
Accessories |  |
DC Jack Adapter | dc-adapter.git | Report Bug

## Where and How do I report Bugs?

If you found a bug in one of the Tinkerforge projects, we would love if you could report it! First of all, you have to identify the correct repository for your problem:

Bugs that are specific to a Brick/Bricklet (e.g. a specific parameter of a function in a Brick/Bricklet does not work or there is a hardware bug on a Brick/Bricklet) and bugs in the Brick Daemon and Brick Viewer can be reported to the obviously belonging repository.

However, if the bug is in every Brick (e.g. Stack communication is erroneous or a bug in the USB communication) report to the Brick Library repository. If it is in every Bricklet (e.g. the timing of recurring events is wrong) report to the Bricklet Library repository. If it is in the API or the API Documentation (e.g. typo in the API of a Brick/Bricklet or wrong statement in the documentation of a Brick/Bricklet) report to the API Generator repository.

For us it is important that we can reproduce the bug you found. You should try to write anything in the bug report that is needed to reproduce your scenario. This includes code snippets that crash something, the setup of your hardware project or instructions how you connected Bricks and Bricklets.

The content of this page is licensed under Creative Commons Attribution 3.0 Unported License.