You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* reorganise hardware
* remove older containing directories
* add i2c header note
* fix first revision issues
* add version 1.1 number
* update hole sizes
* correct rev number
* add lcsc number to diode
* rewrite for clarity
Updated descriptions for hardware versions to include links and improve clarity.
* rework readme for readability
* remove outdated note
* move 3d model
* move skiff instructions to th dir
* reword input detection note
Clarified the technical specifications by mentioning the addition of hardware for input detection.
* reword and correct links
* rework shields and intro text
* correct shield links
* remove erroneous bullet point
* Create build_guide.md
* minor edits
* add kit sale link
The EuroPi is a user reprogrammable [Eurorack](https://en.wikipedia.org/wiki/Eurorack) module developed by [Allen Synthesis](https://www.allensynthesis.co.uk) that uses the [Raspberry Pi Pico](https://www.raspberrypi.com/products/raspberry-pi-pico/) to process and produce modular level signals based on code written in [MicroPython](https://micropython.org/). The entire project is open-source.
2
4
5
+
## Documentation
6
+
### Hardware
7
+
The hardware source files and documentation (including build guides) can be found in the [hardware overview](hardware/README.md), and kits can be bought directly from [Allen Synthesis](https://allensynthesis.square.site/product/europi-panel-pcb/16?cp=true&sa=true&sbp=false&q=false).
3
8
4
-
The EuroPi is a fully user reprogrammable module based on the [Raspberry Pi Pico](https://www.raspberrypi.com/products/raspberry-pi-pico/), which allows users to process inputs and controls to produce outputs based on code written in Python. The entire project is open-source.
9
+
### Software
10
+
Before using any of the software, follow the [programming_instructions](software/programming_instructions.md) to set up and calibrate your module.
11
+
A list of user contributed scripts (along with descriptions for their usage) can be found in [contrib/README.md](software/contrib/README.md).
The EuroPi firmware allows you to interact with the hardware easily using code written in MicroPython. You can read the full list of available functions in the [EuroPi API Documentation](https://allen-synthesis.github.io/EuroPi/), which also includes some examples of some of those functions can be used. Some of the less obvious but potentially useful functions are also explained in more depth in [interesting_things.md](software/interesting_things.md).
21
14
22
-
</p>
23
-
24
-
---
25
-
26
-
This repository relates to the EuroPi module, however some users may be expecting to see what is now referred to as the 'EuroPi Prototype'. The repository for this (now deprecated) module [can be found here](https://github.com/roryjamesallen/EuroPi-Prototype)
27
-
28
-
You can find more about this and other projects of mine on [my website](https://www.allensynthesis.co.uk)
If you would like to extend any of the features of the EuroPi software, you can view the [firmware source code](software/firmware/europi.py), and make contributions of your own after reading the [contribution guidelines](contributing.md).
33
16
17
+
## Specification
34
18
* 6 0-10V Control Voltage outputs, each with indicator LED
35
19
* 2 Knobs with 12 bit resolution
36
20
* 2 Push Buttons
@@ -39,39 +23,10 @@ You can find more about this and other projects of mine on [my website](https://
39
23
* 128x32 OLED Display
40
24
* I²C expansion header on the rear for extra sensors or outputs
41
25
42
-
### Improvements on the Prototype version
43
-
44
-
* All outputs are the full Eurorack unipolar range of 0-10V, previously only 0-3.3V
45
-
* Two inputs, previously no way to accept input from other modules
46
-
* The buttons have hardware debouncing to allow users to change out capacitor values for reduced accidental 'double click'
47
-
* A 10 pin Eurorack shrouded power header is now used to prevent accidental reverse powering of the module
48
-
* The 5V supply for the Pico is now regulated down from the +12V supply, so no 5V rail is required from your Eurorack power supply
49
-
* The power supply is now diode protected to prevent back-powering your rack when the module is connected via USB
50
-
* All jacks are protected from overvoltage input (previously the Pico GPIO pin was directly exposed to any input, potentially leading to damage)
51
-
52
-
### Documentation
53
-
54
-
**Hardware**: Details of the hardware can be found at [hardware README](hardware/EuroPi/README.md). Additionally the [BoM](hardware/EuroPi/bill_of_materials.md) and the [build guide](hardware/EuroPi/build_guide.md) can be found in the hardware folder.
55
-
56
-
57
-
**Software**: Before using any of the software, follow the instructions in [programming_instructions.md](software/programming_instructions.md) to set up and calibrate your module.
58
-
59
-
A list of user contributed scripts and their usage can be found in [contrib/README.md](software/contrib/README.md).
60
-
There is also a [YouTube playlist](https://www.youtube.com/playlist?list=PLbingtr9KGPUdIODLWgzgAdIyN497YyEs) showcasing EuroPi and some of the different scripts available.
61
-
62
-
The EuroPi firmware API documentation can be found at https://allen-synthesis.github.io/EuroPi/. This documentation will explain all of the available features of the EuroPi firmware API. It also includes some examples of how to use various features of the firmware as well as [interesting_things.md](software/interesting_things.md).
63
-
64
-
If you would like to extend any of the features of the EuroPi software, you can view the firmware source code at [europi.py](software/firmware/europi.py).
65
-
66
-
### Issues
67
-
If you find any bugs, either in the software, the hardware, or the documentation, please create an Issue by clicking the 'Issue' tab along the top.
68
-
Please feel free to create any issue you see fit, I'll either attempt to fix it or explain it.
69
-
There are Issue templates available, so please choose whichever is most relevant, depending on if your Issue is a hardware or software bug, if it's a documentation error or suggestion, if it's a question about the project as a whole, or a suggestion about the project as a whole.
This module, and any documentation included in this repository, is entirely "free" software and hardware, under different licenses depending on the software, hardware, and documentation itself.
28
+
## License
29
+
This module, and any documentation included in this repository, is entirely "free" software and hardware. The hardware is [certified by the Open Source Hardware Association].(https://certification.oshwa.org/uk000048.html)
75
30
76
31
* Software: [Apache 2.0](software/LICENSE)
77
32
* Hardware: [CERN OHL-S v2](hardware/LICENSE)
@@ -82,6 +37,19 @@ The only thing I would ask is that you refrain from using the brand name 'Allen
82
37
83
38
If you have a bug fix or improvement that you think is worth sharing, then feel free to send over any pictures or documentation and it can be merged with the main project!
84
39
40
+
## Issues
41
+
If you find any bugs, either in the software, the hardware, or the documentation, please [create a GitHub issue](https://github.com/Allen-Synthesis/EuroPi/issues/new/choose) so it can be fixed by one of the maintainers. There are issue templates available, so please choose whichever is most relevant.
42
+
85
43
### Disclaimer
44
+
Recreate any of the files found in this repository at your own risk; I will attempt to solve any issues that you might have with my designs, but I can't guarantee that there are not minor bugs in any of the documents, both hardware and software. If you want a module or kit that you know will work and will have customer support, you can order one directly from [Allen Synthesis](https://allensynthesis.co.uk/).
86
45
87
-
Recreate any of the files found in this repository at your own risk; I will attempt to solve any issues that you might have with my designs, but I can't guarantee that there are not minor bugs in any of the documents, both hardware and software.
46
+
### EuroPi Prototype
47
+
This repository relates to the EuroPi module, however some users may be expecting to see what is now referred to as the 'EuroPi Prototype'. The repository for this (now deprecated) module [can be found here](https://github.com/roryjamesallen/EuroPi-Prototype)
48
+
#### Improvements on the Prototype version
49
+
* All outputs are the full Eurorack unipolar range of 0-10V, previously only 0-3.3V
50
+
* Two inputs, previously no way to accept input from other modules
51
+
* The buttons have hardware debouncing to allow users to change out capacitor values for reduced accidental 'double click'
52
+
* A 10 pin Eurorack shrouded power header is now used to prevent accidental reverse powering of the module
53
+
* The 5V supply for the Pico is now regulated down from the +12V supply, so no 5V rail is required from your Eurorack power supply
54
+
* The power supply is now diode protected to prevent back-powering your rack when the module is connected via USB
55
+
* All jacks are protected from overvoltage input (previously the Pico GPIO pin was directly exposed to any input, potentially leading to damage)
0 commit comments