diff --git a/README.md b/README.md
index 2489284df..80fa48185 100644
--- a/README.md
+++ b/README.md
@@ -1,36 +1,20 @@
+[](https://discord.gg/JaQwtCnBV5) [](https://www.reddit.com/r/EuroPi/) [](https://github.com/Allen-Synthesis/EuroPi/releases)
# EuroPi
+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.
+## Documentation
+### Hardware
+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).
-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.
+### Software
+Before using any of the software, follow the [programming_instructions](software/programming_instructions.md) to set up and calibrate your module.
+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).
-
-
----
-
-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)
-
-You can find more about this and other projects of mine on [my website](https://www.allensynthesis.co.uk)
-
-
-
-## Capabilities
+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).
+## Specification
* 6 0-10V Control Voltage outputs, each with indicator LED
* 2 Knobs with 12 bit resolution
* 2 Push Buttons
@@ -39,39 +23,10 @@ You can find more about this and other projects of mine on [my website](https://
* 128x32 OLED Display
* I²C expansion header on the rear for extra sensors or outputs
-### Improvements on the Prototype version
-
-* All outputs are the full Eurorack unipolar range of 0-10V, previously only 0-3.3V
-* Two inputs, previously no way to accept input from other modules
-* The buttons have hardware debouncing to allow users to change out capacitor values for reduced accidental 'double click'
-* A 10 pin Eurorack shrouded power header is now used to prevent accidental reverse powering of the module
-* 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
-* The power supply is now diode protected to prevent back-powering your rack when the module is connected via USB
-* All jacks are protected from overvoltage input (previously the Pico GPIO pin was directly exposed to any input, potentially leading to damage)
-
-### Documentation
-
-**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.
-
-
-**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.
-
-A list of user contributed scripts and their usage can be found in [contrib/README.md](software/contrib/README.md).
-There is also a [YouTube playlist](https://www.youtube.com/playlist?list=PLbingtr9KGPUdIODLWgzgAdIyN497YyEs) showcasing EuroPi and some of the different scripts available.
-
-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).
-
-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).
-
-### Issues
-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.
-Please feel free to create any issue you see fit, I'll either attempt to fix it or explain it.
-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.
-
-
-### License
+
-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.
+## License
+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)
* Software: [Apache 2.0](software/LICENSE)
* 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
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!
+## Issues
+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.
+
### Disclaimer
+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/).
-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.
+### EuroPi Prototype
+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)
+#### Improvements on the Prototype version
+* All outputs are the full Eurorack unipolar range of 0-10V, previously only 0-3.3V
+* Two inputs, previously no way to accept input from other modules
+* The buttons have hardware debouncing to allow users to change out capacitor values for reduced accidental 'double click'
+* A 10 pin Eurorack shrouded power header is now used to prevent accidental reverse powering of the module
+* 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
+* The power supply is now diode protected to prevent back-powering your rack when the module is connected via USB
+* All jacks are protected from overvoltage input (previously the Pico GPIO pin was directly exposed to any input, potentially leading to damage)
diff --git a/frequently_asked_questions.md b/frequently_asked_questions.md
index 80d053d7d..ab612cfd8 100644
--- a/frequently_asked_questions.md
+++ b/frequently_asked_questions.md
@@ -42,6 +42,5 @@
## Calibration
-NOTE: ADD THIS TO THE TROUBLESHOOTING GUIDE
| When in the second stage of calibration, my module never reaches 10V, what do I do? | Refer to the [troubleshooting guide](troubleshooting.md) |
|--|--|
diff --git a/hardware/EuroPi-X/README.md b/hardware/EuroPi-X/README.md
deleted file mode 100644
index ca71b8bed..000000000
--- a/hardware/EuroPi-X/README.md
+++ /dev/null
@@ -1,21 +0,0 @@
-# EuroPi X
-
-The EuroPi X is an improved hardware version of the EuroPi. Its exact feature set is yet to be decided, but likely additions are more inputs, more outputs, better noise performance for inputs, better accuracy for outputs, a larger display, and larger flash storage.
-
-Suggested features:
-- RGB LED per output
-- Output LEDs separately controlled to the output voltage
-- DAC outputs (>=12 bit)
-- More inputs
-- Higher performance CV inputs
-- Ability to use +5V rail instead of internally generate
-- Make unused GPIO and USB signals accessible from the back
-- Larger display (128x64 or larger)
-- Bipolar inputs
-- Bipolar outputs
-- Programmable I/O to allow unipolar or bipolar usage
-- Front access USB
-- Front access reset and bootsel
-- MicroSD slot for increased storage
-- Increased flash by default
-- Automatic detection of variant i.e. X or normal hardware
diff --git a/hardware/EuroPi/README.md b/hardware/EuroPi/README.md
deleted file mode 100644
index e6fb66e57..000000000
--- a/hardware/EuroPi/README.md
+++ /dev/null
@@ -1,23 +0,0 @@
-# Hardware Specifications
-
-## Outputs
-- 1k Output Impedance
-- RC filter smoothed PWM
-- ~1.5kHz Maximum usable frequency (without changing RC values)
-- 0.000176V Maximum ripple peak-to-peak
-- 0.0108s Settle time from 0% to 90% duty cycle
-- 0-10V
-
-## Analogue Input
-- 100k Input Impedance
-- 0-12V Readable Range
-- Protected for ±36V (TL074 limits, MCP6002 will always clip to ±3.3V)
-
-## Digital Input
-- 100k Input Impedance
-- 0.8V threshold to read as high
-
-## OLED
-- SSD1306 0.91"
-- 128 x 32 pixels
-- I2C Protocol
diff --git a/hardware/EuroPi/hardware_mods.md b/hardware/EuroPi/hardware_mods.md
deleted file mode 100644
index 7eeac5274..000000000
--- a/hardware/EuroPi/hardware_mods.md
+++ /dev/null
@@ -1,48 +0,0 @@
-# Hardware Mods
-
-This file documents some common hardware modifications to EuroPi. These modifications are wholly
-at your own risk; if performed wrong they could cause damage to your module!
-
-## Alternative to OLED jumper wires
-
-Instead of [soldering jumper wires](/hardware/EuroPi/build_guide.md#oled-configuration) to configure
-the OLED, you can instead install a 2x4 bank of headers and use 4 jumpers. This makes it easy to
-reconfigure the OLED connection, which may be useful if you ever need to replace the display.
-
-
-
-_Header pins and jumpers used in the CPC orientation_
-
-## Reducing analogue input noise
-
-The original analogue input stage, as designed by Émilie Gillet (of Mutable Instruments fame) includes
-a 1nF capacitor located in parallel with the final resistor:
-
-
-
-_The input stage of Mutable Instruments Braids. Note the `1n` capacitor in the upper-right._
-
-If you find your EuroPi's V/Oct outputs are incorrect, or are seeing an undesirable amount of jitter on
-`AIN`, you can add a 1nF capacitor in parallel with `R23`. The easiest way to do this is to _carefully_
-solder the 1nF capacitor directly to the back-side of `R23`, as shown below:
-
-
-
-_A 1nF capacitor soldered to the back-side of the EuroPi PCB, in parallel with `R23`_
-
-After soldering the 1nF capactor in place, you should [recalibrate EuroPi](/software/firmware/tools/calibrate.md).
-
-## Heatsink installation
-
-Several vendors sell aluminium or copper heatsink blocks that can be installed on the Raspberry Pi Pico's processor
-to help dissipate heat. If you find your EuroPi's CPU getting too warm during operation, you may find installing
-a heatsink beneficial.
-
-Most commercially-made heatinks have a self-adhesive, thermally-conductive pad on the back. Simply peel off the
-backing and carefully press the heatink directly onto the CPU. Make sure the Pico is powered off while doing this,
-and follow the manufacturer's guidelines for ESD protection to avoid accidentally damaging the electronics.
-
-
-
-
-_A Raspberry Pi Pico with an aluminium heatsink installed on the CPU_
diff --git a/hardware/EuroPi/panel/europi-panel.ai b/hardware/EuroPi/panel/europi-panel.ai
deleted file mode 100644
index c4bad39be..000000000
--- a/hardware/EuroPi/panel/europi-panel.ai
+++ /dev/null
@@ -1,6100 +0,0 @@
-%PDF-1.6
%
-1 0 obj
<>/OCGs[32 0 R 33 0 R 31 0 R]>>/Pages 3 0 R/Type/Catalog>>
endobj
2 0 obj
<>stream
-
-
-
-
- application/pdf
-
-
- europi-panel
-
-
- 2024-11-11T07:38:23Z
- 2024-11-11T07:38:23Z
- 2024-11-11T07:38:23+01:00
- Adobe Illustrator 29.0 (Windows)
-
-
-
- 68
- 256
- JPEG
- /9j/4AAQSkZJRgABAgEASABIAAD/7QAsUGhvdG9zaG9wIDMuMAA4QklNA+0AAAAAABAASAAAAAEA
AQBIAAAAAQAB/+4ADkFkb2JlAGTAAAAAAf/bAIQABgQEBAUEBgUFBgkGBQYJCwgGBggLDAoKCwoK
DBAMDAwMDAwQDA4PEA8ODBMTFBQTExwbGxscHx8fHx8fHx8fHwEHBwcNDA0YEBAYGhURFRofHx8f
Hx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8f/8AAEQgBAABEAwER
AAIRAQMRAf/EAaIAAAAHAQEBAQEAAAAAAAAAAAQFAwIGAQAHCAkKCwEAAgIDAQEBAQEAAAAAAAAA
AQACAwQFBgcICQoLEAACAQMDAgQCBgcDBAIGAnMBAgMRBAAFIRIxQVEGE2EicYEUMpGhBxWxQiPB
UtHhMxZi8CRygvElQzRTkqKyY3PCNUQnk6OzNhdUZHTD0uIIJoMJChgZhJRFRqS0VtNVKBry4/PE
1OT0ZXWFlaW1xdXl9WZ2hpamtsbW5vY3R1dnd4eXp7fH1+f3OEhYaHiImKi4yNjo+Ck5SVlpeYmZ
qbnJ2en5KjpKWmp6ipqqusra6voRAAICAQIDBQUEBQYECAMDbQEAAhEDBCESMUEFURNhIgZxgZEy
obHwFMHR4SNCFVJicvEzJDRDghaSUyWiY7LCB3PSNeJEgxdUkwgJChgZJjZFGidkdFU38qOzwygp
0+PzhJSktMTU5PRldYWVpbXF1eX1RlZmdoaWprbG1ub2R1dnd4eXp7fH1+f3OEhYaHiImKi4yNjo
+DlJWWl5iZmpucnZ6fkqOkpaanqKmqq6ytrq+v/aAAwDAQACEQMRAD8AW8zfl3+Ysmv30lxpl1fS
STO/1uMGVZAzEqwYV7du2aGeHIDuCS+s6HtnRDDERnGAAG3Knqv5GeXPNOi6VqK61FJa288kZsbS
U/EpUN6r8f2eVV+7M/Q45RBsU8h7Va3T58kPCIlIA8RHwoedb/N6dme8qk3muLzPLpir5bmig1D1
QTJNxKemFaoIZHrVuI2oe9exVY9baL+ZkFxGkeqxLZstJuZ9eUP6ITkrSo3+7AGHbrUb4UIjWk/M
i1NnJpk0d6kCutxC4iVrhhMfSLn0wF5xhQ5TiFqWH2QrKVK/0T8xZtMuIF1gvdSrNGkkZit+PKO6
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
-
-
-
- uuid:75d31e06-3445-4e21-acac-1d6842dfeca3
- xmp.did:a84a3885-be5c-5943-ae16-e3db035f4d99
- uuid:5D20892493BFDB11914A8590D31508C8
- proof:pdf
-
- uuid:87d7cc42-d24f-554d-97c7-b76979e61089
- xmp.did:68099ade-e32b-42d3-94ec-ef546c954f1c
- uuid:5D20892493BFDB11914A8590D31508C8
- proof:pdf
-
-
-
-
- saved
- xmp.iid:a84a3885-be5c-5943-ae16-e3db035f4d99
- 2024-02-16T11:36:52Z
- Adobe Illustrator 27.9 (Windows)
- /
-
-
-
- Document
- Print
- AIRobin
- False
- False
- 1
-
- 40.640000
- 128.500000
- Millimeters
-
-
-
- Cyan
- Magenta
- Yellow
- Black
-
-
-
-
-
- Default Swatch Group
- 0
-
-
-
- White
- CMYK
- PROCESS
- 0.000000
- 0.000000
- 0.000000
- 0.000000
-
-
- Black
- CMYK
- PROCESS
- 0.000000
- 0.000000
- 0.000000
- 100.000000
-
-
- CMYK Red
- CMYK
- PROCESS
- 0.000000
- 100.000000
- 100.000000
- 0.000000
-
-
- CMYK Yellow
- CMYK
- PROCESS
- 0.000000
- 0.000000
- 100.000000
- 0.000000
-
-
- CMYK Green
- CMYK
- PROCESS
- 100.000000
- 0.000000
- 100.000000
- 0.000000
-
-
- CMYK Cyan
- CMYK
- PROCESS
- 100.000000
- 0.000000
- 0.000000
- 0.000000
-
-
- CMYK Blue
- CMYK
- PROCESS
- 100.000000
- 100.000000
- 0.000000
- 0.000000
-
-
- CMYK Magenta
- CMYK
- PROCESS
- 0.000000
- 100.000000
- 0.000000
- 0.000000
-
-
- C=15 M=100 Y=90 K=10
- CMYK
- PROCESS
- 15.000000
- 100.000000
- 90.000000
- 10.000000
-
-
- C=0 M=90 Y=85 K=0
- CMYK
- PROCESS
- 0.000000
- 90.000000
- 85.000000
- 0.000000
-
-
- C=0 M=80 Y=95 K=0
- CMYK
- PROCESS
- 0.000000
- 80.000000
- 95.000000
- 0.000000
-
-
- C=0 M=50 Y=100 K=0
- CMYK
- PROCESS
- 0.000000
- 50.000000
- 100.000000
- 0.000000
-
-
- C=0 M=35 Y=85 K=0
- CMYK
- PROCESS
- 0.000000
- 35.000000
- 85.000000
- 0.000000
-
-
- C=5 M=0 Y=90 K=0
- CMYK
- PROCESS
- 5.000000
- 0.000000
- 90.000000
- 0.000000
-
-
- C=20 M=0 Y=100 K=0
- CMYK
- PROCESS
- 20.000000
- 0.000000
- 100.000000
- 0.000000
-
-
- C=50 M=0 Y=100 K=0
- CMYK
- PROCESS
- 50.000000
- 0.000000
- 100.000000
- 0.000000
-
-
- C=75 M=0 Y=100 K=0
- CMYK
- PROCESS
- 75.000000
- 0.000000
- 100.000000
- 0.000000
-
-
- C=85 M=10 Y=100 K=10
- CMYK
- PROCESS
- 85.000000
- 10.000000
- 100.000000
- 10.000000
-
-
- C=90 M=30 Y=95 K=30
- CMYK
- PROCESS
- 90.000000
- 30.000000
- 95.000000
- 30.000000
-
-
- C=75 M=0 Y=75 K=0
- CMYK
- PROCESS
- 75.000000
- 0.000000
- 75.000000
- 0.000000
-
-
- C=80 M=10 Y=45 K=0
- CMYK
- PROCESS
- 80.000000
- 10.000000
- 45.000000
- 0.000000
-
-
- C=70 M=15 Y=0 K=0
- CMYK
- PROCESS
- 70.000000
- 15.000000
- 0.000000
- 0.000000
-
-
- C=85 M=50 Y=0 K=0
- CMYK
- PROCESS
- 85.000000
- 50.000000
- 0.000000
- 0.000000
-
-
- C=100 M=95 Y=5 K=0
- CMYK
- PROCESS
- 100.000000
- 95.000000
- 5.000000
- 0.000000
-
-
- C=100 M=100 Y=25 K=25
- CMYK
- PROCESS
- 100.000000
- 100.000000
- 25.000000
- 25.000000
-
-
- C=75 M=100 Y=0 K=0
- CMYK
- PROCESS
- 75.000000
- 100.000000
- 0.000000
- 0.000000
-
-
- C=50 M=100 Y=0 K=0
- CMYK
- PROCESS
- 50.000000
- 100.000000
- 0.000000
- 0.000000
-
-
- C=35 M=100 Y=35 K=10
- CMYK
- PROCESS
- 35.000000
- 100.000000
- 35.000000
- 10.000000
-
-
- C=10 M=100 Y=50 K=0
- CMYK
- PROCESS
- 10.000000
- 100.000000
- 50.000000
- 0.000000
-
-
- C=0 M=95 Y=20 K=0
- CMYK
- PROCESS
- 0.000000
- 95.000000
- 20.000000
- 0.000000
-
-
- C=25 M=25 Y=40 K=0
- CMYK
- PROCESS
- 25.000000
- 25.000000
- 40.000000
- 0.000000
-
-
- C=40 M=45 Y=50 K=5
- CMYK
- PROCESS
- 40.000000
- 45.000000
- 50.000000
- 5.000000
-
-
- C=50 M=50 Y=60 K=25
- CMYK
- PROCESS
- 50.000000
- 50.000000
- 60.000000
- 25.000000
-
-
- C=55 M=60 Y=65 K=40
- CMYK
- PROCESS
- 55.000000
- 60.000000
- 65.000000
- 40.000000
-
-
- C=25 M=40 Y=65 K=0
- CMYK
- PROCESS
- 25.000000
- 40.000000
- 65.000000
- 0.000000
-
-
- C=30 M=50 Y=75 K=10
- CMYK
- PROCESS
- 30.000000
- 50.000000
- 75.000000
- 10.000000
-
-
- C=35 M=60 Y=80 K=25
- CMYK
- PROCESS
- 35.000000
- 60.000000
- 80.000000
- 25.000000
-
-
- C=40 M=65 Y=90 K=35
- CMYK
- PROCESS
- 40.000000
- 65.000000
- 90.000000
- 35.000000
-
-
- C=40 M=70 Y=100 K=50
- CMYK
- PROCESS
- 40.000000
- 70.000000
- 100.000000
- 50.000000
-
-
- C=50 M=70 Y=80 K=70
- CMYK
- PROCESS
- 50.000000
- 70.000000
- 80.000000
- 70.000000
-
-
-
-
-
- Grays
- 1
-
-
-
- C=0 M=0 Y=0 K=100
- CMYK
- PROCESS
- 0.000000
- 0.000000
- 0.000000
- 100.000000
-
-
- C=0 M=0 Y=0 K=90
- CMYK
- PROCESS
- 0.000000
- 0.000000
- 0.000000
- 89.999400
-
-
- C=0 M=0 Y=0 K=80
- CMYK
- PROCESS
- 0.000000
- 0.000000
- 0.000000
- 79.998800
-
-
- C=0 M=0 Y=0 K=70
- CMYK
- PROCESS
- 0.000000
- 0.000000
- 0.000000
- 69.999700
-
-
- C=0 M=0 Y=0 K=60
- CMYK
- PROCESS
- 0.000000
- 0.000000
- 0.000000
- 59.999100
-
-
- C=0 M=0 Y=0 K=50
- CMYK
- PROCESS
- 0.000000
- 0.000000
- 0.000000
- 50.000000
-
-
- C=0 M=0 Y=0 K=40
- CMYK
- PROCESS
- 0.000000
- 0.000000
- 0.000000
- 39.999400
-
-
- C=0 M=0 Y=0 K=30
- CMYK
- PROCESS
- 0.000000
- 0.000000
- 0.000000
- 29.998800
-
-
- C=0 M=0 Y=0 K=20
- CMYK
- PROCESS
- 0.000000
- 0.000000
- 0.000000
- 19.999700
-
-
- C=0 M=0 Y=0 K=10
- CMYK
- PROCESS
- 0.000000
- 0.000000
- 0.000000
- 9.999100
-
-
- C=0 M=0 Y=0 K=5
- CMYK
- PROCESS
- 0.000000
- 0.000000
- 0.000000
- 4.998800
-
-
-
-
-
- Brights
- 1
-
-
-
- C=0 M=100 Y=100 K=0
- CMYK
- PROCESS
- 0.000000
- 100.000000
- 100.000000
- 0.000000
-
-
- C=0 M=75 Y=100 K=0
- CMYK
- PROCESS
- 0.000000
- 75.000000
- 100.000000
- 0.000000
-
-
- C=0 M=10 Y=95 K=0
- CMYK
- PROCESS
- 0.000000
- 10.000000
- 95.000000
- 0.000000
-
-
- C=85 M=10 Y=100 K=0
- CMYK
- PROCESS
- 85.000000
- 10.000000
- 100.000000
- 0.000000
-
-
- C=100 M=90 Y=0 K=0
- CMYK
- PROCESS
- 100.000000
- 90.000000
- 0.000000
- 0.000000
-
-
- C=60 M=90 Y=0 K=0
- CMYK
- PROCESS
- 60.000000
- 90.000000
- 0.003100
- 0.003100
-
-
-
-
-
-
- Adobe PDF library 17.00
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-endstream
endobj
3 0 obj
<>
endobj
5 0 obj
<>/ExtGState<>/Properties<>/Shading<>>>/Thumb 66 0 R/TrimBox[0.0 0.0 115.2 364.252]/Type/Page/PieceInfo<>>>
endobj
35 0 obj
<>stream
-HWK
)]
-~ⷵxe>@cl/ft|̪0U3">_ׯӟoÆ?!zOG|K|C~^1|ly||om2s8B:>ނ
[Cg4=ܞGxG!~N6E{4p̱!=zhb`{, 7^k-T