1skiboot-5.2.0
2=============
3
4skiboot-5.2.0 was released on Wednesday March 16th, 2016.
5
6skiboot-5.2.0 is the first stable release of skiboot 5.2, the new stable
7release of skiboot, which will take over from the 5.1.x series which was
8first released August 17th, 2015.
9
10skiboot-5.2.0 contains all bug fixes as of skiboot-5.1.15.
11
12This is the second release that will follow the (now documented) Skiboot
13stable rules - see :ref:`stable-rules`.
14
15Changes since rc2
16-----------------
17Over skiboot-5.2.0-rc2, the following fixes are included:
18
19- Include 'extract-gcov' in make clean.
20- ipmi-sel: Fix esel event logger to handle early boot PANIC events
21- IPMI: Enable synchronous eSEL logging option (for PANIC events)
22- libflash/libffs: Reporting seeing all 0xFF bytes during init.
23- ipmi-sel: Fix memory leak in error path
24
25Changes since rc1
26-----------------
27Over skiboot-5.2.0-rc1, we have the following changes:
28
29- Add Barreleye platform
30
31Generic
32^^^^^^^
33
34- hw/p8-i2c: Speed up SMBUS_WRITE
35- Fix early backtraces
36
37FSP Platforms
38^^^^^^^^^^^^^
39
40- fsp-sensor: rework device tree for sensors
41- platforms/firenze: Fix I2C clock source frequency
42
43Simics simulator
44^^^^^^^^^^^^^^^^
45
46- Enable Simics UART console
47
48Mambo simulator
49^^^^^^^^^^^^^^^
50
51- platforms/mambo: Add terminate callback
52
53  - fix hang in multi-threaded mambo
54  - add multithreaded mambo tests
55
56IPMI
57^^^^
58
59- hw/ipmi: fix event data 1 for System Firmware Progress sensor
60- ipmi: Log exact NetFn value in OPAL logs
61
62AST BMC based platforms
63^^^^^^^^^^^^^^^^^^^^^^^
64
65- hw/bt: allow BT driver to use different buffer size
66
67opal-prd utility
68^^^^^^^^^^^^^^^^
69
70- opal-prd: Add debug output for firmware-driven OCC events
71    We indicate when we have a user-driven event, so add corresponding
72    outputs for firmware-driven ones too.
73
74getscom utility
75^^^^^^^^^^^^^^^
76
77- Add Naples chip support
78
79New Features
80^^^^^^^^^^^^
81Over skiboot-5.1, the following features have been added:
82
83- Naples (P8', i.e. P8 with NVLINK) processor support, including NVLINK.
84- Improvements in gard, libflash/pflash and opal-prd utilities
85
86  - increased testing
87  - increased usability
88  - systemd scripts for opal-prd
89  - pflash can now use the /dev/mtd device to access BMC flash rather than
90    accessing it directly. It is *important* that you use --mtd if your
91    BMC may otherwise know how to interact with its own flash.
92- support for Micron N25Q256Ax and N25Qx256Ax NOR flash.
93- support for Winbond W25Q256BV NOR flash
94- support for an emulated ("fake") RTC clock, useful in simulators
95  and during bringup
96- Explicit 1:1 mapping in ranges properties have been added to PCI
97  bridges. This allows a neat trick with offb and VGA ports that should
98  probably not be told to young children.
99- Added support to read the V2 format of the OCC-OPAL memory region,
100  which supports Workload Optimized Frequency (WOF)
101
102Changes in behavior
103^^^^^^^^^^^^^^^^^^^
104
105- Assigning OPAL IDs to PHBs is now fixed and based on the chip id and PHB
106  index on that chip. On POWER7, we continue to use allocated numbers.
107- We now query the BMC for BT capabilities rather than making assumptions
108
109Removed support
110^^^^^^^^^^^^^^^
111
112- p5ioc2 is no longer supported.
113  This affects a grand total of two POWER7 systems in the world.
114
115**NOTE**: It is planned that skiboot-5.2 will be the last release supporting
116POWER7 machines.
117
118Bugs fixed
119^^^^^^^^^^
120
121- PHB3: Fix unexpected ER (all) on errinjct by PCI config
122- hw/bt: timeout messages when BT interface isn't functional
123- On Habanero, Slot3 should have been "Slot 3".
124- We now completely flush the console buffer before power down and reboot
125- For chips with ibm,occ-functional-state set to false, we don't wait
126  for the OCC to start. This caused needless delay in booting on simulators
127  which did not simulate OCCs.
128- Change OCC reset order to always reset slave OCCs first.
129- slw: Remove overwrites for EX_PM_CORE_ECO_VRET and EX_PM_CORE_PFET_VRET
130  (these were already initialized in hostboot)
131- p8-i2c: send stop bit on timeouts.
132  Some devices can otherwise leave the bus in a held state.
133
134Other improvements
135^^^^^^^^^^^^^^^^^^
136
137- many fixes of compiler and static analysis warnings
138- increased unit test coverage
139- Unit test of "boot debian jessie installer"
140- ability to plug in other simulators to run existing tests (e.g. simulator for
141  non pegasus p8)
142- Support using (patched) Qemu with PowerNV platform support for running
143  unit tests.
144- increased support for running with sparse
145- We now build with -fstack-protector-strong if supported by the compiler
146- We now build with -Werror for -Wformat
147- pflash is now built as part of travis-ci and for Coverity Scan.
148- There is now a RPM SPEC file that can be used as the basis for packaging
149  skiboot and associated utilities.
150
151Contributors
152------------
153
154We have had a number of improvements in workflow over skiboot-5.1.0. Looking
155back, we have roughly the same number of changesets (372 for 5.1.0, 334 for
1565.2.0-rc1 - even closer for 5.1.0-beta1) which indicates a relatively stable
157rate of development.
158
159Complete statistics are included below (generated by gitdm), but I'd like to
160draw attention to a couple of stats:
161
162======== ====== ======= ======= ======  ========
163Release	 csets	Ack	Reviews	Tested	Reported
164======== ====== ======= ======= ======  ========
1655.0	 329	 15	     20	     1	       0
1665.1	 372	 13	     38	     1	       4
1675.2-rc1	 334	 20	     34	     6	      11
168======== ====== ======= ======= ======  ========
169
170Overall, it looks like we're on the right trajectory for increasing the number
171of eyeballs looking at code before it heads in tree, especially around testing.
172Largely, this increase in Tested-by can be attributed to encouraging the
173existing test teams to start commenting on the patches themselves.
174
175Anyway, here's the full stats from skiboot 5.1.0 to 5.2.0-rc1:
176
177Processed 334 csets from 27 developers
1782 employers found
179A total of 46172 lines added, 23274 removed (delta 22898)
180
181Developers with the most changesets
182
183========================== ===========
184========================== ===========
185Stewart Smith              146 (43.7%)
186Cyril Bur                   52 (15.6%)
187Benjamin Herrenschmidt      15 (4.5%)
188Joel Stanley                12 (3.6%)
189Gavin Shan                  12 (3.6%)
190Alistair Popple             10 (3.0%)
191Vasant Hegde                10 (3.0%)
192Michael Neuling             10 (3.0%)
193Russell Currey               9 (2.7%)
194Cédric Le Goater             8 (2.4%)
195Jeremy Kerr                  8 (2.4%)
196Samuel Mendoza-Jonas         6 (1.8%)
197Neelesh Gupta                6 (1.8%)
198Shilpasri G Bhat             4 (1.2%)
199Oliver O'Halloran            4 (1.2%)
200Mahesh Salgaonkar            4 (1.2%)
201Vipin K Parashar             3 (0.9%)
202Daniel Axtens                3 (0.9%)
203Andrew Donnellan             2 (0.6%)
204Philippe Bergheaud           2 (0.6%)
205Ananth N Mavinakayanahalli   2 (0.6%)
206Vaibhav Jain                 1 (0.3%)
207Sam Mendoza-Jonas            1 (0.3%)
208Adriana Kobylak              1 (0.3%)
209Shreyas B. Prabhu            1 (0.3%)
210Vaidyanathan Srinivasan      1 (0.3%)
211Ian Munsie                   1 (0.3%)
212========================== ===========
213
214Developers with the most changed lines
215
216
217========================== =============
218========================== =============
219Stewart Smith              19533 (39.4%)
220Oliver O'Halloran          17920 (36.1%)
221Alistair Popple             3285 (6.6%)
222Daniel Axtens               2154 (4.3%)
223Cyril Bur                   2028 (4.1%)
224Benjamin Herrenschmidt       941 (1.9%)
225Neelesh Gupta                434 (0.9%)
226Gavin Shan                   294 (0.6%)
227Russell Currey               261 (0.5%)
228Vasant Hegde                 245 (0.5%)
229Cédric Le Goater             209 (0.4%)
230Vipin K Parashar             155 (0.3%)
231Shilpasri G Bhat             153 (0.3%)
232Joel Stanley                 140 (0.3%)
233Vaidyanathan Srinivasan      135 (0.3%)
234Michael Neuling              111 (0.2%)
235Samuel Mendoza-Jonas          81 (0.2%)
236Jeremy Kerr                   60 (0.1%)
237Mahesh Salgaonkar             58 (0.1%)
238Vaibhav Jain                  50 (0.1%)
239Ananth N Mavinakayanahalli    43 (0.1%)
240Shreyas B. Prabhu             17 (0.0%)
241Sam Mendoza-Jonas             12 (0.0%)
242Andrew Donnellan              10 (0.0%)
243Ian Munsie                     8 (0.0%)
244Philippe Bergheaud             6 (0.0%)
245Adriana Kobylak                6 (0.0%)
246========================== =============
247
248Developers with the most lines removed
249
250========================= =============
251========================= =============
252Daniel Axtens             2149 (9.2%)
253Shreyas B. Prabhu           17 (0.1%)
254Andrew Donnellan             9 (0.0%)
255Vipin K Parashar             2 (0.0%)
256========================= =============
257
258Developers with the most signoffs (total 190)
259
260========================= =============
261========================= =============
262Stewart Smith              188 (98.9%)
263Gavin Shan                   1 (0.5%)
264Neelesh Gupta                1 (0.5%)
265========================= =============
266
267Developers with the most reviews (total 34)
268
269========================= =============
270========================= =============
271Patrick Williams             5 (14.7%)
272Joel Stanley                 5 (14.7%)
273Cédric Le Goater            5 (14.7%)
274Vasant Hegde                 4 (11.8%)
275Alistair Popple              4 (11.8%)
276Sam Mendoza-Jonas            3 (8.8%)
277Samuel Mendoza-Jonas         3 (8.8%)
278Andrew Donnellan             2 (5.9%)
279Cyril Bur                    2 (5.9%)
280Vaibhav Jain                 1 (2.9%)
281========================= =============
282
283Developers with the most test credits (total 6)
284
285========================= =============
286========================= =============
287Vipin K Parashar             3 (50.0%)
288Vaibhav Jain                 2 (33.3%)
289Gajendra B Bandhu1           1 (16.7%)
290========================= =============
291
292Developers who gave the most tested-by credits (total 6)
293
294=========================== =============
295=========================== =============
296Gavin Shan                   2 (33.3%)
297Ananth N Mavinakayanahalli    2 (33.3%)
298Alistair Popple              1 (16.7%)
299Stewart Smith                1 (16.7%)
300=========================== =============
301
302Developers with the most report credits (total 11)
303
304========================= =============
305========================= =============
306Vaibhav Jain                 2 (18.2%)
307Paul Nguyen                  2 (18.2%)
308Alistair Popple              1 (9.1%)
309Cédric Le Goater            1 (9.1%)
310Aneesh Kumar K.V             1 (9.1%)
311Dionysius d. Bell            1 (9.1%)
312Pradeep Ramanna              1 (9.1%)
313John Walthour                1 (9.1%)
314Benjamin Herrenschmidt       1 (9.1%)
315========================= =============
316
317Developers who gave the most report credits (total 11)
318
319========================= =============
320========================= =============
321Gavin Shan                   6 (54.5%)
322Stewart Smith                3 (27.3%)
323Samuel Mendoza-Jonas         1 (9.1%)
324Shilpasri G Bhat             1 (9.1%)
325========================= =============
326